m351 8 Osag A4 e Screen

You might also like

Download as pdf or txt
Download as pdf or txt
You are on page 1of 20

OTN Manual

OSAG (OTN Software Application Gateway)


Doc. No.: AG-M351-E-8











COPYRIGHT AND TRADE SECRETS/LIABILITY
The present document and its contents remain the property of OTN Systems NV and shall not, without prior
written consent, be copied or transmitted or communicated to third parties, nor be used for any other pur-
pose than such as underlies their delivery to the addressee.

The present document and its contents may change in the course of time or may not be suitable in a specif-
ic situation. Consequently, they are recommended as suggested guideline only.
OTN Systems NV hereby disclaims any liability for any damages that may result from the use of the
present document unless it is used with respect to the operation and maintenance of equipment originally
manufactured by OTN Systems NV and covered by its standard warranty.
Open Transport Network OSAG (OTN Software Application Gateway)
AG-M351-E-8 Page 3 of 20
Contents
1. GENERAL ................................................................................................................................... 4
2. OSAG INSTALLATION ............................................................................................................... 4
3. OVS ALARMS IN EXTERNAL VMS (E.G. VENUS) .................................................................... 4
3.1 General ............................................................................................................................. 4
3.2 OSAG Configuration ......................................................................................................... 4
3.3 Running OSAG ................................................................................................................. 5
4. OMS ALARMS IN OTN MESSENGER ....................................................................................... 6
4.1 General ............................................................................................................................. 6
4.2 OSAG Configuration ......................................................................................................... 6
4.3 Running OSAG ................................................................................................................. 6
5. OSAG REDUNDANCY, NO OMS/OVS REDUNDANCY............................................................. 7
5.1 General ............................................................................................................................. 7
5.2 OSAG.exe.config File on OSAG Server1 (e.g. Master) .................................................... 7
5.3 OSAG.exe.config File on OSAG Server2 (e.g. Slave) ...................................................... 8
5.4 OSAG Redundant Configuration OK ................................................................................ 8
6. OSAG REDUNDANCY WITH OVS/OMS REDUNDANCY .......................................................... 9
6.1 General ............................................................................................................................. 9
6.2 OVS Redundancy Configuration ..................................................................................... 10
6.3 OMS Redundancy Configuration .................................................................................... 10
6.3.1 OSAG.exe.config ............................................................................................................ 10
6.3.2 AlarmClient.exe.config .................................................................................................... 11
6.3.3 OMS.cfg .......................................................................................................................... 11
6.3.4 AutoStart in OMS Console .............................................................................................. 12
6.3.5 Both OMS Servers in Trouble ......................................................................................... 12
6.4 OSAG States .................................................................................................................. 16
7. ABBREVIATIONS ..................................................................................................................... 20


List of Figures
Figure 1 Visualize OVS Alarms Externally .............................................................................................. 4
Figure 2 OSAG.exe.config file. ................................................................................................................ 5
Figure 3 OSAG-Server ............................................................................................................................ 5
Figure 4 OSAG-Server Icon in Taskbar................................................................................................... 5
Figure 5 OMS-OSAG Interface ............................................................................................................... 6
Figure 6 OSAG.exe.config file. ................................................................................................................ 6
Figure 7 OSAG Redundant System ........................................................................................................ 7
Figure 8 Backup Gateway In OSAG Window .......................................................................................... 8
Figure 9 Example: Redundant OPC Clients via Redundant OVS and OSAG in OTN-Classic ................ 9
Figure 10 Example: Redundant OMS and OSAG in OTN-X3M ............................................................. 9
Figure 11 Local OMS Server Running, Remote in Standby (=NotRunning) .......................................... 12
Figure 12 Local OMS Server Running, Remote Unreachable ............................................................... 13
Figure 13 Local OMS Server Faulty, Remote Unreachable .................................................................. 13
Figure 14 Local OMS Server Faulty, Remote Unreachable .................................................................. 14
Figure 15 Local OMS Server Stopping, Remote Unreachable .............................................................. 14
Figure 16 Local OMS Server Stopped, Remote Unreachable ............................................................... 15
Figure 17 Local OMS Server Starting, Remote Unreachable ................................................................ 15
Figure 18 Local OMS Server Running, Remote Unreachable ............................................................... 16
Figure 19 Screen from the MASTER OSAG PC ................................................................................... 17
Figure 20 Screen from the MASTER OSAG PC ................................................................................... 18
Figure 21 Screen from the MASTER OSAG PC ................................................................................... 18
Figure 22 Screen from the MASTER OSAG PC ................................................................................... 19
Figure 23 Screen from the REDUNDANT OSAG PC ............................................................................ 19
Figure 24 Screen from the REDUNDANT OSAG PC ............................................................................ 20


List of Tables
Table 1 Reference Documents ................................................................................................................ 4
Table 2 OSAG Redundancy Policy ....................................................................................................... 16
Table 3 OVS/OMS-OSAG Redundancy States ..................................................................................... 17

OSAG (OTN Software Application Gateway) Open Transport Network
Page 4 of 20 AG-M351-E-8
1. GENERAL
OSAG is alarm handling software;
OSAG allows OVS and OMS to output alarms to external applications;
OSAG itself acts as a server and stores the possible alarms and their status;
External applications can be used to visualize the alarm info;
OSAG itself can be configured redundantly;
OSAG is also necessary if OVS/OMS redundancy is required (see chapter 6).


Table 1 Reference Documents
Ref. Number Title
[1] AG-M330-&-* OTN Management System (OMS), User Manual
[2] AH-M704-&-* OVS Configuration Manual
[3] AH-M340-&-* VENUS Manual
[4] AG-M356-&-* OTN Messenger with Pager
[5] AH-M360-&-* SQL Server Redundancy


2. OSAG INSTALLATION

As of OMS v7.4, OSAG is installed automatically together with the OMS installation. OSAG is installed into directory <OMS
Path>\OSAG.

3. OVS ALARMS IN EXTERNAL VMS (E.G. VENUS)
3.1 General
The OSAG and the OVS can be set-up to output alarms to VENUS. The OVS will receive alarms from one of its interfaces
(UPH, OPC etc.) and sends these alarms, with their alarm state, to the OSAG server and vice versa.
Finally, these alarms can be visualized in a VMS (e.g. Venus).




VENUS
Alarm
database
Visualize alarms
from OSAG
DCOM
Alarms
OVS
(client)
OSAG
(server)



Figure 1 Visualize OVS Alarms Externally

3.2 OSAG Configuration
The OSAG uses a TCP-IP port for communication with other programs (OVS and OMS). This TCP-IP port is the only thing that
might be configured. By default, this port is configured to 4000. Normally, this value is OK, but if any other application already
uses this port, it must be configured to another port number in the following file: <OMS installdir>\OSAG\OSAG.exe.config
(see figure below). Edit and save this file.

Open Transport Network OSAG (OTN Software Application Gateway)
AG-M351-E-8 Page 5 of 20

Figure 2 OSAG.exe.config file.

3.3 Running OSAG

1. Start the OSAG server via Start Programs OTN OMS OSAG; The figure below pops up:


Figure 3 OSAG-Server

2. The OSAG-server icon is also visible in the MS Windows Taskbar.

Figure 4 OSAG-Server Icon in Taskbar

3. Make sure to configure an alarmclient in the OVS configuration tool, as described in Ref. [2] Table 1;

OSAG (OTN Software Application Gateway) Open Transport Network
Page 6 of 20 AG-M351-E-8
4. OMS ALARMS IN OTN MESSENGER

4.1 General
The OSAG and the OMS can be set-up to export OMS alarms to external applications e.g. the OTN Messenger, see figure
below. The OMS and the OMS Alarm Handler Client can both be found on the OMS DVD.
For more information on the OTN Messenger, see Ref. [4] Table 1.



OTN
MESSENGER
Alarm
database
OMS
OSAG (server)

Ethernet
LAN

Alarm- MAIL
OMS Alarm
Handler Client
Alarms
OAlarmServer

Alarm- SMS


Figure 5 OMS-OSAG Interface

4.2 OSAG Configuration
The OSAG uses a TCP-IP port for communication with other programs (OVS and OMS). This TCP-IP port is the only thing that
might be configured. By default, this port is configured to 4000. Normally, this value is OK, but if any other application already
uses this port, it must be configured to another port number in the following file: <OMS installdir>\OSAG\OSAG.exe.config
(see figure below). Edit and save this file.



Figure 6 OSAG.exe.config file.

4.3 Running OSAG
1. Start the OMS server via Start Programs OTN OMS OMS Console Start OMS Server;

2. In the OMS Console, start the OMS Gui via clicking Start OMS GUI;

3. Start the OSAG via Start Programs OTN OMS OSAG or via <OSAG installdir>/OSAG.exe;

4. Start the OMS Alarm Handler Client via Start Programs OTN OMS OMS Alarm Handler Client or via <OMS
installdir>/bin/OMSAlarmHandlerClient.cmd;

5. Start your Alarm Client application e.g. the OTN Messenger via <OTN Messenger Installdir>/OTNMessenger.exe;
Open Transport Network OSAG (OTN Software Application Gateway)
AG-M351-E-8 Page 7 of 20
5. OSAG REDUNDANCY, NO OMS/OVS REDUNDANCY
5.1 General
The OSAG can be set-up redundantly, independent of OVS or OMS redundancy. Two different OSAGs can run on two
different PCs. Both redundant OSAGs will receive alarms, with their status, of the connected systems (OVS or OMS) and
send them to each other. Off course, both OSAGs have to be configured to make them communication possible. This configu-
ration is done on each OSAG server in the file: <OMS installdir>\OSAG\OSAG.exe.config in the section <appSettings>, see
5.2 and 5.3.

The settings in 5.2 and 5.3 are sufficient for OSAG redundancy. If you have additional OMS and/or OVS redundancy, some
extra settings must be done, for OVS see 6.2, for OMS see 6.3.



OSAG Server1
(MASTER)

IP: 220.220.39.3:4000

Ethernet
LAN

OSAG Server2
(SLAVE)

IP: 220.220.39.1:4000

Figure 7 OSAG Redundant System

5.2 OSAG.exe.config File on OSAG Server1 (e.g. Master)
1. In the <appSettings> below, fill out a unique ServerId Master OSAG must have ServerId 0;
2. In the <appSettings> below, in the PeerURL field, fill out the <ip address:port> of the Slave OSAG redundant server;
3. Use/uncomment the <channel> line with the bindTo parameter and comment/delete the <channel> line without the
bindTo parameter. Fill out the IP-address of the NIC card (that does the OSAG communication) on the Master PC in the
bindTo parameter.

<configuration>
<appSettings>
<add key="ServerId" value="0"/>

<!-- For redundante setup use: -->
<add key="PeerUrl" value="tcp://220.220.39.1:4000/AlarmmanagerURI"/>

<add key="LeaseTime" value="600000"/>
<add key="NotifyTimeOut" value="10000"/>

<!-- For OVS redundancy use: -->
<!-- <add key="OVSUrl" value="C:\\Program Files\\OTN Systems\\OVS v5.4\\OVS.exe"/> -->
<!-- <add key="OVSParams" value="-name OVS"/> -->
<!-- <add key="OVSProcesses" value="OTNVideo,X3MVideo,OVSIPClient,OVS"/> -->
<!-- <add key="OVSPingInterval" value="10000"/> -->
<!-- <add key="OVSStartStopTimeOut" value="30000"/> -->

<!-- For OMS redundancy use: -->
<!-- <add key="OVSUrl" value="C:\\OMS\\OMS_V7.1\\bin\\OmsConsole.exe"/> -->
<!-- <add key="OVSParams" value=""/> -->
<!-- <add key="OVSProcesses" value="OmsConsole,OKernel,OAlarmServer,OLogServer,omniNames,OAO_EventJournal,OAO_Journal"/> -->
<!-- <add key="OVSPingInterval" value="10000"/> -->
<!-- <add key="OVSStartStopTimeOut" value="30000"/> -->

</appSettings>

<system.runtime.remoting>
<application name="Alarmmanager">
<service>
<wellknown mode="Singleton" type="Alarmmanager.Alarmmanager, AlarmmanagerLib" objectUri="AlarmmanagerURI" />
</service>
<channels>
<!-- <channel ref="tcp" port="4000" timeout="-1"> -->
<!-- For multiple NICs use: -->
<channel ref="tcp" port="4000" bindTo="220.220.39.3" timeout="-1">
<serverProviders>
<formatter ref="binary" typeFilterLevel="Full" />
</serverProviders>
<clientProviders>
<formatter ref="binary" />
</clientProviders>
</channel>
</channels>
</application>
</system.runtime.remoting>
</configuration>

OSAG (OTN Software Application Gateway) Open Transport Network
Page 8 of 20 AG-M351-E-8
5.3 OSAG.exe.config File on OSAG Server2 (e.g. Slave)
1. In the <appSettings> below, fill out a unique ServerId Slave OSAG must have ServerId 1;
2. In the <appSettings> below, in the PeerURL field, fill out the <ip address:port> of the Master OSAG redundant server;
3. Use/uncomment the <channel> line with the bindTo parameter and comment/delete the <channel> line without the
bindTo parameter. Fill out the IP-address of the NIC card (that does the OSAG communication) on the Slave PC in the
bindTo parameter.

<configuration>
<appSettings>
<add key="ServerId" value="1"/>

<!-- For redundante setup use: -->
<add key="PeerUrl" value="tcp://220.220.39.3:4000/AlarmmanagerURI"/>

<add key="LeaseTime" value="600000"/>
<add key="NotifyTimeOut" value="10000"/>

<!-- For OVS redundancy use: -->
<!-- <add key="OVSUrl" value="C:\\Program Files\\OTN Systems\\OVS v5.4\\OVS.exe"/> -->
<!-- <add key="OVSParams" value="-name OVS"/> -->
<!-- <add key="OVSProcesses" value="OTNVideo,X3MVideo,OVSIPClient,OVS"/> -->
<!-- <add key="OVSPingInterval" value="10000"/> -->
<!-- <add key="OVSStartStopTimeOut" value="30000"/> -->

<!-- For OMS redundancy use: -->
<!-- <add key="OVSUrl" value="C:\\OMS\\OMS_V7.1\\bin\\OmsConsole.exe"/> -->
<!-- <add key="OVSParams" value=""/> -->
<!-- <add key="OVSProcesses" value="OmsConsole,OKernel,OAlarmServer,OLogServer,omniNames,OAO_EventJournal,OAO_Journal"/> -->
<!-- <add key="OVSPingInterval" value="10000"/> -->
<!-- <add key="OVSStartStopTimeOut" value="30000"/> -->
</appSettings>

<system.runtime.remoting>
<application name="Alarmmanager">
<service>
<wellknown mode="Singleton" type="Alarmmanager.Alarmmanager, AlarmmanagerLib" objectUri="AlarmmanagerURI" />
</service>
<channels>
<!-- <channel ref="tcp" port="4000" timeout="-1"> -->
<!-- For multiple NICs use: -->
<channel ref="tcp" port="4000" bindTo="="220.220.39.1" timeout="-1">
<serverProviders>
<formatter ref="binary" typeFilterLevel="Full" />
</serverProviders>
<clientProviders>
<formatter ref="binary" />
</clientProviders>
</channel>
</channels>
</application>
</system.runtime.remoting>
</configuration>



5.4 OSAG Redundant Configuration OK
When communication between the two OSAGs is established, the redundant OSAG will be visible in the OSAG window in the
Backup Gateway section, as shown below:

In case of redundant OSAG,
backup gateway is filled out

Figure 8 Backup Gateway In OSAG Window
Open Transport Network OSAG (OTN Software Application Gateway)
AG-M351-E-8 Page 9 of 20
6. OSAG REDUNDANCY WITH OVS/OMS REDUNDANCY
6.1 General

ATTENTION:

OSAG MASTER = OSAG PC that has key="ServerId" value="0" in the OSAG.exe.config file;
OSAG SLAVE = OSAG PC that has key="ServerId" value="1" in the OSAG.exe.config file;
OVS/OMS MASTER = OVS/OMS PC that has the distribution and publication configured in its SQL Server; See
Ref.[5] in Table 1 for more info on SQL Server Redundancy.
OVS/OMS SLAVE = OVS/OMS PC that has the subscriber configured in its SQL Server; See Ref.[5] in Table 1
for more info on SQL Server Redundancy.

It is strongly advised to configure the OSAG Master on the OVS/OMS Master
It is strongly advised to configure the OSAG Slave on the OVS/OMS Slave

An OSAG/OVS Redundancy system is possible as of OSAG version 2.0.2.
An OSAG/OMS Redundancy system is possible as of OSAG version 2.0.14.




OTN
OVS1
OSAG1
switch
switch
COM
Server
OPC1
OVS2
OSAG2
switch
switch
COM
Server
OPC2
spanning tree
spanning tree
V
I
D
4
V
I
D
4
V
I
D
4
RS422
IP
IP
KEPWARE
RedundancyMaster
KEPWARE
RedundancyMaster
IP
OSAG2 OSAG1

Figure 9 Example: Redundant OPC Clients via
Redundant OVS and OSAG in OTN-Classic




OTN-X3M
OMS1
OSAG1
switch
OMS2
OSAG2
switch
B
O
R
A
B
O
R
A
B
O
R
A
IP
IP
Spanning tree
OSAG2
OSAG1

Figure 10 Example: Redundant OMS and OSAG in
OTN-X3M
OSAG (OTN Software Application Gateway) Open Transport Network
Page 10 of 20 AG-M351-E-8
6.2 OVS Redundancy Configuration
In <OMS installdir>\OSAG\OSAG.exe.config, add following indicated lines (<add key.) in the <appSettings> section of an
OSAG redundant system (see chapter 5):
<appSettings>
<add key="ServerId" value="1"/>

<!-- For redundante setup use: -->
<add key="PeerUrl" value="tcp://220.220.39.3:4000/AlarmmanagerURI"/>

<add key="LeaseTime" value="600000"/>
<add key="NotifyTimeOut" value="10000"/>
<!-- Extra lines for OSAG-OVS Redundancy: -->
<!-- path to OVS.exe with double \\ -->
<add key="OVSUrl" value="C:\\Program Files\\OTN Systems\\OVS v5.4\\OVS.exe"/>
<!-- ovs.exe commandline parameters: -->
<add key="OVSParams" value="-name OVS"/>
<!-- all processes below seperated with a , will be closed by OSAG at a switch-over: -->
<add key="OVSProcesses" value="OVSBroker,OTNVideo,X3MVideo,OVS"/>
<!-- interval in ms between two pings from the OSAG to the own OVS: -->
<add key="OVSPingInterval" value="10000"/>
<!-- The time in ms that OVS can use to start-up. If this fails, it is decided that OVS cannot start. -->
<!-- This is also the time that OVS can use to shut down. After this time, all mentioned process above -->
<!-- are hard killed -->
<add key="OVSStartStopTimeOut" value="60000"/>
</appSettings>

These extra lines (keys) result in PC Icons in the screenshots in paragraph 6.4 below.

6.3 OMS Redundancy Configuration
6.3.1 OSAG.exe.config
In <OMS installdir>\OSAG\OSAG.exe.config, add following indicated lines (<add key.) in the <appSettings> section of an
OSAG redundant system (see chapter 5):

<appSettings>
<add key="ServerId" value="1"/>

<!-- For redundante setup use: -->
<add key="PeerUrl" value="tcp://220.220.39.3:4000/AlarmmanagerURI"/>

<add key="LeaseTime" value="600000"/>
<add key="NotifyTimeOut" value="10000"/>

<!-- Extra lines for OSAG-OMS Redundancy: -->
<!-- path to OmsConsole.exe with double \\ -->
<add key="OVSUrl" value="C:\\OMS\\OMS_V7.0\\bin\\OmsConsole.exe"/>
<!-- OmsConsole.exe commandline parameters: -->
<add key="OVSParams" value=""/>
<!-- all processes below seperated with a , will be closed by OSAG at a switch-over: -->
<add key="OVSProcesses" value=" OVSProcesses" value="OmsConsole,OKernel,OAlarmServer,OLogServer,omniNames,OAO_EventJournal,OAO_Journal,OMSE-
NC,OMSE-EM,OMSE-IM,OMSE-UM,OMSE-LogServer "/>
<!-- interval in ms between two pings from the OSAG to the own OMS: -->
<add key="OVSPingInterval" value="5000"/>
<!-- The time in ms that OMS can use to start-up. If this fails, it is decided that OMS cannot start. -->
<!-- This is also the time that OMS can use to shut down. After this time, all mentioned process above -->
<!-- are hard killed
<add key="OVSStartStopTimeOut" value="120000"/>
</appSettings>

These extra lines (keys) result in PC Icons in the screenshots in paragraph 6.4 below.
Extra info on the line below:
N50 nodes in your network (OMS-FEM is used): Yes/No?
Yes: use the line below:
<add key=" OVSProcesses" value="OmsConsole,OKernel,OAlarmServer,OLogServer,omniNames,OAO_EventJournal,OAO_Journal,OMSE-NC,OMSE-EM,OMSE-IM,OMSE-UM,OMSE-
LogServer "/>
No: use the line below instead:
<add key=" OVSProcesses" value="OmsConsole,OKernel,OAlarmServer,OLogServer,omniNames,OAO_EventJournal,OAO_Journal "/>
All these OVSProcesses (OMSConsole, Okernel...) are monitored when the OSAGs are started for the first time. The
OSAG in the Starting state will maintain this state until all its configured processes are up and running. For example,
OMSAlarmHandlerClientV2 is by default not started together with OMS. If nothing extra is done, the starting OSAG stays
in the Starting state because this process is monitored but never started. As a result, OMSAlarmHandlerClientV2 must be
added in OMS Console Edit Options OMS Boot Sequence, to make it start by default together with OMS.
Open Transport Network OSAG (OTN Software Application Gateway)
AG-M351-E-8 Page 11 of 20



All these OVSProcesses (OMSConsole, Okernel...) are being monitored continously at runtime as well. If at runtime,
one of these processes breaks down, the OSAG turns into a Faulty state. In normal conditions, in OMS redundancy, a
manual switch-over must be forced via right-clicking the PC icon in the OSAG window, and click switch-over. In the
condition that the standby OSAG is not reachable (see 6.3.5), the local OMS server must be stopped/rebooted also via
right-clicking on the PC icon and clicking Stop server.
The OMSAlarmHandlerClientV2 is optional and must only be activated (= added as value in the OVSProcesses list)
when the OSAG window must display the total amount of alarms.
All these OVSProcesses (OMSConsole, Okernel...) are shut down when a switch-over occurs;


6.3.2 AlarmClient.exe.config
In the file <OMS Path>\bin\AlarmClient.exe.config, in the indicated line in the url field, fill out the <ip address:port> of the
PC network card, used to communicate with the alarm handing network. E.g. if you are on the Slave PC, fill out the IP-
address of the used network card that is plugged into the slave PC. Best practise is to do this with both the Master and Slave
PC, but is especially needed on the Master/Slave PC that has multiple network cards plugged in.

<configuration>
<system.runtime.remoting>
<application name="AlarmClient">
<client>
<wellknown type="Alarmmanager.IAlarmmanager, IAlarmmanager" url="tcp:// 220.220.39.1:4000/AlarmmanagerURI" />
</client>
<channels>
<channel ref="tcp" port="0">
<!-- For multiple NICs use: -->
<!-- <channel ref="tcp" port="0" bindTo="127.0.0.1"> -->
<serverProviders>
<formatter ref="binary" typeFilterLevel="Full" />
</serverProviders>
<clientProviders>
<formatter ref="binary" />
</clientProviders>
</channel>
</channels>
</application>
</system.runtime.remoting>
</configuration>


6.3.3 OMS.cfg
The action below has to be done on both the Master and Slave OMS PC when using OSAG/OMS redundancy.
Uncomment the indicated line in the file <OMS Path>\config\OMS.cfg. In the Redundancy_URL field, fill out the <ip
address:port> of the OSAG PC network card. If the OMS and the OSAG are located on the same PC, and there is only one
network card in the PC, keep the original line with localhost:4000 in it.

// ------------------------------------------------------------------------------------------------------
// Uncomment and configure this to enable activation of OMS-redundancy with OSAG
// Fill out the IP address that is configured for the OSAG (in the OSAG config file). In case of
// redundant OMS this IP address is the IP address that the local OSAG uses to contact the remote OSAG.
// ------------------------------------------------------------------------------------------------------
Redundancy_URL=tcp://localhost:4000
// ------------------------------------------------------------------------------------------------------


OSAG (OTN Software Application Gateway) Open Transport Network
Page 12 of 20 AG-M351-E-8
6.3.4 AutoStart in OMS Console
At OMS switch-over, the OMS Console of the new active OMS will start-up automatically. It is possible that the OMS Server is
started automatically as well, but this has to be configured in the OMS Console via Edit Options General General
and setting Autostart = True.


6.3.5 Both OMS Servers in Trouble
In case of OMS Redundancy and in some very exceptional conditions, it is possible that both OMS servers get in trouble. For
example the remote OMS server becomes unreachable due to a fiber break.
If in addition the local OMS server becomes erroneous for some reason, it cannot reboot itself automatically. It cannot be
rebooted by the other OSAG either in this situation, because that one is unreachable. In this very exceptional situation, a
manual reboot of the local OMS server has to be forced. Below, find some screenshots of such a double-trouble scenario, and
how to solve/escape such a situation.
ATTENTION: Forcing a local OMS server reboot can only be performed if at least both OMS Servers (OSAGs) have been in
the Reachable state once.
Screenshot below: Looking at the OSAG Master PC, normal situation, local OMS is up and active (=Running), remote OMS
is in standby (=NotRunning) and ready to take over in case of problems with the local OMS/OVS. (For an overview of all the
possible states, see 6.4)
Indicates
the OSAG
MASTER
Active
Local
OMS
Server
Standby
Remote
OMS
Server

Figure 11 Local OMS Server Running, Remote in Standby (=NotRunning)




Open Transport Network OSAG (OTN Software Application Gateway)
AG-M351-E-8 Page 13 of 20
Screenshot below: Looking at the OSAG Master PC, error situation1, local OMS is up and running, remote OMS becomes
unreachable e.g. due to a fiber break or an other remote error.

Error1:
Remote
OMS
Server

Figure 12 Local OMS Server Running, Remote Unreachable

Screenshot below: Looking at the OSAG Master PC, error situation2, local OMS gets in trouble and turns into the faulty
state, remote OMS is still unreachable. Both OMS servers are in trouble now.

Error2:
Local
OMS
Server
Error1:
Remote
OMS
Server

Figure 13 Local OMS Server Faulty, Remote Unreachable

OSAG (OTN Software Application Gateway) Open Transport Network
Page 14 of 20 AG-M351-E-8
Screenshot below: Looking at the OSAG Master PC, both OMS servers in trouble, a manual reboot of the local OMS server
has to be forced via right-clicking the Local OMS server icon, and then clicking Stop server (Stop server is only available in
the Faulty state).
Right-click
PC icon
and click
Stop server

Figure 14 Local OMS Server Faulty, Remote Unreachable

Screenshot below: Looking at the OSAG Master PC, both OMS servers in trouble, the local OMS server turns into stopping
mode after clicking Stop server on the local OMS server.


Figure 15 Local OMS Server Stopping, Remote Unreachable

Open Transport Network OSAG (OTN Software Application Gateway)
AG-M351-E-8 Page 15 of 20
Screenshot below: Looking at the OSAG Master PC, both OMS servers in trouble, the local OMS server has completely
stopped and is ready for a reboot.


Figure 16 Local OMS Server Stopped, Remote Unreachable

Screenshot below: Looking at the OSAG Master PC, remote OMS server still unreachable, local OMS is rebooting/starting.

Local OMS
server
rebooting

Figure 17 Local OMS Server Starting, Remote Unreachable

Screenshot below: Looking at the OSAG Master PC, local OMS server up and running again after reboot.
OSAG (OTN Software Application Gateway) Open Transport Network
Page 16 of 20 AG-M351-E-8
Local
OMS Server
Active
again !
Remote
OMS Server
still
unreachable

Figure 18 Local OMS Server Running, Remote Unreachable
6.4 OSAG States
- Two OSAGs monitor two OVS/OMS PCs during redundant operation. Each OVS/OMS state is displayed in each OSAG.
- In the OSAG screenshots below, the orange star-icon indicates the MASTER OSAG PC.
- If you are looking at the MASTER OSAG PC, the star-icon is positioned next to the Local PC icon (see further on);
- If you are looking at the REDUNDANT OSAG PC, the star-icon, is positioned next to the Remote PC icon;
- It is possible to switch over manually via right-clicking the PC-icon. This only works when the right-clicked PC-icon is in
the Running state and the other PC-icon is in the Not Running state.

Table 2 OSAG Redundancy Policy
OVS/OMS State PC Color Description
Initializing Grey At startup: This is the first state that is assigned to the remote PC, during the initial start-up.
The remote PC is in the state Initialising. The local PC is in the state Not Running.
Both OSAGs are trying to find each other over the IP network for the first time.
Starting Yellow One of the two OSAGs has decided to start up an OVS/OMS (at start-Up, this will be the MAS-
TER OVS/OMS). The dedicated OVS/OMS will turn into the Starting state.
Not Running Yellow At startup: This is the first state that is assigned to the Local PC, during the first initial start-up.
The remote PC is in the state Initialising.
In operation: This is the state that is assigned to the OVS/OMS that is standby and waiting to
get started, in case the Running OVS/OMS gets into trouble.
Faulty
(OMS only)
Orange This Faulty state is only relevant for OMS. It indicates that the OMS PC is faulty because one of
the OVSProcesses listed in the OSAG.exe.config file is faulty or has crashed. The operator
has to switch-over manually to the other OMS PC via a right-click on the faulty PC icon. If the
other standby OSAG is not reachable, a switch-over cannot be done, perform a stop server
instead (reboot server), see also 6.3.5.
Unreachable Red For some reason, the Running OVS/OMS cannot reach the Not Running OVS/OMS. The
state of the Not Running OVS/OMS turns into Unreachable. Both OVSs/OMSs start up.
Stopping Red The Running OVS/OMS has been commanded to stop because a switch-over is going to
happen. The Running OVS/OMS turns into Stopping.
Stopped Red This state lasts only a few seconds and follows the stopping state. This stopped state wil
soon turn into the the Not Running state.
Running Green This state indicates the active OVS/OMS.
Open Transport Network OSAG (OTN Software Application Gateway)
AG-M351-E-8 Page 17 of 20

Table 3 OVS/OMS-OSAG Redundancy States
Local OVS/OMS State Remote OVS/OMS State Actions
Not Running Not Running (automatic) Start MASTER OVS/OMS
Running Running (automatic) This situation can only occur if both OSAGs cannot commu-
nicate with each other. The redundant OMS/OVS will be stopped auto-
matically when the communication between both OSAGs has been re-
covered.
Not Running Unreachable (automatic) Start OVS/OMS
Not Running Stopped (automatic) Start OVS/OMS
Faulty (OMS only) Not Running (manually) Operator must switch-over manually to redundant OMS
Faulty (OMS only) Unreachable (manually) Operator must stop server on the local OSAG (see 6.3.5)

Find below some example screenshots from a Redundant OSAG-OVS system in operation.
The screenshots for a Redundant OSAG-OMS system are similar.

Also a manual switch over is shown. The screens have been taken both from the MASTER OSAG PC (star-icon local) and
REDUNDANT OSAG PC (star-icon remote).

ATTENTION:
OSAG MASTER = OSAG PC that has key="ServerId" value="0" in the OSAG.exe.config file;
OSAG SLAVE = OSAG PC that has key="ServerId" value="1" in the OSAG.exe.config file;
OVS/OMS MASTER = OVS/OMS PC that has the distribution and publication configured in its SQL Server;
OVS/OMS SLAVE = OVS/OMS PC that has the subscriber configured in its SQL Server;
It is strongly advised to configure the OSAG Master on the OVS/OMS Master
It is strongly advised to configure the OSAG Slave on the OVS/OMS Slave

Screenshot below: Looking at the OSAG Master PC, normal situation, local OMS/OVS is up and running, remote OMS/OVS
is in standby and ready to take over in case of problems with the local OMS/OVS.


Indicates
the OSAG
MASTER
0 Indicates
the OSAG
MASTER

Figure 19 Screen from the MASTER OSAG PC

Screenshot below: Looking at the OSAG Master PC, normal situation, no problems, but operator decides to switch-over to
remote OMS/OVS PC.
OSAG (OTN Software Application Gateway) Open Transport Network
Page 18 of 20 AG-M351-E-8
Right-click for
switch-over

Figure 20 Screen from the MASTER OSAG PC

Screenshot below: Looking at the OSAG Master PC, after the switch-over command, the Running OMS/OVS has been
commanded to stop because a switch-over is going to happen. The Running OMS/OVS turns into Stopping mode.


Figure 21 Screen from the MASTER OSAG PC

Screenshot below: Looking at the OSAG Master PC, after the Stopping state, the local PC turns into the Sopped state. No
two OMS/OVSes can run at the same time. The local PC will soon turn into the NotRunning state, and the remote PC will soon
turn into the Starting state.
Open Transport Network OSAG (OTN Software Application Gateway)
AG-M351-E-8 Page 19 of 20


Figure 22 Screen from the MASTER OSAG PC

Screenshot below: Now looking at the other OSAG Redundant (slave) PC, after the switch-over command on the Master
OSAG, the Master OSAG has turned into the NotRunning state. The local (Redundant) OMS/OVS PC is starting up.

1 Indicates the
OSAG
REDUNDANT PC
OSAG
REDUNDANT
PC

Figure 23 Screen from the REDUNDANT OSAG PC

Screenshot below: Still looking at the OSAG Redundant (slave) PC, after the Local starting state, the PC will turn into the
running state. The local Redundant OMS/OVS PC is up and running.
OSAG (OTN Software Application Gateway) Open Transport Network
Page 20 of 20 AG-M351-E-8


Figure 24 Screen from the REDUNDANT OSAG PC

7. ABBREVIATIONS
GUI Graphical User Interface
OMS OTN Management System
OSAG OTN Software Application Gateway
OTN Open Transport Network
OMS OTN Management System
OVS OTN Video Solution
SMS Short Message Service

You might also like