Note: This version of the VDT (1.10.1) is supported, but is not our latest stable release. The current stable release is 2.0.0.
Below are instructions for updating from VDT 1.10.1u to 1.10.1v. We strongly recommend that you use the new VDT updater script to perform the updates, because it is simpler and more likely to be complete and correct, plus it can update any version of VDT 1.10.1 not just VDT 1.10.1u. If you want to use the updater instead of following the manual instructions here, see this page.
If you installed VDT 1.10.1 after VDT 1.10.1v was released on 2009-04-21, you do not need to do any of these update operations because you will have 1.10.1v.
The best way to do the manual update is to update the individual packages that
have changed. To be clear, we do not recommend using
pacman -update without specifying specific package names. Also
note that you only need to update packages if you installed them. You can see
what packages have been installed with:
pacman -lc
Before you do any of the update directions that follow, please run the following commands to stop services and take a backup of your installation. This applies for all of the updates.
cd $VDT_LOCATION . setup.sh vdt-control --off cp -pr $VDT_LOCATION BACKUP-LOCATION
The copy command makes a complete backup of your VDT installation, in case something goes wrong. Do not skip this step!
Note: if you have not yet updated your CA-Certificates package (released on September 11th in VDT 1.10.1i), some of the following updates may automatically include this update for you. After this update, you will need to do a one-time configuration to re-install the certificates on your system. Many of the components installed by the VDT will not work until the certificates are re-installed. See the full instructions.
It is possible that a previous update silently failed on a Condor update and thus has left your pacman installation data in a broken state. It is possible to fix this problem.
To check for and possibly repair the broken Condor package:
pacman -lc | grep Condor
If you see an entry like this:
[ ] Condor
with a space between the square brackets, then go to the next step; otherwise, your install is fine and you are done with this section.
$VDT_LOCATION/vdt/etc/condor-env.sh
If it exists, your install is broken, go to the next step to fix it; otherwise, your install is fine and you are done with this section
pacman -install Condor
Be sure to use -install not -get; this step should fix your install for other update steps
If your install refers to a GUMS server on another machine, you must set an environment variable to refer to that GUMS server before doing updates. Here is a list of files that may be part of your installation and that would contain the GUMS server hostname:
If you find a GUMS server host in one or more of these files, then set the VDT_GUMS_HOST environment variable in your shell. For Bourne shell and variants (e.g., sh, bash):
export VDT_GUMS_HOST=HOSTNAME
For csh and variants (e.g., tcsh):
setenv VDT_GUMS_HOST HOSTNAME
If the VDT-Logrotate package is installed and in use, you will have to preserve the list of packages to be preserved manually. Before running any updates, backup the logrotate configuration file:
cp -p $VDT_LOCATION/vdt/etc/vdt.logrotate $VDT_LOCATION/vdt.logrotate_BACKUP
After the update, go through the contents of vdt.logrotate_BACKUP, and add back into vdt/etc/vdt.logrotate any contents that are missing.
We plan to improve the update process for VDT log rotation in a future release.
Globus is partitioned into many Pacman packages. To simplify our instructions, we suggest different update steps based on the kind of installation you have. If none of these instructions are helpful for you, please contact us for help.
If you've installed an OSG-CE:
pacman -update Globus-Server pacman -update Globus-Client pacman -update Globus-WS pacman -update Globus-RLS-Client
You will also need to update your job manager. Use the appropriate commands below.
pacman -update Globus-WS-Condor-Setup pacman -update Globus-WS-PBS-Setup pacman -update Globus-WS-LSF-Setup
If you've installed the OSG Worker Node, OSG Client or VDT Client:
pacman -update Globus-Client pacman -update Globus-WS-Client pacman -update Globus-RLS-Client
If you've installed any other high-level package that installs Globus:
OSG note: After updating Globus in an OSG CE, there is one more step to complete. The Globus update overwrites the OSG job environment patch, which allows for extra OSG environment variables to be set in a job’s execution environment. To restore the patch after the Globus update, do this step:
patch -p0 -R < $VDT_LOCATION/vdt/etc/package_data/Job-Environment.configdiff
RFT note: If your Globus installation includes RFT (look for the globus/etc/globus_wsrf_rft directory), then the update probably overwrote your RFT database credentials in a key configuration file. Follow these steps:
$OLD_VDT_LOCATION/globus/etc/globus_wsrf_rft/jndi-config.xml
<parameter>
<name>
userName
</name>
<value>rft</value>
</parameter>
<parameter>
<name>
password
</name>
<value>PASSWORD</value>
</parameter>
$VDT_LOCATION/globus/etc/globus_wsrf_rft/jndi-config.xml
Update the GUMS-Client package if your installation includes it (look for the $VDT_LOCATION/gums/scripts directory):
pacman -update GUMS-Client
Update the GUMS-Service package if your installation includes it (look for a $VDT_LOCATION/gums/gums-service-*.war file):
pacman -update GUMS-Service
After updating the GUMS-Service package, the gums-host-cron service will be disabled by default. If you had the gums-host-cron service enabled before the update, you can re-enable it with the following command:
vdt-control --enable gums-host-cron
Update the PRIMA-GT4 package if your installation includes it (look for a $VDT_LOCATION/globus/lib/prima-gt4-*.jar file):
pacman -update PRIMA-GT4
Updating the PRIMA-GT4 package will also update the PRIMA package. However, if you do not have PRIMA-GT4, then update the PRIMA package if your installation includes it (look for the $VDT_LOCATION/prima directory):
pacman -update PRIMA
Update the Glexec package if your installation includes it (look for the $VDT_LOCATION/glexec-osg directory):
pacman -update Glexec
Update the Generic-Information-Provider package if your installation includes it (look for the $VDT_LOCATION/gip directory):
pacman -update Generic-Information-Provider
Update the CEMon-Server package if your installation includes it (look for the $VDT_LOCATION/glite/share/webapps/ce-monitor.war file):
pacman -update CEMon-Server
Update the Verify-GIP-For-CEMon package if your installation includes it (look for the $VDT_LOCATION/verify-gip-for-cemon directory):
pacman -update Verify-GIP-For-CEMon
Update the Configure-Gratia package if your installation includes it (look for the $VDT_LOCATION/vdt/setup/configure_gratia file):
pacman -update Configure-Gratia
Note: Sometime after updating, you will need to reconfigure OSG-RSV, which may be as simple as rerunning configure-osg.py with your existing config.ini file. But, if you are also updating OSG-RSV, wait until after you have completed that update (see below). For complete configuration information, see the instructions here.
Update the Bestman package if your installation includes it (look for the $VDT_LOCATION/bestman directory):
pacman -update Bestman # see below for configuration
Preserving Bestman configuration: When Bestman is updated in 1.10.1v, the configuration is reverted to the default setup. If you have run configure_bestman manually in the past to provide custom configuration, you will need to re-run the script with all the necessary options.
The command below may be able to provide you a summary of arguments configure_bestman has been called with in the past:
cd $VDT_LOCATION
perl -n -e 'if($a) { $a=0; print} if(m|loaded by vdt/setup/configure_bestman|) { $a=1 }' vdt-install.log
Update the SRM-Client-LBNL package if your installation includes it (look for the $VDT_LOCATION/srm-client-lbnl directory):
pacman -update SRM-Client-LBNL
Update the SRM-Tester-LBNL package if your installation includes it (look for the $VDT_LOCATION/srm-tester-lbnl directory):
pacman -update SRM-Tester-LBNL
Update the OSG-RSV package if your installation includes it (look for the $VDT_LOCATION/osg-rsv directory):
pacman -update OSG-RSV # see below for configuration
Note: Sometime after updating, you will need to reconfigure OSG-RSV, which may be as simple as rerunning configure-osg.py with your existing config.ini file. For complete configuration information, see the instructions here.
Update the Wget package if your installation includes it (look for the $VDT_LOCATION/wget directory):
pacman -update Wget
Update the LCG-Info package if your installation includes it (look for the $VDT_LOCATION/lcg directory):
pacman -update LCG-Info
Update the EDG-Make-Gridmap package if your installation includes it (look for the $VDT_LOCATION/edg directory):
pacman -update EDG-Make-Gridmap
Update the Configure-Xrootd package if your installation includes it (look for the $VDT_LOCATION/vdt/setup/configure_xrootd file):
pacman -update Configure-Xrootd
If you want to install the OSG Matchmaker, newly added to the VDT in this release, use this command:
pacman -get OSG-Match-Maker
If you are finished applying all lettered updates, do not forget to restart services,
typically using vdt-control. For example, to turn on all services:
vdt-control --on