Refer to http://rhq-project.org/display/JOPR2/Installation for the latest information. The instructions on this page may be out of date.

1. Go to the Jopr - Releases page and download the Jopr distribution.
2. Unzip the distribution in a suitable place (i.e. in a directory not too deeply nested and with no spaces or non-ASCII characters in its name)
3. Install a database like PostgreSQL (version 8.2.4 +, please choose C locale for initdb), create a database instance called 'rhq' in it and a user 'rhqadmin' that owns this 'rhq' database.

   create user rhqadmin password 'rhqadmin';
   
   create database rhq owner rhqadmin;
   
4. Eventually set RHQ_SERVER_JAVA_HOME or RHQ_SERVER_JAVA_EXE_FILE_PATH env variables appropriately. This is needed if your JAVA_HOME does not point to a java installation that is valid with Jopr (e.g. java 1.4); Jopr requires java5+.
   
5. cd into the jopr-server-*/ directory and start the Server:
   

bin/rhq-server.sh console

6. After a few seconds, the messages on the console will stop. When this happens, point your browser to http://localhost:7080/ and run the installer.
7. When this is done and you can log in (default user / pass are: rhqadmin/rhqadmin), it is time to start the Agent. Start a second shell for this.
8. Unpackage the Agent into a directory of your choosing:
   
   • If you received the Agent as a .zip package, simply unzip it into your chosen directory
   • If you received the Agent as a agent update binary .jar, copy it to your chosen directory and run "java -jar <agent-update-binary.jar> --install"
   • NEW In Jopr 2.2: If you do not yet have an Agent distribution, but you have started your Jopr Server as described above, then you can pull down an Agent update binary .jar directly from the server and install it using these instructions:
     • Point a browser to "http://<your-server-hostname>:7080/agentupdate/download" and save the Agent binary update jar in a directory where you want to install the agent (the file you save should have a .jar extension; "<your-server-hostname>" should be the hostname or IP address of the server that is running and "7080" is the port on which that the server is accepting HTTP requests)
     • Run "java -jar <agent-update-binary.jar> --install" where "<agent-update-binary.jar>" is the name of the file you downloaded from the server
9. cd into the Agent directory (typically named "rhq-agent").
10. Start the Agent by issuing:
    

    bin/rhq-agent.sh 
    

    Answer the questions asked by the Agent.
11. Go back to the Server GUI and to its Dashboard. Watch resources show up in the upper right in the Autodiscovery portlet, and import them.
12. Done :-)

For a more detailed installation document, you can go to the JBoss Operations Network documentation.

Note for Oracle users:

As Jopr is now using XA-Transactions, you need issue the following grants as sysdba:

GRANT SELECT ON sys.dba_pending_transactions TO rhqadmin;
GRANT SELECT ON sys.pending_trans$ TO rhqadmin;
GRANT SELECT ON sys.dba_2pc_pending TO rhqadmin;
GRANT EXECUTE ON sys.dbms_system TO rhqadmin;

Note for Postgres users:

 org.postgresql.util.PSQLException: FATAL: Ident authentication failed for user "rhqadmin",

you need to edit the pg_hba.conf file from postgres.

locate pg_hba.conf file, which is e.g. located in /var/lib/pgsql/data on Fedora. It should contain a line like the following so that it does not force access to database as 'postgres' UNIX user (by default, it says: ident sameuser)

host    all         all         127.0.0.1/32          trust

restart postgres afterwards:

sudo service postgresql restart