Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

4.3. Running the JBoss ON Server as a Service

The rhq-server.sh script can be managed by the init process so that the server starts automatically when the system boots. This also allows the server process to be managed by services like service and chkconfig.
  1. Copy the rhq-server.sh script into the /etc/init.d/ directory. 
    cp serverRoot/bin/rhq-server.sh /etc/init.d/
    Copy to Clipboard Toggle word wrap
  2. Edit the /etc/init.d/rhq-server.sh script to set the RHQ_SERVER_HOME variable to the JBoss ON server install directory and the RHQ_SERVER_JAVA_HOME variable to the appropriate directory for the JVM. For example: 
    RHQ_SERVER_HOME=serverRoot/jon-server-3.0.0.GA1/
    Copy to Clipboard Toggle word wrap 
    RHQ_SERVER_JAVA_HOME=/usr/
    Copy to Clipboard Toggle word wrap
  3. Edit the /etc/init.d/rhq-server.sh script, and add the following lines to the top of the file, directly under #!/bin/sh. 
    #!/bin/sh
#chkconfig: 2345 95 20   
#description: JBoss Operations Network Server
#processname: run.sh
    Copy to Clipboard Toggle word wrap
    The last two numbers in the #chkconfig: 2345 95 20 line specify the start and stop priority, respectively, for the JBoss ON server.
  4. Add the service to the chkconfig service management command, and verify that it was added properly. 
    chkconfig --add rhq-server.sh
chkconfig rhq-server.sh --list
    Copy to Clipboard Toggle word wrap
  5. Set the rhq-server.sh service to run at run level 5. 
    chkconfig --level 5 rhq-server.sh on
    Copy to Clipboard Toggle word wrap

4.3.2. Configuring JBoss ON as a Windows Service
Copy link

The rhq-server.bat script has an installation option that installs the script as a Windows service.
  1. Set the environment variable to run the Windows service as.
    Every Windows service has to run as some system user. There are two environment variables in the rhq-server.bat script that set the user to use:
    • RHQ_SERVER_RUN_AS sets any Windows user to be the JBoss ON server user. The username given here must be in the standard Windows format, DOMAIN\user, such as EXAMPLEDOMAIN\jsmith.
    • RHQ_SERVER_RUN_AS_ME sets the server to run as whoever the current user is. This overrides the RHQ_SERVER_RUN_AS, if both as set.
    If neither environment variable is set, then the JBoss ON server runs as the system account.
  2. Run the rhq-server.bat script with the install option to set up the service. This prompts for the password of whatever user account is used for the JBoss ON service. 
    serverRoot\bin\rhq-server.bat install
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat