5.2. Installing the Agent from RPM

The JBoss ON agent is installed through the jboss-on-agent package. This package installs all of the agent files, creates a specific JBoss ON agent system user, and configures the JBoss ON agent as a system service.

Important

This procedure is for installing and managing an agent on a platform which will be managed by JBoss ON.
If this system hosts a JBoss ON server, then install the agent as part of the server installation process, as described in Chapter 2, Installing the JBoss ON Server. An agent on the same machine as a JBoss ON server cannot be installed or managed through the agent RPM. It must be installed and managed using the rhqctl script.

5.2.1. Installing Using yum

  1. Configure the yum repos to include the JBoss ON channel (as listed in Table 5.3, “Available Channels for the Agent RPM”). For example:
    [root@server ~]# yum-config-manager --enable jbappplatform-6-x86_64-server-6-rpm

    Note

    Installing the RPM requires specific entitlements for the RHN user account for the 3.2 release. This RHN user account must be used to register the system to have access to the appropriate repositories.
  2. Use yum to install the package.
    [root@server ~]# yum install jboss-on-agent
    This installs the agent in /usr/share/jboss-on-3.2.0.GA/agent.
  3. Configure the agent by running the service jon-agent config command. This runs through the advanced installer to configure the agent.
    [jsmith@server ~]$ sudo service jon-agent config
    RHQ 4.4.0.JON311GA [6910991] (Wed Aug 01 18:43:03 EDT 2012)
    ** Advanced Setup **
    ... 8< ...
    Agent Name [agent.example.com] : agent1
    Agent Hostname or IP Address [!*] :
    Agent Port [16163] :
    Agent Transport Protocol [socket] :
    Agent Transport Parameters [numAcceptThreads=1&maxPoolSize=303&clientMaxPoolSize=304&socketTimeout=60000&enableTcpNoDelay=true&backlog=200] :
    RHQ Server Hostname or IP Address [255.255.255.255] :
    RHQ Server Port [7080] :
    RHQ Server Transport Protocol [servlet] :
    RHQ Server Transport Parameters [/jboss-remoting-servlet-invoker/ServerInvokerServlet] :
    RHQ Server Alias [rhqserver] :
    The setup has been completed for the preferences at node [/rhq-agent/default].
    The config command runs through all of the advanced setup options, which configures three areas of the agent:
    • The agent connection information, used to register the agent to the server
      • The agent name
      • The agent port
      • The agent host (by hostname or IP address)
    • The agent-server communication settings, which include configuring SSL or secure connections and rules on how frequently the agent communicates with the agent
      • The agent protocol, either socket (regular) or sslsocket (secure)
        For sslsocket, the JBoss ON server needs to be configured to accept SSL connections, as in the SSL chapter of Configuring JBoss ON Servers and Agents.
      • Any client transport parameters to use to connect to the server
        Both the server and the agent use JBoss Remoting for communication. JBoss Remoting allows servers and clients to pass connection settings using a URL-style address. Transport parameters include things like pool sizes, timeout periods, and buffer settings. For the complete list, see the JBoss Remoting client parameters documentation.
      • The server protocol which the agent uses to send messages to the server, either servlet (regular) or sslservlet (secure)
        The server connection settings configured on the agent must match the configuration in the server itself.
      • Any server transport parameters to use to receive messages from the agent
        Both the server and the agent use JBoss Remoting for communication. JBoss Remoting allows servers and clients to pass connection settings using a URL-style address. Transport parameters for the server relate to the servlet used to receive agent messages.
    • The JBoss ON server to register with
      • The server host (by hostname or IP address)
      • The server port
      • The server alias, a short nickname to identify the server instance
  4. Start the agent.
    [jsmith@server ~]$ sudo service jon-agent start

5.2.2. Installing by Downloading the RPM

  1. Log into the Customer Portal at https://access.redhat.com.
  2. Click the Downloads tab.
  3. Click the Packages box to search for the agent RPM package.
  4. Enter jboss-on-agent as the package name, select the In the following architectures radio button, and set the appropriate architecture for the system.
  5. Click the package name, and then click the name for the latest agent RPM update.
  6. Scroll to the bottom of the page, and click the Download Package link and save the package to a convenient location on the system.
  7. Install using the rpm command. For example:
    [root@server ~]# rpm -ivh /tmp/downloads/jboss-on-agent-3.2.0.GA.el6.noarch.rpm
    This installs the agent in /usr/share/jboss-on-3.2.0.GA/agent.
  8. Configure the agent by running the service jon-agent config command. This runs through the advanced installer to configure the agent.
    [jsmith@server ~]$ sudo service jon-agent config
    RHQ 4.4.0.JON311GA [6910991] (Wed Aug 01 18:43:03 EDT 2012)
    ** Advanced Setup **
    ... 8< ...
    Agent Name [agent.example.com] : agent1
    Agent Hostname or IP Address [!*] :
    Agent Port [16163] :
    Agent Transport Protocol [socket] :
    Agent Transport Parameters [numAcceptThreads=1&maxPoolSize=303&clientMaxPoolSize=304&socketTimeout=60000&enableTcpNoDelay=true&backlog=200] :
    RHQ Server Hostname or IP Address [255.255.255.255] :
    RHQ Server Port [7080] :
    RHQ Server Transport Protocol [servlet] :
    RHQ Server Transport Parameters [/jboss-remoting-servlet-invoker/ServerInvokerServlet] :
    RHQ Server Alias [rhqserver] :
    The setup has been completed for the preferences at node [/rhq-agent/default].
    The config command runs through all of the advanced setup options, which configures three areas of the agent:
    • The agent connection information, used to register the agent to the server
      • The agent name
      • The agent port
      • The agent host (by hostname or IP address)
    • The agent-server communication settings, which include configuring SSL or secure connections and rules on how frequently the agent communicates with the agent
      • The agent protocol, either socket (regular) or sslsocket (secure)
        For sslsocket, the JBoss ON server needs to be configured to accept SSL connections, as in the SSL chapter of Configuring JBoss ON Servers and Agents.
      • Any client transport parameters to use to connect to the server
        Both the server and the agent use JBoss Remoting for communication. JBoss Remoting allows servers and clients to pass connection settings using a URL-style address. Transport parameters include things like pool sizes, timeout periods, and buffer settings. For the complete list, see the JBoss Remoting client parameters documentation.
      • The server protocol which the agent uses to send messages to the server, either servlet (regular) or sslservlet (secure)
        The server connection settings configured on the agent must match the configuration in the server itself.
      • Any server transport parameters to use to receive messages from the agent
        Both the server and the agent use JBoss Remoting for communication. JBoss Remoting allows servers and clients to pass connection settings using a URL-style address. Transport parameters for the server relate to the servlet used to receive agent messages.
    • The JBoss ON server to register with
      • The server host (by hostname or IP address)
      • The server port
      • The server alias, a short nickname to identify the server instance
  9. Start the agent.
    [jsmith@server ~]$ sudo service jon-agent start