############################################################################### # IBM Content Manager OnDemand for Multiplatforms # # Web Enablement Kit for # # AIX, HP-UX, Linux, Sun Solaris, Windows, Linux on System z # # README # # Release 8.5.0.11 # # May 13, 2016 # # # # 5724-J33 (C) COPYRIGHT IBM CORPORATION 2016 # # 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 Web Enablement Kit. For the latest information about OnDemand, see the OnDemand Web site at: http://www.ibm.com/software/products/ondemand =============================================================================== 1) Installation 1.1) ODWEK Installation 1.1.8.5.0.0) Release (8.5.0.0) 1.1.8.5.0.1) Release (8.5.0.1) 1.1.8.5.0.2) Release (8.5.0.2) 1.1.8.5.0.3) Release (8.5.0.3) 1.1.8.5.0.4) Release (8.5.0.4) 1.1.8.5.0.5) Release (8.5.0.5) 1.1.8.5.0.6) Release (8.5.0.6) 1.1.8.5.0.7) Release (8.5.0.7) 1.1.8.5.0.8) Release (8.5.0.8) 1.1.8.5.0.9) Release (8.5.0.9) 1.1.8.5.0.10) Release (8.5.0.10) 1.1.8.5.0.11) Release (8.5.0.11) 1.2) IBM Global Security Kit Installation 1.2.1) AIX 1.2.2) HPUX 1.2.3) Solaris 1.2.4) Linux 1.2.5) Linux for System z 1.2.6) Windows 1.3) Contents of the Installation Package 2) Web Enablement Kit Change History 2.1) CGI/Servlet 2.1.8.5.0.0) Release (8.5.0.0) 2.1.8.5.0.1) Release (8.5.0.1) 2.1.8.5.0.2) Release (8.5.0.2) 2.1.8.5.0.3) Release (8.5.0.3) 2.1.8.5.0.4) Release (8.5.0.4) 2.1.8.5.0.5) Release (8.5.0.5) 2.1.8.5.0.6) Release (8.5.0.6) 2.1.8.5.0.7) Release (8.5.0.7) 2.1.8.5.0.8) Release (8.5.0.8) 2.1.8.5.0.9) Release (8.5.0.9) 2.1.8.5.0.10) Release (8.5.0.10) 2.1.8.5.0.11) Release (8.5.0.11) 2.2) AFP Web Viewer (ActiveX) 2.2.8.5.0.0) Release (8.5.0.0) 2.2.8.5.0.1) Release (8.5.0.1) 2.2.8.5.0.2) Release (8.5.0.2) 2.2.8.5.0.3) Release (8.5.0.3) 2.2.8.5.0.4) Release (8.5.0.4) 2.2.8.5.0.5) Release (8.5.0.5) 2.2.8.5.0.6) Release (8.5.0.6) 2.2.8.5.0.7) Release (8.5.0.7) 2.2.8.5.0.8) Release (8.5.0.8) 2.2.8.5.0.9) Release (8.5.0.9) 2.2.8.5.0.10) Release (8.5.0.10) 2.2.8.5.0.11) Release (8.5.0.11) 2.3) Image Web Viewer (ActiveX) 2.3.8.5.0.0) Release (8.5.0.0) 2.3.8.5.0.1) Release (8.5.0.1) 2.3.8.5.0.2) Release (8.5.0.2) 2.3.8.5.0.3) Release (8.5.0.3) 2.3.8.5.0.4) Release (8.5.0.4) 2.3.8.5.0.5) Release (8.5.0.5) 2.3.8.5.0.6) Release (8.5.0.6) 2.3.8.5.0.7) Release (8.5.0.7) 2.3.8.5.0.8) Release (8.5.0.8) 2.3.8.5.0.9) Release (8.5.0.9) 2.3.8.5.0.10) Release (8.5.0.10) 2.3.8.5.0.11) Release (8.5.0.11) 2.4) Java Line Data Applet 2.4.8.5.0.0) Release (8.5.0.0) 2.4.8.5.0.1) Release (8.5.0.1) 2.4.8.5.0.2) Release (8.5.0.2) 2.4.8.5.0.3) Release (8.5.0.3) 2.4.8.5.0.4) Release (8.5.0.4) 2.4.8.5.0.5) Release (8.5.0.5) 2.4.8.5.0.6) Release (8.5.0.6) 2.4.8.5.0.7) Release (8.5.0.7) 2.4.8.5.0.8) Release (8.5.0.8) 2.4.8.5.0.9) Release (8.5.0.9) 2.4.8.5.0.10) Release (8.5.0.10) 2.4.8.5.0.11) Release (8.5.0.11) 2.5) Java AFP2HTML Applet 2.5.8.5.0.0) Release (8.5.0.0) 2.5.8.5.0.1) Release (8.5.0.1) 2.5.8.5.0.2) Release (8.5.0.2) 2.5.8.5.0.3) Release (8.5.0.3) 2.5.8.5.0.4) Release (8.5.0.4) 2.5.8.5.0.5) Release (8.5.0.5) 2.5.8.5.0.6) Release (8.5.0.6) 2.5.8.5.0.7) Release (8.5.0.7) 2.5.8.5.0.8) Release (8.5.0.8) 2.5.8.5.0.9) Release (8.5.0.9) 2.5.8.5.0.10) Release (8.5.0.10) 2.5.8.5.0.11) Release (8.5.0.11) 2.6) Java API 2.6.8.5.0.0) Release (8.5.0.0) 2.6.8.5.0.1) Release (8.5.0.1) 2.6.8.5.0.2) Release (8.5.0.2) 2.6.8.5.0.3) Release (8.5.0.3) 2.6.8.5.0.4) Release (8.5.0.4) 2.6.8.5.0.5) Release (8.5.0.5) 2.6.8.5.0.6) Release (8.5.0.6) 2.6.8.5.0.7) Release (8.5.0.7) 2.6.8.5.0.8) Release (8.5.0.8) 2.6.8.5.0.9) Release (8.5.0.9) 2.6.8.5.0.10) Release (8.5.0.10) 2.6.8.5.0.11) Release (8.5.0.11) 2.7) CFSOD Exporter 2.7.8.5.0.0) Release (8.5.0.0) 2.7.8.5.0.1) Release (8.5.0.1) 2.7.8.5.0.2) Release (8.5.0.2) 2.7.8.5.0.3) Release (8.5.0.3) 2.7.8.5.0.4) Release (8.5.0.4) 2.7.8.5.0.5) Release (8.5.0.5) 2.7.8.5.0.6) Release (8.5.0.6) 2.7.8.5.0.7) Release (8.5.0.7) 2.7.8.5.0.8) Release (8.5.0.8) 2.7.8.5.0.9) Release (8.5.0.9) 2.7.8.5.0.10) Release (8.5.0.10) 2.7.8.5.0.11) Release (8.5.0.11) 3) Testing Environment 3.1) Currency Testing 3.2) Testing Environments 4) Reference =============================================================================== 1) Installation ------------------------------------------------------------------------------- 1.1) ODWEK Installation 1.1.8.5.0.0) Release (8.5.0.0) - Unix installs are now packaged with Install Anywhere. The native installs using SMIT, swinstall, pkgadd, or RPM are no longer supported - Pre-reqs - 400MB of free space in /tmp and 400MB in /usr or /opt - IBM Global Security Kit Crypt Version 8 64bit/32bit - IBM Global Security Kit SSL Version 8 64bit/32bit - To install from the command line - odwekaix.bin -i console - odwekhpit.bin -i console - odweksun.bin -i console - odweklinux.bin -i console - odweklinux390.bin -i console - odwekwin.exe - To uninstall from the command line on AIX - /usr/lpp/ars/www/_uninsti850/uninstallodwek -i console - To uninstall from the command line on other UNIX platforms - /opt/ondemand/www/_uninst850/uninstallodwek -i console - To uninstall on Windows use Add/Remove Programs - Please read the Installation Documentation or the online documentation at: http://publib.boulder.ibm.com/infocenter/cmod/v8r5m0/index.jsp for further information - The HPUX PA-RISC Platform is no longer supported. The last supported version will be in the 8.4.1 maintanence stream. Starting with Content Manager OnDemand 8.5, HPUX is supported on the Itanium platform. - 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. - The Java API shared libraries are both 32bit and 64bit on AIX, Sun, Linux, and Windows. The Java API shared library on Linux for System z and HPUX Itanium is 64-bit only. - The ODWEK 32bit Servlet is available on AIX, Sun, Linux, and Windows. 1.1.8.5.0.1) Release (8.5.0.1) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.2) Release (8.5.0.2) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.3) Release (8.5.0.3) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.4) Release (8.5.0.4) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.5) Release (8.5.0.5) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.6) Release (8.5.0.6) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.7) Release (8.5.0.7) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.8) Release (8.5.0.8) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.9) Release (8.5.0.9) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.10) Release (8.5.0.10) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.1.8.5.0.11) Release (8.5.0.11) - Pre-reqs - Previous install of Content Manager OnDemand Web Enablement Kit Version 8.5 1.2) IBM Global Security Kit Installation 1.2.1) AIX The GSKit install media must be accessible to the installation programs. Although the SMIT program can access the install media via a read-only device (such as a CD-ROM), the recommended method is to copy the GSKit media to the local file system first. A good place for this is /var/spool/pkg or alternatively /tmp/gsk8. The AIX packages are distributed in a compressed tar file. To gain access to the software packages that will be recognized by native install tools you first need to uncompress them. This can be achieved as follows: zcat gskcrypt64-8.0.13.4.aix.ppc.tar.Z | tar -xvf - zcat gskssl64-8.0.13.4.aix.ppc.tar.Z | tar -xvf - zcat gskcrypt32-8.0.13.4.aix.ppc.tar.Z | tar -xvf - zcat gskssl32-8.0.13.4.aix.ppc.tar.Z | tar -xvf - This will decompress the RTE install packages for AIX. The following installation instructions assume that you have decompressed the installation packages and are working with them directly. Installing with SMIT GUI tool Do the following: 1. From the command line, run inutoc in the directory containing the GSKit packages. This creates a table of contents needed by SMIT. /usr/sbin/inutoc /tmp/gsk8 2. Invoke the SMIT application by entering smit on the command line. 3. Choose "Software Installation & Maintenance". 4. Then choose "Install Software". 5. Select "Install and Update Software by Package Name". 6. On the device/directory window specify the directory that contains the installable software. 7. Select packages GSKit8.gskcrypt64.ppc.rte, GSKit8.gskssl64.ppc.rte, GSKit8.gskcrypt32.ppc.rte, and GSKit8.gskssl32.ppc.rte from the Multi-select List. 8. Select the file sets of the software package to install. 9. Mark the options appropriate to your installation requirements from the options window. Note: Set the "install all prereqs" options to "yes" 10. Confirm to complete the installation. Installing with installp command line tool To install GSKit 8 for PPC64 systems using the installp command the following chain of commands would need to be executed: 1. /usr/bin/inutoc /tmp/gsk8 2. installp -acgqw -d /tmp/gsk8 GSKit8.gskcrypt64.ppc.rte \ GSKit8.gskssl64.ppc.rte \ GSKit8.gskcrypt32.ppc.rte \ GSKit8.gskssl32.ppc.rte See the installp man page for more information about the command line switches. Removing Packages with SMIT GUI tool Do the following: 1. Invoke SMIT, by entering smit on the command line. 2. From the menu, choose the "Software Installation and Maintenance". 3. Then select "Software Maintenance and Utilities". 4. From the Maintenance window select "Remove Installed Software" to open the "Remove Software Product" dialogue window. 5. Enter the name of the installed GSKit SSL software package (e.g. GSKit8.gskssl64.ppc.rte). 6. Turn the flag for "REMOVE dependent software?" to "YES" to instruct the system to automatically remove the GSKit Crypt software package. 7. Confirm the procedure to complete the removal of the software package. Removing Packages with installp command line tool Use installp to remove all of the GSKit packages. To remove GSKit 8 for PPC64 with the installp command: installp -u -g -V2 GSKit8.gskssl64.ppc.rte \ GSKit8.gskcrypt64.ppc.rte \ GSKit8.gskssl632.ppc.rte \ GSKit8.gskcrypt32.ppc.rte 1.2.2) HPUX In a temporary directory, uncompress and untar each of the compressed packages using the following command: zcat gskcrypt64-8.0.13.4.hpux.ia64.tar.Z | tar -xvf - zcat gskssl64-8.0.13.4.hpux.ia64.tar.Z | tar -xvf - zcat gskcrypt32-8.0.13.4.hpux.ia64.tar.Z | tar -xvf - zcat gskssl32-8.0.13.4.hpux.ia64.tar.Z | tar -xvf - Installing using SAM GUI tool Do the following: 1. Type sam at the prompt to start the System Administration Manager. 2. From the SAM Areas window, double-click the Software Management icon. The Software Management window appears. 3. Double-click the Install Software to Local Host icon. The SD Install window appears and opens the Specify Source pop-up window. 4. From the pop-up window, specify the source host name, source depot path and click OK to return to the SD Install window. 5. From the SD Install window, do the following: a. Select the GSKit Crypt package (gskcrypt64). From the Action pull-down menu, select Mark for Install. b. Select the GSKit SSL package (gskssl64). From the Action pull-down menu, select Mark for Install. c. Select Install (Analysis) from the Action pull-down menu. d. Click OK to start the analysis. When analysis is complete, the SAM tools display a ready status. e. Click OK to start the install. When install is complete, the SAM tool displays a completed status and the Done button is active. f. Click Done to end the installation and select close from the File pull-down menu. Installing with swinstall command line tool Do the following: 1. Run the swinstall command to install each GSKit component as needed: swinstall -s /tmp/gskcrypt64 gskcrypt64 swinstall -s /tmp/gskssl64 gsk8ssl64 swinstall -s /tmp/gskcrypt32 gskcrypt32 swinstall -s /tmp/gskssl32 gsk8ssl32 Removing Packages using SAM GUI tool Do the following: 1. Type sam at the prompt to start the System Administration Manager. 2. From the SAM Areas window, double-click the Software Management icon. The Software Management window appears. 3. Double-click the Remove Software icon. and then Remove Local Host Software icon. The SD Remove - Software Selection window appears. 4. From the SD Remove window, do the following: a. Single click to select the GSKit SSL package. From the Action pull-down menu, select Mark for Remove. b. Single click to select the GSKit Crypt package. From the Action pull-down menu, select Mark for Remove. c. Select Remove (Analysis) from the Action pull-down menu. d. Click OK to start the analysis. When analysis is complete the SAM tools display a ready status. e. Click OK to start the remove. When remove is complete, the SAM tool displays a completed status and the Done button is active. f. Click Done to end the installation and select close from the File pull-down menu. Removal using the Command Line Interface Do the following: 1. Run the swremove command to remove the GSKit SSL and GSKit Crypt packages. swremove gskssl64 gskcrypt64 gskssl32 gskcrypt32 1.2.3) Solaris Note: The Sun installer has some unique behavior such that the expected directory permissions of system directories (for example /usr/bin and /usr/lib) can be noted by the installer if specified by any package being installed (for example most of the Sun packages specify the required permission). The last installed package to require a specific permission sets this expectation for all subsequent installs that do not specify an exact required permission. This can create problems if the system administrator changes the directory permissions of system directories outside of the install database as they will be inconsistent with the installers expected state. Although GSKit does not require specific permissions for these directories the installer may, during the install, require that the permissions be changed to the state that it expects. This behavior is by design and it is expected that system administrators of Sun systems are aware of this behavior and should keep the actual permissions of the system directories consistent with the expected state in the installer database. For interactive install the user will be prompted for the action to take. For silent install the standard GSKit install will fail. There are two known workarounds for this issue for the silent install. Sun system administrators may likely know of more. 1. Use an admin file (as documented by the pkgadd install tool) with the following setting added or changed to: conflict=nochange This will leave the conflicting directory permission attributes unchanged. 2. Use an admin file (as documented by the pkgadd install tool) with the following setting added or changed to: conflict=nocheck This will change the directory attributes to agree with the install database. This is considered the most appropriate option. Note: By default Solaris sets a 9 character limit on the package instance names. As such there is a discrepancy between the naming conventions used in the GSKit package files and the system package instance name. This was necessary to accommodate the character restrictions. The table below show the relation ship between the package name (pkgname), and the package instance name (pkginst). Package Name Package Instance Name gskcrypt64-.sun..tar.Z gsk8cry64 gskssl64-.sun..tar.Z gsk8ssl64 gskcrypt32-.sun..tar.Z gsk8cry32 gskssl32-.sun..tar.Z gsk8ssl32 In a temporary directory, uncompress and untar each of the compressed packages using the following command: zcat gskcrypt64-8.0.13.4.sun.sparc.tar.Z | tar -xvf - zcat gskssl64-8.0.13.4.sun.sparc.tar.Z | tar -xvf - zcat gskcrypt32-8.0.13.4.sun.sparc.tar.Z | tar -xvf - zcat gskssl32-8.0.13.4.sun.sparc.tar.Z | tar -xvf - For GSKit Crypt 64-bit gsk8cry64 would be the decompressed file. The following installation instructions assume that you have decompressed the installation packages and are working with them directly. Installing with admintool GUI tool. Do the following: 1. Start the admintool application by entering admintool at the command prompt. 2. Select Software from the Browse pull-down menu. 3. From the Edit menu choose Add to add the software package to the system. 4. Depending on the Software Location chosen, enter the directory or CD Path or Mount Point that contains the installable package. 5. List the instances: From the displayed list of package instances, identify GSKit Crypt (gsk8cry64) 6. Repeat steps 3-5 however this time add GSKit SSL (gsk8ssl64). Installing with pkgadd command line tool To install GSKit 8 with pkgadd the following commands need to be run: 1. Run the pkgadd command to install each GSKit component as needed: pkgadd [-G] -d /var/spool/pkg gsk8cry64 pkgadd [-G] -d /var/spool/pkg gsk8ssl64 pkgadd [-G] -d /var/spool/pkg gsk8cry32 pkgadd [-G] -d /var/spool/pkg gsk8ssl32 Use the -G option to install GSKit to the current zone only. 2. Run pkgchk to check the accuracy of the installed package. pkgchk gsk8ssl64 Removing Packages using admintool GUI tool 1. Start the GUI application by entering 'admintool' on the command prompt. 2. From the Browse pull-down menu select Software. 3. Mark the package to delete. 4. Select Delete from the Edit menu on the Admintool:Software main window. From the window displayed, confirm to execute the package remove operation. Removing Packages using pkgrm command line tool The procedure to remove a previously installed or partially installed GSKit package is given below. The dependencies are checked before any package is removed. If a dependency exists, the action taken is defined in the admin file. 1. Run the pkgrm command to remove each package as needed To remove installation completely from a system using pkgrm you need to run: pkgrm The default mode of the command is interactive, meaning that prompt messages allow you to confirm the actions being taken. A non-interactive mode can be requested with the -n option. However, the command will exit if there is a need for interaction. If you require a completely non-interactive installation to take place, you will need to create an admin file and use option -a. See the pkgrm man page for more information. 1.2.4) Linux The installation must be performed as the user root. The -nodeps flag should not be used unless specifically called out in the instructions below. Installing with RPM command line tool Do the following: 1. Use the rpm command to perform the installation as follows: To install in the default location: /usr/local rpm -Uv gskcrypt64-8.0.13.4.linux.x86_64.rpm rpm -Uv gskssl64-8.0.13.4.linux.x86_64.rpm rpm -Uv gskcrypt32-8.0.13.4.linux.x86.rpm rpm -Uv gskssl32-8.0.13.4.linux.x86.rpm Removal using the Command Line Interface Note that the rpm command run with the -qa option will provide a list of installed packages. This may be used to determine the exact names of the currently installed GSKit packages. For example, rpm -qa | grep gsk Do the following: 1. Run the rpm command to remove the GSKit SSL package followed by the GSKit Crypt package. rpm -ev gskssl64-8.0.13.4 gskcrypt64-8.0.13.4 \ gskssl32-8.0.13.4 gskcrypt32-8.0.13.4 1.2.5) Linux for System z The installation must be performed as the user root. The -nodeps flag should not be used unless specifically called out in the instructions below. Installing with RPM command line tool Do the following: 1. Use the rpm command to perform the installation as follows: To install in the default location: /usr/local rpm -Uv gskcrypt64-8.0.13.4.linux.s390x.rpm rpm -Uv gskssl64-8.0.13.4.linux.s390x.rpm rpm -Uv gskcrypt31-8.0.13.4.linux.s390.rpm rpm -Uv gskssl31-8.0.13.4.linux.s390.rpm Removal using the Command Line Interface Note that the rpm command run with the -qa option will provide a list of installed packages. This may be used to determine the exact names of the currently installed GSKit packages. For example, rpm -qa | grep gsk Do the following: 1. Run the rpm command to remove the GSKit SSL package followed by the GSKit Crypt package. rpm -ev gskssl64-8.0.13.4 gskcrypt64-8.0.13.4 \ gskssl31-8.0.13.4 gskcrypt31-8.0.13.4 1.2.6) Windows The GSKit Crypt and SSL components are installed automatically. 1.3) Contents of the Installation Package. - This release includes the following files: README - This file. arswww.cgi - This is the Web Enablement Kit CGI program. 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. icudt44l.dat (Windows, Linux) icudt44b.dat (AIX, Sun, HPUX, Linux for System z) - This file should be left in the installation Locale directory. lib32/icudt44.dll (Windows 32bit) lib32/icuin44.dll (Windows 32bit) lib32/icuio44.dll (Windows 32bit) lib32/icuuc44.dll (Windows 32bit) lib32/icule44.dll (Windows 32bit) lib32/iculx44.dll (Windows 32bit) - These libraries are used for 32bit ICU support. On Windows, these files must be placed in the same directory as the arswww.cgi file. if using the JAVA Api's or servlet, thes files must be placed in a directory that is in the command search path defined by the Path environment variable. lib64/icudt44.dll (Windows 64bit) lib64/icuin44.dll (Windows 64bit) lib64/icuio44.dll (Windows 64bit) lib64/icuuc44.dll (Windows 64bit) lib64/icule44.dll (Windows 64bit) lib64/iculx44.dll (Windows 64bit) - These libraries are used for ICU support. When using the JAVA APIs on Windows, these files must be placed in a directory that is in the command search path defined by the Path environment variable. arsgsk32.dll (Windows 32bit) arsgsk64.dll (Windows 64bit) - These libraries are used for GSKit SSL support. On Windows, these files must be placed in the same directory as the arswww.cgi file. if using the JAVA Api's or servlet, thes files must be placed in a directory that is in the command search path defined by the Path environment variable. servlets/ArsWWWServlet.jar servlets/ArsSVTInterface.class arswwwsl32.dll (Windows) libarswwwsl32.a (AIX) libarswwwsl32.so (Sun, Linux) - 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) ars3wapi64.dll (Windows) libars3wapi32.a (AIX) libars3wapi64.a (AIX) libars3wapi32.so (Sun, Linux) libars3wapi64.so (Sun, Linux, HPUX, Linux for System z) - 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 (ActiveX) - All languages including DBCS support plugins/afpplgin.zip - IBM OnDemand AFP Web Viewer (ActiveX) - Zip format for all languages include DBCS support plugins/imgplgin.exe - IBM OnDemand Image Web Viewer (ActiveX) - All languages - These are self extracting files (InstallShield). These files should be downloaded to the user's Windows XP, Windows Vista, or Windows 7 system, and run to install the appropriate Web Viewer. If the user is running a browser while the installation is in progress, then the user must stop and restart the browser before the Web Viewer can be used. exporter/CFSODExporter.jar - Only for use with CFS-OD -------------end of Installation----------------------------------------------- 2) Web Enablement Kit Change History ------------------------------------------------------------------------------- 2.1) CGI/Servlet 2.1.8.5.0.0) Release (8.5.0.0) - Pre-reqs - AIX 5.3 or later - HP-UX V11i V3 or later - Sun Solaris V10 or later - Linux RedHat (RHEL) 5 Update 0 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 2008 or later - Java Runtime Environment 1.5 or higher 2.1.8.5.0.1) Release (8.5.0.1) APARs: PM26540 - ArsXenos MetaData Resources retrieval error on MP - Removed byte shifting code designed for System z PM28627 - CsvRestoreFoldernames can become blocked under load - Removed redundant code. PM29056 - Trailing BLANKS in CHAR fields exceed IEs limit of 2KB - Added code to strip trailing blanks in URLs. PM29084 - ODWEK CGI with IIS and POST METHOD causes hang - Changed the codepage to match the input data stream 2.1.8.5.0.2) Release (8.5.0.2) APARs: PM35688 - WEK CGI doc retrieve fails if FOLDER NAME has NLS char - Corrected character conversion for folder names PM40832 - Cross site scripting issues with _html (_h) _frame (_frm) - Corrected html tags for some parameters PM40324 - ARSWWW.CGI cmd lin encode/decode cause seg fault - Corrected message handling for -d and -e parameters 2.1.8.5.0.3) Release (8.5.0.3) 2.1.8.5.0.4) Release (8.5.0.4) APARs: PM46418 - AFP2PDF STANZA ISN'T BEING PROPERLY MATCHED - Corrected Application Identifier mapping PM46904 - AOIQS Cookie trace displays password in clear text - Removed trace statement PM48412 - When ODWEK invokes ext pgm, stdout/stderr not redirected - Added parameter to redirect stdout/stderr to /dev/null 2.1.8.5.0.5) Release (8.5.0.5) APARs: PM55119 - Cross-site scripting vulnerability 2.1.8.5.0.6) Release (8.5.0.6) 2.1.8.5.0.7) Release (8.5.0.7) 2.1.8.5.0.8) Release (8.5.0.8) APARs: PM88700 - Retrieve of line data fails when docid not supplied PM95624 - CGI Trace overrun under load (arstfmt error) 2.1.8.5.0.9) Release (8.5.0.9) APARs: PI11822 - ODWEK CGI generates error when _template=* PI14044 - DB2 SQL0104N Error when doing certain searches in OD Clients 2.1.8.5.0.10) Release (8.5.0.10) APARs: Other fixes: Servlet fails to init if Language is not ENU (Windows only) 2.1.8.5.0.11) Release (8.5.0.11) APARs: -------------end of CGI/Servlet------------------------------------------------ 2.2) AFP Web Viewer (32bit ActiveX) 2.2.8.5.0.0) Release (8.5.0.0) - Pre-reqs - Windows XP SP2 - Windows Vista (32bit or 64bit) - Windows 7 (32bit or 64bit) - Current version is AFP Web Viewer V3.5.5.1 2.2.8.5.0.1) Release (8.5.0.1) APARs: PM11861 - Resource/Font DataPaths not read from reg or ftdport2.ini - Updated the AFP Web Viewer to 3.5.5.2 2.2.8.5.0.2) Release (8.5.0.2) - Updated the AFP Web Viewer to 3.5.5.2 2.2.8.5.0.3) Release (8.5.0.3) Enhancements: - The AFP Web Viewer now supports Firefox 4 and 5 - Updated the AFP Web Viewer to 3.5.5.5 2.2.8.5.0.3) Release (8.5.0.3) 2.2.8.5.0.4) Release (8.5.0.4) Enhancements: - Updated the AFP Web Viewer to 3.5.5.6 2.2.8.5.0.5) Release (8.5.0.5) 2.2.8.5.0.6) Release (8.5.0.6) 2.2.8.5.0.7) Release (8.5.0.7) APARs: PM83248 - AFPLG LO SEG retrieve fails w/HTTPS after initial retrv 2.2.8.5.0.8) Release (8.5.0.8) 2.2.8.5.0.9) Release (8.5.0.9) Enhancements: - Updated the AFP Web Viewer to 3.06.00.13 2.2.8.5.0.10) Release (8.5.0.10) APARs: PI26711 - Retrieving LO segments fails if folder name contains NLS chars 2.2.8.5.0.11) Release (8.5.0.11) APARs: -------------end of AFP Plugin------------------------------------------------- 2.3) Image Web Viewer (32bit ActiveX) 2.3.8.5.0.0) Release (8.5.0.0) - Pre-reqs - Windows XP SP2 - Windows Vista (32bit or 64bit) - Windows 7 (32bit or 64bit) 2.3.8.5.0.1) Release (8.5.0.1) 2.3.8.5.0.2) Release (8.5.0.2) 2.3.8.5.0.3) Release (8.5.0.3) 2.3.8.5.0.4) Release (8.5.0.4) 2.3.8.5.0.5) Release (8.5.0.5) 2.3.8.5.0.6) Release (8.5.0.6) 2.3.8.5.0.7) Release (8.5.0.7) 2.3.8.5.0.8) Release (8.5.0.8) 2.3.8.5.0.9) Release (8.5.0.9) APARs: PM99058 - Printing from ImageViewer w/collate prints too many copies 2.3.8.5.0.10) Release (8.5.0.10) 2.3.8.5.0.11) Release (8.5.0.11) -------------end of Image Plugin----------------------------------------------- 2.4) Java Line Data Applet 2.4.8.5.0.0) Release (8.5.0.0) - Pre-reqs - Java 1.5 or later Enhancements: The Applet jar is now timestamped so they no longer expire. The Line Data Viewer Applet now supports Logical Views. Support was added for Local Print Options. Added support for Print Line Count. Added support for Color selection. Improvements to Control Labeling, Tool Tip Text, and status bar. Simpified controls for ease of use. Improved accessibility to allow navigation without a mouse, screen reader support, and system color schemes and fonts. 2.4.8.5.0.1) Release (8.5.0.1) 2.4.8.5.0.2) Release (8.5.0.2) APARs: PM35810 - LDV FIND hangs/fails when search string has '*F' or 'F*' - Changed search to escape certain characters in strings PM41531 - Retr line data via applet throws an Unable to retrieve doc err - Changed Applet to check for view note authorization 2.4.8.5.0.3) Release (8.5.0.3) 2.4.8.5.0.4) Release (8.5.0.4) APARs: PM42631 - LDV applet print output not matching OD Client - Corrected the vertical offset calculation 2.4.8.5.0.5) Release (8.5.0.5) APARs: PM50479 - ARABIC chars incorrectly displayed 2.4.8.5.0.6) Release (8.5.0.6) APARs: PM70183 - [blank] print output when printing FIND ALL results 2.4.8.5.0.7) Release (8.5.0.7) APARs: PM75208 - JLDV displays [blank] LINE data that has TRC PM79918 - JLDV Horizontal scrollbar disappears after resize PM80127 - JLDV data files over 10MB fail to load PM80215 - JLDV FIND ALL 'results' does not allow focus to main doc PM82462 - Mouse wheel actions occurring twice 2.4.8.5.0.8) Release (8.5.0.8) APARs: PM91915 - Mouse click on line data doc not registering PM95134 - Cannot scroll past page 214748 [page num become negative] 2.4.8.5.0.9) Release (8.5.0.9) APARs: PM96717 - COPY DOC PGS TO FILE very slow when doc w/alot of lines 2.4.8.5.0.10) Release (8.5.0.10) APARs: PI16781 - 8.5 JLDV PRINT dialog in 'find' behaves diff from 8.4.1 PI16988 - Slow performance in displaying PRINT dialog PI17008 - LDV FIND from page 2 goes into an infinite loop 2.4.8.5.0.11) Release (8.5.0.11) APARs: -------------end of Java Line Data Applet-------------------------------------- 2.5) Java AFP2HTML Applet 2.5.8.5.0.0) Release (8.5.0.0) - Pre-reqs - Java 1.5 or later Enhancements: The Applet jar is now timestamped so they no longer expire. 2.5.8.5.0.1) Release (8.5.0.1) 2.5.8.5.0.2) Release (8.5.0.2) 2.5.8.5.0.3) Release (8.5.0.3) 2.5.8.5.0.4) Release (8.5.0.4) 2.5.8.5.0.5) Release (8.5.0.5) 2.5.8.5.0.6) Release (8.5.0.6) 2.5.8.5.0.7) Release (8.5.0.7) 2.5.8.5.0.8) Release (8.5.0.8) 2.5.8.5.0.9) Release (8.5.0.9) 2.5.8.5.0.10) Release (8.5.0.10) 2.5.8.5.0.11) Release (8.5.0.11) -------------end of Java AFP2HTML Applet--------------------------------------- 2.6) Java API 2.6.8.5.0.0) Release (8.5.0.0) - Pre-reqs - Java 1.5 or later - AIX 5.3 or later - HP-UX V11i V3 or later - Sun Solaris V10 or later - Linux RedHat (RHEL) 5 Update 0 or later - Linux SUSE (SLES) 10 or later - Linux on System z RedHat (RHEL) 5 Update 0 or later - Linux on System z SUSE (SLES) 10 or later - Windows 2008 or later (32bit and 64bit) Enhancements: - New Generic Transform Interface supports both EXE and JAVA based implementations via XML configuration. See the White Paper "OnDemand Web Enablement Kit Java API Generic Transform Interface" for more details. - Added SSL support for OnDemand Server/Client communication. The Java APIs use the IBM Global Security Kit for SSL support. - New trace engine to increase performance with Trace enabled and provide higher level of trace detail. - Multiple Language Folder Field support. - Added multiple APIs to increase availability of document details including PageCount, DocSize, Doc codepage, Page Rotation and etc.. APARs: PM20689 - DATE search string >128 chars can cause unexpected results - Corrected character string lengths For Customers running WEBi: - Some ODWEK files will need to be relocated or updated for compatability with WEBi. 1.) Administrators will need to manually update the LineDataViewer and AFP2HTML Applet files by copying the 3 applet files (ODAfp2Html2.jar, ODLineDataViewer2.jar, IEFix.js) from the ODWEK Install directory to the WEBi install directory under WebSphere. Typically, /installedApps//wcappservices.ear/wcodservices.war/applets) The WebServer will then need to be restarted. 2.) On Windows, You will need to copy the 32 bit ICU library files from the C:\Program Files\IBM\OnDemand Web Enablement Kit\lib32 directory into the base ODWEK install path. Typically, C:\Program Files\IBM\OnDemand Web Enablement Kit 2.6.8.5.0.1) Release (8.5.0.1) APARs: PM26540 - ArsXenos MetaData Resources retrieval error on MP - Removed byte shifting code designed for System z PM28627 - CsvRestoreFoldernames can become blocked under load - Removed redundant code. PM29056 - Trailing BLANKS in CHAR fields exceed IEs limit of 2KB - Added code to strip trailing blanks in URLs. 2.6.8.5.0.2) Release (8.5.0.2) APARs: PM32902 - ODHit.updateValuesForHit() fails - Changed restore hit use database values for ApplID fields PM38146 - ODHit.getDocument to orphan doc crashes intermittently - Changed code to allow for missing documents 2.6.8.5.0.3) Release (8.5.0.3) 2.6.8.5.0.4) Release (8.5.0.4) APARs: PM53890 - ADDHOLD() THROWS NULLPOINTEREXCEPTION - Changed algorithm to initialize values PM54917 - xmlParse not propogating exceptions - Changed Parsing API to return exceptions 2.6.8.5.0.5) Release (8.5.0.5) APARs: PM56870 - Retrieve JAVA API hangs if resource is missing PM61064 - Extra space in the afp2pdf command causes the options file parameter (-i) to be ignored when ODWEK transforms AFP2PDF on Unix Systems. 2.6.8.5.0.6) Release (8.5.0.6) APARs: PM61076 - Dup notes returned when getNotes is called twice PM63546 - Large search stmt causes crash in ODFolder.search() PM63665 - invalid session pointer crashes 64-bit ODWEK lib on WINDOWS PM63825 - Doc store w/no FLDR fld mapped to AG seg fld, LOADDATE=0 2.6.8.5.0.7) Release (8.5.0.7) APARs: PM79267 - Prevent stg of 0 byte doc using ODHit.storeDocument PM80161 - ODWEK after expired password reset user appears not logged on PM80287 - getStoreDocFields returns cached copy of the fields PM86977 - ODWEK may CRASH w/APIP_SETFORCEDRETURN native call 2.6.8.5.0.8) Release (8.5.0.8) APARs: PM86977 - ODWEK may CRASH w/APIP_SETFORCEDRETURN native call PM94825 - Adding an annotation with an empty string causes a crash 2.6.8.5.0.9) Release (8.5.0.9) APARs: PM97347 - DeleteNamedQuery fails, if getNamedQuery/QueryNames not called 1st PM99399 - ODWEK memory leak doing LDVA FIND ALL PI06370 - Terminating Null [x00] added to linedata output stream PI08013 - ODFolder.storeDocument() crashes w/field value uninit - LINUX PI08359 - If APPLET_SERVER_SEARCH=TRUE, 'SEARCH ALL' fails w/exception PI14044 - DB2 SQL0104N Error when doing certain searches in OD Clients 2.6.8.5.0.10) Release (8.5.0.10) APARs: PI18093 - ODWEK retrieve of LO Line [>100 pages] generates RC: 2155 PI20617 - Sudden OD Server disconnect issue with doc data buffer cleanup PI23008 - ODServer.getUser() returns null if OD security exit is ON PI27857 - ODFolder.getApplNames() lists all APPs in FLFD not just selected APPs PI35565 - ODFolder.getApplNames() returns null if Application Group has already been retrieved Other Fixes: - Removed a function that strips encoding chars from the docid - Incomplete message returned when adding a document with an unsupported datatype - ODHit.getDocLocation intermittently returns the wrong value 2.6.8.5.0.11) Release (8.5.0.11) APARs: PI36692 - Buffer cleanup issue when AFP resource retrieve interrupted PI49875 - Memleak in ODHit.getResources when cancel called before retrieve completes -------------end of Java API--------------------------------------------------- 2.7) CFSOD Exporter 2.7.8.5.0.0) Release (8.5.0.0) - Pre-reqs - Java 1.5 or later - AIX 5.3 or later - HP-UX V11i V3 or later - Sun Solaris V10 or later - Linux RedHat (RHEL) 5 Update 0 or later - Linux SUSE (SLES) 10 or later - Linux on System z RedHat (RHEL) 5 Update 0 or later - Linux on System z SUSE (SLES) 10 or later - Windows 2008 or later (32bit and 64bit) 2.7.8.5.0.1) Release (8.5.0.1) 2.7.8.5.0.2) Release (8.5.0.2) 2.7.8.5.0.3) Release (8.5.0.3) 2.7.8.5.0.4) Release (8.5.0.4) 2.7.8.5.0.5) Release (8.5.0.5) 2.7.8.5.0.6) Release (8.5.0.6) 2.7.8.5.0.7) Release (8.5.0.7) 2.7.8.5.0.8) Release (8.5.0.8) 2.7.8.5.0.9) Release (8.5.0.9) APARs: PJ41637 - EXPORTER LOGGING DOES NOT HANDLE LARGE LOG FILES PROPERLY 2.7.8.5.0.10) Release (8.5.0.10) 2.7.8.5.0.11) Release (8.5.0.11) ----------------end of Web Enablement Kit Change History----------------------- 3) OnDemand Testing ------------------------------------------------------------------------------- 3.1) Currency Testing ------------------------------------------------------------------------------- OnDemand Web Enablement Kit has been currency tested with: AIX 6.1 AIX 7.1 Linux SUSE Enterprise Server 11 Linux RedHat Enterprise Server 6 Windows 8.1 IE 10.0, 11.0 Firefox 27 Google Chrome 33 -------------end of Currency Testing------------------------------------------- 3.2) Testing Environments ------------------------------------------------------------------------------- Content Manager OnDemand for Multiplatforms Web Enablement Kit is tested on 9 different platforms. The following is a list of the environments in which IBM tested the latest fix pack. JVM: Java 1.5 (32 and 64 bit) AIX: AIX 5.3 HP-UX Itanium: HP-UX V11i v3 Sun: Sun Solaris V10 Windows: Windows - 2008, XP SP2, Vista, and Windows 7 (32bit and 64bit) Linux: RedHat - Linux RedHat (RHEL) 5 U0 SuSE - Linux SUSE (SLES) 10 Linux on System z: RedHat - Linux RedHat (RHEL) release 5 U0 SuSE - Linux SUSE (SLES) 10 -----------------end of OnDemand Testing Environment--------------------------- -----------------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 1248667 When printing line data, the text appears to be shrunken versus how the document views in the viewer 1392275 Compatibility matrix for the Content Manager OnDemand clients and servers 1440786 Collecting data for display problems in Content Manager OnDemand Web Enablement Kit with the AFP Web Viewer Plug-In 1461325 OnDemand Line Data Viewer Applet Find string not populated with previous value with multiple documents open 1469028 After installing ODWEK v8.5.0, I receive an error when running the ODWEK CGI or Servlet 1470716 What is the largest sized line data document that can be viewed by the OnDemand Line Data Applet Viewer? 1497464 Instructions on how to map AFP fonts for the AFP Web Viewer are in the Windows Client Customization Guide 1502422 Does ODWEK trace support writing to a Windows mapped network drive? 1512339 Attempting to run an ODWEK Java API application results in the following error "a prerequisite shared library may be missing" 1596366 How do I resolve java.lang.UnsatisfiedLinkError, java.lang.NoClassDefFoundError, or GSKit errors when deploying an ODWEK Java API application? 1612054 Installing or upgrading the Content Manager OnDemand server, features, or ODWEK on AIX completes, but with errors occur 1637482 The argument '_docid' was not specified ExtId=2171 error after upgrading ODWek to 8.5.0.6 1646185 Unable to highlight text and display the pop-up menu in the Content Manager OnDemand line data viewer applet 1645825 A blank document or error "Could not init document. Parameters were null" is displayed in the Content Manager OnDemand Line Data Viewer Applet 1647961 Documents cannot be displayed in an OnDemand web plugin such as AFP web plugin when opened in Internet Explorer 1657713 ODWEK receives reason code 997 after 8.5.0.6 to 8.5.0.8 upgrade 1659716 Security Bulletin: CM OnDemand GSKit Vulnerability (CVE-2013-6329) 1657158 ODServer.xmlParse core dumps on Solaris with Java 1.5 1660454 Warning messages using Oracle Java 7 Update 25 and newer with the Content Manager OnDemand Line Data Viewer Applet 1666114 ODWEK CGI and Servlet cookies always encrypted 1683348 Possible retrieval of wrong document from CMOD when OnDemand Object Server becomes unavailable in the middle of a retrieval transaction and the user application ignores this connection error. This can occur on any of the supported CMOD products. 1693181 Security Bulletin: TLS padding vulnerability affects Content Manager OnDemand for Multiplatforms (CVE-2014-8730) -----------------end of Reference----------------------------------------------