Service Graph Connector for Nokia Altiplano

Release version: Yokohama

Updated January 30, 2025

5 minutes to read

Use the Service Graph Connector for Nokia Altiplano Access Network SDN Controller to pull in data from the Nokia Altiplano software into your ServiceNow instance using REST APIs.

The Service Graphs Connector for Nokia Altiplano pulls in asset inventory data (physical network resources) from the Nokia Altiplano database.

Request apps on the Store

Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

Nokia Altiplano SGC Architecture

Data Source defined as the following:

Custom load by script
Data in single column

For a general overview of Service Graph Connector technology, see Getting started with Service Graph Connectors.

Supported versions

Supported Nokia Altiplano Controller minimum versions: 24.6.

Use cases

The following are examples on how you can use the Nokia Altiplano Service Graph Connector:

The Nokia Altiplano Service Graph Connector can be used to pull data from the Nokia Altiplano Access Controller via REST API (through a MID Server), confirming that the CMDB is populated with accurate, up-to-date information about physical network resources such as OLTs and ONTs, among others. This integration provides a telecom-model-aligned view of network resources and their relationships.
Future Capabilities: In upcoming releases, the Nokia Altiplano Service Graph Connector expands its capabilities to discover not only physical resources but also logical resources and services/connections, enabling a more comprehensive view of both the physical and logical aspects of the network. It will also support event-driven discovery, where the Altiplano Controller notifies the ServiceNow instance (via the MID Server) about a change and sequentially triggers a discovery task.
Ability to configure and save synchronization schedules.

Guided setup

The guided setup for the Service Graphs Connector for Nokia Altiplano provides an organized sequence of tasks to configure the integration on your instance. To access the guided setup, see Configure Service Graph Connector for Nokia Altiplano.

CMDB Integrations Dashboard

The Integration Commons for CMDB store app provides a dashboard with a central view of the status, processing results, and processing errors of all installed Service Graph Connectors. You can see metrics for all integration runs. You can filter the view to a specific integration, a specific time duration, or a specific integration run. For more details about monitoring SolarWinds integrations in the CMDB Integrations Dashboard, see Integration Commons for CMDB.

Import Sets

The Import Sets are the input for the IntegrationHub ETL, where the transformation maps create and model relationships. When data is loaded into the Import Set, the transformation process is triggered.

Before you begin

Role required: admin

Procedure

Navigate to All > System Import sets > Administration > Import Sets.

The Data Source script automatically creates staging tables.

Data Mapping

Data from data sources in the Nokia Altiplano software is mapped and transformed into ServiceNow CMDB tables using the Robust Transform Engine (RTE). Data is inserted into ServiceNow CMDB using the Identification and Reconciliation Engine (IRE).

When you complete the guided setup, you can configure the integration to periodically pull data from the SolarWinds software.

The data is loaded into staging tables, then inserted into the following CMDB target tables with the following relationships:

Mapping CMDB CIs and CI Relationships (Physical Layer)


CIs	CI Relationships
OLT CI	OLT Device is represented by the OLT CI. Table name: cmdb_ci_optical_line_terminal OLT CI contains Slot CIs.
ONT CI	ONT Device is represented by the ONT CI. Table name: cmdb_ci_optical_network_terminal ONT CI contains Network Interface CIs. ONT Network Interface CIs is contained by the ONT CI.
Slot CI	Chassis slots are represented by the Slot CI. Table name: cmdb_ci_container_slot Slot CI is contained by OLT CI. Slot CI contains the Interface Card CI (LT/NT cards, Fan/PSU units).
Subslot CI	LT/NT card cages are represented by the Subslot CI. Table name: cmdb_ci_container_subslot Subslot CI is contained by OLT LT card CI. Subslot CI is contained by OLT NT card CI. Subslot CI contains the Interface Card CI (transceiver cards).
Interface Card CI	LT and NT cards are represented by the Interface Card CI. Transceiver cards are represented by the interface Card CI. Fan and Power Supply Units are represented by the Interface Card CI. (Special cards, Fan, and Power Supply Units CI might be changed in the next releases). Table name: cmdb_ci_interface_card LT Card contains the Subslots CIs. NT Card contains the Subslots CIs. NT cards CIs contains Network Interface CIs LT/NT transceiver cards CIs contains Network Interface CIs. LT/NT Card CI is contained by the LT/NT Slots CI. LT transceiver Card CI is contained by the subslot CI (LT Card). NT transceiver Card CI is contained by the Subslot CI (NT card).
Network Interface CI	LT card PON access ports as well as NT card network ports are represented by the Network Interface CI. Table name: cmdb_ci_ni_interface Network Interface CIs contained by LT transceiver/NT transceiver/NT cards CIs. ONT Network Interface CI is contained by ONT CIs.

You can use the IntegrationHub ETL application to view and manage data maps.

For more information, see IntegrationHub ETL.

Supported xNFs

Lightspan MF-2 (OLT)
Lightspan ISAM FX-4 (OLT)
Lightspan XS-010X-Q (ONT)
Lightspan XS-010X-R (ONT)

Special System properties

Service Graph Connector for Nokia Altiplano installs special system properties that control various behaviors of the application.

Before you begin

Role required: admin

Procedure

Navigate to All > Service Graph Connectors > Nokia Altiplano > Properties.

You can also access these properties by entering sys_properties.list and filtering by the name ‘*altiplano’.

Table 1. Nokia Altiplano SGC System Properties
Property Name	Recommended / Default Value	Description
sn_sgc_altiplano.olt_batch_size	300	The OLT Datasource batch size for REST Calls. The number represents number of Altiplano response entities. (Increasing may cause failure in the REST actions execution)
sn_sgc_altiplano.onu_batch_size	3	The ONU Datasource batch size for REST Calls. The number represents number of LT cards related ONU data. (Increasing may cause failure in the REST actions execution)
sn_sgc_altiplano.onu_ci_class	ONT	ONU CI Class, Valid values: ONU or ONT

Examples of Retrieving Data from Nokia Altiplano via REST API

Examples of Retrieving Data from Nokia Altiplano via REST API.

URL format

Versioned URL: POST: altiplano-indexsearch/latestcompleted-inv/_search

For OLT


{
    "_source": [
        "deviceAVmetadata",
        "inventorymetadata",
        "inventorydata.ietf-hardware:hardware",
        "inventorydata.ietf-hardware:hardware-state",
        "inventorydata.nokia-state:state"
    ],
    "sort": [{"_id": {"order": "asc"}}],    
    "from": 0,  
    "size":300
}

For ONU


{
      "query": {
            "bool": {
                "should": [
                    {
                        "exists": {
                            "field": "inventorydata.ietf-interfaces:interfaces-state.interface.bbf-xponvani:v-ani.onu-present-on-this-olt.detected-serial-number"
                        }
                    }
                ]
            }
    },
    "_source": [
         "inventorydata.ietf-interfaces:interfaces-state.interface.bbf-xponvani:v-ani.onu-present-on-this-olt.detected-serial-number",
        "inventorydata.bbf-fiber-onu-emulated-mount:onus.onu.root.ietf-hardware-mounted:hardware-state",
        "inventorydata.bbf-fiber-onu-emulated-mount:onus.onu.name"
     ],
    "sort": [{"_id": {"order": "asc"}}],    
    "from": 0,  
    "size": 3
}