5.3. Editing JBoss ON Server Configuration in rhq-server.properties

JBoss ON server configuration properties are stored either in the rhq-server.properties configuration file in the serverRoot/jon-server-3.1.2.GA1/bin directory or in the JBoss ON database. The configuration file contains most of the basic information about the JBoss ON server, such as the TCP/IP ports it listens on and its hostname or IP address.
The JBoss ON server configuration is loaded from the rhq-server.properties file when the server starts. The initial configuration is defined by the installer when the JBoss ON program is set up.

NOTE

Because the configuration properties are loaded from rhq-server.properties when the JBoss ON server starts up, you have to restart the JBoss ON server after making any changes to that configuration file so the new settings are loaded.

5.3.1. Properties Set at Installation

The defining server properties — such as the server name, port, and the database to use — are set when the server instance is configured.
Changing the database properties is covered in Section 7, “Managing Databases Associated with JBoss ON”.
Database Type
This sets the type or vendor of the database that is used by the JBoss ON server. This is either PostgreSQL or Oracle.
Database Connection URL
This gives the JDBC URL that the JBoss ON server uses when connecting to the database, such as jdbc:postgresql://localhost:5432/rhq or jdbc:oracle:oci:@localhost:1521:orcl.
Database JDBC Driver Class
This gives the fully qualified class name of the JDBC driver that the JBoss ON server uses to communicate with the database, such as oracle.jdbc.driver.OracleDriver.
Database XA DataSource Class
This gives the fully qualified class name of the JDBC driver that the JBoss ON server uses to communicate with the database, such as org.postgresql.xa.PGXADataSource or oracle.jdbc.xa.client.OracleXADatasource.
Database User Name
This gives the name of the user that the JBoss ON server uses when logging into the database. This user must already exist in the database; according to the basic installation instructions, this is a specially-created rhqadmin user (not related to the super user in JBoss ON).
Database Password
This gives the password of the database user that is used by the JBoss ON server when logging into the database. This password is stored in a hash in the rhq-server.properties file. When the password is changed in the database, then the password must be manually hashed and copied into the rhq-server.properties file. This is described in Section 7.2, “Changing Database Passwords”.
Server Name
This sets a unique name for the JBoss ON server. The default is the system's hostname, but it can be any string, as long as it is unique within the JBoss ON server cloud.

NOTE

Unlike other server properties, this is only managed through the JBoss ON UI, not its rhq-server.properties file.
Server Public Address
This gives the public IP address to use for the server. This is the address that must be recognized by all agents needing access to this server. By default, this is the value of the localhost's public IP address. The public IP address is used with the HTTP/HTTPS ports to provide a high availability endpoint for agents.

NOTE

Unlike other server properties, this is only managed through the JBoss ON UI, not its rhq-server.properties file.
HTTP Port
This sets the port that the JBoss ON GUI listens to for unsecured HTTP requests. This is the port number in the JBoss ON GUI URL, such as the 7080 in http://localhost:7080. This is also the unsecured port used as the endpoint in high availability.
Secure HTTPS Port
This sets the port that the JBoss ON GUI listens to for secured HTTPS requests. This is the port number used in the JBoss ON GUI URL, such as the 7443 in https://localhost:7443. This is also the secure port used as the endpoint in high availability.
Server Bind Address
This gives the IP address for the JBoss ON GUI console, among other services, to bind to. This is the host in the JBoss ON GUI URL, such as server.example.com in http://server.example.com:7080.
Email SMTP Hostname
This sets the hostname of the SMTP server used by the JBoss ON server. Emails are sent primarily for alert notifications.
Email From Address
This sets the address to use for the From header of all emails sent by the JBoss ON server.