IBM Content Management e-client -- ReadMe

IBM^(R) Content Management e-client ReadMe

Version 7.1.3.0
Modified July 2002

   Introduction
   Installing the e-client
   Updating the e-client with this CSD
   Updates, known problems and workarounds
   Corrections to documentation
   Other sources of information
   Notices

Introduction

Welcome to IBM Content Management e-client Readme file. This file contains the latest information about installing the e-client and updates and known problems with workarounds for using the e-client.

How to get more information

For the latest information on the CM e-client and on installing the e-client, see the product Web pages:
www.ibm.com/software/data/eip

Installation information is available in the e-client Installation Information online from the first pages of the install program. To start the install, open setup.html on this CD in your browser.

This section contains updates to the installation information found in the online e-client Installation Information and in the Installing section of the online documentation for the e-client, IBM Content Management e-client Information.

Please note the following concerning installation:

If you are using WebSphere Application Server, it must be running when you install the e-client. To determine that WebSphere is running, check that IBM WS AdminServer is running in your Windows Services.
You must give the installation program permission to run its applet. Grant permission when the Security warning screens are displayed.
Installation requires a Java^(tm) Virtual Machine (JRE) to run.
When the installation program asks about Java Virtual Machines (JRE), we recommend that you have the program search your system and use an existing virtual machine. Select the search for existing Virtual Machines button and click on OK.
When the list of Virtual Machines is displayed, choose one to use. The list shows all the compatible JREs found, so you can choose any of them.
Be sure to install the Enterprise Information Portal connectors for all types of content servers you want to access. Only servers for which you have installed the EIP connectors can be shown in the servers list on the logon page.
For Japanese, Korean, Simplified Chinese, and Traditional Chinese, Java Runtime (JRE) 1.1.8 International is required to install e-client.
You can obtain the internationalized version of JRE 1.1.8 from:
http://java.sun.com/products/jdk/1.1/jre/download-jre-windows.html
At the bottom of this page, select the option to download the internationalized version of Java Runtime Environment.
The Help button in the Java security window may not work on some browsers.
The Browser button on the InstallShield Wizard page for searching for a Java Virtual Machine may not work. To search for Virtual Machines, select the "I want to search my system..." radio button and click on OK.
Before uninstalling, copy the file idmwas.clean.xml from the ...\CMeclient\save directory to a local directory and modify it as described in the e-client online document.
After installing the e-client, if your Enterprise Information Portal administration database is not local, you must modify the settings in the IDM.properties files. See the online e-client Information on managing the e-client for information on setting the configuration in IDM.properties.
To start the e-client, open your browser and enter the following URL in the location or address bar:
http://host name/Web app name/IDMInit
where host name is the name of your WebSphere server and Web app name is the name of the e-client Web application. The default Web application name is e-client.

Installing this CSD

This installation contains updates to the GA version of e-client 7.1.2. This CSD also includes the fixes needed to support the IBM Content Connector for Panagon Image Services using the EIP administration database. The specific APARs and defects addressed in this CSD addresses are listed below.

The installation (setup.html) installs over an exisiting copy of eClient or in a new directory (new installation). If you are installing over an exisiting copy of the e-client, be aware of 2 things:

You must modify IDM.properties and IDMadminDefaults.properties after installation. Your current copies of these files were copied to #IDM.properties and #IDMadminDefaults.properties respectively.
To restore your current settings, copy #IDM.properties to IDM.properties and #IDMadminDefaults.properties to IDMadminDefaults.properties after installing the CSD.
If you have altered any JSP files of the e-client, you must save them before installing the CSD; if not, they will be overwritten during the install process.

APARs contained in this CSD:

IR45940 - select/deselect from the hitlist does not always check/uncheck each item in the list.
IR45943 - Toolbar on the viewer window does not always show up.
IR46045 - Search on a Federated template item fails when a blank is in the search value.
IR45101 - Print the current page prints the 1st page of the document
IR46211 - Folder name does not show up on the hitlist when the folder is open. It just says "Folder"

Updates, known problems and workarounds

Major Installation Issue: There is a known problem in EIP dealing with long filenames that affects the e-client if it is installed using the default directory: ...\Program Files\. During image manipulation on the mid-tier server, EIP will use the directory set by the IDM.propertieskey word WorkingDir as a location to place a temporary file. The default value set during installation is the install directory\Working. If there is a space in the install directory name, for example, "Program Files", then EIP fails on some document transforms and the selected document are not be shown on the user's browser. There are 2 work arounds for this problem:

Override the default installation directory name to use a simple name; for example, change the installation path from C:\Program Files\e-client to C:\eclient
Change the path in the WorkingDir keyword in the IDMproperties file to a simple path; for example, change WorkingDir=C:\Program Files\Working to C:\Temp

Some points to understand with the e-client:

Do not use your browser's Back button when using the e-client. Use the buttons and links in the e-client to move forward or return to a previous page.
A batch file, IDMWAS.BAT, is created during installation, that you can use to run the WebSphere XML configuration. It is in the same directory as the XML configuration files.
You must define IBM Content Manager OnDemand and IBM Content Manager ImagePlus for OS/390 servers in the IDM.properties file. Refer to the online e-client information for defining connections for these servers.
When you make changes to the IDM.properties file for logging or trace, you must stop and restart the e-client Web app server for the changes to take effect.

Corrections to documentation

Please note the following updates to the online e-client information:

In the installation instructions, step 2 should read:
Open setup.html on the CD in your browser and select your language.

Other sources of information

For more information on IBM Content Management e-client, see:
www.ibm.com/software/data/eip

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
J74/G4
555 Bailey Avenue
P.O. Box 49023
San Jose, CA 95161-9023
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

Trademarks

The following terms are trademarks of the IBM Corporation in the United States or other countries or both:

IBM ImagePlusM
DB2 DB2 Universal Database
WebSphere OS/390

Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both.

Java, JavaServer Pages, JavaBeans, JSP, and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product or service names may be trademarks or service marks of others.

IBM(R) Content Management e-client ReadMe

Contents