How to Install RHQ

# by todd walters

Contents

Part I: Install Java and Configure Postgres. 2

Part II: Install RHQ.. 3

Part III:  Setup RHQ as a Service. 3

Part IV:  Installing the Agent on Clients. 4

Part V: Import Clients into RHQ-Server. 4

Part VI:  Create Alerts   - (coming soon). 5

Reference

·         https://docs.jboss.org/author/display/RHQ/Installing+the+Server?_sscc=t

·         Download the latest (4.8) RHQ  https://docs.jboss.org/author/display/RHQ/Download

·         RHQ 4.8 Release Notes

Information

URL

http://rhq01.mycompany.com:7080/coregui/

Login

user = rhqadmin

pass = rhqadmin

Database

name = rhq

owner = rhqadmin

rhqctl Examples

[root@rhq01 PG_9.2_201204301]# rhqctl status

14:53:49,439 INFO  [org.jboss.modules] JBoss Modules version 1.2.0.CR1

RHQ Storage Node                               (pid 52238  ) IS running

RHQ Server                                                       (pid 52406  ) IS running

JBossAS Java VM child process           (pid 52406  ) IS running

RHQ Agent                                                        (pid 53126  ) IS running

# rhqctl status --server

14:54:48,066 INFO  [org.jboss.modules] JBoss Modules version 1.2.0.CR1

RHQ Server                                                       (pid 52406  ) IS running

JBossAS Java VM child process            (pid 52406  ) IS running

Install Locations

RHQ Server Home         =          /software/rhq

RHQ Server                   =          /software/rhq/rhq-server-4.8.0

RHQ Storage                =          /software/rhq/storage

RHQ Storage Node       =          /software/rhq/rhq-server-4.8.0/rhq-storage

RHQ Agent                   =          /software/rhq/rhq-agent

Postgres Data               =          /postgres/pgdc01/9.2/

Postgres Tablespace     =          /postgres/data/dt001

Documentation Reference

·         RHQ Server Install -      

·         RHQ Agent Installation 

·         Initial Auto discovery and Import

·         RHQ Demos 

Part I: Install Java and Configure Postgres

1.       Switch user to postgres

2.       Change directory to # cd /postgres/pgdc01/9.2

3.       Create rhqadmin user

a.       $ createuser -h 127.0.0.1 -p 5432 -U postgres -S -D -R -P rhqadmin

4.       Create tablespace

a.       # psql

b.      # create tablespace dt001 owner rhqadmin location '/postgres/data/dt001';

c.       CREATE TABLESPACE

5.       Create database using pre initialized database and tablespace

a.       $ createdb -h 127.0.0.1 -p 5432 --tablespace=dt001 -U postgres -O rhqadmin rhq

6.       Switch back to root and install jdk

a.       # yum install jdk.x86_64

7.       Configure RHQ_SERVER_JAVA_HOME in /home/root/.bash_profile by adding the following:

·         export JAVA_HOME=/usr/java/latest
PATH=$PATH:$HOME/bin:$JAVA_HOME/bin

export PATH

export RHQ_SERVER_JAVA_HOME=$JAVA_HOME

·         source again:  . ~/.bash_profile

Part II: Install RHQ

1.       Upload the zip file to the server (prebuilt with postgresql kickstart)

2.       Create rhq directory

a.       # mkdir /software/rhq

3.       Copy the .zip file to /software/rhq (increased to 4gb)

4.       Unzip the file as shown

a.       # unzip rhq-server-4.8.0.zip

5.       Change directory to bin and edit the rhq-server.properties file

a.       cd /software/rhq/rhq-server-4.8.0/bin

b.      rhq.server.email.smtp-host=mail.mycompany.com

6.       Get encoded password and set in rhq-server.properties

a.       # ./rhq-installer.sh --dbpassword=rhqadmin
11:33:58,420 INFO  [org.jboss.modules] JBoss Modules version 1.2.0.CR1
11:33:59,710 INFO  [org.rhq.enterprise.server.installer.Installer] *** Encoded Password: 1eeb2f255e832171df8592078de921bc

7.       Create /software/rhq/storage directory and logical volume to mount

a.       # lvcreate -L 10GB rhelvg -n rhqstorLV

b.      # mkfs /dev/mapper/rhelvg-rhqstorLV

c.       Edit /etc/fstab and add line to mount to /software/rhq/storage

d.      # mount –a

8.       Change /software/pgpool/etc/pgpool.conf port from 9999 to 5999.

9.       Install using rhqctl from the bin dir

a.       # ./rhqctl install --storage-data-root-dir=/software/rhq/storage/

10.   Login to verify URL

a.     http://rhq01.mycompany.com:7080/coregui/

Part III:  Setup RHQ as a Service

1.       Copy /software/rhq/rhq-server-4.8.0/bin/rhq-server.sh

a.       # cp rhq-server.sh /etc/init.d/rhq-server

2.       Add to chkconfig

a.       # chkconfig –add rhq-server.sh

b.      # chkconfig rhq-server on

3.       Edit file and change RHQ_SERVER_HOME

a.       RHQ_SERVER_HOME=/software/rhq/rhq-server-4.8.0/

b.      JAVA_HOME=/usr/java/latest

c.       RHQ_SERVER_JAVA_HOME=$JAVA_HOME

4.       Verify rhq-server will run

a.       # service rhq-server status

Part IV:  Installing the Agent on Clients

1.       Download the agent to Install

a.       wget -P /tmp/  http://spacewalk.mycompany.com/sw/rhq-enterprise-agent-4.8.0.jar

2.       Install to /software directory

a.       # cd /software

b.      # java -jar /tmp/rhq-enterprise-agent-4.8.0.jar –install

3.       Configure the Agent ( later installs will have preconfigured agent)

a.       # cd /software/rhq-agent/bin

b.      # ./rhq-agent-wrapper.sh config 

                                                               i.      Enter defaults except for RHQ Server Host Name = rhq01.mycompany.com

4.       Start up the Agent

a.       # ./rhq-agent-wrapper.sh start

5.       Alternatively go to http://rhq01.mycompany.com:7080/coregui/CoreGUI.html#Administration/Topology/RemoteAgentInstall and install root from server. NOTE: must have root ssh perms, which we would need to modify.

Part V: Import Clients into RHQ-Server

1.       Login to RHQ Server

2.       Go to Inventory > Discovery Queue

3.       Click on resources you choose to import (select Child Platform too if wanted)

4.       Click on Import

Part VI:  Create Alerts   - (coming soon)

References

·         https://docs.jboss.org/author/display/RHQ/Initial+Auto-discovery+and+Import