IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Environment Checking Utility

The Environment Checking Utility (ECU) is a stand-alone tool. You can use this utility to check the prerequisite packages before launching the ITCAM Agent for WebSphere Applications installer, ITCAM Agent for WebSphere Applications configuration, or Managing Server installer. envcheck.sh generates a report to specify if the prerequisite packages have been installed correctly. The prerequisite packages are registered in a property file. The property file can be extended if new prerequisite packages or libraries are required.

To get the Environment Checking Utility, use IBM Passport Advantage. Search for the IBM Tivoli Composite Application Manager for Application Diagnostics V7.1: (ITCAMAD71) Managing Server Component. envcheck.sh is also shipped as a part of the ITCAM for Application Diagnostics installation media set.

Before launching the Environment Checking Utility:

  1. Install the Runtime Environment for the Java platform version 1.4.2 or higher.

  2. Set JAVA_HOME in the system environment variables.

    • For Windows, set...

        JAVA_HOME=JRE_PATH

    • For Linux and UNIX systems...

        JAVA_HOME=JRE_PATH; export JAVA_HOME

  3. Use one of the following commands to launch envcheck.sh:

    • For Windows...

        envcheck.bat

    • For Linux and UNIX systems...

        envcheck.sh

    On UNIX systems, to ensure envcheck.sh can gather all the necessary operating system information, log on as the root user.

  4. To launch envcheck.sh 
    ./envcheck.sh -reportPath /path/to/reports \
             [-check Configuration_file_name] \
             [-logPath Log_path] \
             [-tmpPath Tmp_path] \
             [-showSteps] \
             [-noWizard] \
             [-help]

    ...where..

    -reportPath /path/to/reports Required. envcheck.sh generates a report of all the content checks. /path/to/reports indicates the path name to save the report to.
    -check Configuration_file_name Optional. Specify the configuration file for this release...

    itcamfwas_dc Data collector
    itcamfwas_ms Managing Server

    If -check parameter option is not specified, envcheck.sh will prompt you to select one of the configuration files.

    -logPath Log_path Optional. Log path name for envcheck.sh. Default is ECU_PATH/logs.
    -tmpPath Tmp_path Optional. Temporary directory for ECU. Default is ECU_PATH/tmp.
    -showSteps Optional. If set, envcheck.sh will prompt with steps generated by a navigation wizard.
    -noWizard Optional. If set, envcheck.sh will not prompt for any wizard navigation inputs, but the following options are available: Back, Next or Cancel.
    -help Optional. Display information on available options.

    envcheck.sh performs the following checks. You are prompted to enter any additional information if required.

    OS Information check. Check operating system version, release, architecture, bit mode, and user information.
    Prerequisite OS packages and libraries check. On a UNIX platform, envcheck.sh checks the prerequisite packages of ITCAM Agent for WebSphere Applications data collector and ITCAM Agent for J2EE data collector.
    Processor and memory information check. Check the information processors and memory.
    Database information check. Check installed DB2 information.
    Ports check. Check the default ports of the data collector.
    Select WebSphere Home. Select the WAS home directory to check.
    WebSphere Information check. Check the selected WAS information.
    Global Security Status check. Check the Global Security Status of selected WAS information.
    Select Application Server Instance. Select the application server instances to check.
    JVM parameters check. Check the JVM parameters of selected application server instances.
    WebSphere Connection wsadmin check. Check the wsadmin connection of selected application server instances.
    Generate Java Core. Generate Java core of selected application server instances.
    Open source J2EE frameworks check. Check if open source J2EE frameworks are installed on the selected application server instances.
    Third-party tools check. Check if third-party tools are installed on the selected application server instances.
    Other Tivoli products check. Check if other Tivoli products are installed on the selected application server instances. envcheck.sh generates a report of the content checks and saves it to the location specified by the -reportPath parameters.


    +

    Search Tips   |   Advanced Search