################################################################################ # IBM Content Manager OnDemand Web Enablement Kit # # AIX, HP-UX, Linux, Sun Solaris, Windows # # README # # Release 7.1.1.2 # # June 21, 2004 # # # # 5697-G34 (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.1.0 Release (7.1.1.0) 3.1.7.1.1.1 Release (7.1.1.1) 3.1.7.1.1.2 Release (7.1.1.2) 3.2 AFP Web Viewer (Plugin/ActiveX) 3.2.7.1.1.0 Release (7.1.1.0) 3.2.7.1.1.1 Release (7.1.1.1) 3.2.7.1.1.2 Release (7.1.1.2) 3.3 Image Web Viewer (Plugin/ActiveX) 3.3.7.1.1.0 Release (7.1.1.0) 3.3.7.1.1.1 Release (7.1.1.1) 3.3.7.1.1.2 Release (7.1.1.2) 3.4 Java Line Data Applet 3.4.7.1.1.0 Release (7.1.1.0) 3.4.7.1.1.1 Release (7.1.1.1) 3.4.7.1.1.2 Release (7.1.1.2) 3.5 Java AFP2HTML Applet 3.5.7.1.1.0 Release (7.1.1.0) 3.5.7.1.1.1 Release (7.1.1.1) 3.5.7.1.1.2 Release (7.1.1.2) 3.6 Java API 3.6.7.1.1.0 Release (7.1.1.0) 3.6.7.1.1.1 Release (7.1.1.1) 3.6.7.1.1.2 Release (7.1.1.2) 4. Testing Environment 5. Reference ================================================================================ 2. Installation 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 ARSWWW_CACHE_DIR directive in the arswww.cfg 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) - This file should be left in the installation directory. arsct32.dll (Windows) icudt26l.dat (Windows, Linux) icudt26b.dat (AIX, SunOS, HPUX) icudt26l.dll (Windows) libicudata.so (AIX, SunOS, Linux) libicudata.sl (HPUX) icuin26.dll (Windows) libicui18n.so (AIX, SunOS, Linux) libicui18n.sl (HPUX) icuuc.dll (Windows) libicuuc.so (AIX, SunOS, Linux) libicuuc.sl (HPUX) - These files must be placed in the same directory as the arswww.cgi file on Windows or /opt/ondemand/lib must be added to LD_LIBRARY_PATH environment variable on Linux. These libraries are used for ICU support. ArsWWWServlet.jar ArsWWWInterface.class arswwwsl.dll (NT) libarswwwsl.a (AIX) libarswwwsl.so (SunOS) 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 ARSWWW_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.1.0 Release (7.1.1.0) - Pre-reqs - AIX 5.1 or Later - HP-UX 11.0 or later - Linux Kernal 2.4.19 or Later - Sun Solaris 8 or later (SPARC only) - Windows 2000 or later - Added several enhancements for performance and stability - Corrected the name for Xenos JS executable on UNIX Platforms 3.1.7.1.1.1 Release (7.1.1.1) - Corrected problems viewing notes - Corrected problems with Private to Group Note permissions - Corrected problems running in a Clustered Environment - Enhanced Xenos logging to retain temporary files 3.1.7.1.1.2 Release (7.1.1.2) - Corrected problems viewing Line Data that caused memory faults - Added a new arswww.ini paramter Update Timestamp to prevent multiple Logins in low cache environments - Corrected rendering of Blank lines that produced duplicates --------------end of CGI/Servlet------------------------------------------------ 3.2 AFP Web Viewer (Plugin/ActiveX) 3.2.7.1.1.0 Release (7.1.1.0) - Version 2.0.7.1 - Pre-reqs - Windows XP - Windows 2000 or later - Corrected problems with Text Selection 3.2.7.1.1.1 Release (7.1.1.1) 3.2.7.1.1.2 Release (7.1.1.2) - Corrected problems with the status bar using IE Frames - Corrected window refresh and paint problems - Corrected Problems viewing AFP Documents with large numbers of pages --------------end of AFP Plugin------------------------------------------------- 3.3 Image Web Viewer (Plugin/ActiveX) 3.3.7.1.1.0 Release (7.1.1.0) - Pre-reqs - Windows XP - Windows 2000 or later 3.3.7.1.1.1 Release (7.1.1.1) 3.3.7.1.1.2 Release (7.1.1.2) --------------end of Image Plugin----------------------------------------------- 3.4 Java Line Data Applet 3.4.7.1.1.0 Release (7.1.1.0) - Update the applet to save orientation settings - Updated applet certificates - Updated applet to support Print Preview and Fit To Width 3.4.7.1.1.1 Release (7.1.1.1) - Corrected problems viewing Thai data - Made changes to support Mac OS X - Added the ability to set applet version for different browsers 3.4.7.1.1.2 Release (7.1.1.2) - Corrected a problem copying pages to file when the document has a blank page - Corrected problems with the horizontal scroll bar - Corrected problems printing documents with invalid page ranges - Corrected truncation problems when printing landscape documents - Corrected problems printing in Traditional Chinese environment --------------end of Java Line Data Applet-------------------------------------- 3.5 Java AFP2HTML Applet 3.5.7.1.1.0 Release (7.1.1.0) - Fixed viewing of AFP with upside down characters - Updated applet certificates 3.5.7.1.1.1 Release (7.1.1.1) - Added the ability to set applet version for different browsers --------------end of Java AFP2HTML Applet--------------------------------------- 3.6 Java API 3.6.7.1.1.0 Release (7.1.1.0) - Added several enhancements for performance and stability 3.6.7.1.1.1 Release (7.1.1.1) - Added error handling for decompression problems - Corrected problems with return values from ODFolder.getNumApplGroups - Enhanced Xenos logging to retain temporary files - Added a new method ODFolder.recreateHit - Corrected ODServer.retrieve to handle special characters 3.6.7.1.1.2 Release (7.1.1.2) - Corrected ODServer.viewpassthru exception handling ---------------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 - 2.4.19 ------------------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 1154614 Copying and sending SCS data from the OnDemand client for Windows 1154986 OnDemand for Multiplatforms Version 7.1.1: Installing the information center 1155436 Automatically Starting the ARSRD program 1155460 Utilizing an OnDemand server printer definition in Report Distribution 1155471 Double byte character set fonts required for Adobe PDF Distributions 1162698 Allow Logging of Xenos Transforms 1168766 ODWEK Applet Version - Browser Specific and Automatic detection ------------------end of Reference----------------------------------------------