############################################################################### # IBM Content Manager OnDemand for Multiplatforms # # Server for # # AIX, HP-UX, Linux, Sun Solaris, Windows, Linux on System z # # README # # Release 8.4.1.2 # # June 30, 2009 # # # # 5724-J33 (C) COPYRIGHT IBM CORPORATION 2009 # # 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 2.1.3.8.4.1.0) Release (8.4.1.0) 2.1.3.8.4.1.1) Release (8.4.1.1) 2.1.3.8.4.1.2) Release (8.4.1.2) 1.2) DB2 Licensing 2) Server Change History 2.1) Notes 2.1.1) Enhancements 2.1.2) Documntation Changes 2.1.3) APARs 2.1.3.8.4.1.0) Release (8.4.1.0) 2.1.3.8.4.1.1) Release (8.4.1.1) 2.1.3.8.4.1.2) Release (8.4.1.2) 2.2) AIX Server 2.2.8.4.1.0) Release (8.4.1.0) 2.2.8.4.1.1) Release (8.4.1.1) 2.2.8.4.1.2) Release (8.4.1.2) 2.3) HP-UX Server 2.3.8.4.1.0) Release (8.4.1.0) 2.3.8.4.1.1) Release (8.4.1.1) 2.3.8.4.1.2) Release (8.4.1.2) 2.4) Sun Solaris Server 2.4.8.4.1.0) Release (8.4.1.0) 2.4.8.4.1.1) Release (8.4.1.1) 2.4.8.4.1.2) Release (8.4.1.2) 2.5) Windows Server 2.5.8.4.1.0) Release (8.4.1.0) 2.5.8.4.1.1) Release (8.4.1.1) 2.5.8.4.1.2) Release (8.4.1.2) 2.6) Linux Server 2.6.8.4.1.0) Release (8.4.1.0) 2.6.8.4.1.1) Release (8.4.1.1) 2.6.8.4.1.2) Release (8.4.1.2) 2.7) Linux on System z Server 2.7.8.4.1.0) Release (8.4.1.0) 2.7.8.4.1.1) Release (8.4.1.1) 2.7.8.4.1.2) Release (8.4.1.2) 3) OnDemand Testing 3.1) Concurrency Testing 3.2) Testing Environment 4) Reference -----------------end of Contents----------------------------------------------- 1) Installation Notes ------------------------------------------------------------------------------- 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. 1.1) Upgrade Steps 2.1.3.8.4.1.0) Release (8.4.1.0) These steps are only required if you are upgrading from the previous 8.3 version of OnDemand for Multiplatforms 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. 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 [] 2.1.3.8.4.1.1) Release (8.4.1.1) - Pre-reqs - Previous install of OnDemand for Multiplatforms Server V8.4.1 2.1.3.8.4.1.2) Release (8.4.1.2) - Pre-reqs - Previous install of OnDemand for Multiplatforms Server V8.4.1 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. Customers 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. For more information on the Enhanced Retention Management and Integration with FileNet(R) P8, see the "Compliance and Retention Management with IBM Content Manager OnDemand" whitepaper available at: http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101378 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) APARs 2.1.3.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 2.1.3.8.4.1.1) Release (8.4.1.1) PK74863 - ACIF does not use INLINE resource - Upgraded ACIF to PK74886 PK75071 - ARSMAINT -l parameter not being recognized - Changed the paramter parser to accept the -l option without any additional paramters PK77151 - ARSDD Image fails to display strings in the hitlist - Corrected type casting for certain integer types PK78168 - ARSTBLSP -a throws DB errors, stops SYS LOG messages - Corrected the Server Initialization for a local connection PK78355 - ARSDOC UPD/DEL fails/crashes with hitlist > 65535 hits - Added code to re-initialize Application Group information PK79635 - ARSDOC ADD fails with using > 20 Index fields - Increased the size of index field array PK80053 - ARSSYSCR gives SQL0117N in locales with comma as a decimal - Changed the print format for the SQL statement to avoid localization of the decimal point PK80518 - ARSDOC QUERY -F with duplicate folder names gets an S0C4 - Changed the algorithm to manage folder information 2.1.3.8.4.1.2) Release (8.4.1.2) PK84202 - ARSLOAD issues "UNABLE TO REGISTER THE RESOURCE" err msg - Allow the updating of resource set to migrate at a later date PK85179 - ARSTBLSP -a issues error with ADMIN uid and LDAP enabled - Updated the build to use the LDAP libraries for arstblsp PK84774 - Loading Arabic data issues SQL0104N AN UNEXPECTED TOKEN err - Ensured that all SQL is generated in LTR order PK87828 - RD fails with CLI error: SQL0104N - Corrected SQL syntax when there is no user defined SQL PK88291 - USER DEFINED PDF does not allow Data Compression - Allow compression for user defined PDF documents PK87021 - ARSMAINT -D and ARSADMIN UNLOAD -D do not reload - Corrected SQL Syntax and a file permission problem PK89994 - A large file is only partially received from MVS - Corrected length calculation to preserve high order bytes -------------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 2.2.8.4.1.1) Release (8.4.1.1) 2.2.8.4.1.2) Release (8.4.1.2) -------------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 2.3.8.4.1.1) Release (8.4.1.1) 2.3.8.4.1.2) Release (8.4.1.2) -------------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 - if you receive an error message stating "Patch is associated with a product that is not installed in target location", then use the command - odsun -console -vpd /root/ibmod841vpd - To uninstall from the command line - /opt/ondemand/_uninst84/uninstallod -console or - /opt/ondemand/www/_uninst841/unintallodwek -console -vpd /root/ibmod841vpd - Please read the Installation Documentation online at: http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1/ for further information 2.4.8.4.1.1) Release (8.4.1.1) 2.4.8.4.1.2) Release (8.4.1.2) --------------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 2.5.8.4.1.1) Release (8.4.1.1) 2.5.8.4.1.2) Release (8.4.1.2) APARs: PK62114 - ARSLOAD does not del .ARD file in Win NTFS file systems - Synchronized loading to allow the deletion of input files PK85295 - OD CONFIG can't find DB2 if service name is not "DB2-0" - Updated the configurator to look for the DB2 service name -------------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 - Oracle 10g 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 2.6.8.4.1.1) Release (8.4.1.1) 2.6.8.4.1.2) Release (8.4.1.2) -------------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 2.7.8.4.1.1) Release (8.4.1.1) 2.7.8.4.1.2) Release (8.4.1.2) APARs: PK87025 - LDAP auth fails w/'Authentication method not supported' err - Change algorithm to handle different behavior of the LDAP Bind function -------------end of Linux on System z Server----------------------------------- -----------------end of Server Change History---------------------------------- 3) OnDemand Testing ------------------------------------------------------------------------------- 3.1) Concurrency Testing ------------------------------------------------------------------------------- Content Manager OnDemand has had concurrency testing performed with the following sofware products and operating systems. - AIX V6.1 - Windows Server 2008 SP1 - HP-UX 11i v3 - Oracle 11g - DB2 V9.5 - TSM V5.5 and V6.1 -------------end of Concurrency Testing---------------------------------------- 3.1) Testing Environments ------------------------------------------------------------------------------- Content Manager OnDemand for Multiplatforms is tested in 15 configurations on 9 different platforms. The following is a list of the environments in which IBM tested the latest fix pack. AIX: AIX - 5.3 DB2 - 9.1 Oracle - 10g TSM - 5.4 HP-UX: HP-UX - B11.23 (11i v3) DB2 - 9.1 Oracle - 10g TSM - 5.4.1 SunOS: SunOS - 5.10 DB2 - 9.1 Oracle - 10g TSM - 5.4 Windows: Windows - 2003 R2 DB2 - 9.1 Oracle - 10g SQL Server - 2005 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 Oracle - 10g 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 Testing Environments--------------------------------------- -----------------end of OnDemand Testing--------------------------------------- 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 1318327 What causes an accumulation of arssockd processes or threads in an OnDemand server? 1321729 Updated arssupport invocation syntax 1321730 Does IBM Content Manager OnDemand Support the Installation Path Name in Unicode on Windows? 1326825 You are unable to retrieve documents from a specific DB2 Content Manager OnDemand Customized Application 1330810 How to enable LDAP trace in Content Manager OnDemand 1343530 Does OnDemand support Server Print for printing selected pages of an AFP report that contains Invoke Medium Map structured fields? 1351707 Updates to the system control tables in IBM Content Manager OnDemand for Multiplatforms Version 8.4.1 Administration Guide 1358556 What Prerequisites are Checked During the 8.4.1.0 Version Upgrade Install? 1366943 After upgrading to OnDemand server V8.4.1, LDAP authentication fails for users with passwords longer than eight characters 1367010 IBM DB2 Content Manager OnDemand password change with the LDAP authentication enabled 1388835 When you upgrade to V8.4.1, you must run the arsdb command for OnDemand Report Distribution 1366170 The arstblsp command generates database errors and the system log messages might stop writing after an upgrade 1293840 Documentation correction for deleting a report 1386314 How to install IBM DB2 Content Manager OnDemand on a multi partitioned database for DB2 1381134 The PDF indexer does not support PDF documents that contain digital signatures 1383154 What is the maximum number of loads that can be done per application group in IBM Content Manager OnDemand? 1389598 Issuing a -kill command during the arsload process might cause a partial load 1326829 IBM FileNet P8 Content Federation Services for OnDemand Integration Known Limitation: Federation and Records Declare on Duplicate Documents 1005892 OnDemand Security User Exit return codes explained 1367006 IBM Content Manager OnDemand Security User Exit and the LDAP Authentication 1206601 In what situations will OnDemand expire document data from cache or Tivoli Storage Manager? -----------------end of Reference----------------------------------------------