6.3. Editing JBoss ON Server Configuration in rhq-server.properties
rhq-server.properties
configuration file in the serverRoot/jon-server-3.2.GA/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.
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
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.
6.3.1. Properties Set at Installation
This sets the type or vendor of the database that is used by the JBoss ON server. This is either PostgreSQL or Oracle.
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.
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.
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.
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).
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 8.2, “Changing Database Passwords”.
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
rhq-server.properties
file.
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
rhq-server.properties
file.
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.
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.
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
.
This sets the hostname of the SMTP server used by the JBoss ON server. Emails are sent primarily for alert notifications.
This sets the address to use for the From header of all emails sent by the JBoss ON server.