Configuring the agent on Linux or AIX systems

You can configure the SAP agent on Linux or AIX® systems so that the agent can collect data of the SAP Applications Server that is being monitored.

Procedure

On the command line, change the path to the agent installation directory. For example, /opt/ibm/apm/agent/bin
Run the following command:
```
./sap-agent.sh config instance_name
```
where, instance_name is the name that you want to give to the instance.

Important: The agent instance name must match the 3-digit system identifier (SID) of the managed SAP Applications Server. For example, if the SID of the managed SAP Applications Server is PS1, enter PS1 as the instance name.
When the command line displays the following message, type 1 and press Enter.
```
Edit ‘Monitoring Agent for SAP Applications’ setting? \[1=Yes, 2=No\]
```
Configure the SAP agent by using the Application Server mode or the Logon Group mode.
- To configure the SAP agent in the Application Server mode complete the following steps:
  1. When the command line displays the following message, type 1 and press Enter: Connection Mode [ 1=Application Server Mode, 2=Logon Group Mode ]
  2. Specify values for the configuration parameters. For information, see Configuration parameters of the agent.
- To configure the SAP agent in the Logon Group mode complete the following steps:
  1. When the command line displays the following message, type 2 and press Enter: Connection Mode [ 1=Application Server Mode, 2=Logon Group Mode ]
  2. Specify values for the configuration parameters. For more information about the configuration parameters, see Configuration parameters of the agent.

**Important**: For the Application Server mode, it is mandatory to configure the **Dialog Instance** having dispatcher on the SAP system where the message server or ASCS is configured. For the **Logon Group** mode, it is not mandatory to configure the **Dialog Instance** having dispatcher on the SAP system where the message server or ASCS is configured.

Run the following command to start the SAP agent:
```
./sap-agent.sh start instance_name
```

**Important**: If you want to create another instance of the SAP agent, repeat the steps from 1 to 5. Use a unique System Identifier for each SAP agent instance that you create.

What to do next

Log in to the IBM Cloud Pak console}to view the data that is collected by the agent in the dashboards. For more information about using the console, see Starting the Cloud App Management UI.