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:
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.
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):
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:
After a short while the Hyperic Analytics Pack adaptor should appear:
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.
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
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
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)
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:
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.
The next thing to do is to start creating some custom dashboards. I will cover that in a future blog post!