Deploying Agent Controller and IBM i Log and Trace Analyzer

You install Agent Controller by running a command-line tool on your workstation.

About this task

Important: Agent Controller requires that you install the IBM® XML Toolkit for iSeries® (5733-XT1) or its follow-on product, the IBM XML ToolKit for Power® Systems (5733-XT2). Contact your Power Systems vendor to obtain a copy.

Procedure

  1. Get Agent Controller save files. Copy ibmrac.os400.zip to your local drive. This file can be found in folder ibmrac on Installation Disk 1 for Rational® Developer for Power Systems Software. Unzip ibmrac.os400.zip to a temporary local folder.
  2. On your workstation, open a new Command Prompt window.
  3. Navigate to X:\rdi_prod\plugins\com.ibm.etools.iseries.logging.adapter_versionnumber\serverruntime, where X:\rdi_prod is the fully qualified path name of the folder where you installed Rational Developer for Power Systems Software and versionnumber is the version number of the com.ibm.etools.iseries.logging.adapter plug-in.
  4. Make sure that the jt400.jar file is in your Java™ class path. jt400.jar can be found in X:\rdi_prod\plugins\com.ibm.etools.iseries.toolbox_versionnumber\runtime.
  5. Run setup.bat. You may need to edit setup.bat to put in the correct class path for jt400.jar.
  6. Follow the prompt of setup.bat to complete the deployment of Agent Controller and IBM i Log and Trace Analyzer. When you are asked for the location of the Agent Controller file, type the name of the folder where you unzipped Agent Controller earlier.

What to do next

You have now installed Agent Controller. You now need to configure it.
  1. Sign on to your IBM i server and start QSHELL.
  2. Switch to the /opt/hyadesdc/bin directory and run the setup script by typing: ./SetConfig.sh .
  3. Follow the on-screen prompts to configure Agent Controller.
    1. For the question about network access mode, answer ALL.
    2. For the question about security being enabled, answer TRUE.
      Note: If security is enabled, you will be prompted to accept a security certificate for your IBM i host when communicating with Agent Controller the first time. For example, use IBM i Log and Trace Analyzer to convert a job log. Accept the certificate, and give an alias name to the host.
    3. Accept the default value for other questions.

Feedback