7 About Design Studio Construction

This chapter explains how the Oracle Communications Network Integrity Optical TMF814 CORBA cartridge is built from the Oracle Communications Design Studio perspective.

Model Collections

Table 7-1 shows the Design Studio construction of the Generic TMF814 model collection.

Table 7-1 Generic TMF814 Model Collection

Specification Name	Dynamic Entity Type
tmf814MEGeneric	Physical Device Specification
tmf814DeviceGeneric	Logical Device Specification
tmf814EquipmentGeneric	Equipment Specification
tmf814EquipmentHolderGeneric	Equipment Holder Specification
tmf814PortGeneric	Physical Port Specification
tmf814TPInterfaceGeneric	Device Interface Specification This specification applies for all types of termination points (TPs).
tmf814TPLayersGeneric	Device Interface Configuration Specification

Actions

The following tables outline the Design Studio construction of the Optical TMF814 CORBA cartridge actions and associated components:

Table 7-2, "Actions Design Studio Construction"
Table 7-3, "TMF814 Scan Parameters Design Studio Construction"
Table 7-4, "Discovery Processor Design Studio Construction"

Note:

Parameter values are case-sensitive and must be entered in capital letters when commands are run from a command line interface.

Table 7-2 Actions Design Studio Construction

Action Name	Result Category	Address Handler	Scan Parameter Group	Processors
Discover Abstract TMF814 action	Device	N/A	N/A	TMF814 Property Initializer TMF814 Session Manager TMF814 Device Recorder Initializer TMF814 ME Collector TMF814 Device Modeler TMF814 Equipment Collector TMF814 Equipment Modeler TMF814 PTP Collector TMF814 PTP Modeler TMF814 CTP Discoverer for PTP TMF814 FTP Collector TMF814 FTP Modeler TMF814 CTP Discoverer for FTP TMF814 Device Persister TMF814 Device Recorder Persister TMF814 Cross-Connect Discoverer TMF814 Topological Link Collector TMF814 Topological Link Modeler Pipe Persister
Discover TMF814 action	Device	CORBA Address Handler	TMF814Parameters. See Table 7-3 AutoResolutionParameter. See Network Integrity Developer's Guide.	TMF814 CORBA Property Initializer TMF814 Property Customizer
Discover Huawei U2000 action	Device	N/A	N/A	Huawei Customizer Huawei MSTP EndPoint Collector Huawei MSTP EndPoint Modeler

Action Name

Result Category

Address Handler

Scan Parameter Group

Processors

Discover Abstract TMF814 action

Device

N/A

TMF814 Property Initializer
TMF814 Session Manager
TMF814 Device Recorder Initializer
TMF814 ME Collector
TMF814 Device Modeler
TMF814 Equipment Collector
TMF814 Equipment Modeler
TMF814 PTP Collector
TMF814 PTP Modeler
TMF814 CTP Discoverer for PTP
TMF814 FTP Collector
TMF814 FTP Modeler
TMF814 CTP Discoverer for FTP
TMF814 Device Persister
TMF814 Device Recorder Persister
TMF814 Cross-Connect Discoverer
TMF814 Topological Link Collector
TMF814 Topological Link Modeler
Pipe Persister

Discover TMF814 action

Device

CORBA Address Handler

TMF814Parameters. See Table 7-3

AutoResolutionParameter. See Network Integrity Developer's Guide.

TMF814 CORBA Property Initializer
TMF814 Property Customizer

Discover Huawei U2000 action

Device

N/A

Huawei Customizer
Huawei MSTP EndPoint Collector
Huawei MSTP EndPoint Modeler

Table 7-3 TMF814 Scan Parameters Design Studio Construction

Parameter Name	Parameter Type	Description	UI Label
UserName	Text box	User name of the element management system (EMS) or network management system (NMS) used for getting details.	Username
Password	Secret text	Password of EMS or NMS system.	Password
EMSNamingService	Text box	EMS Naming Service The EMS session factory CORBA object name.	Ems Naming Service
EMSNamingServiceFormat	Drop down	List: PLAIN, STRINGIFIED The EMS session factory CORBA object name format.	Ems Naming Service Format
CollectEquipment	Drop down	List: TRUE, FALSE	Collect Equipment
CollectTP	Drop down	List: ALL, ONLY PTP, ONLY FTP, NONE	Collect Termination Points
CollectCTP	Drop down	List: CURRENT, IN USE, POTENTIAL, NONE	Collect Connection TP
EquipmentFetchSize	Text box	Number of equipment objects to fetch at a time for each EMS call.	Equipment Fetch Size
TPFetchSize	Text box	Number of contained TP objects to fetch at a time for each EMS call.	Termination Point Fetch Size
CTPCollectionDepth	Text box	The depth (level of children objects) to which contained TPs are collected.	Contained TP Collection Depth
ORBProperties	Text box	Semicolon separated name value pairs for ORB Properties.	Orb Properties
ORBArguments	Text box	Semicolon separated name value pairs for ORB Arguments.	Orb Arguments
ManagedElementName	Text box	Name of ME. This parameter works in combination with Managed Element Name Qualifier. This parameter helps to filter the scan.	Managed Element Name
ManagedElementNameQualifier	Drop down	List: EQUALS, EQUALS_IGNORE_CASE, CONTAINS, CONTAINS_IGNORE_CASE, STARTS_WITH, STARTS_WITH_IGNORE_CASE, ENDS_WITH, ENDS_WITH_IGNORE_CASE This parameter works in combination with Managed Element Name to filter the collected MEs by name and qualifier.	Managed Element Name Qualifier
NetworkElementNames	Text Box	Name of NE. This parameter works in combination with Network Element Names Qualifier. This parameter helps to filter the scan.	Network Element Names
NetworkElementNameQualifier	Drop down	List: EQUALS, EQUALS_IGNORE_CASE, CONTAINS, CONTAINS_IGNORE_CASE, STARTS_WITH, STARTS_WITH_IGNORE_CASE, ENDS_WITH, ENDS_WITH_IGNORE_CASE COMMA_DELIMITED_NAMES, COMMA_DELIMITED_NAMES_IGNORE_CASE This parameter works in combination with Network Element Name to filter the collected NEs by name and qualifier.	Network Element Name Qualifier
CrossConnectCollectionType	Drop down	List: USE_SNC, USE_ME_MANAGER, NONE This parameter controls how cross-connects are collected. Select None to disable cross-connect collection.	Cross-connect Collection Type
TopologicalLinkCollectionType	Drop down	List: ALL, BETWEEN_SN, INSIDE_SN, NONE This parameter controls how topological links are collected. Select None to disable topological link collection.	Topological Link Collection Type

Table 7-4 Discovery Processor Design Studio Construction

Discovery Processors	Variable
CORBA Property Initializer	Input: N/A Output: corbaSeed(oracle.communications.integrity.abstractcorbacartridge.CorbaSeed) A JavaBean that holds properties related to the CORBA cartridge. See Network Integrity CORBA Cartridge Guide for more information.
TMF814 CORBA Property Initializer	Input: corbaSeed Output: corbaSeed
CORBA Connection Manager	Input: corbaSeed Output: namingServer(org.omg.CosNaming.NamingContextExt) orb(org.omg.CORBA.ORB) See Network Integrity CORBA Cartridge Guide for more information.
TMF814 Property Initializer	Input: N/A Output: tmf814Properties(oracle.communications.integrity.tmf814discovery.beans.TMF814Properties) A JavaBean that contains the set of TMF814 properties. See Table 2-1, "TMF814 Property Initializer Properties and Values" for a list of properties. tpDetailMap(oracle.communications.integrity.tmf814discovery.model.tp.TPNameMap) A map listing properties to PTP names.
TMF814 Property Customizer	Input: tmf814Properties orb namingServer Output: tmf814Properties
Huawei Customizer	Input: customProperties tmfNameToDeviceNameMap (oracle.communications.integrity.tmf814discovery.model.DeviceNameMapping) Output: tmfNameToDeviceNameMap (oracle.communications.integrity.tmf814discovery.model.DeviceNameMapping)
TMF814 Session Manager	Input: tmf814Properties Output: sessionManager(oracle.communications.integrity.tmf814discovery.session.SessionManager) A session manager instance responsible for creating emsMgr and multiLayerSubnetwork, and for managing EMSSession and TMF814 Object managers.
TMF814 Device Recorder Initializer	Input: tmf814Properties, customProperties Output: recordMode(boolean) A Boolean indicating whether Recording Mode is enabled.
TMF814 ME Collector	Input: N/A Output: meIterable Iterable object for each collected ME.
TMF814 Device Modeler	Input: tmf814Properties customProperties managedElement(org.tmforum.mtnm.managedElement.ManagedElement_T) One instance of the meIterable. This processor is run once for each instance of manamedElement. Output: physicalTree(oracle.communications.integrity.tmf814discovery.model.ocimtree.PhysicalTree) A representation of the Information Model Physical Tree containing a physical device as the root object, to which child objects can be added. logicalTree(oracle.communications.integrity.tmf814discovery.model.ocimtree.LogicalTree) A representation of the Information Model Logical Tree containing a logical device as the root object, to which child objects can be added.
TMF814 Equipment Collector	Input: tmf814Properties, customProperties, sessionManager, physicalTree, managedElement Output: equipmentOrHolderIterable(java.lang.Iterable<org.tmforum.mtnm.equipment.EquipmentOrHolder_T>) Iterable object that iterates for each collected Equipment object or Holder object.
TMF814 Equipment Modeler	Input: tmf814Properties physicalTree equipmentOrHolder(org.tmforum.mtnm.equipment.EquipmentOrHolder_T) One instance of the equipmentOrHolderIterable. This processor is run once for each instance of equipmentOrHolder. Output: equipment(oracle.communications.inventory.api.entity.Equipment) Returned value if input is equipment. equipmentHolder(oracle.communications.inventory.api.entity.EquipmentHolder) Returned value if input is equipment holder.
TMF814 PTP Collector	Input: tmf814Properties customProperties equipment(oracle.communications.inventory.api.entity.Equipment) A modeled Information Model equipment object. equipmentHolder(oracle.communications.inventory.api.entity.EquipmentHolder) A modeled Information Model equipment holder object. Output: ptpIterable(java.lang.Iterable<org.tmforum.mtnm.terminationPoint.TerminationPoint_T>) Iterable object for each collected PTP belonging to an Equipment object.
TMF814 PTP Modeler	Input: tmf814Properties equipment An Information Model object that is modeled as the parent for all ports. physicalTree logicalTree tpDetailMap ptp(org.tmforum.mtnm.terminationPoint.TerminationPoint_T) A PTP object, modeled as a Physical Port in the Physical Tree, and as a Device Interface in the Logical Tree. Output: deviceInterface(oracle.communications.inventory.api.entity.DeviceInterface) A modeled Information Model interface object. physicalPort(oracle.communications.inventory.api.entity.PhysicalPort) A modeled Information Model port object.
TMF814 CTP Discoverer for PTP	Input: tmf814Properties Provides the CTP flag, termination point (TP) fetch size, and CTP depth properties. customProperties deviceInterface logicalTree physicalPort ptp Parent PTP for which all CTPs are discovered. Output: n/a
TMF814 FTP Collector	Input: tmf814Properties Provides the CTP flag and TP fetch size properties. customProperties logicalTree managedElement The name of the ME is used to fetch the FTP. Output: terminationPointIterable(java.lang.Iterable<org.tmforum.mtnm.terminationPoint.TerminationPoint_T>) Iterable object for each collected FTP.
TMF814 FTP Modeler	Input: tmf814Properties logicalTree tpDetailMap terminationPoint(org.tmforum.mtnm.terminationPoint.TerminationPoint_T) Output: deviceInterface Modeled Information Model object for a TP. TPs are modeled and added to the Logical Tree as direct child objects of a logical device.
TMF814 CTP Discoverer for FTP	Input: tmf814Properties customProperties terminationPoint TPs for which CTPs are fetched and modeled. deviceInterface Parent Information Model object for all top level CTPs. logicalTree Output: n/a
TMF814 Device Persister	Input: tmf814Properties physicalTree logicalTree managedElement Output: n/a
TMF814 Device Recorder Persister	Input: tmf814Properties Output: n/a
TMF814 Cross-Connect Discoverer	Input: tmf814Properties, customProperties, tpDetailMap Output: n/a
TMF Topological Link Collector	Input: tmf814Properties, customProperties, tpDetailMap Output: topologicalLinkIterable(java.util.Iterable) Iterable object that iterates for each collected topological link object. tlPipeMap(java.util.Map<java.lang.String,java.utilList<oracle.communications.inventory.api.entity.Pipe>>) A map listing all collected topological links by their container group.
TMF814 Topological Link Modeler	Input: tmf814Properties tpDetailMap topologicalLink(org.tmforum.mtnm.topologicalLink.TopologicalLink_T) tlPipeMap Output: linkPipe(oracle.communications.inventory.api.entity.Pipe) A modeled topological link as a pipe entity.
TMF814 Pipe Persister	Input: tmf814Properties, tpDetailMap, tlPipeMap Output: n/a