Configure the agent for Linux

Before you begin

Set the RunningInBackground parameter in your tms1.cfg file to RunningInBackground=T.

Note: The RunningInBackground parameter is required for Linux® only. It is used to suppress the prompts displayed by TM1® Server. Since Planning Analytics Administration uses scripts to start and stop databases on TM1 Server, you must set RunningInBackground=T on Linux.

Procedure

  1. Navigate to <PA_install_location>/paa_agent/bin.
  2. Run the ./shutdown_agent.sh command to stop the IBM Planning Analytics Administration Agent if it is running.
  3. Navigate to <PA_install_location>/paa_agent/wlp/usr/servers/kate-agent.
  4. In a text editor, open the bootstrap.properties file.
  5. Set the full path of the directory that contains TM1 databases data directories to SERVERS_DIR.
    Note: Multiple paths must be separated by a semicolon. For example, /opt/ibm/cognos/tm1_64/samples/tm1/;/srv/prod/servers/.
  6. Save and close the bootstrap.properties file.
  7. Navigate to <PA_install_location>/paa_agent/bin.
  8. Run ./set_java_home.sh <Full path to JRE> to set JAVA_HOME for your Planning Analytics Administration agent.
  9. Run ./startup_agent.sh install to set up the Planning Analytics Administration agent service.
    Note: You must have root or sudo privileges to perform this step.
  10. Run ./startup_agent.sh command to start the Planning Analytics Administration agent.

What to do next

Navigate to Planning Analytics Administration in Planning Analytics Workspace Local and verify that the TM1 databases appear.

Note: If you change the bootstrap.properties file later, you must restart the IBM Planning Analytics Administration Agent by running ./startup_agent.sh command.