################################################################################ # IBM Content Manager OnDemand Web Enablement Kit # # AIX, HP-UX, Linux, Sun Solaris, Windows # # README # # Release 7.1.2.1 # # Dec. 20, 2004 # # # # 5724-J33 (C) COPYRIGHT IBM CORPORATION 2004 # # 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. Contents 2. Installation 3. Web Enablement Kit Change History 3.1 CGI/Servlet 3.1.7.1.2.0 Release (7.1.2.0) 3.1.7.1.2.1 Release (7.1.2.1) 3.2 AFP Web Viewer (Plugin/ActiveX) 3.2.7.1.2.0 Release (7.1.2.0) 3.2.7.1.2.1 Release (7.1.2.1) 3.3 Image Web Viewer (Plugin/ActiveX) 3.3.7.1.2.0 Release (7.1.2.0) 3.3.7.1.2.1 Release (7.1.2.1) 3.4 Java Line Data Applet 3.4.7.1.2.0 Release (7.1.2.0) 3.4.7.1.2.1 Release (7.1.2.1) 3.5 Java AFP2HTML Applet 3.5.7.1.2.0 Release (7.1.2.0) 3.5.7.1.2.1 Release (7.1.2.1) 3.6 Java API 3.6.7.1.2.0 Release (7.1.2.0) 3.6.7.1.2.1 Release (7.1.2.1) 4. Testing Environment 5. Reference ================================================================================ NOTE: Support for Solaris will be released at a later date. ================================================================================ 2. Installation - Unix installs are now packaged with InstallShield MP. The native installs using SMIT, swinstall, pkgadd, or RPM are no longer supported - Pre-reqs - for PTF 7.1.2.0 - Previous install of OnDemand Web Enablement Kit V7.1.1 - for all subsequent 7.1.2.x PTFs - Previous install of OnDemand Web Enablement Kit V7.1.2 - Java Runtime Environment 1.4.1 or higher - rpm and rpm-build package for Linux - To install from the command line - odwekaix -console - odwekhp -console - odweksun -console - odweklinux -console - odwekwin.exe -console - Please read the Installation Documentation in the CMODDoc.zip package for further information Before using the latest version of the Web Enablement Kit, you must delete all of the files from the Web Enablement Kit cache directory. The directory is specified by the CACHEDIR directive in the arswww.ini file. 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. arsscknt.dll (Windows) arssck32.dll (Windows) arsct32.dll (Windows) - This file should be left in the installation directory. icudt30l.dat (Windows, Linux) icudt30b.dat (AIX, SunOS, HPUX) - This file should be left in the installation Locale directory. icudt30.dll (Windows) libicudata30.a (AIX) libicudata30.so (SunOS, Linux) libicudata30.sl (HPUX) icuin30.dll (Windows) libicui18n30.a (AIX) libicui18n30.so (SunOS, Linux) libicui18n30.sl (HPUX) icuuc30.dll (Windows) libicuuc30.a (AIX) libicuuc30.so (SunOS, Linux) libicuuc30.sl (HPUX) - 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 ArsWWWInterface.class arswwwsl.dll (NT) libarswwwsl.a (AIX) libarswwwsl.so (SunOS,Linux) libarswwwsl.sl (HPUX) - Servlet support files. ArsWWWServlet.jar should be placed into the web server's servlet directory. Because the servlet uses JNI, you may have to put ArsWWWInterface.class and the shared library file into into a directory other than the web server's servlet directory. This is due to class loader issues. See the documentation for more information. ODApi.jar - Java api. See the documentation for more information on how write applications using the api's. ODApiDoc.zip - Java api documentation. Unzip this file and view index.html with your browser. 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 Java API jar file api/ODApiDoc.zip - This is the OnDemand Java API Documentation locale/arscpcs.cfg - This file contains the code page to code set mappings. This file should stay in the installation directory. locale/uconvtab/* - These files are the iconv conversion tables. They 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/ODLineDataViewer.jar - IBM OnDemand Line Data Viewer applet. applets/ODLineDataViewer2.jar - IBM OnDemand Line Data Viewer applet for Java Runtime 1.4. applets/ODLineDataViewer.cab - IBM OnDemand Line Data Viewer applet. - These applet files are used when enabling the java line data viewer applet. (See the documentation for more information). applets/ODAfp2Html.jar - IBM OnDemand AFP Transform applet. applets/ODAfp2Html.cab - IBM OnDemand AFP Transform applet. - These applet files are used when enabling the java AFP2HTML viewer applet. (See the documentation for more information). plugins/afpplgus.exe - IBM OnDemand AFP Web Viewer (Plugin/ActiveX) - English only 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 98, Windows NT, Windows XP, or Windows 2000 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. --------------end of Installation----------------------------------------------- 3. Web Enablement Kit Change History -------------------------------------------------------------------------------- 3.1 CGI/Servlet 3.1.7.1.2.0 Release (7.1.2.0) - Pre-reqs - AIX 5.1 or Later - HP-UX 11.0 or later - Linux Kernal 2.4.21 or Later - Sun Solaris 8 or later (SPARC only) - Windows 2000 or later - Java Runtime Environment 1.4.1 or higher 3.1.7.1.2.1 Release (7.1.2.1) - Removed Operating System prereq check on Sun. - Corrected problems adding Notes from the Applets or hitlist --------------end of CGI/Servlet------------------------------------------------ 3.2 AFP Web Viewer (Plugin/ActiveX) 3.2.7.1.2.0 Release (7.1.2.0) - Version 2.0.7.1 - Pre-reqs - Windows XP - Windows 2000 or later 3.2.7.1.2.1 Release (7.1.2.1) - Updated AFP Viewer to Version 2.7.1.3 - Corrected a problem viewing shaded boxes --------------end of AFP Plugin------------------------------------------------- 3.3 Image Web Viewer (Plugin/ActiveX) 3.3.7.1.2.0 Release (7.1.2.0) - Pre-reqs - Windows XP - Windows 2000 or later - Updated the Pixtrans support for Image Viewing 3.3.7.1.2.1 Release (7.1.2.1) --------------end of Image Plugin----------------------------------------------- 3.4 Java Line Data Applet 3.4.7.1.2.0 Release (7.1.2.0) - Pre-reqs - Java 1.4.1 or later 3.4.7.1.2.1 Release (7.1.2.1) --------------end of Java Line Data Applet-------------------------------------- 3.5 Java AFP2HTML Applet 3.5.7.1.2.0 Release (7.1.2.0) - Pre-reqs - Java 1.4.1 or later 3.5.7.1.2.1 Release (7.1.2.1) --------------end of Java AFP2HTML Applet--------------------------------------- 3.6 Java API 3.6.7.1.2.0 Release (7.1.2.0) 3.6.7.1.2.1 Release (7.1.2.1) - Corrected problems retrieving Large Objects from V2 Servers - Corrected problem with the StoreDoc API not closing files - Corrected a problem with the GetServer API - Corrected problems with the ODHit.addNote API when using special characters in the note. ---------------end of Web Enablement Kit Change History------------------------- 4. OnDemand Testing Environment -------------------------------------------------------------------------------- This following is a list of the environments in which IBM tested the latest Release/PTF. AIX: AIX - 5.1 HP-UX: HP-UX - 11.0 SunOS: SunOS - 5.8 Windows: Windows - 2000, 2003 Linux: RedHat - RHES release 3 Kernel 2.4.21-15 SuSE - SLES 8 Kernel 2.4.21-138 zLinux: RedHat - RHES release 3 Kernel 2.4.21-20 SuSE - SLES 8 Kernel 2.4.21-83 ------------------end of OnDemand Testing Environment--------------------------- 5. Reference -------------------------------------------------------------------------------- You can find information updates by searching the Web Based Technical Support web site at www.ibm.com/support. You can find the following additional documents by entering the document # or title in the search field: Document # Document title 7004520 Migrating from previous releases 1190968 Unable to install CM OD ODWEK or Server 7.1.2 on Sun Solaris 1190663 National language support in IBM® DB2® Content Manager OnDemand for Multiplatforms, Version 8.3 ------------------end of Reference----------------------------------------------