Using the Cartridge

3 Using the Cartridge

This chapter explains how to use the Oracle Communications Network Integrity Optical TMF814 CORBA cartridge.

Creating a Discover TMF814 Scan

The Optical TMF814 CORBA cartridge allows you to create a Discover TMF814 scan.

To create a Discover TMF814 scan:

Create a scan, as explained in the Network Integrity Help.
On the General tab, do the following:
- From the Scan Action list, select one of the following:
  - To discover entities from a generic TMF814 element or network management system, select Discover TMF814.
  - To discover entities from a Huawei U2000, select Discover Huawei U2000.
  The Scan Type field displays Discovery.
- Enter the following TMF814 scan action parameters:
  - In the Username field, enter the username for the target element or network management system (EMS or NMS).
  - In the Password field, enter the password for the target EMS or NMS.
  - In the EMS Naming Service field, enter the EMS session factory CORBA object name.
  - From the EMS Naming Service Format list, specify whether the EMS session factory CORBA object name uses the Plain or the Stringified format.
  - From the Collect Equipment list, specify whether you want to collect equipment holder objects.
  - From the Collect Termination Points list, specify the type of termination points (TPs) you want to collect. To not collect any TPs, select None.
  - From the Collect Connection TP list, specify the type of connection TPs you want to collect. To not collect any connection TPs, select None.
  - (Optional) To set the number of equipment objects to retrieve with each EMS call, enter a value in the Equipment Fetch Size field. Leave this field blank to retrieve all equipment objects in a single EMS call.
  - (Optional) To set the number of TPs to retrieve with each EMS call, enter a value in the Termination Point Fetch Size field. Leave this field blank to retrieve all TPs in a single EMS call.
  - (Optional) To set the depth to which contained TPs are collected, enter a value in the Contained TP Collection Depth field. Leave this field blank to retrieve all contained TPs.
  - (Optional) To pass custom object request broker (ORB) properties to the Discover Abstract TMF814 action, enter name value pairs in the ORB Properties field, separated by a semicolon, as in the following example:
```
Property_1=value_1;Property_2=value_2;Property_n=value_n
```
  - (Optional) To pass custom ORB arguments to the Discover Abstract TMF814 action, enter name-value pairs in the ORB Arguments field, separated by a semicolon, as in the following example:
```
Argument_1=value_1;Argument_2=value_2;Argument_n=value_n
```
  - (Optional) To filter the discovered managed elements (MEs) by name, enter a name in the Managed Element Name(s) field and set the Managed Element Name Qualifier list.
  - (Optional) To filter the discovered network elements (NEs) by name, enter a name in the Network Element Name(s) field and set the Network Element Name Qualifier list.
  - In the Cross Connect Collection Type field, specify how cross-connect objects are collected. To not collect any cross-connect objects, select None.
  - In the Topological Link Collection Type field, specify how topological links are collected. To not collect any topological links, select None.
  See Table 7-3 for more information.
On the Scope tab, do one of the following:
- Enter the EMS CORBA Loc URL
- Import the IOR file
- Enter the content of the IOR file
Note:

All entries on the Scope tab must be unique. All entries are validated against the CorbaURLAddressHandler address handler.
Make any other required configurations.

Creating a Discover TMF814 Optical Transmission Devices Scan

To create a Discover TMF814 Optical Transmission Devices Scan:

Create a new scan.

See Network Integrity Online Help for more information.
On the General tab, do the following:
1. From the Scan Action list, select Discover TMF814 Optical Transmission Devices.
  
  The Scan Type field displays Discovery.
2. Select the Detect Discrepancies checkbox.
3. Select the Enabled checkbox.
Enter the values for the following Ems Connection scan parameters:
1. In the Ems User Name field, enter the username for the target element management system.
2. In the Ems Password field, enter the password for the target element management system.
3. In the Ems Type field, select ECI or HUAWEI2000 based on EMS vendor.
4. In the Ems Instance Name field, enter name of EMS instance connection is required.
5. In the Ems Vendor field, provide the vendor name for name resolution; not mandatory if EMS uses a naming service.
6. In the Ems Class field, provide the vendor name for name resolution; not mandatory if EMS uses a naming service.
7. In the Ems Version field, provide the vendor name for name resolution; not mandatory if EMS uses a naming service.
8. In the Ems Session Factory field, provide the vendor name for name resolution; not mandatory if EMS uses a naming service.
Enter the following TMF814 Transmission Scan Params:
1. In the Me Name field, enter comma separated values of names of managed elements to be discovered.
2. Select the Full Network Scan checkbox to perform a full network discovery.
3. In the Nms Vendor Name field, enter the NMS Vendor identifier value.
4. In the Nms Circle Name field, enter the NMS Circle identifier value.
5. In the Tech Domain, select SDH or DWDM based on requirement.
6. Select the Fetch CTP checkbox, to discover and model CTPs.
On the Scope tab, do one of the following:
- Enter the EMS CORBA Loc URL.
- Import the IOR file.
- Enter the contents of the IOR file.
Note:

All entries on the Scope tab must be unique. All entries are validated against the CorbaURLAddressHandler address handler.
Make any other required configurations.
Run the scan.

You can also create a Discover TMF814 Optical Transmission Devices Scan for running incremental scans. The prerequisites for incremental discovery are:

Collect the physical layer notification from CORBA based NMS/EMS system using the NMS listener.
It is necessary to run an incremental import scan so that the notification status is updated from INITIAL to IMPORTED.

To create a Discover TMF814 Optical Transmission Devices (Incremental) Scan:

Create a new scan.

See Network Integrity Online Help for more information.
On the General tab, do the following:
1. From the Scan Action list, select Discover TMF814 Optical Transmission Devices.
  
  The Scan Type field displays Discovery.
2. Select Detect Discrepancies checkbox.
3. Select Enabled checkbox.
Enter the following Ems Connection scan parameters:
1. In the Ems User Name field, enter the username for the target element management system.
2. In the Ems Password field, enter the password for the target element management system.
3. In the Ems Type field, select ECI or HUAWEI2000 based on EMS vendor.
4. In the Ems Instance Name field, enter name of EMS instance connection is required.
5. In the Ems Vendor field, provide the vendor name for name resolution; not mandatory if EMS uses a naming service.
6. In the Ems Class field, provide the vendor name for name resolution; not mandatory if EMS uses a naming service.
7. In the Ems Version field, provide the vendor name for name resolution; not mandatory if EMS uses a naming service.
8. In the Ems Session Factory field, provide the vendor name for name resolution; not mandatory if EMS uses a naming service.
Enter values for the following Incremental Scan Parameters (this is only required for incremental discovery):
1. Select the Incremental Scan checkbox to perform incremental discovery.
2. In the Nms Notification Vendor field, enter the Nms Vendor identifier value.
3. In the Nms Notification Circle field, enter the Nms Circle identifier value.
4. In the Nms Notification Count field, enter the count of notification to be processed.
On the Scope tab, do one of the following:
- Enter the EMS CORBA Loc URL.
- Import the IOR file.
- Enter the content of the IOR file.
Note:

All entries on the Scope tab must be unique. All entries are validated against the CorbaURLAddressHandler address handler.
Make any other required configurations.
Run the scan.