vFabric Hyperic Integration with vCenter Operations – a quick guide to setup

With the launch of vCenter Operations 5.7.1 VMware also released a new integration with vFabric Hyperic called the Hyperic Analytics pack.  The new analytics pack has an easy to install adapter and a preconfigured dashboard.  Here are some simple steps you can follow to get this up and running.

1 – Install the Hyperic vApp

2 – Install some Hyperic Agents and point them at the vApp

3 – Install and configure the Hyperic Adapter in vCenter Operations

Once installed you can start to use the out of the box preconfigured dashboard and also build up some powerful custom dashboards combining vCenter and Hyperic metrics to manage entire application stacks.

1 – Install the Hyperic vApp

If you have not bought the product you can get a 60 day evaluation version here: https://my.vmware.com/web/vmware/evalcenter?p=vf-hyperic

The file you need for the vAPP is:

Hyperic OVA

The installation documentation for Hyperic is here:  http://www.vmware.com/pdf/Getting-Started-with-vFabric-Hyperic-57.pdf

It’s quite a lengthy document, the bit you need to follow is from page 34 ‘Procedure’.  Also, note when you do ‘File|Deploy OVF Template’ the actual file you are deploying is an OVA, not an OVF as described in the documentation.  Once deployed simply start the vApp and it is ready to go.

2 – Install Hyperic Agents

Again this is described in the above document.  To install the agents on a Windows Server (perhaps a SQL or Exchange box to get some interesting application data) just download and run the following on the server you want to manage and during the installation configure it to connect to your Hyperic server.

Windows agent install

3 – Install and Configure the Hyperic Analytics Pack adapter

Note:  IMPORTANT!  Your vCenter Operations vApp must be at release 5.7.1.

3.1 – Install adapter PAK file

The adapter PAK file and documentation is available at: ftp://ftp.integrien.com/VCOPS-VMware_Product_Adapters/VMware-HypericSolutionsPack/

Log into the admin console of your vCenter Operations vApp – http://ipaddressofvCOPS-UI/admin and navigate to the update tab.  Locate the PAK file and enter it’s location in the update box, accept the EULA, click OK to confirm and go and get a cup of tea/coffee while it installs (don’t be surprised if it takes 10-15 minutes):

PAK file installing

Now you need to configure the adaptor and the first step is to ‘Describe’ the adaptor.

3.2 – Describe Adapter

Log into the custom UI – http://ipaddressofvCOPS-UI/vcops-custom and select admin| support.   Scroll down to the Adaptors info panel and click on the Describe button:

Describe button

After a short while the Hyperic Analytics Pack adaptor should appear:

Analytics adapter

3.3 – Configure vCenter in the Hyperic Server

The next step is to tell the Hyperic instance your vCenter details.  Log into your Hyper Server console ( http;//ipaddressof hyperic:7080 ) navigate to Administration|HQ Server Settings and enter the server details.

Hyperic vCenter

You can check that it is connected properly by browsing for a resource in the Resources tab and looking for a MOID and vCenter UUID

MOID

3.4 – Configure Postgres to accept inbound communication from vCenter Operations

The next step is not well documented – there is a KB article that describes what needs to be done (for an older version) and I have raised this to see if VMware can provide an updated KB and installation document.

The Hyperic DB needs to be configured to allow it to accept inbound communication from the Hyperic vCenter Operations Adapter.  To do this you will have to edit a configuration file.

Log into the Hyperic DB server as Root (same password as you set for hqadmin when you installed it), navigate to the /opt/vmware/vpostgres/9.1/data directory and edit the pg_hba.conf file.

Add the line

Host            All              All                 0.0.0.0/0                 trust

postgres

3.5 – Add Credentials

Next, go back to the vCenter Operations Custom UI as you need to Add Credentials so the Hyperic adaptor can talk to the Hyperic vApp.  Select Environment|Configuration|Credentials.  Choose Adapter kind vCenter Operations Hyperic Analytics Pack and Hyperic Credentials as the credential and click Add

Provide an instance name of your choices and enter credentials for the Adapter to authenticate to Hyperic (Hyperic User name) and for Hyperic to authenticate to vCenter Operations (Http Post User name)

credentials

3.6 – Add an Adapter instance

The penultimate step is to add an Adapter instance.

In the vCenter Operations Custom UI select Environment|Configuration|Adapter instances.  Select vCenter Operations Standard Server then vCenter Operations Hyperic Analytics Pack from the Adapter Kind drop-down menu.

Click on Add New Adapter Instance icon.  And fill the details in as follows:

adapter

To use Certificates (in a production environment for example) information on configuration is provided in the Adapter installation documentation.

3.7 – Add the Availability dashboard

Finally you need to import the Hyperic Availability dashboard.  This is called Hyperic-Availability.xml and can be found in the vcenterops\user\plugins\inbound\hypericapi_adapter3\conf\dashboards folder in the vCenter Operations UI server.

On the vCenter Operation Custom UI select Import and import the dashboard.  Got to Dashboards|HQ|Availability to open it.

Availability dashboard

The next thing to do is to start creating some custom dashboards.  I will cover that in a future blog post!

5 Thoughts

  1. on the postgresql setting I found for hyperic 5.7.1 you need to have the Method as md5 not trust and this worked fine.

    Great article and very very very did I say very handy.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s