Question & Answer
Question
This guide contains step by step instructions and information to migrate your IBM Content Manager OnDemand server to V10.1.0. Follow the instructions for the version of Content Manager OnDemand server you currently have installed. To ensure you have the latest APAR fixes, stay current with maintenance by applying the latest Content Manager OnDemand server fix pack.
Answer
 |
Prerequisites |
 |
Upgrading from V9.5.0.X |
 |
Upgrading from V9.0.0.X |
 |
How to Uninstall Content Manager OnDemand Server V10.1 |
 |
Miscellaneous |
Prerequisites
Requirements for Content Manager OnDemand for Multiplatforms V10.1.0
This document describes the minimum system requirements for Content Manager OnDemand for Multiplatforms V10.1. Further information can be found in the product README.
Upgrading from V9.0.0.X
- Perform the Pre-upgrade Tasks in the general server upgrade guide. Ensure you have a current database backup.
Note: The Content Manager OnDemand server install now also contains and installs the Content Manager OnDemand Web Enablement Kit (ODWEK).
Note: The Content Manager OnDemand server does not support OnDemand Clients (e.g. Windows Client, ODWEK, CICS, etc.) prior to V8.5.
Note: If using an ACIF user exit, it must be recompiled after upgrading to V10.1 to utilize the current version of ICU, 58.2, and new Content Manager OnDemand server installation directory. - Download the required target Content Manager OnDemand server software.
- Download the V10.1.0.0 full install package from IBM Passport Advantage.
- Download your target V10.1.0.X fix pack. For example, V10.1.0.1.
- Stop your Content Manager OnDemand library and object server.
- Upgrade the Content Manager OnDemand server software on your library and object server. The fix pack is an executable installer. For example, to install the fix pack via command line on Linux® and Unix, run odaix.bin -i console. On Unix and Linux, this step must be performed as root. On Windows, use the account Content Manager OnDemand server runs under.
- Run the V10.1.0.0 installer.
- Run your desired target V10.1.0.X fix pack installer.
- On Linux and Unix platforms, update the IBM Global Security Kit Crypt and IBM Global Security Kit SSL software for Content Manager OnDemand V10.1. A newer version is included and required by Content Manager OnDemand V10.1. Refer to the product README for platform specific installation steps.
- Upgrade your Content Manager OnDemand instance. By default, V10.1 will be installed to a different directory than V9.5 or V9.0.
- On Unix, restore your Content Manager OnDemand server configuration files (ars.ini, ars.cfg, ars.cache, ars.dbfs, arsload.cfg) and re-compiled custom user exits to your Content Manager OnDemand V10.1 directories.
- On Windows, run the V10.1 OnDemand Configurator to upgrade the instance.
- Alter the Content Manager OnDemand database for use with V10.1.0 by running the following commands on your library server as the Content Manager OnDemand instance owner specified in the OnDemand Configurator on Windows or the ars.ini on all other platforms.
- Mandatory. Drop the Content Manager OnDemand system table indexes:
arsdb -I instance_name -efv
- Mandatory. Alter the Content Manager OnDemand database:
arsdb -I instance_name -uv
- Mandatory. Recreate the Content Manager OnDemand system table indexes:
arsdb -I instance_name -rfv
- Mandatory. Reorg and update statistics on all the Content Manager OnDemand system tables:
arsdb -I instance_name -mv
If using Oracle®, run the following command instead:
arsdb -I instance_name -sv
- Optional, but recommended. Update the System Log and System Load application groups and folders to support new style dates.
Important: Once this is performed, older clients (prior to V9.0.0) will not be able to query the System Log or System Load folders.
Note: When the System Log and System Load application groups are updated, the current table will be closed and a new one will be opened once a new message or load is generated.
Note: Running these update commands will remove any user/group specific folder fields that have been defined for the System Log and System Load Folders. Customers will have to add the user/group specific folder fields again after the update is done.
- Update the System Log application group and folder:
arssyscr -I instance_name -l -u
- Update the System Load application group and folder:
arssyscr -I instance_name -a -u
- Mandatory. Drop the Content Manager OnDemand system table indexes:
- Verify the appropriate ulimit settings are in place for the Content Manager OnDemand instance owner. Since the Content Manager OnDemand server is a 64-bit process, the soft and hard limits for the user running the server process should be set to unlimited for data (-d), memory (-m), and stack (-s).
- Start your Content Manager OnDemand library and object server.
- Optional. Uninstall your Content Manager OnDemand V9.0 or V9.5 software. By default, Content Manager OnDemand V10.1 will be installed to a different directory than previous versoins and does not automatically uninstall them.
Upgrading from V9.5.0.X
- Perform the Pre-upgrade Tasks in the general server upgrade guide. Ensure you have a current database backup.
Note: The Content Manager OnDemand server install now also contains and installs the Content Manager OnDemand Web Enablement Kit (ODWEK).
Note: The Content Manager OnDemand server does not support OnDemand Clients (e.g. Windows Client, ODWEK, CICS, etc.) prior to V8.5.
Note: If using an ACIF user exit, it must be recompiled after upgrading to V10.1.0 to utilize the current version of ICU, 58.1, and new Content Manager OnDemand server installation directory. - Download the required Content Manager OnDemand server software.
- Download the V10.1.0.0 full install package from IBM Passport Advantage.
- Download your target V10.1.0.X fix pack. For example, V10.1.0.1.
- If you have Content Manager OnDemand Report Distribution installed:
- Download the V10.1.0.0 full install package.
- Download the V10.1.0.1 fix pack.
- Stop your Content Manager OnDemand library and object server.
- Upgrade the Content Manager OnDemand server software on your library and object server. The fix pack is an executable installer. For example, to install the fix pack via command line on Linux and Unix, run odaix.bin -i console. On Unix and Linux, this step must be performed as root. On Windows, use the account Content Manager OnDemand server runs under.
- Run the V10.1.0.0 installer.
- Run the V10.1.0.1 installer.
- On Linux and Unix platforms, update the IBM Global Security Kit Crypt and IBM Global Security Kit SSL software for Content Manager OnDemand V10.1. A newer version is included and required by Content Manager OnDemand V10.1. Refer to the product README for platform specific installation steps.
- Upgrade your Content Manager OnDemand instance. By default, V10.1 will be installed to a different directory than V9.5 or V9.0.
- On Unix, restore your Content Manager OnDemand server configuration files (ars.ini, ars.cfg, ars.cache, ars.dbfs, arsload.cfg) and re-compiled custom user exits to your Content Manager OnDemand V10.1 directories.
- On Windows, run the V10.1 OnDemand Configurator to upgrade the instance.
- Alter the Content Manager OnDemand database for use with V10.1 by running the following commands on your library server as the Content Manager OnDemand instance owner specified in the OnDemand Configurator on Windows or the ars.ini on all other platforms.
- Mandatory. Drop the Content Manager OnDemand system table indexes:
arsdb -I instance_name -efv
- Mandatory. Alter the Content Manager OnDemand database:
arsdb -I instance_name -uv
- Mandatory. Recreate the Content Manager OnDemand system table indexes:
arsdb -I instance_name -rfv
- Mandatory. Reorg and update statistics on all the Content Manager OnDemand system tables:
arsdb -I instance_name -mv
If using Oracle®, run the following command instead:
arsdb -I instance_name -sv
- Optional, but recommended. Update the System Log and System Load application groups and folders to support new style dates.
Important: Once this is performed, older clients (prior to V9.0.0) will not be able to query the System Log or System Load folders.
Note: When the System Log and System Load application groups are updated, the current table will be closed and a new one will be opened once a new message or load is generated.
Note: Running these update commands will remove any user/group specific folder fields that have been defined for the System Log and System Load Folders. Customers will have to add the user/group specific folder fields again after the update is done.- Update the System Log application group and folder:
arssyscr -I instance_name -l -u
- Update the System Load application group and folder:
arssyscr -I instance_name -a -u
- Update the System Log application group and folder:
- Mandatory. Drop the Content Manager OnDemand system table indexes:
- Verify the appropriate ulimit settings are in place for the Content Manager OnDemand instance owner. Since the Content Manager OnDemand server is a 64-bit process, the soft and hard limits for the user running the server process should be set to unlimited for data (-d), memory (-m), and stack (-s).
- Start your Content Manager OnDemand library and object server.
- Optional. Uninstall your Content Manager OnDemand V9.0 or V9.5 software. By default, Content Manager OnDemand V10.1 will be installed to a different directory than previous versoins and does not automatically uninstall them.
How to Uninstall Content Manager OnDemand Server V10.1.0
To uninstall Content Manager OnDemand server V10.1.0:
- On Linux: /opt/ibm/ondemand/V10.1/_uninst101/uninstallod -i console
- On Windows: Use Programs and Features in the Control Panel
- All other platforms: /opt/IBM/ondemand/V10.1/_uninst101/uninstallod -i console
To uninstall Global Security Kit Crypt and Global Security Kit SSL, refer to the Content Manager OnDemand README file.
Miscellaneous
- To upgrade to Content Manager OnDemand server V10.1.0, the full install package must be downloaded from IBM Passport Advantage.
Related Information
[{"Type":"SW","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEPCD","label":"Content Manager OnDemand for Multiplatforms"},"ARM Category":[{"code":"a8m0z0000001gP1AAI","label":"technote"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.1.0"}]
Was this topic helpful?
Document Information
Modified date:
23 April 2021
UID
swg21446135