Skip Headers
Oracle® Communications Network Integrity Optical UIM Integration Cartridge Guide
Release 7.2.2

Part Number E35809-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

3 Using the Cartridge

This chapter provides instructions for using the Oracle Communications Network Integrity Optical UIM Integration cartridge.

Creating a Discover Enhanced Huawei U2000 Scan

The Discover Enhanced Huawei U2000 scan discovers a Huawei OptiX OSN 3500 device and models it into both physical device and logical device models.

To create a Discover Enhanced Huawei U2000 scan:

  1. Create a discovery scan.

    See the Network Integrity Help for more information.

  2. On the General tab of the Create Scan page, do the following:

    1. From the Scan Action list, select Discover Enhanced Huawei U2000.

      The Scan Type field displays Discovery. The Scan Action Parameters area displays the TMF814Parameters scan parameter group.

    2. Set the following scan action parameters:

      • In the Username field, enter the user name for the target element management system (EMS) or network management system (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 scan, enter name/value pairs in the ORB Properties field, separated by a semicolon. For example:

        Property_1=value_1;Property_2=value_2;Property_n=value_n
        
      • (Optional) To pass custom ORB arguments to the scan, enter name/value pairs in the ORB Arguments field, separated by a semicolon. For 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 to a matching parameter value against collected MEs.

      • (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 to a matching parameter value against collected NEs.

      • From the Cross Connect Collection Type list, select None.

      • From the Topological Link Collection Type list, select None.

      See Network Integrity Optical TMF814 CORBA Cartridge Guide for more information.

  3. On the Scope tab of the Create Scan page, do one of the following:

    • Enter the EMS CORBA Loc URL, and click the Add Address icon.

    • Click the Import icon, and import the IOR file.

    • Paste the content of the IOR file and, click the Add Address icon.

    Note:

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

  5. Save the scan.

Creating a Discover Enhanced TMF814 Scan

The Discover Enhanced TMF814 scan discovers logical devices on the network and models them into the generic Network Logical Device model.

To create a Discover Enhanced TMF814 scan:

  1. Create a discovery scan.

    See the Network Integrity Help for more information.

  2. On the General tab of the Create Scan page, do the following:

    1. From the Scan Action list, select Discover Enhanced TMF814.

      The Scan Type field displays Discovery. The Scan Action Parameters area displays the TMF814Parameters scan parameter group.

    2. Set the following scan action parameters:

      • In the Username field, enter the user name for the target 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, select False.

      • 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. For 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. For 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 to a matching parameter value against collected MEs.

      • (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 to a matching parameter value against collected NEs.

      • From the Cross Connect Collection Type list, select None.

      • From the Topological Link Collection Type list, select None.

      See Network Integrity Optical TMF814 CORBA Cartridge Guide for more information.

  3. On the Scope tab of the Create Scan page, do one of the following:

    • Enter the EMS CORBA Loc URL, and click the Add Address icon.

    • Click the Import icon, and import the IOR file.

    • Paste the content of the IOR file and, click the Add Address icon.

    Note:

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

  5. Save the scan.

Creating an Import Optical from UIM Scan

The Import Optical from UIM scan imports a Huawei OptiX OSN 3500 device from UIM and models it into physical device and logical device models.

To create an Import Optical from UIM scan:

  1. Create an import scan.

    See the Network Integrity Help for more information.

  2. On the General tab of the Create Scan page, do the following:

    1. From the Scan Action list, select Import Optical from UIM.

      The Scan Type field displays Import.

    2. In the Scan Action Parameters area, use the default values.

  3. Make any other required configurations.

  4. Save the scan.

Creating an Import Logical Optical from UIM Scan

The Import Logical Optical from UIM scan imports a network logical device from UIM and models it into the Network Logical Device model.

To create an Import Logical Optical from UIM scan:

  1. Create an import scan.

    See the Network Integrity Help for more information.

  2. On the General tab of the Create Scan page, do the following:

    1. From the Scan Action list, select Import Logical Optical from UIM.

      The Scan Type field displays Import.

    2. In the Scan Action Parameters area, ensure Import Logical Devices is selected and Import Physical Devices is not selected. Leave all the remaining fields with their default values.

  3. Make any other required configurations.

  4. Save the scan.

Working with Discrepancies

This cartridge allows you to detect and resolve discrepancies between your discovered data and your imported UIM data. When you resolve a discrepancy, the resolution is submitted to UIM by Network Integrity. See the Network Integrity Help for more information about working with discrepancies.

When the Optical UIM Integration cartridge is deployed to your run-time application, you can use Network Integrity to:

  • Detect and resolve discrepancies for Huawei OptiX OSN 3500 devices:

    1. Create a Discovery Huawei U2000 scan that returns only Huawei OptiX OSN 3500 devices.

    2. (Optional) To run automatic discrepancy resolution, select the AutoResolutionParameter scan parameters and select Auto Resolve Discrepancies.

    3. Create an import scan. From the Scan Action list, select Import from UIM.

    4. Configure your import scan with the Detect Discrepancies option enabled.

    5. In the Scan Action parameters area, filter the import scan to return Huawei OptiX OSN 3500 devices.

    6. Run the scans: first the discovery scan, then the import scan.

      The scan with Detect Discrepancies enabled must be run last. Discrepancy detection runs automatically after the import scan completes.

    7. Review and resolve any reported discrepancies.

  • Detect and resolve discrepancies for network logical devices:

    1. Create a discovery scan. From the Scan Action list, select Discover Enhanced TMF814.

    2. In the Scan Action Parameters area, filter the discovery scan to return network logical devices.

    3. (Optional) To run automatic discrepancy resolution, select the AutoResolutionParameter scan parameters and select Auto Resolve Discrepancies.

    4. Create an import scan. From the Scan Action list, select Import from UIM.

    5. Configure your import scan with the Detect Discrepancies option enabled.

    6. Save the scan.

    7. Run the scans: first the discovery scan, then the import scan.

      The scan with Detect Discrepancies enabled must be run last. Discrepancy detection runs automatically after the import scan completes.

    8. Review and resolve any reported discrepancies.

  • Resolve discrepancies in UIM:

    1. Review the scan results for a scan with Detect Discrepancies enabled.

    2. On the Scan Details page, click Review Discrepancies.

    3. For every discrepancy you want to resolve, right-click on the discrepancy and select Correct in UIM.

    4. Click Submit.

      The Optical UIM Integration cartridge calls the appropriate API to resolve the discrepancy in UIM.