Infa9Logs

Version 17

    Introduction

     

    Infa9logs is a tool used to collect application services logs – both from log service and from file system, workflow logs and session logs.

    Purpose

     

    Infa9Logs is a command line utility to collect multiple logs with a single command. It can be used to collect application service logs written to file system, log service agent, workflow and session logs. Logs being an important component for debugging, these logs help Informatica support obtain a holistic view of the problem with all logs collected for the same time frame.

     

    Prerequisites

    • Java Version should be either 1.5 or above. Tool shows an error message if it is older version.
    • Set INFA_HOME environment variable before running Infa9log. If this varibale is not set, the tool will pick it either from the Properties file or from the VM parameter (-DINFA_HOME) or from the command line argument. If it is not found anywhere, you might see an error message. It is a best practice to set it to INFA_HOME\java.


    Supported Informatica Products

    • PowerCenter 9.0.1 and above
    • Data Quality

     

    License Info

    • Free download

    Current Version

    • Infa9Logs 1.0

    Download

    • Infa9Log.tar (The attachment is available at the bottom of this document)

    How to Install

    1. Download the attached tar file (Infa9Log.tar) and extract the file.
    2. If you are using the tool on *NIX, ensure you transfer the zip file through FTP in binary mode to the server machine (in case of *NIX) and use dos2unix command to convert StartInfaLogs.sh, services.xml and infaLog.properties files to UNIX format.
    3. If you are running the tool against PowerCenter 8.x, re-name services.xml_V8 to services.xml and InfaLog.properties_V8 to InfaLog.properties. By default, the tool is configured to run against PowerCenter 9.x.
    4. Set INFA_HOME environment variable. This should point to the location where Informatica server is installed.
    5. Set JAVA_HOME environment variable. JAVA_HOME should point to the Java directory under $INFA_HOME$/  OR to any JAVA_HOME with Java version above 1.5.
    6. On Unix, execute StartInfaLogs.sh file and provide your program arguments as following:

      StartInfaLogs.sh -o <ZipOutDir>[ -un <user-name][ -pd <password>][ -hp host:port] [-sd startDate{YYYY-MM-DD}] [-ed endDate{YYYY-MM-DD}] [-st serviceType] [-sl Sesslog1:Sesslog2...] [-wl WFlog1:WFlog2...]
    7. On Windows, execute StartInfaLogs.bat and provide your program arguments as following:

      StartInfaLogs.bat -o <ZipOutDir> [-un <user-name>][ -pd <password>][ -hp host:port] [-sd startDate{YYYY-MM-DD}] [-ed endDate{YYYY-MM-DD}] [-st serviceType] [-sl Sesslog1:Sesslog2...] [-wl WFlog1:WFlog2...

      Command options elaborated:
      • <ZipOutDir>:  location you want the output zip file to be generated; this is the only mandatory parameter.
      • -un <user-name> and -pd <password>   PowerCenter domain username/password for fetching service logs
      • -hp host:port  Domain's host name and port number
      • -sd startDate and -ed endDate  is timeline between which, you want the service logs to be zipped. Date format should be YYYY-MM-DD (please refer to the example below).
      • -s1 Sesslog1:Sesslog2... -wl WFlog1:WFlog2  can be used to fetch session and workflow logs. colon-separated values of session/workflow log filename can be provided if logs of multiple sessions/workflows are being requested. This should exactly match the session/worklet/workflow log file names under session OR workflow log directory.
      • Log file(s) will be created under <zipOutDir>/infalog/ (configurable parameter: TEMP_LOG_DIR in InfaLog.properties file).
    8. The services.xml will contain a list of directories where PowerCenter 8 or 9 log files are created (apart from the binary logs accessible from admin console/administrator).
    9. The InfaLog.properties file will contain configuration properties which directly command the tool's execution. You can edit them and view the comments for a more detailed explanation on each property.

     

    Examples

     

    Most commonly used options -

    setenv INFA_HOME /home/infauser/Informatica9

    setenv JAVA_HOME /home/infauser/Informatica9/java

     

    • Collect filesystem log files: ./StartInfaLogs.sh -o /tmp
    • Collect filesystem log files along with service logs: ./StartInfaLogs.sh -o /tmp -un Administrator -pd Administrator  -hp InfaHost.InfaDomain.com:6005 -sd 2014-07-07 -ed 2014-07-08 -st IS -fm Text

     

    References

     

     

    Supported Platforms

    • Supports all Platforms