vSphere Integration: Orchestrator Package Details

Table of Contents

• Introduction
• How to Trigger Orchestrator Events from Uptime
  • Configuring Uptime to communicate with VMware Orchestrator
  • Uptime Workflow Elements
• How to Trigger Uptime Events from Orchestrator
  • Installing the uptime workflow package in Orchestrator
  • Configuring Orchestrator to communicate with Uptime

---

Introduction

The Uptime Orchestrator package allows administrators to integrate Uptime's infrastructure management and monitoring capabilities with Orchestrator's versatile scripting engine.

Integration provides benefits to both solutions: Uptime administrators can create Action Profiles that react to critical events by automatically initiating and providing parameters for Orchestrator workflows; Orchestrator administrators can retrieve values from and act on a Monitoring Station's monitored elements.

---

How to Trigger Orchestrator Events from Uptime

Configuring Uptime to communicate with VMware Orchestrator

Configuring Uptime to work with Orchestrator is as easy as going to the Config page in the Uptime interface and entering the Orchestrator login info.

1. Login to the Uptime Monitoring Station interface as a user that has Administrator permissions (must be able to see the Config tab)
2. Click on the Config tab at the top and click on the "VMware vCenter Orchestrator" link on the left
3. Click on the "Edit Configuration" button on the top right (screenshot)
   
   
4. Enter all of the appropriate settings for Uptime to connect to Orchestrator
   • Orchestrator Enabled - Check on to use Orchestrator features in Uptime (action profiles)
   • Orchestrator Server - Hostname of system where Orchestrator server is installed
   • Orchestrator Port - Port to connect to Orchestrator (default 8281)
   • SSL - If SSL is enabled on Orchestrator
   • Username - User name to login to Orchestrator
   • Password - Password to login to Orchestrator
   
   
   
5. Click on the "Test Configuration" button to test if Uptime can properly communicate with Orchestrator

Congratulations! You should now have successfully integrated Uptime with VMware Orchestrator!

Uptime Workflow Elements

The following workflows elements are available through the Uptime Orchestrator package, and can be used in Uptime workflows, or in other workflows that include actions on the Uptime Monitoring Station:

Workflow Element	Notes
Add element to service group	Adds an element (found on host > ESX server > node) to an Uptime Service Group by hostname or IP address.
Add element to view	Moves an element to a view, both of which are referenced by their Uptime name. Element IDs are resolved from the names.
Add ESX host
Add agent system
Add node
Create infrastructure group
Create view
Destroy element
Destroy infrastructure group
Destroy view
Get service monitor data	Both the service monitor metric's name and the host's display name are required.
Get service monitor status	The host's display name is required.
Get application status	The Uptime Application's name must be specified.
Move element into infrastructure group	Moves an element to a group, both of which are referenced by their Uptime name. Element and group IDs are resolved from their names.
Remove element from service group
Remove element from view
Trigger external event	To trigger the external check, all parameters normally used with extevent.pl must be provided.

---

Orchestrator Setup

Installing the uptime workflow package in Orchestrator

Installing the uptime workflow package is as simple as downloading it and importing it into Orchestrator.

uptime produces a package with the namespace: com.uptimesoftware.uptime

The package file is available here

1. Login to Orchestrator using the VMware Orchestrator Client
2. Select the "Packages" section on the left and click on the drop down arrow and select "Import Package..." option (see screenshot below)
   
   
3. Locate the downloaded uptime package file and click Open
   
   
4. Confirm the signature and click on the Import button
   
   
   
   You should now see the uptime workflow package in Orchestrator:
   
   

Configuring Orchestrator to communicate with Uptime

Now that the uptime workflow package is in Orchestrator, we just need to point it to the Uptime monitoring station.

1. Click on the Configurations section on the left
2. Right-click on the "Uptime Configuration" option on the left and click on "Edit"
   
   
3. Enter the Uptime "admin" user name and password and the Uptime monitoring station URL. The URL must be in the following format:
   http://<HOSTNAME>:9996/command
4. Click on the Save and Close button on the bottom right