upgrade-site.sh

With this script, you can perform a cumulative patch upgrade or downgrade on a running instance.

Overview

This is a wrapper for the upgrade.py script.

The script verifies the following:

It performs the following actions depending on the options specified:

Usage

Run this script as follows:

Example

To perform a component upgrade from a base SourceForge installation (patch level 0) to patch level 2, use this command:

sudo ./upgrade-site.sh -t -d /opt/collabnet/teamforge -l 2

Options

-f [manifest] | --file [manifest]
The manifest file with the appropriate information for this upgrade.
-d [INSTALLATION_DIR] | --directory [INSTALLATION_DIR]
The directory where the application is installed.
Note: This option is required.
-r | --rollback
Rolls back the previous (most recently applied) patch. For example, if you upgrade the site from patch level 1 to patch level 4, and then run upgrade-site.sh with this option, the resulting patch level on the site is patch 1.
-l [level] | --level [level]
The patch level to which the SourceForge site must be upgraded (or downgraded).
-V | --verbose
Displays script output including traceback errors. If this option is not used, the script displays error messages but not the actual traceback errors.
-v | --version
Displays the script version.
-n | --noninteractive
Non-interactive mode.
-t | --testrun
Displays a summary of the actions that will be performed as part of the upgrade or downgrade. Use this option to view a description of what would take place during a patch upgrade (or downgrade) before you actually apply the patch.
Note: You must use this option along with the l, r, u, or f options.
-u | --uninstall
Decrements the patch level on the site by one. For example, if you upgrade the site from patch level 1 to patch level 4, and then run upgrade-site.sh with this option, the resulting patch level on the site is patch 3.
-h | --help
Prints usage information.
Note: Do not use the following combinations of options in the same command:
  • -u (uninstall) with -r (rollback)
  • -f (manifest) with -l (level)
  • any combination of -u, -r, -l, -f

If you do, the script exits with a corresponding error message.