Install Hyperic Server RPM

About this page...

This page has instructions for installing Hyperic Server 4.6 from an RPM to an RHEL 5 or RHEL 6 virtual machine

Before running the installer, see Hyperic Installation and Startup Process for information about where server installation fits in the implementation process. For production environments, there are several steps to perform before installing the Hyperic Server, including database setup and SSL configuration.

Installing a downloaded RPM?

Steps 1 through 3 apply if you are installing Hyperic Server from the VMware RPM repository. If instead, you have downloaded the server RPM, skip to Step 4 - Specify Server Configuration.

About Hyperic Server RPM

The name of the vFabric Hyperic Server RPM package is vfabric-hyperic-server, appended by an architecture suffix, such as .noarch or .x86_64.

When you install the server RPM, there are two ways to define the required installation options:

You can specify required Hyperic Server installation options in a properties file prior to installing the server, as described in Step 4 - Specify Server Configuration in Properties File, or
You can supply configuration options after installing the server, using one of the methods described in Configure Hyperic Server After RPM Installation.

The installation owner and the installation group are both hyperic

By default, yum will install the server in /opt/hyperic/server-current, where /opt/hyperic/server-current is a symbolic link to a sibling versioned directory, such as /opt/hyperic/server-4.6-EE.

Step 1 - Install vFabric License Server

Install the vFabric License Server on the VM where your existing vCenter Server is installed. For instructions, see Install vFabric License Server on Your vCenter Server in vFabric Suite 5.1.

Step 2 - Activate vFabric License

Active your vFabric Hyperic license. For instructions, see Activate vFabric Platform Licenses in vFabric Suite 5.1.

Step 3 - Install vFabric Repository RPM

In this step you install the vFabric Repository RPM on the RHEL VM where you will install the Hyperic Server. This RPM allows you to browse the vFabric repository.

vFabric RPM repositories are located on repo.vmware.com.

Following the instructions for you version of vFabric Suite:

Instructions for 5.0 and 5.1 Repositories

vfabric-5-2-repo — vFabric component RPMs that are certified for vFabric Platform 5.
vfabric-5.1-repo-5.1-1 — vFabric component RPMs that are certified for vFabric Suite 5.1.
vfabric-all-repo — vFabric component RPMs for customers who have not bought a vFabric 5 Standard or Advanced license, and more recently released versions of vFabric components that may not necessarily be certified to work with those of vFabric 5 or vFabric 5.1. (Note: This respository is deprecated in vFabric Suite 5.2}

If you have a vFabric Standard or Advanced license, plan to install only RPMs that are certified for vFabric 5 or 5.1, then install vfabric-5-repo-5-2 or vfabric-5.1-repo-5.1-1, as appropriate. If you do not have a vFabric Standard or Advanced license, or want to install a maintenance release that was not certified for vFabric 5 or vFabric 5.1, install vfabric-all-repo.

To install the 5.0, 5.1, or the vfabric-all-repo repository:

Log in to the RHEL VM as the root user (or as a user with sudo privileges).
Open a terminal window.

Install the desired repository RPMs. Note that the URLs of the RPMs vary depending on whether the version of RHEL you use.

For RHEL 5:

rpm -Uvh http://repo.vmware.com/pub/rhel5/vfabric/5/vfabric-5-repo-5-2.noarch.rpm
\\ to install the vFabric 5 repository RPM
rpm -Uvh http://repo.vmware.com/pub/rhel5/vfabric/5.1/vfabric-5.1-repo-5.1-1.noarch.rpm
\\ to install the vFabric 5.1 repository RPM
rpm -Uvh http://repo.vmware.com/pub/rhel5/vfabric-all/vfabric-all-repo-1-1.noarch.rpm
\\ to install the "all-repo" repository RPM

For RHEL 6:

rpm -Uvh http://repo.vmware.com/pub/rhel6/vfabric/5.1/vfabric-5.1-repo-5.1-1.noarch.rpm \\ to install the vFabric 5 repository RPM
rpm -Uvh http://repo.vmware.com/pub/rhel6/vfabric-all/vfabric-all-repo-1-1.noarch.rpm \\ to install the "all-repo" repository RPM

Use sudo to run the preceding commands if you are not logged in as root.

Searching the RPM repository

You can use the yum search vfabric command to list of vFabric components that you can install from the VMware repository. For example:

yum search vfabric
...
======================================== Matched: vfabric =========================================
vfabric-eula.noarch : VMware vFabric 5.1 End User License Agreement
vfabric-gemfire.noarch : VMware vFabric GemFire
vfabric-hyperic-agent.noarch : VMware vFabric Hyperic Agent
vfabric-hyperic-server.x86_64 : VMware vFabric Hyperic Server
vfabric-insight-agent.noarch : com.springsource.insight.dist.vfabric:agent-rpm
vfabric-insight-dashboard.noarch : com.springsource.insight.dist.vfabric:dashboard-rpm
vfabric-rabbitmq-java-client-bin.noarch : The RabbitMQ Java Client Library
vfabric-rabbitmq-server.x86_64 : The RabbitMQ server
vfabric-sqlfire.noarch : VMware vFabric SQLFire
vfabric-tc-server-standard.noarch : VMware vFabric tc Server Standard
vfabric-web-server.x86_64 : VMware vFabric Web Server

Instructions for 5.2 Repository

To install the vFabric 5.2 repository:

On the RHEL computer, start a terminal either as the root user or as an unprivileged user who has sudo privileges.
Install the vFabric repository RPM using the following wget command, passing it the appropriate URL. The URL differs depending on the version of RHEL you are using.
- Note: Run the entire wget command on a single line. Include the | sh at the end, or the RPM installation will not work.
- For RHEL 5:
```
wget -q -O - http://repo.vmware.com/pub/rhel5/vfabric/5.2/vfabric-5.2-suite-installer | sh
```
- For RHEL 6:
```
wget -q -O - http://repo.vmware.com/pub/rhel6/vfabric/5.2/vfabric-5.2-suite-installer | sh
```
- If necessary, use sudo to run the preceding commands if you are not logged in as the root user. For example:
```
sudo wget -q -O - http://repo.vmware.com/pub/rhel6/vfabric/5.2/vfabric-5.2-suite-installer | sh
```

The command performs the following tasks:

Imports the vFabric GNU Privacy Guard (GPG) key.
Installs the vFabric 5.2 repository RPM.
Launches the VMware End User License Agreement (EULA) acceptance and repository configuration script.
Outputs the EULA for you to read; you must answer yes to accept the terms and continue.

Step 4 - Specify Server Configuration

This section has instructions for configuring Hyperic Server in a properties file prior to installation. If you do not create a properties file prior to installing the server, the installer will configure the Hyperic Server in accordance with a default properties file.

To define Hyperic Server installation options in a properties file:

Running as root, or using sudo, create a directory for the properties file:

mkdir -p /etc/vmware/vfabric/hyperic

Specify the server installation settings in a file named vfabric_hyperic_server.properties.

You must name the file exactly as described and put it in the specified location for the RPM installation to work correctly.

See Server Properties File for RPM Installation for a listing of a sample vfabric_hyperic_server.properties file. Note that the example properties file configures Hyperic Server to use the built-in local Postgresql database. You can edit the properties file to configure Hyperic Server to use an external — either local or remote — Postgresql, MySQL, or Oracle database.
Copy vfabric_hyperic_server.properties to the /etc/vmware/vfabric/hyperic/ directory.
Install Hyperic Server following the instructions in the next section.

Step 5 - Install Hyperic Server

Start local SMTP server on Hyperic Server host

The RPM installer requires that your SMTP server is listening on port 25 on the Hyperic Server host.

To install Hyperic Server:

On the platform where you wish to install the Hyperic Server:
```
yum install vfabric-hyperic-server 
```
yum command automatically choses the appropriate RPM package based on your architecture (32- or 64-bit). You can also install the RPM with a particular architecture by specifying the appropriate suffix. For example, to install the 64-bit RPM of vFabric Web Server: yum install vfabric-web-server.x86_64
yum resolves dependencies and displays the packages it plans to install.

If this is the first time that you have installed a vFabric component on the VM, yum also installs the vfabric-eula RPM and prompts you to accept the VMware license agreement.
Enter y at the prompt to start the installation installation.
What happens next depends on whether you specified the server configuration in the /etc/vmware/vfabric/hyperic/vfabric_hyperic_server.properties file.
- If you did create the properties file, the setup dialog and responses from the properties file are displayed, and an "Installation Complete" message appear. After seeing this message, proceed to the Start the Hyperic Server step of Hyperic Installation and Startup Process.
- If you did not specify the server configuration in the properties file, the following message is displayed:
```
/etc/vmware/vfabric/hyperic/vfabric_hyperic_server.properties, not found. HQ will be installed, but not configured. 

Please use /opt/hyperic/hyperic-hqee-installer/setup.sh to interactively 
configure HQ. 
```

Step 6 - Start the Hyperic Server

Need to configure a license?

If you obtained Hyperic Server standalone, rather than as a part of vFabric Suite, perform the steps in Install or Configure vFabric Hyperic License before starting the Hyperic Server.

yum installs Hyperic Server to start automatically each time your RHEL VM is booted. The init script is /etc/init.d/hyperic-hq-server.

Follow these steps to start the Hyperic server manually:

Log in to the RHEL VM as root.
Open a terminal window and run the init script:
```
 
/etc/init.d/hyperic-hq-server start 
```
The first time Hyperic Server starts it may take a few minutes to initialize; subsequent startups will be faster.
After Hyperic Server starts, invoke the Hyperic user interface in your browser:
```
 
http://host:7080 
```
- Where host is the hostname of the RHEL VM on which you just installed Hyperic Server. #* If your browser is on the same computer on which you installed Hyperic Server, you can use localhost rather than the name of the computer.
Log in using the default administration username/password of hqadmin/hqadmin; be sure to change the password after you log into the Hyperic UI.

After Installing Hyperic Server

For information about installing the Hyperic Agent, see Install Hyperic Agent RPM.
For information and required and optional Hyperic Server Configuration see Hyperic Installation and Startup Process.

Server Properties File for RPM Installation

This section contains a listing of vfabric_hyperic_server.properties.

# Properties file for vFabric Hyperic Server Configuration 
# 
# This file must be place in /etc/vmware/vfabric/hyperic/ with a name of 
# vfabric_hyperic_server.properties to be used by the vfabric-hyperic-server 
# rpm for vFabric Hyperic Server configuration. 
# 
# 
# To configure the build-in local Postgresql database uncomment the below 
# sections. See below for other database types. 
# 
################################################################################
# Configuration of local built-in Postgresql database 

# Use the local built-in Postgresql database instead of other database types 
BUILT_IN_POSTGRESQL=yes 

# Do you accept the terms of the agreement? 
HQ_ACCEPT_EULA=y 

# HQ server installation path 
HQ_SERVER_INSTALL_PATH=/opt/hyperic 

# email address that HQ will use as the sender for email messages 
HQ_SENDER_EMAIL_ADDRESS=hqadmin@eng.vmware.com 

# encryption key to use to encrypt the database password 
HQ_DB_CRYPT_KEY=12345678 

# username be for the initial admin user 
HQ_ADMIN_USER=hqadmin 

# password be for the initial admin user 
HQ_ADMIN_PASSWORD=hqadmin 

# email address be for the initial admin user 
HQ_ADMIN_EMAIL_ADDRESS=hqadmin@eng.vmware.com 


# End of configuration for local built-in Postgresql database 
################################################################################



# To configure HQ with a local or remote database other than the built-in 
# local instance of Postgresql comment out the above section and uncomment 
# the properties in the section below. Support databases include local or remote 
# versions of MySQL, Oracle, and Postgresql. 
# 
################################################################################
# For configuration with local or remote MySQL, Oracle, and Postgresql databases 

### Do you accept the terms of the agreement? 
#HQ_ACCEPT_EULA=y 

### HQ server installation path 
#HQ_SERVER_INSTALL_PATH=/opt/hyperic 

### email address that HQ will use as the sender for email messages 
#HQ_SENDER_EMAIL_ADDRESS=hqadmin@eng.vmware.com 

### database type of [mysql|oracle|postgesql] 
#HQ_DB_TYPE=mysql 

### JDBC connection URL for HQ database 
#HQ_JDBC=jdbc:mysql://10.0.0.1:3306/hqdb 

### username to use to connect to the database 
#HQ_DB_USERNAME=hqadmin 

### password to use to connect to the database 
#HQ_DB_PASSWORD=hqadmin 

### encryption key to use to encrypt the database password 
#HQ_DB_CRYPT_KEY=12345678 

### username be for the initial admin user 
#HQ_ADMIN_USER=hqadmin 

### password be for the initial admin user 
#HQ_ADMIN_PASSWORD=hqadmin 

### email address be for the initial admin user 
#HQ_ADMIN_EMAIL_ADDRESS=hqadmin@eng.vmware.com 

# End of configuration 
################################################################################