Preparing the existing system

The system upgrade involves the following steps:

Putting the system in a quiescent state

Before you upgrade your system from WebSphere Business Integration Server Express 4.4 to Express Plus 4.4 on OS/400 and i5/OS, you must make sure it is in a quiescent state. This means that all in-progress events are completed and all in-doubt transactions are resolved before backing up the environment and performing the upgrade procedure.

The following steps describe how to put the system in a quiescent state:

  1. Resubmit failed events or discard the events (this step is optional).
  2. Stop all connectors from polling the event tables by setting the connector PollFrequency property to No and restarting the connector.
  3. Let all events run through the system, including all in-process events. All in-doubt transactions must be resolved.
  4. Clear the queues by removing any old events from the queues.
    Note:
    Perform step 4 only if you are not processing your failed events and choose to resubmit the events from the application. Otherwise, the queues should be empty, but double-check to be sure.

See the System Administration Guide for more information about how to stop a running system gracefully.

Backing up the system

If you are upgrading from WebSphere Business Integration Server Express v4.4 to Express Plus v4.4 on OS/400 and i5/OS, backing up the system allows you to recover any files that might be overwritten inadvertently during the installation of the new version. Before performing the upgrade procedure, back up both static data and dynamic data (changeable data that you back up on a regular basis, regardless of upgrades). For examples of static and dynamic data, see Table 3..

To back up the system, do the following:

Table 3 summarizes how to back up the different components.

Table 3. Backup methods for data
Type of data Backup method
Static data
Repository Use the repos_copy utility to save some or all of the customized system components. For more information, see the description of how to back up components in the System Administration Guide.
Custom map Java class files (.class) To include these files in your system backup, make sure the following directory is in your system backup: ProductDir\DLMs
Custom connectors Include the following directory in your system backup: ProductDir\connectors\connector_name, where connector_name is the name of the custom connector.
Customized startup scripts If you have customized any startup scripts, make sure that they are included in your system backup.
InterChange Server Express configuration file (InterchangeSystem.cfg) Include in your system backup the InterChange Server Express configuration file that resides in the /QIBM/UserData/WBIServer44/servername directory, where servername is the InterChange Server Express name. QWBIDFT44 is the default on OS/400 and i5/OS.
Dynamic data
Cross-reference, failed events, and relationship tables Use the database backup utility for the database. For more information, see the description of how to back up system components in the System Administration Guide.
Connector event archive tables Use the database backup utility for the database that contains these tables.
Log files Include the following directory in your system backup:/QIBM/UserData/WBIServer44/servername/DLMs, where servername is the InterChange Server Express name. QWBIDFT44 is the default on OS/400 and i5/OS.

Shutting down the system

After backups are complete and you are upgrading from WebSphere Business Integration Server Express v4.4 to Express Plus v4.4, you will need to shut down the system as follows:

  1. Shut down InterChange Server Express and its related components.
  2. End the QWBISVR44 subsystem using the following CL Command, ENDSBS SBS(QWBISVR44) OPTION(*CNTRLD).
    Note:
    Alternatively, issue this command from a QSH shell or through CL to gracefully end the WebSphere Business Integration express server instance(s) in preparation for shutdown. /QIBM/ProdData/WBIServer44/bin/stop_server_gracefully.sh serverName. The serverName matches the name of the server instance.
  3. End the MQ Queue Manager using the following CL command, WRKMQM. Find the queue name and then select the option to end the queue manager.

    The queueName is serverName.QUEUE.MANAGER where serverName is the Interchange Server Express instance name. The default server is named QWBIDFT44 and therefore, the queueName is QWBIDFT44.QUEUE.MANAGER. The serverName is provided entirely in uppercase in the queueName along with the rest of the name. This is mandatory.

    Note:
    It is not mandatory for the queue manager name to be serverName.QUEUE.MANAGER. It can be a custom queue name that you specify.

For more information on system shutdown, see the System Administration Guide.

Copyright IBM Corp. 2004, 2005