Show Table of Contents
7.13.2. Setting a Java Option
Editing the
agent-configuration.xml file only sets the node name; the node location still has to be passed every time the agent is started.
By setting a Java option in the
rhq-agent-env.sh file, the Java preferences node information is set once and then persisted, so you can restart the agent as a service, without having to pass --prefs options or edit and reload the configuration.
- Open the agent prompt. For example, if the agent process is already running, the prompt can be opened by re-running the
rhq-agent.shscript with the-noption.[rhquser@server ~]$ agentRoot/rhq-agent/bin/rhq-agent.sh -n
- Use the
setconfigcommand to set theRHQ_AGENT_ADDITIONAL_JAVA_OPTSvalue with the preference node. For example:> setconfig RHQ_AGENT_ADDITIONAL_JAVA_OPTS="-Djava.util.prefs.userRoot=agentUserHomeDir/.java/.userPrefs/rhq-agent/agent01-node"
The preference node can be in the user preferences directory with a different name, such asagent01-node, or it can be in an entirely different location, such as/etc/agent-preferences, which is not a shared or filesystem-mounted location. - Restart the agent process to load the new configuration. For example, if the agent is running as a service:
[rhquser@server ~]$ service rhq-agent-wrapper.sh stop [rhquser@server ~]$ service rhq-agent-wrapper.sh start
Note
It is also possible to stop the agent, edit the
rhq-agent-env.sh file directly, and then restart the agent.
Important
Do not set the Java option within the rhq-agent runtime directory because this file is overwritten during JBoss ON agent updates. The default location for the rhq-agent runtime is
$USERHOME/.java/.userPrefs/rhq-agent/default.
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.