Upgrading OpsWise Automation Center

From OpsWise Documentation Wiki

Contents 1 Introduction 2 Back Up Your Database 3 Run an OpsWise Export 4 Stop Tomcat and Remove the Opswise Core 5 Stop Outboard (Agent) Components 6 Prepare Your Database 7 Download the New OpsWise Release 8 Install and Verify the OpsWise Core 9 Run Opswise Import 10 Check Your Data 11 Install OpsWise Outboard 12 Start / Stop OpsWise Components 13 Verify the Outboard Installation

Introduction

These instructions describe how to upgrade OpsWise Automation Center from one version to another. The current upgrade is from OpsWise Summer 2009 to OpsWise Winter 2010.

For each upgrade, you must install the new versions of the core, transporter and hub components at the same time. OpsWise agents do not need to be upgraded at the same time and older versions will still operate with updated core components. However, we recommend that you also upgrade the agents as soon as possible to avoid letting the software get too out of date.

For a system overview, click here.

Back Up Your Database

Important • Before upgrading your system, back up your database. The database backup is a fail-safe measure; you will be using the OpsWise export/import utility described below to migrate your data.

Run an OpsWise Export

Before running the export:

1. Log in with ops.admin or a user with administrator privileges.
2. Disable all active triggers to make sure no tasks are being processed.
3. Check the Activity screen to verify that there are no active task instances. If there are, wait until they complete before you start the export process. If necessary, you can force finish tasks.

Follow these steps to run a bulk export of your data:

1. From the navigation pane, select Configuration > Maintenance Scripts.



2. Locate and run the script

opswise_bulk_export.js 

3. The utility prompts for a confirmation. Click Yes.
4. As your data is exported, the output from the script is written to the screen, as shown.



5. Look over the output for any error messages. If you see any, copy the output to a file and send it to helpdesk@opswise.com.
6. Zip or tar the contents of

$CATALINA_HOME/webapps/opswise/WEB-INF/plugins/com.opswise/backup/unload/ 

7. Copy the zip/tar file to a safe place for use after the upgrade process.

Stop Tomcat and Remove the Opswise Core

Important • Make sure you have copied to a safe location all the exported files from the previous step before continuing with this step. In this step you will stop and remove the core system (which does not include the agent components).

1. Stop the Tomcat process, as follows:
   
• In Windows, you should use the services application to stop Tomcat. You may also issue the stop command on a command line:

net stop <name of Tomcat service>

• In Unix, stop the daemon using the script found in the /etc/init.d directory for Tomcat.

service <name of Tomcat service> stop

• In either system, you can stop the service using the $TOMCAT_HOME/bin/shutdown.bat or $TOMCAT_HOME/bin/shutdown.sh scripts:

Windows	Linux/Unix
> cd $CATALINA_HOME\bin > shutdown	> cd $CATALINA_HOME/bin > ./shutdown



2. Delete the directory:

$CATALINA_HOME/webapps/opswise/ 

3. Delete the file:

$CATALINA_HOME/webapps/opswise.war

Stop Outboard (Agent) Components

For the outboard components (the agent and associated processes), you do not need to remove the old versions. This process upgrades the existing software.

Note - You can run downlevel versions of OpsWise agents with new versions of the core, hub, and transporter processes.

Follow these instructions to stop the processes.

1. Stop the Hub process.
   

   Windows	Linux/Unix
   From the services window, stop the following process: Hub Guardian	Login as root and type the following command: service opsmsghub stop

   
   
2. Stop the Transporter process.

   Windows	Linux/Unix
   From the services window, stop the following process: Transport Guardian	Login as root and type the following command: service opstransport stop

   
   
3. Stop all Agent processes (required only for agents you are updating to the new release).

   Windows	Linux/Unix	z/OS
   From the services window, stop the following process: Agent Guardian	Login as root and type the following command: service opsagent stop	Issue the MVS stop command: P OPSPROC

Prepare Your Database

Delete or drop your database using the appropriate database admin tool.

Important • Before dropping your existing database, make sure you have created a backup as described at the beginning of the procedure.

Download the New OpsWise Release

Click here for instructions about downloading the latest OpsWise software.

Install and Verify the OpsWise Core

The OpsWise core processor is a Java application running within Apache Tomcat. For this reason, the core software and installation procedure is basically the same for all platforms.

Run Opswise Import

In this step, you are importing your data that you exported earlier using the OpsWise bulk export.

1. Unzip/untar the backup file that you created earlier using the OpsWise export.
2. Copy the XML files to the following directory:

$CATALINA_HOME/webapps/opswise/WEB-INF/plugins/com.opswise/backup/unload

3. From the navigation pane, select Configuration > Maintenance Scripts.
4. Locate and run the script

opswise_bulk_import.js 

5. The utility prompts for a confirmation. Click Yes.
6. As your data is imported, the output from the script is written to the screen. Look over the output for any error messages. If you see any, copy the output to a file and send it to helpdesk@opswise.com.
7. Run the following script:

clear_cache.js

Check Your Data

At this point, your previous definitions, users and passwords have all been restored. Log out and in again, and review your records to make sure all your previous definitions, users and passwords have been restored successfully.

Install OpsWise Outboard

If you are upgrading to a new release, you must reinstall these components. If you are installing a maintenance release, you only need to do an upgrade. Your OpsWise representative will indicate what type of release is being provided. Click the link below for the platform you want to install:

• Windows
• Linux (Suse, Redhat, CentOS, Fedora, Ubuntu)
• Unix HPUX
• MAC OSX
• Unix AIX
• Solaris Intel
• Solaris Sparc
• z/OS (agent only)

Start / Stop OpsWise Components

• Windows
• Linux (Suse, Redhat, CentOS, Fedora, Ubuntu)
• MAC OSX
• Unix HPUX
• Unix AIX
• Solaris Intel
• Solaris Sparc
• z/OS (Agent Only)

Verify the Outboard Installation

As a final step, you should verify that your outboard components are installed, running, and communicating with the OpsWise core server. Click here for instructions.