Before upgrading any system, you must perform the following steps:
Before you upgrade your system, 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:
See the System Administration Guide for more information about how to stop a running system gracefully.
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 2.
To back up the system, do the following:
repos_copy -sWICSEX -oRepositoryExpress.txt -uadmin -pnull
ProductDir/mqseries/crossworlds_mq.tst
IBM recommends taking a system backup of the entire InterChange Server Express product directory.
Table 2 summarizes how to back up the different components.
Table 2. 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. |
| ICS Express configuration file (InterchangeSystem.cfg) | Include in your system backup the ICS Express configuration file, which resides in the ProductDir directory. |
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:
ProductDir/logs |
After backups are complete, you can shut down the system as follows:
For more information on system shutdown, see the System Administration Guide.