The following tables describe how Altiplano CIs are represented in the CMDB and how they relate to each other across physical and logical layers.

Tabela 1. CMDB CI Mapping and Relationships (Physical Layer)

CI Type	CMDB Table	Description and Relationships
OLT CI	cmdb_ci_optical_line_terminal	Represents the OLT device. Contains Slot CIs and Logical Network Interface CIs.
ONU/ONT CI	cmdb_ci_optical_network_terminal or cmdb_ci_optical_network_unit	Represents ONU or ONT devices. The class is determined by the system property sn_sgc_altiplano.onu_ci_class. Contains Network Interface CIs.
Slot CI	cmdb_ci_container_slot	Represents main chassis slots. Contained by OLT CIs. Contains Interface Card CIs (for example, LT/NT, PSU, fan). Model transformations are applied in the data source. For more information, see the above mentioned Model transformation for slot and subslot CIs table.
Subslot CI	cmdb_ci_container_subslot	Represents subcomponents within interface cards (for example, cages for SFPs). Contained by LT/NT cards. Contains transceiver card CIs. For more information, see the above mentioned Model transformation for slot and subslot CIs table.
Interface Card CI	cmdb_ci_interface_card	Represents LT/NT cards, transceivers, and control units. Can contain subslots and network interfaces.
Network Interface CI	cmdb_ci_ni_interface	Represents both physical (for example, PON, Ethernet) and logical (for example, VLAN) ports. Contained by interface cards or ONU/ONT CIs. Logical ports are related to physical ports using Members::Member of.
Logical Connection CI	cmdb_ci_ni_logical_path	Represents logical paths such as PON or VLAN between OLT and ONU. Defined with Port A and Port Z attributes referencing terminating Network Interface CIs. VLAN paths consume PON paths.
IP Address CI	cmdb_ci_ip_address	Represents discovered IP addresses for OLTs. Owned by the corresponding OLT CI.

• Containment relationships
  • OLT CI → contains Slot CI
  • Slot CI → contains Interface Card CI
  • Interface Card CI → contains Subslot CI
  • Subslot CI → contains transceiver Interface Card CI
  • ONU/ONT CI → contains Network Interface CIs
• Interface relationships:
  • Logical Connections -> terminated by Network Interfaces
  • Network Interfaces -> members of Network Interfaces
• Logical path relationships:
  • VLAN path (parent) → consumes → PON path (child)
  • Logical paths → terminate at → Network Interface CIs via Port A and Port Z
• Ownership: IP Address CI → owned by OLT device

1. Network equipment models (sn_ent_nw_equipment_model)
   • The supported OLT is Nokia Lightspan MF-2, by default the model name is "Nokia MF-2"
   • ONU/ONT models are manufacturer + ONU/ONT. the system property sn_sgc_altiplano.onu_ci_class defines if ONU or ONT will be used.
   • If the model wasn’t found in the model table, a new model is created in the CI. and the CI will be created as "Network gear"
2. Equipment holder models: (sn_ent_nw_holder_model)
   • Slots models: "Traffic Slot", "FAN Slot", "Power Slot"
   • Subslots models: "SFP Subslot"
   • The used model name can be customized by the customer through the Altiplano extension point (sn_sgc_altiplano.AltiplanoCustomizedModels)
   • If the model wasn’t found in the model table, a new model is created in the CI.
3. Network card models (sn_ent_nw_card_model)
   • Card models are found by the model name, manufacturer, and model number discovered from the Altiplano API
   • If the model wasn’t found in the model table, a new model is created in the CI.
4. Network Interface Models: (sn_ent_nw_interface_model).
   • Ethernet ports models are found by the "port bandwidth" column in the Network Interface table (sn_ent_nw_interface_model). the port bandwidth of the port CI is located by the discovered port speed in the Bandwidth table (bandwidth)
   • PON physical ports models: "PON Access Interface", "PON Network Interfaces"
   • Logical ports models: "ENET Interface", "VLAN Interface", "LAG Interface", PON Logical Interface"
   • If the model wasn’t found in the model table, the reference to the "Model ID" will remain empty.
5. Logical network connection models (sn_ent_logical_nw_connection_model)
   • PON Access Path
   • VLAN Path
   • If the model wasn’t found in the model table, the reference to the "Model ID" will remain empty.

The following structure enables end-to-end traceability from OLT through its hardware layers to the connected ONU and associated logical paths.

OLT (cmdb_ci_optical_line_terminal)
├── Slot
│   ├── Interface Card (LT/NT)
│   │   ├── Subslot
│   │   │   └── Interface Card (Transceiver)
│   │   │       └── Network Interface (PON port)
├── Logical Connections (PON/VLAN) → Connected to →
└── ONU/ONT (cmdb_ci_optical_network_terminal)
    └── Network Interface (ONT port)