IBM Support

Important installation steps for the Content Manager OnDemand Full Text Search feature

News


Abstract

The Content Manager OnDemand Full Text Search feature installer (in versions 9.5, 10.1, and 10.5) is an install wrapper of the IBM ECM TextSearch installer. When installing the Content Manager OnDemand Full Text Search feature, both installers will default to a directory containing the version number. If you already have a previous version of the Content Manager OnDemand Full Text Search feature, the new version’s installation will become a new install and no data will be migrated from the previous version. Do not uninstall the previous version or begin indexing to the new version before taking the steps described later in this document.

Content

The default install location for the Content Manager OnDemand Full Text Search feature contains a directory name that includes the version number. During an upgrade to a new version, no migration of data (collection indexes and configuration parameters) is done.
For example, on AIX the default V10.1 and V10.5 locations are listed below:
/opt/IBM/odfts/V10.1
/opt/IBM/odfts/V10.5
Before uninstalling the previous version or running the new version, you must reconcile the data (collection indexes and configuration parameters) as described in the following steps. 
Reconcile collection indexes
Before you can search your full text indexes or continue with the indexing of documents with the new version, you must specify the location of the collection indexes in the new version. If you haven’t already, it is recommended you move this information out from under a version directory. For more information on how to do this see Changing the location of the Content Manager OnDemand Full Text Search (FTS) indexing information at www.ibm.com/support/pages/node/6442931.
Reconcile configuration parameters
If you have modified any other configuration parameters for the previous version, you must migrate those parameter settings to the new version. While most parameters are never changed, you might have updated parameters such as the maximum document size or the maximum extracted document size.
To list your current parameters for the previous IBM ECM TextSearch version, issue the command shown below from the bin directory under the previous install directory.
For example, from the /opt/IBM/odfts/V10.1/bin location, issue the following command:
configTool.sh list –system -showAdvanced
You should then issue the same command for the new IBM ECM TextSearch version and compare the results.
To make these parameter changes to the new install, issue the following command from the /opt/IBM/odfts/V10.5/bin directory:
configTool.sh set –system -<parameter name> <value>
For example, to change the maxDocumentSizeBytes parameter you would issue the following command:
configTool.sh set –system –maxDocumentSizeBytes 1200000000
It is important to change only those settings in the new version that you know you had modified in the previous version.

[{"Line of Business":{"code":"LOB45","label":"Automation"},"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"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.1.0;10.5.0;9.5.0","Type":"MASTER"},{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSQHWE","label":"Content Manager OnDemand for z\/OS"},"ARM Category":[{"code":"a8m0z0000001gP1AAI","label":"technote"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.1.0;10.5.0;9.5.0"},{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSB2EG","label":"Content Manager OnDemand for i"},"ARM Category":[{"code":"a8m0z0000001gP1AAI","label":"technote"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
19 May 2022

UID

ibm16588065