############################################################################### # IBM Content Manager OnDemand for Multiplatforms # # Server for # # AIX, HP-UX, Linux, Sun Solaris, Windows, Linux on System z # # README # # Release 8.4.1.0 # # Nov. 14, 2008 # # # # 5724-J33 (C) COPYRIGHT IBM CORPORATION 2008 # # All Rights Reserved # # Licensed Materials - Property of IBM # # US Government Users Restricted Rights - Use, duplication or # # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # ############################################################################### Welcome to the Installation Notes for IBM Content Manager OnDemand Server. For the latest information about OnDemand, see the OnDemand Web site at: http://www.software.ibm.com/data/ondemand =============================================================================== Contents ------------------------------------------------------------------------------- 1. Installation Notes 1.1. Upgrade Steps 1.2. DB2 Licensing 2. Server Change History 2.1. Notes 2.1.1. Enhancements 2.1.2. Documntation Changes 2.1.3. Other Notes 2.1.4. APARs 2.1.8.4.1.0. Release (8.4.1.0) 2.2. AIX Server 2.2.8.4.1.0 Release (8.4.1.0) 2.3. HP-UX Server 2.3.8.4.1.0 Release (8.4.1.0) 2.4. Sun Solaris Server 2.4.8.4.1.0 Release (8.4.1.0) 2.5. Windows Server 2.5.8.4.1.0 Release (8.4.1.0) 2.6. Linux Server 2.6.8.4.1.0 Release (8.4.1.0) 2.7. Linux on System z Server 2.7.8.4.1.0 Release (8.4.1.0) 3. Testing Environment 4. Reference -----------------end of Contents----------------------------------------------- 1. Installation Notes ------------------------------------------------------------------------------- 1.1. Upgrade Steps Note: The Content Manager OnDemand Server 8.4.1 no longer supports Clients prior to 7.1.2.0. This includes, but is not limited to, the Windows Client, ODWEK CGI/Servlet/Java APIs, CICS, and II4C(eClient). Please ensure the clients used to access your Content Manager OnDemand server are at currently supported levels. Note: When upgrading the Content Manager OnDemand Server to the current version, you need to also upgrade the Windows Administrator Client and Web Administration Client to the same level as the Server. Before upgrading to OnDemand 8.4.1.0, you should backup your database and make sure you have a copy of the currently installed version of OnDemand. Note: Install the APAR PK78168 hotfix for the ARSTBLSP command after upgrading the Content Manager OnDemand for Multiplatforms Software. You can get hotfix from ftp://service.software.ibm.com/software/ondemand/fixes/v841/8.4.1.0/ Follow the instructions in the PK78168.txt README file for installing the hotfix. To upgrade the OnDemand Database for use with OnDemand 8.4.1, Log in as the OnDemand instance owner and run the following commands after installing 8.4.1. This is mandatory. Stop the OnDemand server arssockd stop [] Install OnDemand 8.4.1.0 See the section on your specific platform Update the database using the following command: arsdb [-I ] -uv If you have installed Report Distribution, also run this command: arsdb [-I ] -uRv Then perform database maintenance arsdb [-I ] -mv for Oracle arsdb [-I ] -sv Note: If you have installed Report Distribution add the -R parameter to the previous command Start the OnDemand Server arssockd [] Where OD_INSTANCE is the OnDemand Instance Name. If this is not specified, the default is ARCHIVE. To update the System Log Application Group for the longer 2000 character Message Text, run the following commands. This is not mandatory, but not doing this will cause SQL truncation warnings to be issued for some messages being stored in the System Log. So, it is recommended you update the System Log Application Group. Stop the OnDemand server arssockd stop [] Update the System Log Application Group: arssyscr [-I ] -l Close the current System Log table: arstblsp [-I ] -a 1 -g "System Log" Start the OnDemand Server arssockd [] Creating the new System Load Application Group is not mandatory. Creating this Application Group will impact loading performance because a new row is inserted for every load. To create the System Load Application Group, you can run the following commands: Stop the OnDemand server arssockd stop [] Create the System Load Application Group: arssyscr [-I ] -a Start the OnDemand Server arssockd [] 1.2. DB2 Licensing OnDemand now ships the appropriate DB2 V9.1 Enterprise Restricted Use License file for use with OnDemand Multiplatforms. If you have installed DB2 V9.5 Enterprise or Workgroup Edition, you do not need to register using this license file. DB2 V9.5 Enterprise and Workgroup ship with their own restricted use license. Customer should Register the DB2 product license key using the db2licm command. The DB2(R) product uses the license key information contained in the nodelock file. The nodelock file is created or updated by running the db2licm command and specifying the license file for the DB2 product. Creating or updating the nodelock file is referred to as registering the DB2 product license key. You must register the DB2 V9.1 product license key by running the db2licm command on each computer where DB2 is installed. If you want the product or feature license key added automatically during the installation of DB2, you need to copy the license key provided with OnDemand for Multi Platforms to the /db2/license directory of the DB2 installation image before launching the DB2 Setup wizard. The procedure to manually register your DB2 product license key using root or Administrator authority: 1. Log in as a user with root authority. 2. Register the DB2 product license key with the appropriate command: For AIX and other UNIX-based operating systems: /opt/IBM/db2/V9.1/adm/db2licm -a filename For Windows(R) operating systems: C:\Program Files\IBM\SQLLIB\Bin\db2licm.exe -a filename where filename is the full pathname and filename for the license file that corresponds to the product you are bundling. For Content Manager OnDemand for MultiPlatforms, this file can be found in the following directories: For AIX: /usr/lpp/ars/config/db2ese_o.lic For other UNIX-based operating systems: /opt/ondemand/config/db2ese_o.lic For Windows(R) operating systems: C:\Program Files\IBM\OnDemand for WinNT\Config\db2ese_o.lic After running the db2licm command, the DB2 product license key information is contained in the nodelock file in the following directories: For AIX: /var/ifor. For other UNIX-based operating systems: /var/lum. For Windows(R) operating systems: C:\Program Files\IBM\SQLLIB\license. To manually register your DB2 product license key as the instance owner: 1. Create the instance environment and become the instance owner. 2. Register your DB2 product license with the appropriate command: For AIX and other UNIX-based operating systems: /opt/IBM/db2/V9.1/adm/db2licm -a filename For Windows(R) operating systems: C:\Program Files\IBM\SQLLIB\Bin\db2licm.exe -a filename Where db2instance_path is where the DB2 instance was created and filename is the full pathname and filename for the license file that corresponds to the product you are bundling. More information can be found in the DB2 InfoCenter at http://publib.boulder.ibm.com/infocenter/db2luw/v9/index.jsp search for "Registering the DB2 product license key using the db2licm command" -------------end of Installation Notes----------------------------------------- 2. Server Change History ------------------------------------------------------------------------------- 2.1. Notes ------------------------------------------------------------------------------- 2.1.1. Enhancements Enhanced retention management capabilities Content Manager OnDemand now provides the ability to hold or suspend the retention for documents so that the expiration for those documents can be prevented until the hold is released. Integration with FileNet(R) P8 platform You can now send Content Manager OnDemand metadata to FileNet and take advantage of FileNet's Business Process Management (BPM) and FileNet's Records Manager (RM) capabilities. Optimizing PDF file storage The Content Manager OnDemand PDF indexer now supports resource grouping and removing unused resources. After you enable resource grouping, common resources across statements in a single report are grouped and stored as a single instance, and unused resources from a report can be removed before indexing. These features can tremendously save disk space and reduce cost. CITRIX support Content Manager OnDemand client is now supported in the Citrix environment. Additional platform support for the Content Manager OnDemand Web Administrator Content Manager OnDemand Web administrator now supports Linux(R) on Intel(R) based machines. Support for additional LDAP servers Novell eDirectory Version 8.8 SP2 Sun Java(TM) System Directory Server Enterprise Edition 6.3 Updated ACIF to PK72203 ACIF Unicode support The ACIF indexer now supports indexing and loading of Unicode data in code pages 1200, 1208, 13488, and 17584. ACIF indexer enhancement The ACIF indexer now allows a column range to be specified for the trigger. ARSSUPPORT utility You can use ARSSUPPORT, a Java based tool to gather diagnostic information such as log entries. This tool is especially helpful when you need to report problems to IBM Software Support. For more information, see "ARSSUPPORT utility" in the Administration Guide. The arssockd verbose command You can now issue the "arssockd verbose " command to send configuration information and status messages to stdout during the OnDemand Server startup. This is for UNIX only. 2.1.2. Documentation changes Trace Parameters for several commands have been updated to make them consistent across all platforms. The old parameters were: -F Trace output format (Default: TEXT) C or CSV T or TEXT X or XML -L Trace level number - add together (Default: 3) 1: Errors 2: Warnings 4: Info 8: Flow -T Fully-qualified trace file name The new parameters are: -1 Fully-qualified trace file name -2 Trace level number The values are additive. (Default: 3) 1: Errors 2: Warnings 4: Info 8: Flow -3 Trace output format (Default: TEXT) C or CSV T or TEXT X or XML The Application post processor input file now has a column header. This new header begins with a "<" and ends with the ">" characters. 2.1.3. Other Notes OnDemand has been tested with Oracle 11g. OnDemand has been tested with HP-UX 11i v3. 2.1.4. APARs 2.1.8.4.1.0. Release (8.4.1.0) PK62915 - PDD image search issues: Server failed during search PK66329 - Search fails in (AIX) ARSDD CD-ROM image - Rebuilt the Ctree libraries with the UNIFRMAT option PK62114 - ARSLOAD does not del .ARD file in Win NTFS file systems - Added a loop to retry the deletion PK65532 - ARSLOAD with -h -b -B parms will cause arsload to crash - Corrected a memory overrun when using the -h hostname PK65917 - PDF IDX ignores '-' causes next word to be concat - Set parameter for the PDF Libs so that they deal correctly with hyphens PK66730 - OD does not contact Active Dir Server w/LDAP Auth on Win - Changed the API being used to do the initial binds PK67890 - OD crashes when deleting AG w/invalid TSM Storage Node - Corrected a memory issue when TSM not initialized because of incorrect information PK69152 - LDAP doesn't check server for UID CASE-SENSITIVE=ON flag - LDAP wasn't checking for user case-sensitivity PK69416 - ARSLOAD cores with filename idx and -B has invalid value - Null pointer being accessed when AG or APPL not found PK69520 - PDD errors with No logical place to store object - Added a change force the Storage Set to not migrate PK70633 - PDD fails when going against 7.1.2.x servers - Forced Application Groups to be cache only PK73437 - Comma in a search value of str fld can cause srvr crash - Corrected parsing algorithm for Tokenized Query PK19731 - arsrd core dump in RD of OD 7125 - Changed the way arsrd terminates -------------end of Notes------------------------------------------------------ 2.2. AIX Server 2.2.8.4.1.0. Release (8.4.1.0) - Pre-reqs - Previous install of OnDemand V8.4 - AIX 5L for POWER 5.3 or later - Database - DB2 V9.1 or later - Oracle 10g or later - With AIX TCPIP Patch, IY89429. - Tivoli Storage Manager Extended Edition 5.4 or later with the 64bit TSM Client API - Installation - Unix installs are now packaged with InstallShield MP. The native installs using SMIT, swinstall, pkgadd, or RPM are no longer supported - Pre-reqs - 110MB of free space in /tmp To specify a different temporary directory you can use the "-is:tempdir " option for InstallShield - To install from the command line - odaix -console - To uninstall from the command line - /usr/lpp/ars/_uninst84/uninstallod -console - Please read the Installation Documentation online at: http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1/ for further information -------------end of AIX Server------------------------------------------------- 2.3. HP-UX Server 2.3.8.4.1.0. Release (8.4.1.0) - Pre-reqs - Previous install of OnDemand V8.4 - HP-UX V11i V2 or later - Database - DB2 9.1 or later - Oracle 10g or later - Tivoli Storage Manager Extended Edition 5.4 or later with the 64bit TSM Client API - HPUX Patch PHCO_35744 - Installation - Unix installs are now packaged with InstallShield MP. The native installs using SMIT, swinstall, pkgadd, or RPM are no longer supported - Unix installs are now packaged with InstallShield MP - Pre-reqs - 200MB of free space in /tmp To specify a different temporary directory you can use the "-is:tempdir " option for InstallShield - To install from the command line - odhpux -console - To uninstall from the command line - /opt/ondemand/_uninst84/uninstallod -console - Please read the Installation Documentation online at: http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1/ for further information -------------end of HP-UX Server----------------------------------------------- 2.4. Sun Solaris Server 2.4.8.4.1.0. Release (8.4.1.0) - Pre-reqs - Previous install of OnDemand V8.4 - Sun Solaris V10 or later (SPARC only) - Database - DB2 9.1 or later - Oracle 10g or later - Tivoli Storage Manager Extended Edition 5.4 or later with the 64bit TSM Client API - Solaris 10 linker patch 117461-08 - Installation - Unix installs are now packaged with InstallShield MP. The native installs using SMIT, swinstall, pkgadd, or RPM are no longer supported - Pre-reqs - 138MB of free space in /tmp To specify a different temporary directory you can use the "-is:tempdir " option for InstallShield - Make sure your DISPLAY environment variable is set appropriately - To install from the command line - odsun -console - To uninstall from the command line - /opt/ondemand/_uninst84/uninstallod -console - Please read the Installation Documentation online at: http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1/ for further information --------------end of Solaris Server-------------------------------------------- 2.5. Windows Server 2.5.8.4.1.0. Release (8.4.1.0) - Pre-reqs - Previous install of OnDemand V8.4 - Windows 2003 R2 or later - Database - DB2 9.1 or later - On 64bit Windows 2003, DB2 9 running FP 1 is required - Oracle 10g or later - On 64bit Windows 2003, Oracle 10g 32-bit client Version 10.2.0.3 is needed. - Microsoft SQL Server 2005 - On 64bit Windows 2003, Microsoft SQL Server 2005 SP1 is required. - Tivoli Storage Manager Extended Edition 5.4 or later with the 32bit TSM Client API - Installation - Pre-reqs - 102MB of free space on C:\ To specify a different temporary directory you can use the "-is:tempdir " option for InstallShield - To install from the command line - odwin.exe -console - To uninstall use Add/Remove Programs - Please read the Installation Documentation online at: http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1/ for further information -------------end of Windows Server--------------------------------------------- 2.6. Linux Server 2.6.8.4.1.0 Release (8.4.1.0) - Pre-reqs - Previous install of OnDemand V8.4 - Linux RedHat (RHEL) 4 Update 4 or later - Linux SUSE (SLES) 10 or later - Database - DB2 9.1 or later - Tivoli Storage Manager Extended Edition 5.4 or later with the 64bit TSM Client API - Installation - Unix installs are now packaged with InstallShield MP. The native installs using SMIT, swinstall, pkgadd, or RPM are no longer supported - Pre-reqs - 138MB of free space in /tmp To specify a different temporary directory you can use the "-is:tempdir " option for InstallShield - To install from the command line - odlinux -console - To uninstall from the command line - /opt/ondemand/_uninst84/uninstallod -console - Please read the Installation Documentation online at: http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1/ for further information -------------end of Linux Server----------------------------------------------- 2.7. Linux on System z Server 2.7.8.4.1.0. Release (8.4.1.0) - Pre-reqs - Previous install of OnDemand V8.4 - Linux RedHat (RHEL) 5 U0 - Linux SUSE (SLES) 10 - Database - DB2 9.1 or later - Tivoli Storage Manager Extended Edition 5.4 or later with the 64bit TSM Client API - Open LDAP V2.3 - Installation - Unix installs are now packaged with InstallShield MP. The native installs using SMIT, swinstall, pkgadd, or RPM are no longer supported - Pre-reqs - 88MB of free space in /tmp To specify a different temporary directory you can use the "-is:tempdir " option for InstallShield - To install from the command line - odlinux390 -console - To uninstall from the command line - /opt/ondemand/_uninst84/uninstallod -console - Please read the Installation Documentation online at: http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1/ for further information -------------end of Linux on System z Server----------------------------------- -----------------end of Server Change History---------------------------------- 3. OnDemand Testing Environment ------------------------------------------------------------------------------- The following is a list of the environments in which IBM tested the latest Release/PTF. AIX: AIX - 5.3 DB2 - 9.1 TSM - 5.4 HP-UX: HP-UX - B11.23 (11i v2,v3) DB2 - 9.1 TSM - 5.4.1 SunOS: SunOS - 5.10 DB2 - 9.1 TSM - 5.4 Windows: Windows - 2003 R2 DB2 - 9.1 TSM - 5.4 Linux: RedHat - RHES release 4 U4 Kernel (2.6.9 glibc-2.3.4) SuSE - SLES 10 Kernel (2.6.16 glibc-2.4-31) DB2 - 9.1 TSM - 5.4 Linux on System z: RedHat - RHEL release 5 U0 Kernel (2.6.18-8.el5 glibc-2.5-12) SuSE - SLES 10 Kernel (2.6.16 glibc-2.4-31) DB2 - 9.1 TSM - 5.4 -----------------end of OnDemand Testing Environment--------------------------- 4. Reference ------------------------------------------------------------------------------- You can find information updates by searching the Web Based Technical Support web site at: http://www.ibm.com/software/data/ondemand/mp/support.html You can find the following additional documents by entering the document # or title in the search field: Document # Document title -----------------end of Reference----------------------------------------------