Installing a New Java Version

Basic Steps

1. down load the files from the java download site. Keep them all in the same directory, e.g./tmp
2. check space availablity for each target directory by running checkQuota
3. create the jdk-* subdirectory under each OS directory, e.g. linux, solaris, etc.
4. change the patch variable in the installJava script to the latest patch number
5. cd to the place where you downloaded all the files
6. run installJava
7. check that the new versions were unpacked properly
8. run the release script to deploy the new versions
9. restart the test server and check that everything still works
10. restart all the other servers. Use the server monitoring page to do this.
11. update the web page
12. announce to mailing lists

The download url may change but currently the download page is

http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u26-download-400750.html

Download to /tmp, the set of files that match the pattern:

Make sure there is sufficient space in the target directories by running

/afs/.slac.stanford.edu/package/java/common/install/checkQuota

if not, clean up by deleting old releases in:

• /afs/.slac.stanford.edu/package/java/i386_linux2
• /afs/.slac.stanford.edu/package/java/amd64_linux
• /afs/.slac.stanford.edu/package/java/sun4x_55

Old releases should not have links to them and their release number should be several levels lower than a current release.

If you still need more space put in an  afs request

Use the mkdir command to create the new directory; for example for patch 26:

        cd /afs/.slac.stanford.edu/package/java/i386_linux2

        mkdir jdk1.6.0_26

Target Directories - Readonly and Shadow Version

visible path = /afs/slac/package/java/directory_name

shadow path = /afs/*.*slac/package/java/directory_name (note the dot in the path hides this directory)

*If a download release contains two files one ends up in the target directory under bin

Install the new versions

Edit the script installJava located in

/afs/.slac.stanford.edu/package/java/common/install/installJava

cd to the place where you downloaded all the files and execute installJava from there.

Deploy the new versions

The script /afs/slac.stanford.edu/package/java/build/release is a bourne shell script that assembles the names of the volumes it finds in the java directory that will be updated and then makes calls to the vos_release command which in turn calls vos commands to update a release.  The same script is in the shadow directory but it refers to the visible path when building the package list.

Once you deploy the new version you must restart the servers so they can pick up the changes. The best way is to restart the test server and see if everything is ok there. If nothing breaks then restart the other servers.

Updating the Web Page

Update the web page in the shadow directory (the visible directory is read-only). Drag the path to index.html into the browser location window to see your changes. Once the code is released the web page will also be updated with the copy in the shadow directory.

If you need to make changes to the web page only then rerun the release script using common as the argument:

     /afs/slac.stanford.edu/package/java/build/release common

The common directory, containing the web page index.html will be updated. View the changes on line using the url

http://www.slac.stanford.edu/comp/java/index.html

Announce via Mailing Lists