Download JBoss Operations Network 3.2 Installation Guide

JBoss O perat ions Net work 3.2 Inst allat ion G uide
When the JBoss ON agent is installed from the agent installer JAR file, the system user and group
who own the agent installation files is the same user who installs the JAR. So, a special system user
can be created or selected, and then the agent can be installed by that user.
If the agent and the resource are run as different users and the agent needs to perform some actions
as the resource user, there are a few configuration options, depending on what needs to be done:
Configure scripts or operations to run using sudo. For long-running operations, such as starting
a service or a process, the user which executes the script should be the same as the resource user
because that user will have the proper authorization and permissions.
Set start script environment variables to use the resource's principal and credentials, if available.
For JVM or JMX servers. Select the connection configuration based on the user settings. For
different users, use JMX remoting. For the same user, use either JMX remoting or the attach API.
T ab le 4 .1. C h eat Sh eet f o r Ag en t an d R eso u rce U sers
R eso u rce
U ser In f o rmat io n
PostgreSQL
No effect for monitoring and discovery. The
agent user must have read/write permissions to
the PostgreSQL configuration file for
configuration viewing and editing.
No effect for monitoring and discovery. The
agent user must have read/write permissions to
the Apache configuration file for configuration
viewing and editing.
Must use the same user or can't be discovered
D ifferent users are fine when using JMX
remoting; cannot be discovered with different
users and the attach API
D ifferent users are all right, but requires read
permissions on run.jar and execute and search
permission on all ancestor directories for run.jar
Apache
Tomcat
JMX server or JVM
JBoss AS/EAP
4 .2. Inst alling t he Agent from JAR File
1. Point your browser to the download URL on the server. For example:
http://server.example.com:7080/agentupdate/download
Save the agent binary update .jar in a directory where you want to install the agent. The file
you save should have a .jar extension.
2. Copy the agent update binary .jar you downloaded from the JBoss ON server to the
directory.
3. Install the JAR:
java -jar downloaded_agent_jar_file.jar --install
This will tell the agent update binary to extract the JBoss ON agent distribution and install a
fresh copy of it in the rhq-agent subdirectory.
40