| 1 |
arta |
1.1 |
Release Notes JSOC V3.0 14Aug2006 |
| 2 |
|
|
----------------------- --------- |
| 3 |
|
|
|
| 4 |
|
|
(Release to implement Postgres namespace features for DRMS) |
| 5 |
|
|
(Notes will follow.) |
| 6 |
|
|
|
| 7 |
|
|
The official release version is in /home/production/cvs/jsoc. |
| 8 |
|
|
This will remain unchanged until the next release. |
| 9 |
|
|
You may make any changes you want in your sandbox, but anything that you |
| 10 |
|
|
commit will appear in the next offical release. |
| 11 |
|
|
|
| 12 |
|
|
**************** If You Don't Have a Sandbox ******************************** |
| 13 |
|
|
|
| 14 |
|
|
You need a cvs "sandbox" to contain your view of a JSOC release: |
| 15 |
|
|
(There is no need to do this unless you're going to be a jsoc developer.) |
| 16 |
|
|
|
| 17 |
|
|
Set the env variables: |
| 18 |
|
|
CVSROOT=:ext:sunroom.stanford.edu:/home/cvsuser/cvsroot |
| 19 |
|
|
CVS_RSH=ssh |
| 20 |
|
|
|
| 21 |
|
|
Make a cvs dir and do: |
| 22 |
|
|
> cd /home/you/cvs |
| 23 |
|
|
> cvs checkout jsoc |
| 24 |
|
|
############################################################################ |
| 25 |
|
|
|
| 26 |
|
|
---------------------------------------------------------------------------- |
| 27 |
|
|
Resync your sandbox with the V3.0 release: |
| 28 |
|
|
|
| 29 |
|
|
> cd /home/you/cvs/jsoc |
| 30 |
|
|
> cvs update -APd >& cvsupdate.log |
| 31 |
|
|
|
| 32 |
|
|
Inspect cvsupdate.log for any "C " status. |
| 33 |
|
|
|
| 34 |
|
|
C file |
| 35 |
|
|
A conflict was detected while trying to merge your changes to file |
| 36 |
|
|
with changes from the source repository. file (the copy in your |
| 37 |
|
|
working directory) is now the result of attempting to merge the two |
| 38 |
|
|
revisions; an unmodified copy of your file is also in your working |
| 39 |
|
|
directory, with the name .#file.revision where revision is the revi- |
| 40 |
|
|
sion that your modified file started from. Resolve the conflict |
| 41 |
|
|
|
| 42 |
|
|
|
| 43 |
|
|
---------------------------------------------------------------------------- |
| 44 |
|
|
Check for any files that have not been commited (not Status: Up-to-date): |
| 45 |
|
|
|
| 46 |
|
|
> cvsstatus (NOTE: s/b an alias for $JSOCROOT/scripts/cvsstatus.pl) |
| 47 |
|
|
(see end) |
| 48 |
|
|
|
| 49 |
|
|
Determine if any modified files need to be committed or replaced with the |
| 50 |
|
|
repository version before proceeding. |
| 51 |
|
|
If you have a file here that you wanted in the release, please contact CM. |
| 52 |
|
|
|
| 53 |
|
|
---------------------------------------------------------------------------- |
| 54 |
|
|
You now need to make on linux_ia64 (lws) or linux_x86_64 or linuxia32 |
| 55 |
|
|
(some workstations) machines depending on where you want to run: |
| 56 |
|
|
Please use n12 and n00 for x86_64 and linuxia32 builds. (good compilers) |
| 57 |
|
|
|
| 58 |
|
|
> ssh lws (and then again for n12, etc.) |
| 59 |
|
|
> cd /home/you/cvs/jsoc |
| 60 |
|
|
> ./configure -force -client |
| 61 |
|
|
(ignore modification time in future msgs (small delta)) |
| 62 |
|
|
|
| 63 |
|
|
> make clean |
| 64 |
|
|
> make -j 4 >& make.log.lws (optional, run 4 jobs in parallel for speed) |
| 65 |
|
|
|
| 66 |
|
|
Set your path for /home/you/cvs/jsoc/bin/linux_ia64 (or linux_x86_64 or |
| 67 |
|
|
linux_ia32). NOTE: This is usually done by source .setJSOCenv in your .login. |
| 68 |
|
|
|
| 69 |
|
|
****************Additional Info********************************************** |
| 70 |
|
|
|
| 71 |
|
|
The command |
| 72 |
|
|
|
| 73 |
|
|
> configure -help |
| 74 |
|
|
|
| 75 |
|
|
will print information about how to create a customized build, |
| 76 |
|
|
to e.g. use a different compiler or turn on debugging flags. |
| 77 |
|
|
|
| 78 |
|
|
If you are unfamiliar with the use of cvs see the file: |
| 79 |
|
|
jsoc/CM/working_with_sandbox.txt. |
| 80 |
|
|
|
| 81 |
|
|
There's a linux4 cvs gui at xim:/usr/bin/lincvs |
| 82 |
|
|
Also on our jsoc web page: |
| 83 |
|
|
|
| 84 |
|
|
http://jsoc.stanford.edu/cvs/jsoc/ |
| 85 |
|
|
|
| 86 |
|
|
---------------------------------------------------------------------------- |
| 87 |
|
|
|
| 88 |
|
|
WARNING: The "cvs diff" command does not always return differences even |
| 89 |
|
|
when there are some. The "cvs status" will show that the file is not |
| 90 |
|
|
Up-to-date but the "cvs diff" will not show any differences. |
| 91 |
|
|
|
| 92 |
|
|
Work Around: Use the Apache cvs gui to see the diffs. For example, go to |
| 93 |
|
|
http://jsoc.stanford.edu/cvs/jsoc/src/base/libdrms/ |
| 94 |
|
|
and click on the name in the File column and then click on |
| 95 |
|
|
"diffs to previous #" to see the diffs. |
| 96 |
|
|
|
| 97 |
|
|
----------------------------------------------------------------------------- |
| 98 |
|
|
|
| 99 |
|
|
CHANGE to cvsstatus alias: |
| 100 |
|
|
If you have this alias defined, please change it. |
| 101 |
|
|
This was previously: |
| 102 |
|
|
> alias cvsstatus |
| 103 |
|
|
cvs status | egrep ^File: | egrep -v Up-to-date |
| 104 |
|
|
|
| 105 |
|
|
Now make it (as approriate for your location of the jsoc tree): |
| 106 |
|
|
> alias cvsstatus '$HOME/cvs/jsoc/scripts/cvsstatus.pl' |
| 107 |
|
|
|
| 108 |
|
|
The old cvsstatus could generate many file names without giving their location |
| 109 |
|
|
in the tree. This was hard to deal with. |
| 110 |
|
|
|
| 111 |
|
|
The new cvsstatus is now a perl script that will print out all the not |
| 112 |
|
|
Up-to-date files and also their full path name in the repository. |
| 113 |
|
|
|
