This chapter describes how the Oracle Communications Network Integrity UIM Integration cartridge is built from the Oracle Communications Design Studio perspective.
The following tables describe the Design Studio construction of actions and associated components in the UIM Integration cartridge:
Note:
Parameter values are case-sensitive and must be entered in capital letters when commands are run from a command-line interface.Table 5-1 describes how actions in the UIM Integration cartridge are constructed in Design Studio.
Table 5-1 Design Studio Construction of Actions
Action | Result Category | Address Handler | Scan Parameter Groups | Processors |
---|---|---|---|---|
Abstract Import from UIM |
Device |
N/A |
N/A |
|
Import from UIM |
Device |
N/A |
UIMImportParameters. See Table 5-5. |
|
Abstract Detect UIM Discrepancies |
Device |
N/A |
N/A |
|
Abstract Resolve in UIM |
Device |
N/A |
N/A |
|
Oracle Communications Unified Inventory Management (UIM) requires certain characteristics to model attributes that are native in Network Integrity. Some of these characteristics are part of UIM Integration, delivered in the ora_ni_uim_ocim cartridge. Other attributes are part of UIM, delivered in the ora_uim_model cartridge.
These characteristics have the Ignore Characteristic in Network Integrity tag. They appear as characteristics in UIM, but not in Network Integrity. The UIM Integration cartridge needs to handle these characteristics differently.
Table 5-2 shows UIM integration characteristics.
Table 5-2 UIM Integration Characteristics
Characteristic | Source | Enumerations |
---|---|---|
nativeEmsName |
ora_ni_uim_ocim |
N/A |
nativeEmsAdminServiceState |
ora_ni_uim_ocim |
Available values:
|
nativeEmsServiceState |
ora_ni_uim_ocim |
Available values:
|
physicalLocation |
ora_uim_model |
N/A |
ifType |
ora_uim_model |
N/A |
minSpeed |
ora_uim_model |
N/A |
maxSpeed |
ora_uim_model |
N/A |
nominalSpeed |
ora_uim_model |
N/A |
physicalAddress |
ora_uim_model |
N/A |
mtuCurrent |
ora_ni_uim_ocim |
N/A |
mtuSupported |
ora_ni_uim_ocim |
N/A |
nativeEmsConnectorPresent |
ora_ni_uim_ocim |
N/A |
serialNumber |
ora_uim_model |
N/A |
To integrate Network Integrity cartridges with UIM and to include the attributes listed in Table 5-2, add the characteristics listed in the following table to your UIM cartridge specifications.
Table 5-3 displays characteristics that entities should include for integration with UIM.
Table 5-3 Characteristics for UIM Integration
UIM Entity | Characteristics to Include |
---|---|
LogicalDevice |
|
DeviceInterface |
If the Interface is to mimic a MediaInterface in Network Integrity, the following will also be required:
|
PhysicalDevice |
nativeEmsName |
Equipment |
|
EquipmentHolder |
|
PhysicalPort |
|
The Import from UIM action uses the UIMImportParameters scan parameter group. Table 5-4 outlines the Design Studio construction of this scan parameter group.
Table 5-4 UIMImportParameters Scan Parameter Group Design Studio Construction
Characteristic Name | Parameter Type | Description | UI Label |
---|---|---|---|
adminState |
Dropdown |
The status of the device in the inventory system. |
Inventory State |
importLogicalDevices |
Check box |
Use this box to indicate whether to import logical devices. By default, this box is checked in the UI. |
Import Logical Devices |
importPhysicalDevices |
Check box |
Use this box to indicate whether to import physical devices. By default, this box is checked in the UI. |
Import Physical Devices |
logicalDeviceSpecification |
String |
The specification name for logical devices. This field supports wildcard characters. |
Logical Device Specification |
name |
String |
Use to filter imported devices by device name. This field supports wildcard characters. |
Name |
networkLocationEntityCode |
String |
The network or entity location code. This field supports wildcard characters. |
Network/Entity Location |
physicalDeviceSpecification |
String |
The specification name for physical devices. This field supports wildcard characters. |
Physical Device Specification |
Table 5-5 describes how processors are constructed in Design Studio.
Table 5-5 Design Studio Construction of Processors
Processor | Variable |
---|---|
Import UIM Initializer |
Input: N/A Output:
|
Scan Parameter UIM Initializer |
Input: filters Output: N/A |
Logical Device UIM Finder |
Input:
|
Physical Device UIM Finder |
Input:
|
Logical Device UIM Importer |
Input:
Output:
|
Linked Physical Device UIM Importer |
Input:
Output:
|
Logical Device UIM Persister |
Input: N/A Output: N/A |
Physical Device UIM Importer |
Input:
Output:
|
Physical Device UIM Persister |
Input: N/A Output: N/A |
UIM Discrepancies Filter Initializer |
Input: N/A Output: N/A |
Discrepancy Detector |
Input: N/A Output: N/A |
UIM Resolution Framework Initializer |
Input: N/A Output:
|
UIM Resolution Initializer |
Input:
Output: N/A |
UIM Resolution Framework Dispatcher |
Input:
Output: N/A |