Running Rational Product Updater from a command line

Rational® Product Updater can be started from a command line and you can silently install all product updates and optional new features.

Note: You cannot enter a user ID and password for a proxy server from a command line.
To run Product Updater from a command line:
  1. Change to the directory where the Product Updater tool is installed.
    • For Windows®: the default installation directory for the Product Updater tool is system_drive:\Program Files\IBM\Rational\Software Development Platform\6.0\updater\eclipse.
    • For Linux®: the default installation directory is /opt/IBM/Rational/SoftwareDevelopmentPlatform/6.0/updater/eclipse.

    If you have installed Product Updater in a different directory, you will need to change to that directory.

  2. Enter the appropriate command and option as described in the tables below. If you are in an environment with a proxy server, and you are entering a command that requires Product Updater to connect to the Internet (such as -installUpdates), you might also need to enter additional arguments, as shown in Table 3.

    Note that if you are starting the Product Updater user interface, you can click Preferences > Proxy Settings to configure a proxy server connection. See Configuring Rational Product Updater to use a proxy server.

    Table 1. Commands to run the Product Updater
    Windows command Linux command Description
    jre\bin\java.exe -cp startup.jar org.eclipse.core.launcher.Main [options] [proxy server arguments] ./rpu -nosplash -console [options] [proxy server arguments] Use this command to run Product Updater synchronously with console output and to silently install product updates or optional new features.
    This command should be used for the following options:
    • -installUpdates
    • -installFeatures
    • -history
    • -purge

    This command does not return until Product Updater stops. There is no splash screen, and if there is any console output you will see it.

    rpu.exe [options] [proxy server arguments] ./rpu [options] [proxy server arguments] This command starts the Product Updater user interface. Use this command for starting the Product Updater tool with the following options:
    • -features
    • -policyFile [path]
    • -policyURL [URL]
    • -updates
    This command returns immediately.
    Table 2. Command options
    Option Description
    -features Start the Product Updater tool, search for optional new features, and switch to the Optional Features tab.
    -history Display in the console a list of currently installed Rational software development products.
    -installUpdates Silently search for and install all product updates. This option allows you to run the Product Updater tool in a Windows scheduled task or Linux crontab entry.
    -installFeatures Silently search for and install all optional new features. This option allows you to run the Product Updater tool in a Windows scheduled task or Linux crontab entry.
    -policyFile [path] Change from the default policy file to the policy file on your file system specified by [path].
    -policyURL [URL] Change from the default policy file to the remote policy file found at the URL [URL].
    -purge Removes from your system all files that have been superseded by updates that you have installed.

    Important: If you run the -purge option you will not be able to roll back any of the currently installed updates. You will still be able to uninstall products. See Removing outdated files.

    -updates Start the Product Updater tool, search for updates and switch to the Updates tab.
    Table 3. Arguments for enabling an HTTP proxy server connection.
    Proxy server arguments Description
    -vmargs The -vmargs command must precede the proxy server options listed below. For example, rpu.exe [options] -vmargs -Dhttp.proxyEnabled=true -Dhttp.proxyHost=<proxy-host> -Dhttp.proxyPort=<proxy-port>.
    -Dhttp.proxyEnabled=true Enable an HTTP proxy connection.
    -Dhttp.proxyHost=<proxy-host> Specify the HTTP proxy host address, where <proxy-host> is the Internet protocol (IP) address or the domain name system (DNS) host name of your proxy server.
    -Dhttp.proxyPort=<proxy-port> (Optional). Specify the HTTP proxy host address, where <proxy-port> is the port number on which the proxy server listens for requests.
Examples:
  1. Silently search for and install all available product updates.

    Windows:

    jre\bin\java.exe -cp startup.jar org.eclipse.core.launcher.Main -installUpdates

    Linux:

    ./rpu -nosplash -console -installUpdates

  2. Silently search for and install all available product updates and optional new features using a proxy server to connect to the Internet.

    Windows:

    jre\bin\java.exe -cp startup.jar org.eclipse.core.launcher.Main -installUpdates -vmargs -Dhttp.proxyEnabled=true -Dhttp.proxyHost=<proxy-host> -Dhttp.proxyPort=<proxy-port>

    Linux:

    ./rpu -nosplash -console -installUpdates -vmargs -Dhttp.proxyEnabled=true -Dhttp.proxyHost=<proxy-host> -Dhttp.proxyPort=<proxy-port>

  3. Start the Product Updater user interface and have it search the update sites specified in policy file on your file system. (For example, C:\Temp\update_site\policy.xml.)

    Windows:

    rpu.exe -policyFile C:\Temp\update_site\policy.xml

    Linux:

    ./rpu -policyFile /usr/tmp/update_site/policy.xml

  4. Start Product Updater user interface so that it immediately searches for optional new features.

    Windows:

    rpu.exe -features

    Linux:

    ./rpu -features

Related tasks
Finding and installing product updates
Rolling back product updates
Removing outdated files
Exporting a list of installed Rational software development products
Changing the update sites preference
Configuring Rational Product Updater to use a proxy server
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.