HP

HPjmeter 4.1 User's Guide

English
  HPjmeter 4.1 User's Guide > Chapter 4 Monitoring Applications   

Managing Node Agents

Each managed node requires an HPjmeter node agent that manages communication between the console and JVM agents.

Once the Session Preferences window closes, and after waiting for a few moments, you should see the running JVM agents listed below the connected server host name. If no JVM appears, check that a node agent is running on that server. If no node agent is running, the console cannot show the JVM agents.

On HP-UX, you can run the node agent as a daemon or service for automatic, continuous operation, or as a manual process when you do not need continuous operation.

Managing Node Agents On HP-UX

Running Node Agent as a Daemon

When you install HPjmeter on HP-UX systems, you can start the node agent as a daemon for continuous automatic operation.

NOTE: Though you can run the node agent continuously, the node agent is not a high availability application.

As a daemon, the node agent can use an alternate port number. To specify a different port number, edit the /sbin/init.d/HPjmeter_NodeAgent file, add the -port option, and manually start the node agent.

To start or stop the node agent daemon on HP-UX PA and IA:

$ /sbin/init.d/HPjmeter_NodeAgent start|stop

To change default options, such as port number, edit the contents of the file.

Verifying HP-UX Daemon is Running

When the node agent is running as a daemon on a HP-UX system, use these steps to verify that the node agent is running:

  1. You must be logged in with root permissions.

  2. Check that these files exist:

    • /sbin/init.d/HPjmeter_NodeAgent

    • /sbin/rc3.d/S999HPjmeter_NodeAgent

  3. Use the ps command, or its equivalent on your system:

    $ ps -ef | grep node

    The result should show:

    $ JMETER_HOME/bin/nodeagent -daemon 

    where

    JMETER_HOME=/opt/hpjmeter 

    The –daemon flag indicates that the node agent is running as a daemon.

To start or stop the node agent daemon manually:

$ /sbin/init.d/HPjmeter_NodeAgent start|stop

Starting Node Agents Manually

If you cannot use the node agent daemon or you need to set up access restrictions, you can start a node agent manually. For information about access restrictions, see Working with Firewalls .

A node agent must be running before the console can connect to a managed node to discover your applications and open monitoring sessions.

Start the node agent from the command line by typing:

$ JMETER_HOME/bin/nodeagent

where $JMETER_HOME has the default value of

JMETER_HOME=/opt/hpjmeter 

You can run the node agent as a background process. By default, the node agent listens for console connections on port 9505, but you can designate an alternate port number using this option: -port port_number

Stopping Node Agents

To stop a manually started node agent, abort the process.

Node Agent Access Restrictions

To make the JVM agent visible to the corresponding node agent, start a node agent with the same group ID or user ID of each JVM process whose JVM agent uses the group_private (default) or owner_private options. Node agents started as root will see all JVM agents regardless of the ownership ID used on the JVM agent.

Running Multiple Node Agents

To run multiple node agents on the same managed node, each node agent must listen on a different port to control visibility to JVMs. Use the node agent port option to specify a port number. Each user or group must remember the port on which their node agent is running to connect to it.

To provide more secure access, run multiple node agents and use the owner_private or group_private option for the JVM agent. For more information, refer to Node Agent Access Restrictions.