Installing WebHookPost
The first piece that needs to be set up and configured is the tool used to listen for the POST coming from the YourSix system. This is called internally the WebHookPost but can be called anything we like on the IIS server. This should be installed on a machine with IIS that is externally accessible.
- Create a folder to hold the application. Typically "C:\inetpub\wwwroot\webhook".
- Unzip the WebHookPost application (WebHookPost-CI-1.0.0.10251.zip ) into this path.
- Open the Web.Config file and edit the default values for the "Y6SignalCache" and "Y6LogPath" if desired. Also, create these folders if needed.
- In IIS, add application to the site you wish this to live under. Typically "Default Web Site"
- Provide whatever alias you like the path to be called. This is part of the URL that would be given to the YourSix system to know how to send the POST to Manitou.
- Set the Physical Path to point to the folder created in Step 1.
- Open a browser and navigate to the URL for https://{default web site}/{alias}/y6signal. You should get the following message if it is all configured correctly. Now any POSTS to that same URL should result in a JSON file being created in the Y6SignalCache directory.
Media Gateway Data Mapping
We have to build the Media Gateway side. Start with the Data Map. A sample file (YourSix-10620221714824.sig) is useful for this part. Place the sample file on the server.
Here is where the sample file is useful.
- Click the ellipsis next to the label and point to the example file.
- Select the desired label from the parsed sample file.
The event code mapping listed is for all known topics coming from YourSix currently. If they add more, this mapping would need to be updated. - Add the "Replace" Field Mapping Method for the topic field. (Ellipsis to the far right) These are what become different event codes. We suggest using the following as defaults:
- Note that we are using the CentralStationAccount from YourSix to create the TXID, the groupDescription to create the Area, and the Device Name to create the Zone for the alarm. These MUST be set up in the YourSix portal for this to route correctly in Manitou.
Media Gateway Connector
We need to build the connector to pull in the files we receive from YourSix. Navigate to Universal Connector > Connector
- Click Add and create a new File Connector called Y6
- Select the folder pointed to by the Web.Config called Y6SignalCache for the File Location
- Add ".SIG" for the File Extension
Media Gateway Line Drivers
The last piece is to configure the Line Driver to tie this all together. Navigate to the Line Drivers section.
- Add a new line by selecting the Y6 connector from the first dropdown box
- Add a description (YourSix)
- Choose Universal Connector for the Line Function
- Right-click the Properties box and select Properties
- Set the Name = YOURSIX
- Pick the FieldSet to the Y6DATAMAP we created
- Set the FEP that you wish to use
- Set the Receiver that was created to receive MGW signal
- Set the Line number you wish to use
- Pick the UCSEND menu
You are now done setting up the Media Gateway. Save and if needed "Re-load & Restart all Devices".
Initial Testing
Initial testing can be done by copying/pasting the example file into the Y6SignalCache folder. The Media Gateway log should show it being processed and passed through to Manitou. You can look at the Raw Data Log to make sure it gets received correctly. It will likely end up in the default system account but should create an alarm.
