2.8. Basic Setup: Installing the Server on Windows

  1. When opening the command prompt, right-click the name or icon, and select Run as Administrator.
  2. Download the JBoss ON binaries from the Customer Support Portal.
    1. In the Customer Support Portal, click the Downloads tab, and then the Downloads icon in the page.
    2. Select the JBoss Operations Network link under the System Management area in the Downloads page.
    3. Download the JBoss Operations Network 3.2 Base Distribution package by clicking the Download icon.
    4. There are additional plug-in packs available for EAP, EDS, EWS, and SOA-P. If any of those plug-ins will be used with the JBoss ON server, then download them as well.
  3. Create a directory for the server to be installed in.
    Use a relatively short name. Path names longer than 19 characters can cause problems running the server or executing some tasks.
  4. Unzip the server distribution to the desired home directory for JBoss ON. For example:
    C:> winzip32 -e jon-server-3.2.0.GA.zip C:\jon
    This creates a version-specific installation directory, C:\jon\jon-server-3.2.0.GA. A directory with this name should not exist prior to the unzip operation.

    Important

    Be careful when using the extract all command. Expanding the archive automatically creates a directory called jon-server-VER.RELEASE/, which is about 20 characters. Using extract all, instead of specifying the directory to which to extract the archive, can double the directory name by extracting to the archive name and then to a subdirectory — for example, C:\example\jon-server-3.2.0.GA\jon-server-3.2.0.GA. Using other tools may install it to a downloads directory such as C:\Users\Administrator\Downloads.
    If directory paths are too long, then installations on Windows can fail.
    It is recommended that you extract the archive to C:\jon, such as C:\jon\jon-server-3.2.0.GA.
  5. Set the directory path to the JDK installation for a 32-bit JDK. For example:
    set RHQ_JAVA_HOME=C:\Program Files\Java\jdk1.6.0_29
    The default Java service wrapper included with JBoss ON requires a 32-bit JVM, so the Java preference set for the server must be a 32-bit JDK. The JBoss ON server must use a 32-bit JVM even on 64-bit systems.
    Running the server or agent with a 32-bit JVM does not in any way affect how JBoss ON manages other resources which may run with a 64-bit JVM. JBoss ON can still manage those resources and those resources can still use the 64-bit Java libraries for their own processes.
  6. Optional. By default, the script assumes that the backend database is a PostgreSQL server running on the same system as the server. Other settings — such as the database password, the server port numbers, the server name, and the way it handles database schema — use predefined defaults. One parameter, the bind address for the server, is empty and prompted by the control script.
    To change any of these defaults or to set additional information, edit the rhq-server.properties file. This is briefly covered in Section 2.6.2, “Attributes in the Properties File”.
  7. Optional. The Windows services run by default as the local system account (Default or .\LocalSystem). It is possible to configure the services to run as different users by setting the appropriate properties in the rhq-agent-env.bat script.
    The RHQ_*_RUN_AS parameter sets the user account to use. The RHQ_*_RUN_AS_ME parameter uses the logged in user as the service account. If both parameters are set, then the RHQ_*_RUN_AS_ME parameter is the one which is used.
    RHQ_SERVER_RUN_AS=.\username
    RHQ_SERVER_PASSWORD=password
    	
    RHQ_STORAGE_RUN_AS=.\username
    RHQ_STORAGE_PASSWORD=password
    	
    RHQ_AGENT_RUN_AS=.\username
    RHQ_AGENT_PASSWORD=password
    The defined user account must have the log on as service permission. This may need to be granted explicitly.
  8. Run the JBoss ON control script to configure the server and other services. If the rhq-server.properties file is not edited, then the script prompts for a bind address for the server; this can be set to 0.0.0.0.
    C:\jon\jon-server-3.2.0.GA\bin> serverRoot/jon-server-3.2.0.GA/bin/rhqctl.sh install --start
    23:07:00,901 INFO  [org.jboss.modules] JBoss Modules version 1.2.2.Final-redhat-1
    
    The [jboss.bind.address] property is required but not set in [rhq-server.properties].
    Do you want to set [jboss.bind.address] value now?
    yes|no: yes
    jboss.bind.address: 0.0.0.0
    Is [0.0.0.0] correct?
    yes|no: yes
    This command does two things:
    • Configure the JBoss ON server, a storage node, and an agent.
    • Start all services when the configuration process is complete.
  9. It may take several minutes for the server process to start fully. Afterward, log into the server web UI to begin configuring resources.
    The default administrator username and password are rhqadmin/rhqadmin. The server URL is http://hostname:7080. For example:
    http://server.example.com:7080