IBM Performance Management

Configuring the agent on Linux and AIX systems

You run the configuration script and respond to prompts to configure the agent on Linux and AIX® systems.

Procedure

  1. On the command line, run the following command: install_dir/bin/hadoop-agent.sh config where install_dir is the installation directory of Hadoop agent. The agent is installed at the following default installation directory:
    • Linuxopt/ibm/apm/agent
    • AIXopt/ibm/ccm/agent
  2. When the command line displays the following message, type 1 to continue with the configuration steps and press Enter.
    Edit ‘Monitoring Agent for Hadoop' setting? [1= yes, 2= No]
  3. When the command line displays the following message, select the appropriate trace level and press Enter.
    This parameter allows you to specify the trace level used by the Java providers Java trace level [ 1=Off, 2=Error, 3=Warning, 4=Information, 5=Minimum Debug, 6=Medium Debug, 7=Maximum Debug, 8=All ] (default is: 2)
  4. Optional: When the command line displays the following message, specify the arguments for the Java™ virtual machine and press Enter.
    This parameter allows you to specify an optional list of arguments to the java virtual machine JVM arguments (default is:)
  5. When you are prompted, specify a port number if you want to change the default port number of 6789.
    Remember:
    • The agent uses the port to listen to the data from the socket clients.
    • The value 0 indicates that an ephemeral port is used.
  6. When the command line displays the following message, type 1 and press Enter to add a host.
    Edit ‘Hosts’ settings? [1=Add, 2=Edit, 3=Del, 4=Next, 5=Exit] (default is: 5)
    Remember: To modify the configuration settings of a particular host, type 4 and press Enter until you see the host name.
  7. When you are prompted, enter the host name of the server that is being monitored and press Enter.
    Remember:
    • Specify the fully qualified domain name (FQDN) of the node when you specify the host name. For example, hos1.ibm.com.
    • If the length of FQDN exceeds 25 characters, specify only the short host name without the domain name. For example, if the FQDN of a host is myhadoopclustersetupnode.ibm.com, the short host name is myhadoopclustersetupnode.
  8. When you are prompted, enter the IP address of the host and press Enter. You are redirected to step 6 for adding more hosts.
  9. Type 5 and press Enter to exit the configuration steps after you add all the hosts.
  10. Run the following command to start the agent: install_dir/bin/hadoop-agent.sh start

What to do next

  1. Configure each Hadoop node so that the Hadoop agent can collect data. For information about the configuration settings, see Configuring Hadoop nodes.
  2. Enable the subnode events to view eventing thresholds of the Hadoop agent. For information about enabling subnode events, see Configuring the dashboard for viewing Hadoop events.
  3. Log in to the Performance Management console to view the data that is collected by the agent in the dashboards. For information about using the Performance Management console, see Starting the Performance Management console.