3.12. Managing the Server Service
3.12.1. Starting the Server and Other Services
The simplest way to start all installed services (server, agent, and storage node) is simply to run the script with the
start command.
[jsmith@server ~]$ serverRoot/bin/rhqctl start Trying to start the RHQ Server... RHQ Server (pid 27547) is starting
Any individual service can be started using the appropriate option (
--server, --storage, or --agent).
[jsmith@server ~]$ serverRoot/bin/rhqctl start --server
The
RHQ_JAVA_HOME environment variable must be set on Red Hat Enterprise Linux systems for the server to start. This can be set to a general value like /usr/.
Note
The server must be started using the rhqctl script, not the rhq-server.sh script.
Any agents installed with the server must be started using the rhqctl command. It must not be started using the rhq-agent.sh script.
Additionally, the agent must be started without requiring any user intervention. The RHQ_AGENT_PASSWORD_PROMPT parameter should always be commented out or set to false so that no password is required to start the agent.
3.12.2. Opening the Server in a Console
When the server is running as a service on either Windows or Linux, it is running in the background. It is possible to open the server in a console window, using the control script:
- Stop the JBoss ON server.
[jsmith@server ~]$ serverRoot/jon-server-3.3.2.GA/bin/rhqctl stop
- Run the rhqctl script with the console command.
[jsmith@server ~]$ serverRoot/jon-server-3.3.2.GA/bin/rhqctl console --server
