Update: yes it still works with 6.7, no need to change or remove anything the upgrade just works.

With this next post I will share my vRops “Custom Rest Outbound Plugin“, what this plugin allows you to do is customize the structure of the XML / JSON sent by vRops to the destination REST listener. (check out this post for a simple Powershell listener you can use to debug / test the structure)

I will start off by saying… use this at your own risk! removal / cleanup of the plugin requires access to the Cassandra DB so it might not be everyone’s cup of tea! + each time vRops upgrades you risk breaking vRops because the plugin prevents “analytics” from starting due to changes in lib’s &/or java versions…. I maintain this for myself and I am happy to do it for the community but I defiantly do not support it!

I am not going to go over the top and write a full on detailed blog post… you should be able to “read between the lines” and work it out…. otherwise this really isn’t for you to play with!
Dowonload for vRops 6.6 – 6.6.1: CustomRestPlugin-vMan-v1.1-vRops_66

Installation of the plugin

1). You will need to stop vRops from the Admin console, take a snapshot, SSH to the vRops server or servers (I run this in a PROD clustered vRops configuration without issues) and follow the install instructions below.

2). The plugin jar will need to be copied to /usr/lib/vmware-vcops/user/plugins/outbound

3). Update /usr/lib/vmware-vcops/user/conf/messages/notificationPlugin.properties with the values below (note if you use vRops in a language other than English you will need to update your respective language file notificationPlugin_**.properties)

4). Start vRops from the admin console, wait for it to start up and then login to the GUI, navigate to Administration –> Management –> Outbound Settings

Create a new outbound plugin with the required details

REQUEST EXAMPLE:

I use the <CallBackAddress> for the ticketing system to insert the Incident number back into vRops as a “note”

EXAMPLE REQUEST OUTPUT below…

(note that if you enable debug you will get a file generated here on the vRops server: /storage/log/vcops/log/XXX-CustomRestOutputXXXX.xml)

Here are a list of options that can be used in the REQUEST

To use it just create a new rule in Notification Settings and select the clustom outbound plugin for method

To remove the plugin and clean up the vRops Cassandra database

If you have deployed it to the system and want to remove it / clean up the GUI or update the describe.xml you can do so by following the instructions below.

Worth making a snapshot vRops now…

1).Remove what was added to /usr/lib/vmware-vcops/user/plugins/outbound and the /usr/lib/vmware-vcops/user/conf/messages/notificationPlugin.properties

2). Connect to the vRops via SSH, then run the cqlshrc command to connect to the Cassandra DB

3). Run a select looking for the plugin…

4). Now delete the record…

5). Restart the vmware-vcops service, no need to reboot…

vMan