Configuration Support Manager for ILM

Version 2

    Introduction

     

    Our Configuration Support Manager (CSM) tool has been our backbone in enabling us to gather configuration information from your hosts running Informatica, tracking your configurations, replicate issues and advising health checks. It has been the foundation for our rich configuration management capabilities.

     

    With CSM for ILM, you can collect the system, environment and product details of the machine hosting Information Life Cycle Management (ILM).

     

    CSM gathers data from ILM metadata repository, which can help in troubleshooting issues related to:

    • Specific to versions and patches
    • Accelerators
    • Custom and standard entities
    • Sequences
    • Jobs and schedules

    And in turn, with the information gathered from the configuration files, Informatica Support can better understand the following:

    • ILM Web Server configuration details
    • File archive server configuration details and
    • File archive server for attachments configuration details

     

    Purpose

     

    When you run the CSM utility, it generates an XML file and depending on the system configuration the CSM Client utility gathers the following information:

     

    • System (UNIX)
    • System Information
    • CPU Information
    • Environment Variables
    • File System
    • Operating System Patches
    • Network Information
    • User Limits
    • Swap Information
    • System (Windows)
    • Memory Information
    • CPU Information
    • Environment Variables
    • Disk Information
    • Operating System Information
    • Network Configuration
    • Product (ILM)
    • Installed Products
    • Product Patches
    • AMhome (ILM Metadata Repository) Schema Details
    • AMhome Schema Object Details
    • Amhome Properties
    • Repository Attributes
    • Instance Statistics
    • Installed Product Family Versions (PFVs)
    • Archived Entities
    • Standalone Job Details
    • User Roles
    • ILM related Database Links
    • Configuration Properties
    • Quartz Properties
    • Attachment Properties
    • Java Version

     

    The information gathered through CSM for ILM, and the XML file that you upload or send, enables Informatica Support to:

    • Find any anomalies/symptoms that could cause issues.
    • Help replicate or reproduce an issue by creating similar environment.
    • And, aid to provide a solution for the issues easily and quickly.
    • Help in Configuration Management of your environment
    • Provide relevant health check recommendation

     

    Prerequisites/System Requirements

    • Ensure that the JAVA_HOME environment variable is set. It is mandatory to have Java 1.5 or above (JRE or JDK) in the path before running the CSM Client. Otherwise, the ILM product information will not be fetched.

    Supported Informatica products

    • ILM

    License Info

    • Free Download

    Current Version

    • CSM for ILM 1.0

    Download

    • csm-ilm-release.zip (See Attachment section below)

    How to Install

     

    The CSM Client output for ILM can be generated using one of the following methods:

    • Command line interface (CLI)
    • Web Application

     

    Using CLI
    1. Download and extract (unzip) the csm-ilm-release-1.0.zip\csm-ilm-cli.zip file in a location from where CSM will run.
    2. Assign execute permissions to the executable file only in UNIX platforms.
    3. Depending on the operating system run one of the following:
      1. Windows use run.bat
      2. UNIX, LINUX, SUNOS and HPUX, use run.sh
      3. Run the CSM using one of the following modes:

     

    Command Line Option

    cd csm-ilm-release-1.0\csm-ilm-cli\csm

    On *nix

    ./run.sh ilm –h <Database host> -o <Database port> -d <Database service> -u <Database username> -x <Database password> -t <Database type> -i <ILM installation directory> -s

    On Windows

    ./run.bat ilm –h <Database host> -o <Database port> -d <Database service> -u <Database username> -x <Database password> -t <Database type> -i <ILM installation directory> -s

    When prompted for the Java home directory provide the path to either the JDK bin directory or JRE bin directory.

    CLI interactive

    cd csm-ilm-release-1.0\csm-ilm-cli\csm

    On *nix

    ./run.sh

    On Windows

    ./run.bat

    • When prompted for the Java home directory provide the path to either the JDK bin directory or JRE bin directory.
    • Also provide the necessary inputs as and when required
    • The output is an XML file with the following naming convention csmclient<hostname>.xml
    • Open the XML in Internet Explorer to view the formatted output.
    Web Deployment

    The following are the steps to generate the CSM Client output for ILM using web application:

    1. Download and extract (unzip) the csm-ilm-release-1.0.zip\csm-ilm-web-deployable.zip file.
    2. Assign execute permissions to the executable file only in UNIX platforms.
    3. Depending on the operating system run one of the following:
      1. Windows use deploy.bat
      2. UNIX, LINUX, SUNOS and HPUX, use deploy.sh
    4. When prompted for the ILM home directory provide the path of the ILM home directory.
    5. Rerun the startApplimation.sh file on UNIX platforms and startApplimation.bat on windows machine.
    6. Launch the URL <ILM_URL>/csm/generatecsm.jsp
    7. By default, the following AMHOME.properties details are displayed:
      1. Database Type
      2. Database Host
      3. Database port
      4. Database Service Name
      5. Database User Name
      6. Database User Password
      7. ILM Installation Directory
      8. Change the Database Type according to the AMHOME.properties database type.
      9. The following are the valid values:
        1. Oracle
        2. SQL Server
        3. DB2
      10. Enter password in the Database User Password text box.
      11. Click Generate New CSM.
      12. A message is displayed asking you not refresh or navigate away from this page
      13. Once the CSM XML is generated, a message is displayed confirming the creation with the location.

     

    Known Limitations

    None

    References

    Blog: https://communities.informatica.com/community/my-support/products/application_ilm/application_ilm/debugging-tools/blog/2011/10/24/csm-client-for-ilm

    KB: https://communities.informatica.com/infakb/howto/3/Pages/124460.aspx

     

    Release History

    Sl No.

    Version History

    Release Date

    1

    1.0

    June 2012

     

    Supported Platforms

    All Informatica supported platforms