Working with NSO 5.
x
Has anything changed?
Martin Åkerström
Solutions Architect
2020
• Common Data Model
• Different NED versions
API Changes
What has changed?
•
• Templates updates
• Code changes
• New functionality/features
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
Common Data
Model
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Without CDM only a single
version of YANG module
could be loaded
Common Data
Model • No need to upgrade the
whole network in one go
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Crunched namespace
from mount-id and XML
namespace
• Introduces YANG schema
mount defined in RFC 8528
Schema Changes • ned-id is now mandatory
• Globally unique over all NED
versions
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
admin@ncs(config)# show full-configuration devices device
devices device ex0
address 127.0.0.1
port 12022
authgroup default
device-type netconf ned-id router-nc-1.0
state admin-state unlocked
!
devices device ex1
address 127.0.0.1
port 12023
authgroup default
device-type netconf ned-id router-nc-1.0
ned-id
state admin-state unlocked
!
$ ls -la packages/
total 0
drwxr-xr-x 5 makerstr staff 160 Feb 20 09:25 .
drwxr-xr-x 12 makerstr staff 384 Jun 5 16:56 ..
drwxr-xr-x 8 makerstr staff 256 Jun 5 16:56 router-nc-1.0
drwxr-xr-x 8 makerstr staff 256 Jun 5 16:56 router-nc-1.1
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Discover model changes on
upgrade
Services where config will
•
NED Migration change and what has
changed
• Services that are affected
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
NED Migration
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
Ned version
Scheme
NED releases in the same maintenace
branch are backawards compatible
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Large network upgrades
More control
NED Migration
•
• Not all at once
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Service Templates
API Changes • Programmatic APIs
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
<config-template xmlns="http://tail-f.com/ns/config/1.0"
servicepoint="syslog-servicepoint">
<devices xmlns="http://tail-f.com/ns/ncs" foreach="{devices}">
<device when="{deref(current())">
<name>{string(current())}</name>
<config>
<?if-ned-id.router-nc-1.0:router-nc-1.0?>
<sys xmlns="http://example.com/router">
<syslog>
<server foreach="{/server}">
<name>{name}</name>
<selector foreach="{selector}">
<name>{name}</name>
<option>
<pid/>
</option>
API Changes
<facility>{facility}</facility>
</selector>
</server>
</syslog>
Service templates </sys>
<?elif-ned-id router-nc-1.1:router-nc-1.1?>
<sys xmlns="http://example.com/router">
<syslog>
<server foreach="{/server}">
<name>{name}</name>
<selector foreach="{selector}">
<name>{name}</name>
<option>pid</option>
<facility>{facility}</facility>
</selector>
</server>
</syslog>
</sys>
<?end?>
</config>
</device>
</devices>
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
</config-template>
• Python
def create_apache_device(self, service, name):
dev = _get_device(service, name)
if 'apache-nc-1.0:apache-nc-1.0' ==
API Changes ncs.application.get_ned_id(dev):
self.create_apache1_device(dev)
Programmatic APIs elif 'apache-nc-1.1:apache-nc-1.1' ==
ncs.application.get_ned_id(dev):
self.create_apache2_device(dev)
else:
raise Exception('unknown ned-id
{}'.format(get_ned_id(dev)))
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Java
String nedIdStr =
context.getNEDIdByDeviceName(elemName.valueAsString
API Changes ());
if ("webserver-nc-1.0:webserver-nc-
1.0".equals(nedIdStr)) {
Programmatic APIs ipStr = ipv4Str;
}
else if ("webserver2-nc-1.0:webserver2-nc-
1.0".equals(nedIdStr)) {
ipStr = ipv6Str;
}
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Test your services in NSO 5.x
• It's probably easier than you
think
• An updated test-enviroment
makes a difference
Now what? • Start to look at the features
© 2019 Cisco and/or its affiliates. All rights reserved. Cisco Public
