********************************************************************
(c) Copyright 2008, 2011 International Business Machines Corp.
    All rights reserved.
********************************************************************

Welcome to IBM® Tivoli Composite Application Manager for WebSphere® Application Server Version 7.2

License terms and conditions

The relevant terms and conditions, notices, and other information are provided in the country-specific license agreement files on the installation image for this component. Any non-English version of the license information is unofficial and is provided to you for your convenience only. The English version of the license files is the official version. Other licensing information and third-party notices appear in the copyright.txt, non_IBM_license.txt, and notices.txt files on the installation image for this component.

Accessing non-web documentation

The following non-web documentation is available:

Readme file
This file, the readme.html file, provides information that includes links to the procedures for installing and using the component. This document is not translated.
Help files
The help files provide detailed instructions for completing tasks and specifying settings in the graphical systems management tools. Access the help files by using the help menus, links, or buttons provided in the tool interfaces.

Accessing the most current web-based documentation for Version 7.2

The most current documentation is in the IBM Tivoli Composite Application Manager for Application Diagnostics Information Center.

Accessing the web-based installation documentation for Version 7.2

The documentation for installation is in the Installation Guide in the IBM Tivoli Composite Application Manager for Application Diagnostics Information Center.

Last-minute updates, limitations, and known problems for Version 7.2

  1. Known Issue: ITCAM for WAS V7.2 does not support configuration for application servers with a space character " " in the server name.
  2. Known Issue: The user can only select one server during the configuration process. Similarly, only one server can be specified for silent configuration parameter: APP_SERVER_NAMES
  3. Known Issue: z/OS configuration prompts are unclear. The z/OS configuration script (setupdc.sh) issues the following prompt:
    Do you wish to remove and recreate the runtime directory? (y|n):
    Additionally, the help for the cleanup option in both the setup and the unconfig.sh scripts, refers to a “runtime” directory. The runtime directory referenced is the runtime for an application server instance, for example:
    /runtime/was80.tvt7006.b8sr00a.
    Replying "Y" to this prompt will attempt to remove and remake was80.tvt7006.b8sr00a, not the entire directory called "runtime".
  4. Known Issue: Runtime application server directory not deleted when the cleanup option is used when the application server is running. In the script that unconfigures the z/OS data collector, if the argument "-cleanup" is supplied, ITCAM attempts to delete the configuration’s runtime directory, for example:
    /runtime/was80.tvt7006.b8sr00a.
    If the application server is running at that time, deleting all the log files may not be possible, leaving the runtime logs directory and the log files that could not be deleted, for example:
    /runtime/was80.tvt7006.b8sr00a//logs/CYN/logs.
  5. Known Issue: After enabling the z/OS Data Collector to connect to the Managing Server with Transaction Tracking (TTAPI), the following error message is found in the Data Collector log and the WebSphere server cannot be seen in the deep dive UI:
    Data Collector log ERROR message [java.lang.ExceptionInInitializerError at java.lang.J9VMInternals.initialize(J9VMInternals.java:227)
    Cause: The ITCAM for Transactions native library for transaction Tracking (TTAPI) installed on the z/OS machine does not match the level required by ITCAM for WebSphere Application Server V7.2.
    Solution: If you don't need integration with Transaction Tracking (TTAPI), you can disable this feature and restart the WebSphere server. Otherwise, you need to install the most recent copy of the ITCAM for Transactions native library for TTAPI on z/OS .

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. For a current list of IBM trademarks, visit the IBM Copyright and trademark information website.

For trademark attribution statements, visit the IBM Terms of use website.