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.

Manual Update Instructions for VDT 1.10.1x

Below are instructions for updating from VDT 1.10.1w to 1.10.1x. 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.1w. 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.1x was released on 2009-06-04, you do not need to do any of these update operations because you will have 1.10.1x.

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

Pre-update directions

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: Updating CA-Certificates

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.

Fixing a Broken Condor Package

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:

  1. Look for an uninstalled 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.

  2. Look for the following file in your install:
    $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

  3. Fix the install:
    pacman -install Condor

    Be sure to use -install not -get; this step should fix your install for other update steps

Setting the Environment

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

Preserving Log Rotations

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.

Updating Glexec

Update the Glexec package if your installation includes it (look for the $VDT_LOCATION/glexec directory):

pacman -update Glexec

Post-update directions

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