Question & Answer
Question
This guide contains step-by-step instructions and information to migrate your IBM Content Manager OnDemand server to V10.5.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 V10.1.0.X |
 |
Upgrading from V9.5.0.X |
 |
How to uninstall Content Manager OnDemand server V10.5 |
 |
Miscellaneous |
Prerequisites
Requirements for Content Manager OnDemand for Multiplatforms V10.5.0
This document describes the minimum system requirements for Content Manager OnDemand for Multiplatforms V10.5. Further information can be found in the product README file.
- Perform the Pre-upgrade Tasks in the general server upgrade guide. Ensure you have a current database backup.
Note: The Content Manager OnDemand server installation now also contains and installs the Content Manager OnDemand Web Enablement Kit (ODWEK).
Note: The Content Manager OnDemand server does not support OnDemand Clients (such as the OnDemand Windows Client, ODWEK, CICS, etc.) earlier than V9.0.
Note: If you are using an ACIF user exit, it must be recompiled after you upgrade to V10.5.0 to use the current version of ICU, which is V58.1, and new Content Manager OnDemand server installation directory. - Download the required Content Manager OnDemand server software.
- Download the V10.5.0.0 full installation package from IBM Passport Advantage.
- Download the latest V10.5.0.X fix pack (if one exists) from Fix Central. For example, V10.5.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 base installation image and fix pack are self-extracting executable installers. For example, to install the base package by using the command line on AIX, run odaix.bin -i console. On Windows, using the account that the Content Manager OnDemand server runs under, run odwin.exe.
- Run the V10.5.0.0 installer to install the base package.
- Run the V10.5.0.1 installer to install the latest fix pack (if one exists).
- On Linux and Unix platforms, update the IBM Global Security Kit Crypt and IBM Global Security Kit SSL software for Content Manager OnDemand V10.5. A newer version is included and required by Content Manager OnDemand V10.5. Refer to the product README file for platform-specific installation steps.
- Upgrade your Content Manager OnDemand instance. By default, V10.5 will be installed to a different directory than V10.1 or V9.5.
- 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.5 directories.
- On Windows, run the V10.5 OnDemand Configurator to upgrade the instance.
- Update the Content Manager OnDemand indexes for use with V10.5 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.
- Optional. Drop the Content Manager OnDemand system table indexes:
arsdb -I instance_name -efv
- Optional, or mandatory if you dropped them in the previous step. Re-create 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 you are 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 step is performed, older clients (earlier than 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:
- Optional. 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, V9.5, or V10.1 software. By default, Content Manager OnDemand V10.5 will be installed to a different directory than previous versions 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 installation now also contains and installs the Content Manager OnDemand Web Enablement Kit (ODWEK).
Note: The Content Manager OnDemand server does not support OnDemand Clients (such as the OnDemand Windows Client, ODWEK, CICS, etc.) earlier than V9.0.
Note: If you are using an ACIF user exit, it must be recompiled after you upgrade to V10.5.0 to use the current version of ICU, which is V58.1, and new Content Manager OnDemand server installation directory. - Download the required Content Manager OnDemand server software.
- Download the V10.5.0.0 full installation package from IBM Passport Advantage.
- Download the latest V10.5.0.X fix pack (if one exists) from Fix Central. For example, V10.5.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 base installation image and fix pack are self-extracting executable installers. For example, to install the base package by using the command line on AIX, run odaix.bin -i console. On Windows, using the account that the Content Manager OnDemand server runs under, run odwin.exe.
- Run the V10.5.0.0 installer to install the base package.
- Run the V10.5.0.1 installer to install the latest fix pack (if one exists).
- On Linux and Unix platforms, update the IBM Global Security Kit Crypt and IBM Global Security Kit SSL software for Content Manager OnDemand V10.5. A newer version is included and required by Content Manager OnDemand V10.5. Refer to the product README file for platform-specific installation steps.
- Upgrade your Content Manager OnDemand instance. By default, V10.5 will be installed to a different directory than V10.1 or V9.5.
- 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.5 directories.
- On Windows, run the V10.5 OnDemand Configurator to upgrade the instance.
- Alter the Content Manager OnDemand database for use with V10.5 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. Re-create 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 you are 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 step is performed, older clients (earlier than 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, V9.5, or V10.1 software. By default, Content Manager OnDemand V10.5 will be installed to a different directory than previous versions and does not automatically uninstall them.
To uninstall Content Manager OnDemand server V10.5.0:
- On Linux: /opt/ibm/ondemand/V10.5/_uninst105/uninstallod -i console
- On Windows: Use Programs and Features in the Control Panel
- All other platforms: /opt/IBM/ondemand/V10.5/_uninst105/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.5.0, the full installation package must be downloaded from IBM Passport Advantage.
Related Information
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"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.5.0","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
24 January 2023
UID
ibm11284370