Actions

Monitoring redundancy in VS Operator

From Zenitel Wiki

AI.png

The VS Operator can be used together with a redundant system, communicating with the Operational IP address. It can provide graphical indications of Server Status and Server Operational Mode, and also display the Power Supply status.

Monitoring Servers

Here is a description on how to set up monitoring so the ICX-AlphaCom statuses can be viewed in VSOP.

An example of the VS-Operator display:

Redundancy monitoring


AlphaPro Events

To pass the Server Status and Operational Mode to VS-Operator, we use a Dummy Number (9600) and the Custom Parameter feature. We also add an event to trigger a refresh of the status' towards VSOP using another dummy number (991)

In AlphaPro configure these two events:

Redundancy monitoring event


Action commands:

IF %op(%udd(101),=,1)
@*D1 M7F01 L(1)9600 U0 W1 W2 W0 W0 W0
ENDIF
IF %op(%udd(101),=,2)
@*D1 M7F01 L(1)9600 U0 W2 W1 W0 W0 W0
ENDIF
IF %op(%udd(101),=,3)
@*D1 M7F01 L(1)9600 U0 W1 W3 W0 W0 W0
ENDIF
IF %op(%udd(101),=,4)
@*D1 M7F01 L(1)9600 U0 W3 W1 W0 W0 W0
ENDIF


Timeout event


Action commands:

$ST L%1.dir W200 L991
IF %chg(1,0)
IF %op(%syse(230),==,0)
IF %syse(232)
WUDD 101 1
STOP
ENDIF
WUDD 101 2
STOP
ENDIF
ENDIF
IF %syse(232)
WUDD 101 3
STOP
ENDIF
WUDD 101 4


VS-Operator configuration

Create two icon sets to display the status. One icon set will be for the Operational Status of the ICX-AlphaCom, and the other will be to indicate the VS-Operator connection to the Operational Server.

The icons used in this example are created in PowerPoint.

Operational Status Icons

IPHA example3.png


Navigate to the Icon sets menu and click Add, then choose GPD:


Give the GPD Icons a name, in this case IPHA_Monitor

Add your four custom icons as GPD state 0-3 by clicking the 3 dots beside 'Image', selecting the Load button and navigating to your Icon. Note that after loading, you may need to disable the Stretch option to display correctly.

  • State 0 - Blank Icon
  • State 1 - Operational Icon
  • State 2 - Standby Icon
  • State 3 - Offline Icon
dd icons to GPD StatesA C


System Operation Icons

IPHA example5.png


Navigate to the Icon sets menu and click Add, then choose Node:

Adding Node Icon Set


Add your two custom icons as Node state 0-1 following the directions in the last step.

Adding custom icons


VSOP Map

To display the Icons, we need to create a Map page with a background. In the example below, the Zenitel logo and the icons for the ICX Primary and ICX Secondary has been created as a static image in Powerpoint.

Click on Map Pages, followed by Add. Give the map a name and load in the background image. Resize accordingly.

dding a Map pageA


VSOP Startup script

If VSOP is started after the IPHA monitor scripts have already run in the ICX-AlphaCom Event Handler, the status of the Operational Server or System status unknown, so a startup script is needed the force the Event Handler to resend the status. Here, we send a command to the ICX-AlphaCom to start a 10 second timer on our Dummy Number 991

Click on Menu and Global Settings. Enable the Startup script and click on the 3 dots to open the editor. Add the following line;

Action commands:

App.STE ("$ST L101 W100 L991");


Adding a Startup Script


VSOP Filter

In order to catch the custom parameters sent from the Event Handler we need a filter, and this filter must be tied to our first Dummy Number 9600.

Click on Filter Sets, followed by Add and Station.

Adding a Filter Set


Create a custom filter using the On Custom Params message

Give the Filter a name, here we are using IPHA_State. Select On Custom Params and enable the check boxes for Show, Log and Script. Enter a Message Text to be displayed in the Journal and enter the Script. Action commands:

int n1 = App.Params.Get("cp1", 0);
int n2 = App.Params.Get("cp2", 0);
App.SetGPDState("Primary", n1, true, true);
App.SetGPDState("Secondary", n2, true, true);


Press the Test button, followed by the OK button.

Adding the Filter Script for On Custom Params


Adding devices to VSOP

Vsop add.jpg


Add two GPD devices. Name these 2 devices Primary and Secondary. Set the Source name field for Primary and Secondary respectively. Set the Icon Set for IPHA_Monitor.

Vsop redundancy GPD.png


Add one Node Device. Name this the Node name of the system. Set the Icon Set for NodeStatus

Vsop redundancy node.png


Add one Station device. Name this IP_HAFilter and set the AlphaCom Station to Node 1 Directory Number 9600 and the Filter Set to IPHA_state.

Vsop redundancy station.png


Place the icons on the map by drag and drop.

Redundant Power supplies

The Power Supplies can be monitored, and faults and warnings can be logged.

Here is a description on how to set up monitoring so the redundant power supply statuses can be viewed in VSOP.

Redundant power monitoring


OBS icon The following description relates to the redundant power solution as mentioned further up in this article



AlphaPro Event

In AlphaPro configure the two TKIS-2 kits which receive the inputs from the Redundancy module as 9901 Primary and 9902 Secondary. Put them both in a UDP group (UDP2 is used in this example), and create this event:

Redundant power supply monitoring event


Action commands:

@*d1 M7F03 L(1)9901 U0 W%chg(1,0) W%sev(1) W0 W0 W0 "PSU%1.nam\t %1.nam\t"
IF %chg(1,0)
IF %op(%sev(1),=,1)
LOG "Power redundancy DOWN for %1.nam server"
STOP
ENDIF
IF %op(%sev(1),=,2)
LOG "Power redundancy WARNING for %1.nam server"
STOP
ENDIF
ENDIF
LOG "Power redundancy OK for %1.nam server"


VS Operator Configuration

VSOP Icons

Create a icon set (the icons used in this example is created in PowerPoint): The GPD Icons used for the Redundant Power Supply statuses:

IPHA example15.png


Navigate to the Icon sets menu and click Add, then choose GPD:

Adding GPD icon set


Name the Icon Set 'PSU Monitoring' and add your four custom icons as GPD state 0-3:

Creating custom GPD icon set


VSOP Filter

In order to catch the custom parameters sent from the Event Handler we need a filter, and this filter must be tied to the TKIS-2 Power monitoring stations.

Click on Filter Sets, followed by Add and Station.

1: Adding Station filter set


Create a custom filter using the On Custom word string message

Give the Filter a name, here we are using PowerMonitor. Select On Custom word string and enable the check box for Script. As we are creating the Log messages from the script, we can leave the Show and Log checkboxes unchecked, and we do not need a message text. Copy and paste the script, press the Test button and then OK.

Creating custom filter set


Action commands:

int RED_state = App.Params.Get("cp1", 0);
int RED_type = App.Params.Get("cp2", 0);
if (RED_state==1)
{
App.SetGPDState("%CSP1", RED_type, true, true);
if (RED_type==1)
App.Log("Redundancy power for %CSP2 server is reported down", true, true);
else if (RED_type==2)
App.Log("Redundancy power for %CSP2 server reports a warning", true, true);
}
if (RED_state==0)
{
App.SetGPDState("%CSP1", 3, true, true);
App.Log("Redundancy power for %CSP2server is reported OK", true, true);
}


OBS icon '%CSP1 (custom string parameter 1) refers to the Source Name of the GPD.



Adding devices to VSOP

Add two GPD devices. Name the 2 GPD devices 'PSUPrimary' and 'PSUSecondary'. Set the Source name field for Primary and Secondary respectively. Set the Icon Set for PSU Monitoring.

GPD name reference


Add two Station devices, one for each TKIS (9901 & 9902). Name the TKIS-2 station 'Power TKIS 1' and 'Power TKIS 2' and select the station custom filter for Redundant Power Supply monitoring.

Vsop power tkis.png


Place the GPS Icons on the Map. Optionally, create Icons for the Power Monitoring TKIS-2 units and place them on the Map.