Admin Guide 4. Troubleshooting
The Abiquo Events Notifier is a Python application that uses the Abiquo Outbound API and the Abiquo API to monitor the Abiquo platform and send emails to notify users of events in Abiquo. You can configure the users, as well as the types of events that will trigger notification emails. By default, the Email Notifier accesses the Abiquo API every five seconds but you should tune this value for your installation. You can run the Abiquo Events Notifier on the Abiquo Server or on a separate server with access to Abiquo API.
Download the Abiquo Email Notifier script from the Abiquo Enterprise Support website.
Abiquo Events Notifier require some additional python packages to run. You can get them from the default repository in CentOS6 or from a third party repository such as RPMforge in CentOS5 for example.
CentOS6 additional packages installation example:
Set the polling interval, which is the amount of time between API checks. The default is 5 seconds and the recommended value is between 5 and 10 seconds, but you should tune the polling value for your installation.
Set the IP of Abiquo API Server, a valid Cloud Admin user account registered in Abiquo and change the port if this is required in your setup.
IP address of the Abiquo API Server
Cloud Admin username
Cloud Admin password
|api_port||Abiquo API Server port|
Sender email address
Outgoing mail server IP address. The default is localhost
The default outgoing mail server port is 25
Alternatively, the events notifier can be run as "./main.py". Events will then display on the screen.
Rules can be added while the notifier is running. It will load rules every time it analyzes events, depending on the polling interval.
In the following examples, USERA and USERB must be Abiquo users with valid email addresses.
1. Monitor VAPP_CREATE and VAPP_DELETE actions performed by USERA and notify USERB.
2. Notify all users when their deploys/undeploys have finished.
3. Notify USERA when their deploys/undeploys have finished.
4. Notify USERB on all major events.
5. Notify the cloud admin user on all critical events.