Note	Download the NED package only when you onboard a new device type into Cisco MSX Managed Device service pack.

The Cisco Network Services Orchestrator (NSO) uses Network Element Drivers (NEDs) to orchestrate a multivendor network for different devices types and services. You can add a new NED after the Cisco MSX is installed and deployed into production.

The NED management functionality in Cisco MSX allows you to add, replace, and delete NED for device management.

The Cisco MSX service packs have a predefined set of NED package that is uploaded into NSO. The Managed Device service pack consists of Cisco IOS NED. Thus allows you to onboard any IOS-XE device. Similarly, for onboarding ASR9000, you need a new Cisco IOS-XR NED added into the Managed Device NSO using the NED management functionality.

This service pack also extends its support for devices such as Cisco IOS-XR, Cisco CAT, Cisco NX-OS, Cisco ASA, Juniper SRX, and FORTINET.

README.signature
cisco_x509_verify_release.py
ncs-4.7.6-juniper-junos-4.5.13.signed.bin
ncs-4.7.6-juniper-junos-4.5.13.tar.gz
ncs-4.7.6-juniper-junos-4.5.13.tar.gz.signature
tailf.cer

Cisco MSX Managed Device service pack supports out-of-the-box device models. To facilitate the SNMP metric collection for new device type, use the device model construct with several fields that capture all the necessary metrics data.

Sample device model fields:

"deviceModelName": "", ---> Unique Name
"platformDeviceType": "",  --> This is a global field and a big category where this particular device belongs. For example "CPE".
"platformDeviceSubType": "", --> This is sub category. For example, Sub category of a Juniper Device can be "SRX", "EX" etc..
"interfaces": [], ---> List of interfaces for the device model.
"lan": [], ---> Interfaces that can be categorized as LAN.
"wan": [], ---> Interfaces that can be categorized as WAN.
"nedId": "", --> NSO NED ID for this device
"deviceType": "",  --> NSO Device-Type for this device
"directTemplate":"" --> This field allows you to apply configurations to a device while it is onboarded to MSX. In this case, use this for applying SNMP configuration. Create a new file and name it. Save the NSO XML template in this file. 
 Note:  Ensure that you keep a note of the file name used for the XML template. You can reuse this later during device model preparation.
"deviceMetricConfigurations": [{
        "snmpDetails": {  ----> This is needed to connect to the device. This step is for preparing the CLI configuration for the SNMP support. Enter your choices for authentication protocol, privacy protocol, user used, and so on. Ensure to make a note of it.
            "snmpAuthProto": "",
            "snmpVersion": "",
            "snmpPrivProto": "",
            "snmpUserName": ""
        },
        "platformDeviceType": "",  ---> This must be similar to the device model section. 
        "platformDeviceSubType": "", ---> This must be similar to the device model section. 
        "snmpOidList":[], -----> The set of OIDs that is required to retrieve the data
        "snmpCpuMemoryUptimeQueryTemplate": { ---> This is a query template that explores the data collected from SNMPBEAT and provides a representation on the UI based on device OIDs and MIBs that are specific to this new device type.
        }
    }]
}

The two important fields in the data model construct are given in the table below:

Note	This table contains the list of default OIDs that work only for specific Cisco devices. These OIDs may vary for the new device type. Therefore, the list of extra OIDs that helps to fetch the necessary data has to be imported into Cisco MSX.

Table 2. SNMP OID and Query Template

Data Model Field	List of Default OID/Query Template	Metrics Data
snmpOidList	"oid":".1.3.6.1.2.1.1.3"	System / System Uptime
	"oid":".1.3.6.1.6.3.10.2.1.3”	snmpEngineBoots
	"oid":".1.3.6.1.4.1.9.9.109.1.1.1.1.6"	CPU / MEM
	"oid":".1.3.6.1.4.1.9.9.109.1.1.1.1.7"	CPU / MEM 1 min
	"oid":".1.3.6.1.4.1.9.9.109.1.1.1.1.8"	CPU / MEM 5 min
	"oid":".1.3.6.1.4.1.9.9.48.1.1.1”	CiscoMemoryPool
	"oid":".1.3.6.1.2.1.2.2.1”	InterfaceTable
snmpCpuMemoryUptimeQueryTemplate	"enterprises.2636.3.1.13.1.11.9.1.0.0"	Memory consumption value in terms of percentage (%)

SNMP OID List: In the Managed Device service pack, SNMP metrics are collected using the OIDs of the device type. OIDs are ISO specific, but the OIDs for CPU and memory are enterprise-specific.

The collected SNMP metric data are as follows:

• Interface traffic

• Interface BW utilization

• CPU

• Memory

• System Uptime

For examples:

Table 3. SNMP OID

Name of the Vendor	OID for CPU	Description
CISCO	1.3.6.1.4.1.9.9.109.1.1.1	(1.3.6.1.4.1) – This prefix is the standard OID and must not be changed. (9.9.109.1.1.1)-This is Cisco enterprise-specific code.
JUNIPER	1.3.6.1.4.1.2636.3.1.13.1.21	(1.3.6.1.4.1.) - This prefix is the standard OID and must not be changed. (2636.3.1.13.1.21) - This is Juniper enterprise-specific code.

SNMP QUERY Template: The Managed Device service pack can process the data that is collected as a part of SNMP polling using the Query Template. The metrics data is represented differently for each vendor. Query template is defined based on these returned metric values.

For example: The table below lists some of the sample query templates.

Table 4. SNMP Query Template

Name of Vendor	OID for Memory Usage Metrics	Description
JUNIPER SRX	"enterprises.2636.3.1.13.1.11.9.1.0.0"	Represents the memory usage value in terms of percentage (%).
Cisco ASA	".1.3.6.1.4.1.9.9.48.1.1.1"	Cisco has no OID for representing values in terms of percentage (%). But, Cisco uses the query calculation on the data fields to calculate the memory metrics. Execute this OID to get the metrics of both free memory and used memory. Use these two values to compute memory usage in terms of percentage (%).

{
    "deviceModels": [{
        "deviceModelName": "Juniper SRX",
        "platformDeviceType": "",
        "platformDeviceSubType": "",
        "interfaces": [],
        "lan": [],
        "wan": [],
        "nedId": "",
        "deviceType": "",
        "directTemplate":""
  
  
    }],
    "deviceMetricConfigurations": [{
        "snmpDetails": {
            "snmpAuthProto": "",
            "snmpVersion": "",
            "snmpPrivProto": "",
            "snmpUserName": ""
        },
        "platformDeviceType": "",
        "platformDeviceSubType": "",
        "snmpOidList":[], 
        "snmpCpuMemoryUptimeQueryTemplate": {
        }
    }]
}