autoupdate: Urchin Automatic Updates Utility

autoupdate: Urchin Automatic Updates Utility

Overview

The autoupdate utility is used to check, download, and upgrade Urchin components.

Supported operations:

  • automatic upgrades of Urchin components such as the Urchin Product, Embedded Help, Help Center documentation and Geo Databases.
  • rollback of an upgrade process if there are errors.

Usage

The autoupdate utility can be invoked by the Urchin scheduler (urchind) on a scheduled basis or manually via the command line. Autoupdate scheduler settings are available via Settings -> Global Settings -> Autoupdate in the Urchin Admin Interface.

The default behavior is to check for updates, download and install the new urchin components. Usage is as follows:

autoupdate [-h] [-v] [-V] [-u] [-r] [-e] [-g] [-H] [-D] [-T] [-f]

Where:

  -h            Prints help information and exits
  -v            Prints version information and exits
  -V            Prints components version numbers and exits
  -u            Updates entire product to newer version
  -r            Rolls back entire product to previously installed version
  -e            Updates help articles
  -g            Updates GeoDB
  -H            Specifies to log run output to history file 
  -D            Enabled debug mode 
  -T <task id>  Specifies the task history record to update               
                Specifying -T forces use of -H               
                Specifying -T prohibits use of -u -g 
  -f <path>     Specifies locally served update package
                Specifying -f also requires explicit -u -g  

Examples

To upgrade all Urchin components to the latest version:

autoupdate -u

If no updates are available for Urchin components, the message "Urchin is up to date: "LAST_UPDATE_TIME" is displayed.

To upgrade Urchin Help Articles to the latest version:

autoupdate -e

Note: The autoupdate utility needs an internet connection to be able to check for and download new updates. The utility uses port 80 to communicate with the Web server providing the updates. It is possible that you will have problems when going through firewalls and proxy servers when performing updates. Please consult your network administrator if this is the case.