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:
- The user invoking the script is the equivalent of a root user.
- The specified directory has a valid SourceForge installation.
It performs the following actions depending on the options specified:
- Displays a summary of what would happen during the patch installation.
- Downgrades or upgrades the site to the specified patch level.
- Reverts the site to the previous patch level it was at, before the current patch
was applied.
- Downgrades the patch level on the site by one.
- Starts SourceForge after successfully installing the patch.
- Allows a test "dry run" of the patch installation.
Usage
Run this script as follows:
-
./upgrade-site.sh -d <INSTALL_DIR> [-r] [-u] [-t] [-l
level] [-f file] [-n] [-h] [-V] [v]
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.