############################################################################### # IBM Content Manager OnDemand for Multiplatforms # # Web Enablement Kit for # # AIX, HP-UX, Linux, Sun Solaris, Windows, Linux on System z # # README # # Release 8.4.1.4 # # Jan. 22, 2010 # # # # 5724-J33 (C) COPYRIGHT IBM CORPORATION 2010 # # 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. # ############################################################################### The information about OnDemand contained in this README file was not available at the time that the OnDemand publications were printed. Please make a note of these items, which supersede the information in the OnDemand publications. For the latest information about OnDemand, see the OnDemand Web site at: http://www.software.ibm.com/data/ondemand =============================================================================== 1) Installation 2.1.8.4.1.0) Release (8.4.1.0) 2.1.8.4.1.1) Release (8.4.1.1) 2.1.8.4.1.2) Release (8.4.1.2) 2.1.8.4.1.3) Release (8.4.1.3) 2.1.8.4.1.4) Release (8.4.1.4) 2) Web Enablement Kit Change History 2.1) CGI/Servlet 2.1.8.4.1.0) Release (8.4.1.0) 2.1.8.4.1.1) Release (8.4.1.1) 2.1.8.4.1.2) Release (8.4.1.2) 2.1.8.4.1.3) Release (8.4.1.3) 2.1.8.4.1.4) Release (8.4.1.4) 2.2) AFP Web Viewer (Plugin/ActiveX) 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.2.8.4.1.3) Release (8.4.1.3) 2.2.8.4.1.4) Release (8.4.1.4) 2.3) Image Web Viewer (Plugin/ActiveX) 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.3.8.4.1.3) Release (8.4.1.3) 2.3.8.4.1.4) Release (8.4.1.4) 2.4) Java Line Data Applet 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.4.8.4.1.3) Release (8.4.1.3) 2.4.8.4.1.4) Release (8.4.1.4) 2.5) Java AFP2HTML Applet 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.5.8.4.1.3) Release (8.4.1.3) 2.5.8.4.1.4) Release (8.4.1.4) 2.6) Java API 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.6.8.4.1.3) Release (8.4.1.3) 2.6.8.4.1.4) Release (8.4.1.4) 3) Testing Environment 4) Reference =============================================================================== Note: The Arabic and Hebrew OnDemand 8.4 ODWEK have the following known limitation: - Messages from ODWEK (aka, client message repository) cannot be displayed in Arabic and Hebrew. The above limitations will be corrected in a future release. =============================================================================== 1) Installation ------------------------------------------------------------------------------- 1.1.8.4.1.0) Release (8.4.1.0) Note: The Java API Shared library name has changed. The old named library, arswwwsl.[a,so,sl,dll] is still used by the servlet. The Servlet class file name has also changed as well. The new name is ArsSVTInterface.class. ** ODWEK API Users need to make sure that the old ArsWWWInterface.class is deleted, as this file is no longer used by the ODWEK Apis, but can cause conflicts if not removed. - Unix installs are now packaged with InstallShield MP. The native installs using SMIT, swinstall, pkgadd, or RPM are no longer supported - Pre-reqs - Previous install of the OnDemand Web Enablement Kit V8.4 - Between 130-200MB of free space in /tmp (depending on platform) for InstallShield. To specify a different temporary directory you can use the "-is:tempdir " option for InstallShield - For Solaris, make sure your DISPLAY environment variable is set appropriately - To install from the command line - odwekaix -console - odwekhp -console - odweksun -console - if you receive an error message stating "Patch is associated with a product that is not installed in target location", please see the flash with document id number 1406686, "Patch is associated with a product that is not installed in target location" error when upgrading OnDemand Server or ODWEK on Solaris - odweklinux -console - odweklinux390 -console - odwekwin.exe -console - To uninstall from the command line on AIX - /usr/lpp/ars/www/_uninsti84/uninstallodwek -console - To uninstall from the command line on other UNIX platforms - /opt/ondemand/www/_uninst84/uninstallodwek -console - To uninstall on Windows use Add/Remove Programs - Please read the Installation Documentation in the CMODDoc.zip or see the online documentation at: http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1/ package for further information - Before using the latest version of the Web Enablement Kit CGI/Servlet, you must delete all of the files from the Web Enablement Kit cache and temp directories. The directories are specified by the CACHEDIR and TEMPDIR directives in the arswww.ini file. - Version 8.4.x.x now includes libraries and an arswww.cgi for 64-Bit Operating Systems on AIX, Sun, HP-UX, Linux,and Linux on System z. Windows is 32-bit only, and Linux on System z is only 64-bit. The filename of the Java API shared libraries has been changed (libname64.so, or libname32.so) to reflect which OS architecture they were built for. - This release includes the following files: README - This file. arswww.cgi - This is the Web Enablement Kit CGI program. This file is now a 64-bit executable. This file should be placed into a directory within your Web server directory space which has been designated as executable and can contain CGI applications. arssck32.dll (Windows) ctreestd.dll (Windows) - No longer needed - This file should be left in the installation directory. icudt36l.dat (Windows, Linux) icudt36b.dat (AIX, SunOS, HPUX) - This file should be left in the installation Locale directory. icudt36.dll (Windows) icuin36.dll (Windows) icuio36.dll (Windows) icuuc36.dll (Windows) icule36.dll (Windows) - No longer needed iculx36.dll (Windows) - No longer needed - These libraries are used for ICU support. On Windows, these files must be placed in the same directory as the arswww.cgi file or when using the JAVA Api's, a directory that is in the command search path defined by the Path environment variable. ArsWWWServlet.jar ArsSVTInterface.class arswwwsl32.dll (Windows) libarswwwsl32.a (AIX 32-Bit) libarswwwsl32.so (SunOS,iLinux 32-Bit) libarswwwsl32.sl (HPUX 32-Bit) - Servlet support files. ArsWWWServlet.jar should be placed into the web server's servlet directory. See the documentation for more information. ODApi.jar ars3wapi32.dll (Windows) libars3wapi32.a (AIX 32-Bit) libars3wapi64.a (AIX 64-Bit) libars3wapi32.so (SunOS,iLinux 32-Bit) libars3wapi64.so (SunOS,iLinux 64-Bit) libars3wapi64.so (zLinux 64-Bit) libars3wapi32.sl (HPUX 32-Bit) libars3wapi64.sl (HPUX 64-Bit) - Java API and support files. See the documentation and api/ODApiDoc.zip for more information on using the API's. arswww.ini - This is the configuration file for the cgi/servlet. See the documentation for information on the configuration settings. This file must be placed in the same directory as the cgi or servlet program. afp2html.ini - This is the configuration file for the AFP2WEB Transform. See the documentation for information on the configuration settings. afp2pdf.ini - This is the configuration file for the AFP2PDF Transform. See the documentation for information on the configuration settings. arsxenos.ini - This is the configuration file for the XENOS Transform. See the documentation for information on the configuration settings. api/ODApi.jar - This is the OnDemand Web Enablement Kit Java API jar file api/ODApiDoc.zip - This is the OnDemand Web Enablement Kit Java API Documentation locale/arscpcs.cfg - This file contains the code page to code set mappings. This file should stay in the installation directory. samples/template.htm - This is a sample of what a template html file can look like. samples/logon.htm - This is another sample html file demonstrating how to gather logon information from the end user and submit it to arswww.cgi. samples/credit.htm - This is another sample html file demonstrating the use of another script function, dochitlist. samples/frames.htm samples/fcredit.htm samples/fblank.htm samples/ftemplat.htm - These are sample html files demonstrating how to use the _frame parameter to build a frames based application. images/grytxtr4.jpg images/odcol2in.gif - These are the images referenced in the sample html files. images/odic_att.gif - image used for Showing Document Attachments - These images are used for the ODDOC type images/odic_aa.gif - image used for Add Annotation button images/odic_aad.gif - image used for Add Annotation button (disabled) images/odic_va.gif - image used for View Annotation button images/odic_vad.gif - image used for View Annotation button (disabled) images/odic_vd.gif - image used for View Document button images/odic_vdd.gif - image used for View Document button (disabled) - These images are used when enabling commands for the command icons column of the document list table. See the documentation for more information. To use your own images, simply rename your image to one of the names above. images/* - The remainder of the images are used by the applet toolbars. They should be placed in the IMAGE_DIR directory. See the documentation for more information. These images cannot be replaced with your own images. applets/ODLineDataViewer2.jar - IBM OnDemand Line Data Viewer applet. applets/ODAfp2Html2.jar - IBM OnDemand AFP Transform applet. - These applet files are used when enabling the java AFP2HTML viewer applet. (See the documentation for more information). applets/IEFix.js - JavaScript file to assist applet launch plugins/afpplgin.exe - IBM OnDemand AFP Web Viewer (Plugin/ActiveX) - All languages including DBCS support plugins/afpplgin.zip - IBM OnDemand AFP Web Viewer (Plugin/ActiveX) - Zip format for all languages include DBCS support plugins/imgplgin.exe - IBM OnDemand Image Web Viewer (Plugin/ActiveX) - All languages - These are self extracting files (InstallShield). These files should be downloaded to the user's Windows XP, Windows 2000, Windows 2003, Windows Vista system, and run to install the appropriate plug-in. If the user is running a browser while the installation is in progress, then the user must stop and restart the browser before the plugins can be used. exporter/CFSODExporter.jar - Only for use with CFS-OD afp2pdf/README afp2pdf/afp2pdf_v301_AIX.tar afp2pdf/afp2pdf_v301_HPUX.tar afp2pdf/afp2pdf_v301_LINUX.tar afp2pdf/afp2pdf_v301_SUN.tar afp2pdf/afp2pdf_v301_WIN32.zip afp2pdf/afp2pdf_v301_zLINUX.tar - InfoPrint Solutions AFP2PDF Transforms afp2web/README afp2web/afp2web_v123n_AIX_CM.tar afp2web/afp2web_v123n_xLINUX_CM.tar afp2web/afp2web_v123n_SUN_CM.tar afp2web/afp2web_v123n_WIN32_CM.zip afp2web/afp2web_v123n_zLINUX_CM.tar afp2web/afp2web_v123n_HP_CM.tar - InfoPrint Solutions AFP2WEB Transforms odwa/* - OnDemand Web Administrator 1.1.8.4.1.1) Release (8.4.1.1) - Pre-reqs - Previous install of OnDemand Web Enablement Kit V8.4.1 1.1.8.4.1.2) Release (8.4.1.2) - Pre-reqs - Previous install of OnDemand Web Enablement Kit V8.4.1 1.1.8.4.1.3) Release (8.4.1.3) - Pre-reqs - Previous install of OnDemand Web Enablement Kit V8.4.1 1.1.8.4.1.4) Release (8.4.1.4) - Pre-reqs - Previous install of OnDemand Web Enablement Kit V8.4.1 -------------end of Installation----------------------------------------------- 2) Web Enablement Kit Change History ------------------------------------------------------------------------------- 2.1) CGI/Servlet 2.1.8.4.1.0) Release (8.4.1.0) - Pre-reqs - AIX 5L for POWER 5.3 or later - HP-UX V11i V2 or later - HPUX Patch PHCO_35744 - Sun Solaris V10 or later (SPARC only) - Linux RedHat (RHEL) 4 Update 4 or later - Linux SUSE (SLES) 10 or later - Linux on System z RedHat (RHEL) 5 U0 - Linux on System z SUSE (SLES) 10 or later - Windows 2003 R2 or later - Java Runtime Environment 1.4.2 or higher 2.1.8.4.1.1) Release (8.4.1.1) APARs: PK76994 - Crash when Tempdir file cannot be opened/created - Corrected the format for an error message PK80604 - Memleak in CGI/Servlet CsvGetNewLogid -> logon path - Changed the logon algorithm used in the CGI/Servlet methods 2.1.8.4.1.2) Release (8.4.1.2) 2.1.8.4.1.3) Release (8.4.1.3) 2.1.8.4.1.4) Release (8.4.1.4) APARs: PM03616 - ODWEK w/AFP2WEB returns wrong doc under load - Changed temporary file naming to be more unique -------------end of CGI/Servlet------------------------------------------------ 2.2) AFP Web Viewer (Plugin/ActiveX) 2.2.8.4.1.0) Release (8.4.1.0) - Pre-reqs - Windows XP SP2 - Windows Vista (32-bit and 64-bit) - Current version is AFP Web Viewer V3.3.1.8 2.2.8.4.1.1) Release (8.4.1.1) - Current version is AFP Web Viewer V3.3.3.0 2.2.8.4.1.2) Release (8.4.1.2) APARs: PK75691 - AFP PLUGIN can't display document if URL > 1024 chars - Updated the AFP Viewer to 3.03.03.01 2.2.8.4.1.3) Release (8.4.1.3) 2.2.8.4.1.4) Release (8.4.1.4) - Current version is AFP Web Viewer V3.5.4.1 -------------end of AFP Plugin------------------------------------------------- 2.3) Image Web Viewer (Plugin/ActiveX) 2.3.8.4.1.0) Release (8.4.1.0) - Pre-reqs - Windows XP SP2 - Windows Vista (32-bit and 64-bit) 2.3.8.4.1.1) Release (8.4.1.1) 2.3.8.4.1.2) Release (8.4.1.2) 2.3.8.4.1.3) Release (8.4.1.3) 2.3.8.4.1.4) Release (8.4.1.4) -------------end of Image Plugin----------------------------------------------- 2.4) Java Line Data Applet 2.4.8.4.1.0) Release (8.4.1.0) - Pre-reqs - Java 1.4.2 or later 2.4.8.4.1.1) Release (8.4.1.1) APARS: PK78224 - JAVA LDV copies wrong pages to file - Corrected page count for copying pages to file Enhancements: - Applet Certificate is valid until Sep. 16, 2011 2.4.8.4.1.2) Release (8.4.1.2) APARs: PK84196 - JAVA LDV truncates report with long rows - Made changes to screen scrolling to eliminate truncation PK85540 - JAVA LDV PRINT does not print 'middle range' of pages - Fixed algorithm to handle multiple pages and ranges 2.4.8.4.1.3) Release (8.4.1.3) 2.4.8.4.1.4) Release (8.4.1.4) -------------end of Java Line Data Applet-------------------------------------- 2.5) Java AFP2HTML Applet 2.5.8.4.1.0) Release (8.4.1.0) - Pre-reqs - Java 1.4.2 or later 2.5.8.4.1.1) Release (8.4.1.1) Enhancements: - Applet Certificate is valid until Sep. 16, 2011 2.5.8.4.1.2) Release (8.4.1.2) 2.5.8.4.1.3) Release (8.4.1.3) 2.5.8.4.1.4) Release (8.4.1.4) -------------end of Java AFP2HTML Applet--------------------------------------- 2.6) Java API 2.6.8.4.1.0) Release (8.4.1.0) - Pre-reqs - Java 1.4.2 or later - AIX 5L for POWER 5.3 or later - HP-UX V11i V2 or later - HPUX Patch PHCO_35744 - Sun Solaris V10 or later (SPARC only) - Linux RedHat (RHEL) 4 Update 4 or later - Linux SUSE (SLES) 10 or later - Linux on System z RedHat (RHEL) 5 U0 - Linux on System z SUSE (SLES) 10 or later - Windows 2003 R2 or later APARs: PK64105 - JVMJNCK037E JNI ERROR IN DELETELOCALREF: ARGUMENT #2 - Identified several areas where we were not checking for JNI exceptions, and/or not cleaning up our JNI references efficiently PK64747 - LOB enabled docs do not open from the doc hitlist - Corrected the allocation for Page information to prevent negative values PK65350 - Storedoc does not allow duplication functionality - Added ODFolder.duplicateHit() to match the arsdoc functionality PK70929 - ODFolder.setMaxHits can set maxhits higher then server def - Added a check to disallow exceeding the maxhits defined by the OnDemand Server 2.6.8.4.1.1) Release (8.4.1.1) APARs: PK78081 - AddFieldsToDocId is ignored with arswww.ini methods - The AddFieldsToDocID was re-instated for use with the deprecated arswww.ini methods PK81094 - TcStoreDoc failure if all fields are not specified - Added checking to verify that the correct number of field values have been provided and improved error messaging to include more detail 2.6.8.4.1.2) Release (8.4.1.2) APARs: PK78081 - AddFieldsToDocId is ignored with arswww.ini methods - Added code to ensure AddFieldsToDocID is set correctly PK80187 - setUserAlias() before ODServer.logon() causes Java to crash - Added a check to ensure there is a valid server session 2.6.8.4.1.3) Release (8.4.1.3) APARs: PK99817 - ODServer.keepServerAlive/isServerTimedOut w/o logon crashes - Added a check to make sure there was an active logon PK96533 - SQL Tokenization not init'd correctly w/ODConfig on UNIX - Forced Tokenized SQL 2.6.8.4.1.4) Release (8.4.1.4) APARs: PM03616 - ODWEK w/AFP2WEB returns wrong doc under load - Changed temporary file naming to be more unique PM04912 - META Doc Retrievals/Resources Fail with Xenos/ODWEK - Corrected document resource handling -------------end of Java API--------------------------------------------------- ----------------end of Web Enablement Kit Change History----------------------- 3) OnDemand Testing Environment ------------------------------------------------------------------------------- This following is a list of the environments in which IBM tested the latest Release/PTF. JVM: Java 1.4.2 (32 and 64 bit) AIX: AIX 5L for POWER 5.3 HP-UX: HP-UX V11i V2 SunOS: Sun Solaris V10 Windows: Windows - 2003, XP SP2, Vista (32-bit and 64-bit) only for the Applets and Web Viewers Linux: RedHat - Linux RedHat (RHEL) 4 SuSE - Linux SUSE (SLES) 10 Linux on System z: RedHat - Linux RedHat (RHEL) release 5 U0 SuSE - Linux SUSE (SLES) 10 SP0 -----------------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 search for the following document numbers or titles. You can find the following additional documents by entering the document # or title in the search field: Document # Document title 1326252 Default font in Java Line Data Viewer cannot be predefined 1351446 How to install IBM Content Manager OnDemand Web Enablement Kit (ODWEK) silently 1381065 Cannot upgrade OnDemand Server or ODWEK, receiving error "Patch is associated with a product that is not installed in target location" 1381589 When will an ODException be thrown when and ODServer.cancel ODWEK Java API call is made? 1382072 A blank page appears after installing the OnDemand Web Administrator 1395090 Retrieving wrong documents intermittently with the ODWEK Java APIs 1404376 Object expected error when launching the ODWEK line data applet viewer 1404699 "Insufficient memory is available to perform the operation" error when using the AFP2PDF transform with ODWEK 1406686 "Patch is associated with a product that is not installed in target location" error when upgrading OnDemand Server or ODWEK on Solaris 1407866 AIX ODM shows previous version after uninstalling OnDemand server or ODWEK 1410187 Collecting data for display problems in Content Manager OnDemand Web Enablement Kit with the AFP2PDF Transform 1410363 How to retain temporary files in the AFP2PDF transform with ODWEK 1410452 How do I enable AFP2PDF Transform logging? 1417484 How do I enable the AFP Web Viewer Plug-in trace? -----------------end of Reference----------------------------------------------