Configuring the agent by responding to prompts

After installation of the Amazon ELB agent, you must configure it before you start the agent. If the Amazon ELB agent is installed on a local Linux computer, you can follow these instructions to configure it interactively through command-line prompts.

About this task

Remember: If you are reconfiguring a configured agent instance, the value that is set in the last configuration is displayed for each setting. If you want to clear an existing value, press the space key when the setting is displayed.

Procedure

Follow these steps to configure the Amazon ELB agent by running a script and responding to prompts.

Run the following command:
```
<install_dir>/bin/amazon_elb-agent.sh config <instance-name>
```
Where <install_dir> is the path where the agent is installed and <instance-name> is the name that you want to give to the agent instance.

Example:
```
/opt/ibm/apm/agent/bin/amazon_elb-agent.sh config elb-inst3
```
Respond to the prompts to set configuration values for the agent. See Configuration parameters for the Amazon ELB agent for an explanation of each of the configuration parameters.
Run the following command to start the agent:
```
<install_dir>/bin/amazon_elb-agent.sh start <instance-name>
```
Where <install_dir> is the path where the agent is installed and <instance-name> is the name of the agent instance.

Example:
```
/opt/ibm/apm/agent/bin/amazon_elb-agent.sh start elb-inst3
```

Example

Creating an agent instance that is named elb-inst3.

# ./amazon_elb-agent.sh config elb-inst3
Configuring Monitoring Agent for Amazon ELB

Edit 'Monitoring Agent for Amazon ELB' settings? [ 1=Yes, 2=No ]  (default is: 1): 1

Subscription Information:
Amazon ELB subscription information

The access ID that is used to authenticate with the specified Amazon Region. 
For example, 'AKIAxxxxxxxxxxxxxxx'.
Access Key ID (default is: ): AKIAIOSFODNN7EXAMPLE

The secret access key that is used to authenticate with the specified Amazon 
Region. For example, 'kK7txxxxxxxxxxxxxxxxxxxxxxxxx'.
Enter Secret Access Key (default is: ): hidden

Re-type : Secret Access Key (default is: ): hidden

The Amazon region where the load balancers are located. For example, 'us-west-2'.
Region (default is: ): us-west-2

Configuration completed successfully.
Automatic start at system initialization has been configured.
Automatic stop at system shutdown has been configured.

Configuring the agent by responding to prompts

About this task

Procedure

Example

What to do next