An upgrade procedure for JBoss Operations Network essentially overlays the new JBoss ON packages and libraries over the existing configuration and databases. The upgrade procedure, then, is very similar to the installation process. The new packages need to be installed, and then the server is set up in the same setup wizard. The difference is that the server reuses its existing databases and data so that the configuration from the previous installation is preserved.

Upgrade to JBoss Operations Network 3.0 is only supported from JBoss ON 2.x versions and later.

NOTE

The JBoss ON servers must be upgraded before the JBoss ON agents can be upgraded.

WARNING

There will be a minimal loss monitoring data because of the downtime required when the server and agents are being upgraded. Additionally, any monitoring data for the JBoss ON server will be lost, if the server is included in the inventory.

7.1. Upgrading the JBoss ON Server

Not every step in this upgrade procedure applies to every JBoss Operations Network installation. Just run through the steps in order, and perform the ones necessary for your deployment.

WARNING

Upgrading the JBoss ON server essentially creates a new server instance that replaces the old instance. If the JBoss ON server was added to the inventory, then the old JBoss ON server resource must be deleted from the inventory because it will not be a usable resource after upgrade. Once the upgrade process is complete, then the JBoss ON server must be added to the inventory again and all of the previous configuration for that resource (like alerts, scheduled operations, and group membership) must be redone.

Stop the JBoss ON server which is being upgraded as well as any currently running JBoss ON instances. For example:

serverRoot/jon-server-3.0.0.GA1/bin/rhq-server.sh stop

WARNING

If the upgraded JBoss ON server will use a database that existing JBoss ON instances are also using, then all of the existing JBoss ON instances have to be stopped. Otherwise, the installer will hang when it tries to contact the database and the database is unavailable because it is in use by another JBoss ON server.

Open the server root directory. For example:

cd /opt/jon

Unzip the server packages.

unzip jon-server-3.0.0.GA1.zip

IMPORTANT

Do not copy the new server installation on top of a previous server installation.

The directory structure within the server package gives the new server installation directory a version-specific name, such as /opt/jon/jon-server-3.0.0.GA1.

Copy over any changes in your original rhq-server.properties file to the new file in serverRoot/jon-server-3.0.0.GA1/bin. Changes to this file include things like setting up SSL and enabling SMTP for email notifications.

NOTE

In JBoss ON 2.3.1 and older versions, the password to access the database is stored in plaintext. In JBoss ON 3.0, this password is hashed for security.

TIP

If you don't want to edit the rhq-server.properties file manually, you can change the server settings to the proper configuration in the Advanced Settings form during the server setup.

Windows only. If the server was installed as a Windows service, then uninstall the Windows service for the original server:

cd c:\old-serverRoot\bin
./rhq-server.bat remove

Then install the new server as a Windows service:

cd c:\new-serverRoot\bin
./rhq-server.bat install

Additional plug-in packs for specific needs (such as supporting management tasks for EWS, EAP, and SOA-P) are available to be installed separate from the core JBoss ON agent packages. Each plug-in pack as at least one (and sometimes more than one) agent plug-in. Each zip file for the plug-ins has a README.txt file with specific setup instructions.

If there are multiple JBoss ON servers in a high availability setup, the agent plug-in pack only has to be installed once. The other servers will pick up the plug-ins as part of the high availability polls.

Start the JBoss ON server. For example:

serverRoot/jon-server-3.0.0.GA1/bin/rhq-server.sh start

Back up your server database before going through the setup wizard. In case there is a problem with the upgrade process, the backup allows you to restore to its previous state.

Do not change any of the settings for the server, especially identifying information such as the Server Name field. This can cause errors during the upgrade process.

When the database connection information is entered, the JBoss ON installer detects the existing JBoss ON database. This introduces a new field to the installer, prompting you for what to do with the existing database.

Choose the default, Keep (maintain existing data). Do not choose Overwrite (lose existing data), or the installer will delete all of your JBoss ON data, including your inventory, monitoring history, alerts, and metrics.

The Registered Servers lists every server in the server cloud. For upgrades and re-installs, this gives you the option to keep the existing server configuration (such as ports and notification settings) or to set new values. To preserve the settings, select the server from the registered servers list; otherwise, select New Server.

Start any JBoss ON agents that were stopped for the upgrade process.

If the older JBoss ON server was added to the JBoss ON inventory, then remove it. The old JBoss ON server must be removed from the inventory because it is no longer a usable resource.

Optional. Add the new JBoss ON server as a resource in the inventory.

Once the server is upgraded, one visible change is that the upgraded GUI uses new icons and style sheets.

Figure 7.1. Updated UI

NOTE

Because there are CSS changes in JBoss ON 3.0, the GUI has a different layout and defined classes in JBoss ON 3.0 than in previous releases. After an upgrade, if the GUI is already open or if the style data are cached, then the JBoss ON UI will be poorly formatted. Manually reload the CSS and image files using Ctrl+F5.