Table Of Contents

Sample CORBA Client Package (BTSxsdk) Implementation

New in Release 4.5.1

Java

CORBA Interface Servant

Dual Mode Operation

Prerequisites

OpenORB Settings

Build the BTSxsdk

Run BTSxsdk

Sample CORBA Client Package (BTSxsdk) Implementation

---

This appendix details a sample implementation of a CORBA Client Package (BTSxsdk). BTSxsdk is a Software Development Kit (SDK) that implements a sample CORBA client for connecting the Cisco BTS 10200 Softswitch through the CORBA adapter. BTSxsdk package is automatically installed onto the Element Management System (EMS) when the CORBA adapter (BTScis package) installs. Use this SDK as a starting point to develop custom client programs. Successfully running this SDK also verifies the correct installation of the CORBA adapter on an EMS.

New in Release 4.5.1

The following capabilities were added in Release 4.5.1 to the Software Developers Kit (SDK):

•Provide both secured and non-secured CORBA interface access using port 684 for the Cognitronics Privacy Manager application.

•The Cisco BTS 10200 Softswitch CORBA interface supports both nonsecured and secured access to the Cisco BTS 10200 Softswitch CORBA interfaces.

•A single Cisco BTS 10200 Softswitch CORBA interface to customer OSS applications can redirect requests from the OSS to 2 redundant Cisco BTS 10200 Softswitch systems.

•Provide CORBA access to the active EMS within a Cisco BTS 10200 Softswitch system. The Cisco BTS 10200 Softswitch CORBA interface exclusively binds to the active EMS.

•No predetermined NIC interface is required during Cisco BTS 10200 Softswitch installation. Previous Cisco BTS 10200 Softswitch installation required operators to specify a NIC address in the dual NIC interface configuration. The Cisco BTS 10200 Softswitch CORBA interface now dynamically binds to the VIP or a NIC address in a dual NIC configuration.

•Provide a single management interface to all Cisco BTS 10200 Softswitch systems.

Java

New Java classes provide the following capabilities:

•Support access to multiple BTS sites using CLLI code

•Conceal redundant EMS nodes (for ACTIVE access only)

•Conceal redundant NIC(s) on each EMS node

•Track the state of the CIS application on each EMS

•Supply a single set of IOR references to the Cisco BTS 10200 Softswitch client applications

Most of this capability is supplied in a series of classes to abstract access to the Cisco BTS 10200 Softswitch. This simplifies the management of objects and connections to the Cisco BTS 10200 Softswitch.

CORBA Interface Servant

The following extensions were added for the CORBA Interface Servant (CIS) application. These extensions are applied in running CIS application engine.

•Bind individual IP addresses to Name Service(s) on each EMS

•Unbind if EM01 is STANDBY, shutdowns or fails over

•Stop processing requests when not in ACTIVE EM01

Dual Mode Operation

Dual mode operations apply. Both non-secure and secure provisioning work only on the active EMS. A switchover from either a failure or a manual request causes the objects to unbind and current connections to break. As a result, queries to the standby side produce Java exceptions.

Prerequisites

The BTSxsdk package is automatically installed onto the EMS when the CORBA adapter installs. If the BTSxsdk is to be installed onto another machine, the following prerequisites apply when implementing the BTSxsdk package:

•BTSxsdk package must be installed on a UNIX machine that is in the same intranet as the EMS where the CORBA adapter is installed.

•Java Development Kit (JDK) 1.4.1_01 or later is installed. This document assumes that the JDK is installed under /usr/java.

Users must be familiar with the Cisco BTS 10200 Softswitch Command Line Interface (CLI) adapter commands.

OpenORB Settings

The OpenORB package requires a modification to the JDK. It updates properties in the JDK to enable it to point to the OpenORB implementation for the CORBA interface objects. There are two ways to modify JDK for OpenORB:

1. the Cisco BTS 10200 Softswitch package BTSoorb automatically updates the JDK during installation, or

2. type the following commands in the order given:

–cd /opt/BTSxsdk/oorb/lib

–java -jar openorb-1.3.1.jar

Build the BTSxsdk

The BTSxsdk package is pre-built in Java. A build is not necessary if sample files are not modified. If necessary, perform the following steps to build a sample client application.

---

Step 1 Go to the BTSxsdk directory.

cd /opt/BTSxsdk

Step 2 Perform export.

export PROJECTDIR=`pwd`

Step 3 Perform export.

export JAVA_HOME=/usr/java

Step 4 Perform make all.

./bin/make all

---

Run BTSxsdk

To run the sample CLI client application, perform the following steps:

---

Step 1 Go to the bin directory.

cd /opt/BTSxsdk/bin

Step 2 Issue the following command to run the BTSxdsk.

a. To connect to the non-secure CORBA server, enter the command:

./bts-cli <Active EMS IP> -n <username> -p <password>

The "Active EMS IP" can be one of the following:

–One of the active EMS management IP addresses

–VIP

–Active EMS DNS name

b. To connect to the secure CORBA server, enter the command:

./bts-cli-secure <Active EMS Mgmt IP> -n <username> -p <password>

The "active EMS Mgmt IP" must be one of the active EMS management IP addresses.

A CLI-like interface appears. Issue a test CLI command such as show sub; limit=1—the XML response displays on the screen.

---