4.2. About the Upgrade Script

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.