Menu Close

Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

4.2. About the Upgrade Script

As with installation (Section 3.6, “About the rhqctl Script”), the rhqctl script is used to manage server migrations. The upgrade command, much like the install command, handles all three management components on the server system:
  • Upgrades the JBoss ON server.
  • Upgrades the JBoss ON agent on the same system as the JBoss ON server. [1]
  • Upgrades a JBoss ON storage node. If upgrading from a 3.1 (or older) deployment, the upgrade process installs a storage node.
The upgrade script requires the original location of the server and agent directories.

Options for Upgrading JBoss ON

--list-versions
Prints the installed version of the servers and storage nodes in the topology. This must be run from a JBoss ON 3.3 server that is newly-installed or already upgraded. This cannot be run from a standalone storage node, only a server.
Note
When this option is used, any other options are ignored.
--from-server-dir directory
Gives the directory path to the server to be upgraded.
--from-agent-dir directory
Specifies the path, relative to the server installation directory in --from-server-dirs>. The default location is serverRoot/jon-server-3.3.2.GA/rhq-agent/.
Note
Only required when the agent is installed in a custom location.
--storage-data-root-dir directory
Specifies the location to use for the storage node (by default, installed as part of upgrading) if it should use a non-default directory. This is useful if the default directory is not writable by the JBoss ON user, such as /var/lib.
Note
For upgrading 3.1 or older servers.
--storage-schema
Updates the storage cluster schema. This is done after all of the storage nodes and servers have been upgraded and are running. This must be run from a JBoss ON 3.3 server that is newly-installed or already upgraded. This cannot be run from a standalone storage node, only a server.
The running time for the schema update varies depending on the schema changes being made and should not be interrupted.
Note
When this option is used, any other options are ignored.
--use-remote-storage-node [true | false]
Sets whether to use a local storage node or one on another system. By default, storage nodes and servers are on the same system; if this option is set to true, then the server configuration is used to identify the remote storage node connection information.
The running time for the schema update varies depending on the schema changes being made and should not be interrupted.
Note
When this option is used, any other options are ignored.


[1] Agents installed from a JAR file are upgraded automatically by the server. Agents installed through an RPM can be updated using the rpm -Uvh command with the new package.