Managing Northbound Interfaces

Available Languages

Download Options

PDF (201.7 KB)
View with Adobe Reader on a variety of devices

Updated:May 4, 2007

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Managing CORBA Interfaces

Table Of Contents

Managing CORBA Interfaces

12.1  What is Cisco MGM GateWay/CORBA?

12.1.1  Viewing the Cisco MGM GateWay/CORBA Properties Pane

12.1.2  Viewing the Cisco MGM GateWay/CORBA Client Configuration Table

12.2  Using a Static CORBA Listener Port on the Cisco MGM Server

12.3  Configuring the CORBA Timeout

Managing CORBA Interfaces

This chapter contains the following information:

•What is Cisco MGM GateWay/CORBA?

•Using a Static CORBA Listener Port on the Cisco MGM Server

•Configuring the CORBA Timeout

Note Cisco MGM GateWay/CORBA is only mentioned briefly here. For more information about Cisco MGM GateWay/CORBA, including how to enable username and password encryption, set the heartbeat event, and create OSS clients, refer to the Cisco Media Gateway Manager 5.0 GateWay/CORBA User Guide and Programmer Manual.

12.1  What is Cisco MGM GateWay/CORBA?

Cisco MGM GateWay is an architectural component that provides northbound EMS-to-NMS interface mediation. Cisco MGM GateWay allows service providers to integrate Cisco MGM with their OSSs by using open standard interfaces.

Note Cisco offers the CORBA (sold separately) option for Cisco MGM GateWay.

The Cisco MGM GateWay/CORBA option is a CORBA-based interface that provides higher-layer management systems with fault, and inventory information for each NE that Cisco MGM manages. The Cisco MGM GateWay/CORBA option is based on the TeleManagement Forum (TMF) standards for the NMS-to-EMS interface. Cisco MGM GateWay/CORBA supports up to eight simultaneous sessions with higher-layer management systems.

Note For more information about Cisco MGM GateWay/CORBA, including how to enable username and password encryption, set the Cisco MGM GateWay/CORBA heartbeat event, and create OSS clients for Cisco MGM GateWay/CORBA, refer to the Cisco Media Gateway Manager GateWay/CORBA User Guide and Programmer Manual.

Figure 12-1 illustrates the Cisco MGM GateWay/CORBA communications architecture within a service provider's OSS environment.

Figure 12-1 Cisco MGM GateWay/CORBA Communications Architecture

Cisco MGM GateWay/CORBA is based on the following TMF standards:

•TMF513 v2.0 (October 2001): Multi-Technology Network Management Business Agreement

•TMF608 v2.0 (October 2001): Multi-Technology Network Management Information Agreement

•TMF814 v2.0 (October 2001): Multi-Technology Network Management Solution Set

12.1.1  Viewing the Cisco MGM GateWay/CORBA Properties Pane

Use the GateWay/CORBA Service Properties pane to stop, start, or configure Cisco MGM GateWay/CORBA service parameters. To view the Cisco MGM GateWay/CORBA Properties pane, from the Domain Explorer window, choose Administration > Control Panel, then choose GateWay/CORBA Service from the hierarchy pane at left. The pane contains two tabs, Global and OSS Clients.

12.1.1.1  Global Tab

Use the Global tab to start and stop Cisco MGM GateWay/CORBA service.

Table 12-1   Field Descriptions for GateWay/CORBA Service—Global Tab

Field

Description

Service Status

Displays the current status of the service: Active, Not Active, or Not Installed.

Service Control

Allows you to stop or start a process. Notice that the Service Control button toggles between Stop and Start, and the Service Status field changes accordingly. This field is not available if the Service Status is Not Installed.

Enable Encryption for Username and Password

When checked, usernames and passwords are transmitted between the EMS server and the OSS in encrypted format. The maximum encryption length is 53 bytes. If this check box is unchecked, Cisco MGM GateWay/CORBA usernames and passwords are transmitted without encryption. By default, encryption is disabled at installation.

Heartbeat for Notification Channel

Notifies the OSS if a failure in the notification service has occurred. The heartbeat is measured in minutes ranging from 0 to 1440 minutes. A zero value implies that the heartbeat is disabled.

Error Level

Allows you to select the error level for the Cisco MGM GateWay/CORBA service. Error levels are:

•Critical

•Major

•Minor

•Informational

•Debug

•Trace

12.1.1.2  OSS Clients Tab

Use the OSS Clients tab to view current Operations Support System (OSS) client configuration information or to add a new OSS client. The OSS Clients tab is not displayed if the Service Status is Not Installed.

Table 12-2   Field Descriptions for GateWay/CORBA Service—OSS Clients Tab

Field

Description

OSS Profile Name

The name of the OSS profile.

Password

The password that the OSS client uses to log into the Cisco MGM server. If you are adding a new OSS client, the password must contain 1 to 53 characters, including one special character (, . ; % & ! + #), at least two letters (A - Z, a - z), and at least one number (0 - 9).

Confirm Password

The reconfirmed password.

OSS IP Address

The OSS IP address.

Delete button

Deletes an OSS profile from the Cisco MGM database. If a profile is deleted, the OSS using this profile cannot connect to Cisco MGM. If the OSS is connected to Cisco MGM when the profile is deleted, Cisco MGM will not terminate the OSS session.

12.1.2  Viewing the Cisco MGM GateWay/CORBA Client Configuration Table

The Cisco MGM GateWay/CORBA Client Configuration Table displays information about Operations Support System (OSS) CORBA client properties. To view the Cisco MGM GateWay/CORBA Client Configuration table, from the Domain Explorer window, choose Administration > Control Panel, then choose Administration > Cisco MGM GW/CORBA Client Configuration Table.

Table 12-3 Field Descriptions for Cisco MGM GateWay/CORBA Client Configuration Table

Column Name

Description

OSS Name

Displays the name of the selected OSS client.

IP Address

Displays the IP address of the OSS client.

12.2  Using a Static CORBA Listener Port on the Cisco MGM Server

To use a static CORBA listener port on the Cisco MGM server, proceed as follows.

Step 1 Log into the Cisco MGM server workstation as the root user.

Step 2 Change the directory to /opt/CiscoMGMServer/bin.

Note The default directory /opt/CiscoMGMServer may have been changed during installation of the Cisco MGM server.

Step 3 Edit the jne454.sh file by inserting a new line before the -Xbootclasspath line:
-Dong.orb.iioplistenerport=Port Number \
For example, if the port number is 5555, enter:
-Dong.orb.iioplistenerport=5555 \
Step 4 Start the Cisco MGM server.

12.3 Configuring the CORBA Timeout

The CORBA timeout determines the number of seconds that the Cisco MGM server has to process a CORBA call and return it to the Cisco MGM client. If the Cisco MGM server does not return a response in time, CORBA automatically times out.

Step 1 Open the ems-client.cfg file.

By default, the ems-client.cfg file is located in the C:\Cisco\MediaGatewayManagerClient\config directory for Windows platforms and in the /opt/CiscoMGMClient/config directory for Sun Solaris platforms.

Step 2 Set the CORBA_Call_Timeout_Seconds parameter to the desired value. The default timeout is 120 seconds; the recommended range is 120 to 300 seconds.

Note If the NE is busy or if the Cisco MGM server is processing many requests, you might need to increase the CORBA timeout parameter accordingly.

Step 3 Save and close the ems-client.cfg file.

Table 12-1 Field Descriptions for GateWay/CORBA Service—Global Tab
Field	Description
Service Status	Displays the current status of the service: Active, Not Active, or Not Installed.
Service Control	Allows you to stop or start a process. Notice that the Service Control button toggles between Stop and Start, and the Service Status field changes accordingly. This field is not available if the Service Status is Not Installed.
Enable Encryption for Username and Password	When checked, usernames and passwords are transmitted between the EMS server and the OSS in encrypted format. The maximum encryption length is 53 bytes. If this check box is unchecked, Cisco MGM GateWay/CORBA usernames and passwords are transmitted without encryption. By default, encryption is disabled at installation.
Heartbeat for Notification Channel	Notifies the OSS if a failure in the notification service has occurred. The heartbeat is measured in minutes ranging from 0 to 1440 minutes. A zero value implies that the heartbeat is disabled.
Error Level	Allows you to select the error level for the Cisco MGM GateWay/CORBA service. Error levels are: •Critical •Major •Minor •Informational •Debug •Trace

Table 12-2 Field Descriptions for GateWay/CORBA Service—OSS Clients Tab
Field	Description
OSS Profile Name	The name of the OSS profile.
Password	The password that the OSS client uses to log into the Cisco MGM server. If you are adding a new OSS client, the password must contain 1 to 53 characters, including one special character (, . ; % & ! + #), at least two letters (A - Z, a - z), and at least one number (0 - 9).
Confirm Password	The reconfirmed password.
OSS IP Address	The OSS IP address.
Delete button	Deletes an OSS profile from the Cisco MGM database. If a profile is deleted, the OSS using this profile cannot connect to Cisco MGM. If the OSS is connected to Cisco MGM when the profile is deleted, Cisco MGM will not terminate the OSS session.

Table 12-3 Field Descriptions for Cisco MGM GateWay/CORBA Client Configuration Table
Column Name	Description
OSS Name	Displays the name of the selected OSS client.
IP Address	Displays the IP address of the OSS client.

Was this Document Helpful?

Feedback

Contact Cisco

Open a Support Case
(Requires a Cisco Service Contract)