Getting Started with Agent Controller - Linux

Contents

Prerequisites

    Notation

    Install Agent Controller

Setting Up Agent Controller

    Configure Agent Controller

    Start Agent Controller

    Stop Agent Controller

Querying Agent Controller version information

Server Logging

Uninstalling Agent Controller

Prerequisites

• Install the Java runtime (JRE) or Java development kit (JDK) 1.5 or 1.4.x
  
• Remove or uninstall all prior versions of Agent Controller.

Notation

<install-dir> = The absolute directory path where the Agent Controller has been unzipped.  For example: /opt/tptpAC

Install Agent Controller

The instructions for installing the new technology Agent Controller and other required software are in the TPTP Platform Download area.  Complete the installation steps before trying to set up Agent Controller.

Setting Up Agent Controller

After a normal installation, you still need to configure the Agent Controller before you can start it.  Perform the following procedures:

Configure Agent Controller

1. Run SetConfig.sh script from a command shell in the <install-dir>/bin directory to generate the configuration file for the Agent Controller.  The script requires that a Java Virtual Machine (JVM) be present in the PATH environment variable.  Follow the prompts and enter the required parameters as appropriate.  The configuration file <install-dir>/config/serviceconfig.xml will be generated based on your inputs.
   
2. Add <install-dir>/bin directory to the PATH environment variable.
3. Add <install-dir>/lib directory to the LD_LIBRARY_PATH environment variable.

Note: Do not encase the environment variable's value in double quotes even if there are spaces in the <install-dir> path.

If you want to make changes to the configuration file that was generated in step 1, you may run the SetConfig.sh script again or you may manually edit the file according to the rules outlined in the document Agent Controller configuration files. The Agent Controller must be restarted for the changes to take effect.

Start Agent Controller

Start the Agent Controller by changing your working directory to  <install-dir>/bin and running ACServer.

Stop Agent Controller

Stop the Agent Controller service by terminating the ACServer process (e.g. closing the command shell).  Alternatively you can stop the Agent Controller service by entering:

ACServer -shutdown 

Querying Agent Controller Version Information

To display the version of Agent Controller, simply type:

ACServer -v
    or
ACServer -version

The Agent Controller will display its version and terminate.

Server Logging

Uninstalling Agent Controller

To uninstall the agent controller:

1. Stop the agent controller:
2. Remove the <install-dir>.
3. Remove the <install-dir>/bin directory from the PATH environment variable, if necessary.
4. Remove the <install-dir>/lib directory from the LD_LIBRARY_PATH environment variable, if necessary.