Integrating Avi Networks Vantage with
Steps to Send Text and SMS Messages from Avi Networks Vantage
PageGate can be easily integrated with Avi Networks' Vantage alert notification system by using PageGate's GetASCII module to receive Command Line notifications from Vantage. PageGate can also receive email alerts from Vantage to turn them in to SMS, pages, updates to web APIs, etc.
First, we'll need to configure PageGate's GetASCII module so it can provide the command line executable to Vantage.
1) In Windows on the PageGate Server, create a new directory for the integration. We recommend creating a sub-directory of your PageGateData directory called 'Vantage'. By default, c:\PageGateData\Vantage\
2) Open the PageGate Admin.
3) Go to Interfaces - GetAscii - Settings.
4) Set the Polling Directory to the directory you created in step 1. By default, c:\PageGateData\Vantage\
5) Check Enabled.
6) Click Apply.
6a) If prompted, you do want to enable this for all existing groups and recipients.
Now that we've made the executable available to Splunk, you'll need to use Vantage's 'External Only' Alert Action:
You'll need to create a batch file (.bat) that Vantage can reference to execute a messaging command to PageGate. This batch file should be accessible to the Vantage server. You'll need to edit the batch file to say:
The command arguments need to be formatted as follows:
<GetASCII polling folder>\sendpage32.exe <recipient or group> <sender> <message>
For example, let's say you have the GetASCII polling directory set to c:\PageGateData\Vantage\, that you have a group in PageGate called 'itdept', that you wanted the alert to come from the sender Vantage and the message should say 'This is a test', you would use the following command arguments:
c:\PageGateData\Vantage\sendpage32.exe itdept Vantage This is a test
To have Avi Networks' Vantage email information to PageGate, you'll first need to configure a sub-domain off of your main email domain and redirect the MX record of the sub-domain to the IP address of the PageGate computer. For example, let's say that our main domain is example.com. We could then have the mail server administrators for example.com create the sub-domain messaging.example.com and redirect the MX record for this sub-domain to the IP of the PageGate computer. Once this is accomplished, here's how to configure PageGate's GetMail module:
1) Open the PG Admin.
2) Go to Interfaces - GetMail - Settings.
3) Check Enabled.
4) Enter your sub-domain name in the "Local Domain" field. For example, messaging.example.com
5) Click Apply.
5a) If prompted, select Yes, you do want this to be enabled for all groups and recipients.
Once you do that, every recipient and group within PageGate becomes a valid email address on the new sub-domain. For example, if we had a group named Alerts, we could send an email to firstname.lastname@example.org and GetMail would read the message in, then submit the message for delivery to all of the members of the Alerts group.