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:

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:

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

  2. Open a terminal window.

  3. 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:

  1. On the RHEL computer, start a terminal either as the root user or as an unprivileged user who has sudo privileges.

  2. 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:

  1. Imports the vFabric GNU Privacy Guard (GPG) key.

  2. Installs the vFabric 5.2 repository RPM.

  3. Launches the VMware End User License Agreement (EULA) acceptance and repository configuration script.

  4. Outputs the EULA for you to read; you must answer yes to accept the terms and continue.

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:

  1. 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

  2. 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.

  3. Enter y at the prompt to start the installation installation.

  4. 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:

  1. Log in to the RHEL VM as root.

  2. 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.

  3. 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.

  4. 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

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 
################################################################################