1. RAN and MW FTP Cartridge Guide
  2. About Design Studio Construction

5 About Design Studio Construction

This chapter provides information on the composition of the Oracle Communications Network Integrity Discovery RAN and Microwave Discovery cartridge from the Oracle Communications Service Catalog and Design – Design Studio perspective.

Table 5-1 shows the RAN and Microwave Discovery Cartridge model collection.

Table 5-1 Model Collections

Specification Information Model Entity Type Intended Usage/Notes
GenericRANLD LogicalDevice Represents root object of the RAN device discovered on the network.
GenericRANInterface DeviceInterface

Represents the interface discovered under GenericRANLD.

Device interfaces discovered and modeled are modeled into GenericRANInterface.
GenericRANPD PhysicalDevice Represents any RAN physical device discovered on the network.
GenericRANEquipmentHolder EquipmentHolder Represents board piece of equipment.
GenericRANShelf Equipment Represents shelf piece of equipment.
GenericRANRack Equipment Represents rack piece of equipment.
GenericRANCard Equipment Represents module piece of equipment.
GenericRANPort PhysicalPort Represents any physical port associated with the RAN devices.
GenericMWLD LogicalDevice Represents root object of the Microwave device discovered on the network.
GenericMWInterface DeviceInterface

Represents interface discovered under GenericMWLD.

Device Interfaces discovered and modeled are modeled into GenericMWInterface.
GenericMWPD PhysicalDevice Represents any Microwave physical device discovered on the network.
GenericMWEquipmentHolder EquipmentHolder Represents board piece of equipment.
GenericMWShelf Equipment Represents shelf piece of equipment.
GenericMWDirectCard Equipment Represents module piece of equipment. Direct cards do not require any equipment holders to mount them.
GenericMWCard Equipment Represents module piece of equipment.
GenericMWPort PhysicalPort Represents any physical port associated with the Microwave devices.

Logical Specification Lineage for Devices

The example below shows a logical specification lineage for RAN and Microwave logical devices. This lineage shows the intended relationship between specifications.

Example logical specification lineage for RAN devices:
GenericRANLD
    [0..*] GenericRANInterface
Example logical specification lineage for Microwave devices:
GenericMWLD
    [0..*] GenericMWInterface

Physical Specification Lineage for Devices

The below examples show the physical specification lineage for physical devices. This lineage shows the intended relationship between specifications for both RAN and Microwave devices.

Example physical specification lineage for RAN devices:
GenericRANPD
    GenericRANRack
        [0..*] GenericRANShelf
                [0..*] GenericRANEquipmentHolder
                        [0..1] GenericRANCard
                               [0..*] GenericRANPort
Example physical specification lineage for Microwave devices:
GenericMWPD
	GenericMWShelf
	[0..*] GenericMWDirectCard
	[0..*] GenericMWEquipmentHolder
		[0..1]  GenericMWCard
                      [0..*]  GenericMWPort
                              [0..*] GenericMWEquipmentHolder
                                     [0..1] GenericMWCard
                                            [0..*]  GenericMWPort

Discovery Action

RAN and Microwave Discovery Cartridge supports the following discovery actions:

  1. RAN and Microwave File Collector

  2. Discover RAN Devices.

  3. Discover Microwave Devices

Table 5-2 RAN and Microwave File Collector

Result Category Address Handler Scan Parameters Model Processors
N/A N/A

RAN and Microwave Discovery Parameters

Note: These scan parameters must be added for the Create Scan web service request even if the values are left empty.

RAN_and_Microwave_Discovery_Cartridge RAN and Microwave File Collector

Table 5-3 Discover RAN Devices

Result Category Address Handler Scan Parameters Model Processors
Device FileTransferAddressHandler

RAN and Microwave Discovery Parameters

Note: These scan parameters must be added for the Create Scan web service request even if the values are left empty.

RAN_and_Microwave_Discovery_Cartridge List of processors:

  • Processors inherited from the RAN and Microwave File Collector

  • RanDiscoveryInitializer

  • Device CSV Parser

  • Equipment CSV Parser

  • Port CSV Parser

  • RanDeviceModelPersister

Table 5-4 Discover Microwave Devices

Result Category Address Handler Scan Parameters Model Processors
Device FileTransferAddressHandler

RAN and Microwave Discovery Parameters

Note: These scan parameters must be added for the Create Scan web service request even if the values are left empty.

RAN_and_Microwave_Discovery_Cartridge List of processors:

  • Processors inherited from the RAN and Microwave File Collector

  • Microwave Files Parser

  • MicrowaveDeviceModelPersister

Discovery Processors

Table 5-5 RAN and Microwave File Collector Action Processors

Processor Name Variable
RAN and Microwave File Collector

Input: N/A

Output: ranAndMicrowaveFileCollectorFileCollection

Collection of files read from the scope provided.

Table 5-6 Discover RAN Devices Action Processors

Processor Name Variable
RanDiscoveryInitalizer

Input: ranAndMicrowaveFileCollectorFileCollection

Collection of files read from the scope provided.

Output:

  • deviceFiles
  • equipmentFiles
  • portFiles
  • logicalDeviceObjectMap
  • physicalDeviceObjectMap
Device CSV Parser

Input:

  • deviceFiles
  • logicalDeviceObjectMap
  • physicalDeviceObjectMap

Output: N/A
Equipment CSV Parser

Input:

  • equipmentFiles
  • logicalDeviceObjectMap
  • physicalDeviceObjectMap

Output: N/A
Port CSV Parser

Input:

  • portFiles
  • logicalDeviceObjectMap
  • physicalDeviceObjectMap

Output: N/A
RANDeviceModelPersister

Input:

  • logicalDeviceObjectMap
  • physicalDeviceObjectMap

Output: N/A

Table 5-7 Discover Microwave Devices Action Processors

Processor Name Variable
Microwave Files Parser

Input: ranAndMicrowaveFileCollectorFileCollection

Collection of files read from the scope provided.

Output: neObjects
MicrowaveDeviceModelPersister

Input: neObjects

Output: N/A

Discrepancy Detection Action

Detect Discrepancies for RAN and Microwave Devices is the action used to perform discrepancy detection.

Table 5-8 Detect Discrepancies for RAN and Microwave Devices

Result Category Results Source Scan Parameters Model Processors
All List of sources:
  • Discover RAN Devices
  • Discover Microwave Devices
 N/A RAN_and_Microwave_Discovery_Cartridge This action extends the Abstract Detect UIM Discrepancies action included in the UIM Integration cartridge. For more information, see Network Integrity UIM Integration Cartridge Guide.

Discrepancy Resolution Action

Resolve RAN and Microwave Devices in UIM is the action used to perform discrepancy resolution.

Table 5-9 Resolve RAN and Microwave Devices in UIM

Result Category Result Source Processors
All
  • Discover RAN Devices
  • Discover Microwave Devices
 This action extends the Abstract Resolve in UIM action included in the Network Integrity UIM Integration cartridge. For more information, see Network Integrity UIM Integration Cartridge Guide.