Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

2. Installation and Upgrade Issues

Q: I'm seeing error messages when I install (or upgrade) my server. What do they mean?
Q: I've installed my server, but I can't connect to it. What's wrong?
Q: The installer fails on PostgreSQL with "Relation RHQ_Principal does not exist."
Q: I upgraded my server, but when I try to connect to the installer page to configure it, it keeps trying to redirect me to the (old) coregui/ module. How do I get to the installer?
Q: The JBoss ON install fails on Oracle with the ORA-01843.
Q:
I'm seeing error messages when I install (or upgrade) my server. What do they mean?
A:
During the upgrade, you may see error messages in the console similar to the following:
ERROR [ClientCommandSenderTask] {ClientCommandSenderTask.send-failed}Failed to send
command [Command: type=[remotepojo]; cmd-in-response=[false]; config=[{rhq.timeout=1000,
rhq.send-throttle=true}]; params=[{targetInterfaceName=org.rhq.enterprise.communications.Ping,
invocation=NameBasedInvocation[ping]}]]. Cause: org.jboss.remoting.CannotConnectException:[.....]
These can be ignored.
Q:
I've installed my server, but I can't connect to it. What's wrong?
A:
If the installer was not bound to 0.0.0.0 when it was run, then the necessary connection properties are not set for the server in the rhq-server.properties file. The java.rmi.server.hostname parameter must be set manually to the real IP address of the server, which matches the value of the jboss.bind.address parameter. Restart the server after editing the rhq-server.properties file to load the new settings.
Q:
The installer fails on PostgreSQL with "Relation RHQ_Principal does not exist."
A:
First, ensure that the JBoss ON server installer has the correct permissions to connect to PostgreSQL. Open the PostgreSQL configuration file pg_hba.conf and check that the permissions have been enabled. The Installation Guide has more information on setting up PostgreSQL for installation.
Q:
I upgraded my server, but when I try to connect to the installer page to configure it, it keeps trying to redirect me to the (old) coregui/ module. How do I get to the installer?
A:
Some browsers cache the previous coregui/ module and attempt to redirect you there automatically after upgrading, even though the upgraded coregui/ module has not yet been loaded.
Simply navigate directly to the installer page:
http:/server.example.com:7080/installer/start.jsf
Q:
The JBoss ON install fails on Oracle with the ORA-01843.
A:
This issue occurs when Oracle runs in a locale where the abbreviation for April is not APR, as in English and German. There are currently two workarounds:
  • Put Oracle in a different locale.
  • Edit one of the server distribution files before running the installer:
    1. Remove the old server directory and unzip the install package again.
    2. Open the serverRoot/jon-server-3.1.0.GA1/jbossas/server/default/rhq-installer.war/WEB-INF/classes directory.
    3. Edit db-data-combined.xml. Update a few dates in the form 01-APR-08 to be in the current locale.
    4. Save the file.
    5. Re-run the installer and choose to overwrite the database.