Release Announcement: NSO 6.5 is now released.
Head to the release highlights to see what's new
LogoLogo
NSO DevCenterTry NSO
NSO 6.1
  • Get Started
  • User Guides
  • Developers
  • Release Info
NSO 6.1
  • Start
  • What's New
  • Administration
    • Get Started
    • Installation and Deployment
      • Local Install
      • System Install
      • Post-Install Actions
        • Explore the Installation
        • Start and Stop NSO
        • Create NSO Instance
        • Enable Development Mode
        • Running NSO Examples
        • Migrate to System Install
        • Modify Examples for System Install
        • Uninstall Local Install
        • Uninstall System Install
      • Containerized NSO
      • Deployment Example
      • Upgrade NSO
    • Management
      • System Management
        • Cisco Smart Licensing
        • Log Messages and Formats
        • Alarm Types
      • Package Management
      • High Availability
      • AAA Infrastructure
      • NED Administration
    • Advanced Topics
      • Locks
      • Compaction
      • IPC Ports
      • Service Manager Restart
      • Security Issues
      • Run NSO as Non-Privileged User
      • IPv6 on Northbound Interfaces
      • Layered Service Architecture
  • Operation & Usage
    • Get Started
    • CLI
      • Introduction to NSO CLI
      • CLI Commands
    • Web UI
    • Operations
      • Basic Operations
      • NEDs and Adding Devices
      • Manage Network Services
      • NSO Device Manager
      • SSH Key Management
      • Alarm Manager
      • Plug-and-Play Scripting
      • Compliance Reporting
      • Listing Packages
      • Lifecycle Operations
      • Network Simulator
  • Development
    • Get Started
    • Introduction to Automation
      • CDB and YANG
      • Basic Automation with Python
      • Develop a Simple Service
      • Applications in NSO
      • Develop and Deploy a Nano Service
    • Core Concepts
      • Services
      • Implementing Services
      • Templates
      • Nano Services
      • Packages
      • Using CDB
      • YANG
      • NSO Concurrency Model
      • Service Handling of Ambiguous Device Models
      • NSO Virtual Machines
        • NSO Python VM
        • NSO Java VM
        • Embedded Erlang Applications
      • API Overview
        • Python API Overview
        • Java API Overview
      • Northbound APIs
        • NSO NETCONF Server
        • RESTCONF API
        • NSO SNMP Agent
    • Advanced Development
      • Development Environment and Resources
      • Developing Services
        • Services Deep Dive
        • Service Development Using Java
        • NSO Developer Studio
      • Developing Packages
      • Developing NEDs
        • NETCONF NED Development
        • CLI NED Development
        • Generic NED Development
        • SNMP NED
        • NED Upgrades and Migration
      • Developing Alarm Applications
      • Kicker
      • Scaling and Performance Optimization
      • Progress Trace
      • Web UI Development
        • JSON-RPC API
    • Connected Topics
      • SNMP Notification Receiver
      • Web Server
      • Scheduler
      • External Logging
      • Encryption Keys
  • Resources
    • Manual Pages
      • Section 1
      • Section 3
      • Section 5
Powered by GitBook
LogoLogo

Site

  • Cisco.com
  • Documentation
  • Learning Labs
  • Sample Code

Connect

  • Feedback
  • Community
  • Blogs
  • Events

Follow Us

  • X/Twitter
  • Facebook
  • YouTube
  • LinkedIn

© Copyright 2025 Cisco Systems, Inc. | This site is part of the official Cisco Crosswork NSO documentation set.

On this page
  • Contents of the Installation Directory
  • Documentation
  • Examples
  • Network Element Drivers (NEDs)
  • Shell Scripts

Was this helpful?

Edit on GitHub
Export as PDF
  1. Administration
  2. Installation and Deployment
  3. Post-Install Actions

Explore the Installation

Explore NSO contents after finishing the installation.

PreviousPost-Install ActionsNextStart and Stop NSO

Last updated 9 months ago

Was this helpful?

Applies to Local Install.

Before starting NSO, it is recommended to explore the installation contents.

Navigate to the newly created Installation Directory, for example:

cd ~/nso-6.0

Contents of the Installation Directory

The installation directory includes the following contents:

Documentation

Along with the binaries, NSO installs a full set of documentation available in the doc/ folder in the Installation Directory. There is also an online version of the documentation available on .

ls -l doc/
drwxr-xr-x   5 user  staff   160B Nov 29 05:19 api/
drwxr-xr-x  14 user  staff   448B Nov 29 05:19 html/
-rw-r--r--   1 user  staff   202B Nov 29 05:19 index.html
drwxr-xr-x  17 user  staff   544B Nov 29 05:19 pdf/

Run index.html in your browser to explore further.

Examples

Local Install comes with a rich set of examples to start using NSO.

$ ls -1 examples.ncs/
README
crypto
datacenter
development-guide
generic-ned
getting-started
misc
service-provider
snmp-ned
snmp-notification-receiver
web-server-farm
web-ui

Network Element Drivers (NEDs)

In order to communicate with the network, NSO uses NEDs as device drivers for different device types. Cisco has NEDs for hundreds of different devices available for customers, and several are included in the installer in the /packages/neds directory.

In the example below, NEDs for Cisco ASA, IOS, IOS XR, and NX-OS are shown. Also included are NEDs for other vendors including Juniper JunOS, A10, ALU, and Dell.

$ ls -1 packages/neds
a10-acos-cli-3.0
alu-sr-cli-3.4
cisco-asa-cli-6.6
cisco-ios-cli-3.0
cisco-ios-cli-3.8
cisco-iosxr-cli-3.0
cisco-iosxr-cli-3.5
cisco-nx-cli-3.0
dell-ftos-cli-3.0
juniper-junos-nc-3.0

The example NEDs included in the installer are intended for evaluation, demonstration, and use with the examples.ncs. These are not the latest versions available and often do not have all the features available in production NEDs.

Install New NEDs

Like the NSO installer, the NEDs are signed.bin files that need to be run to validate the download and extract the new code.

To install new NEDs:

  1. Change to the working directory where your downloads are. The filenames indicate which version of NSO the NEDs are pre-compiled for (in this case NSO 6.0), and the version of the NED. An example output is shown below.

    cd ~/Downloads/
    ls -l ncs*.bin
    
    # Output
    -rw-r--r--@ 1 user  staff   9708091 Dec 18 12:05 ncs-6.0-cisco-asa-6.7.7.signed.bin
    -rw-r--r--@ 1 user  staff  51233042 Dec 18 12:06 ncs-6.0-cisco-ios-6.42.1.signed.bin
    -rw-r--r--@ 1 user  staff   8400190 Dec 18 12:05 ncs-6.0-cisco-nx-5.13.1.1.signed.bin
  2. Use the sh command to run signed.bin to verify the certificate and extract the NED tar.gz and other files. Repeat for all files. An example output is shown below.

    sh ncs-6.0-cisco-nx-5.13.1.1.signed.bin 
     
      Unpacking...  
      Verifying signature...
      Downloading CA certificate from http://www.cisco.com/security/pki/certs/crcam2.cer ...
      Successfully downloaded and verified crcam2.cer.
      Downloading SubCA certificate from http://www.cisco.com/security/pki/certs/innerspace.cer ...
      Successfully downloaded and verified innerspace.cer.
      Successfully verified root, subca and end-entity certificate chain.
      Successfully fetched a public key from tailf.cer.
      Successfully verified the signature of ncs-6.0-cisco-nx-5.13.1.1.tar.gz using tailf.cer
  3. You now have three tar (.tar.gz) files. These are compressed versions of the NEDs. List the files to verify as shown in the example below.

    ls -l ncs*.tar.gz
    -rw-r--r--  1 user  staff   9704896 Dec 12 21:11 ncs-6.0-cisco-asa-6.7.7.tar.gz
    -rw-r--r--  1 user  staff  51260488 Dec 13 22:58 ncs-6.0-cisco-ios-6.42.1.tar.gz
    -rw-r--r--  1 user  staff   8409288 Dec 18 09:09 ncs-6.0-cisco-nx-5.13.1.1.tar.gz
  4. Navigate to the packages/neds directory for your Local Install, for example:

    cd ~/nso-6.0/packages/neds
  5. In the /packages/neds directory, extract the .tar files into this directory using the tar command with the path to where the compressed NED is located. An example is shown below.

    tar -zxvf ~/Downloads/ncs-6.0-cisco-nx-5.13.1.1.tar.gz
    tar -zxvf ~/Downloads/ncs-6.0-cisco-ios-6.42.1.tar.gz
    tar -zxvf ~/Downloads/ncs-6.0-cisco-asa-6.7.7.tar.gz

    Here is a sample list of the newer NEDs extracted along with the ones bundled with the installation:

    drwxr-xr-x  13 user  staff   416 Nov 29 05:17 a10-acos-cli-3.0
    drwxr-xr-x  12 user  staff   384 Nov 29 05:17 alu-sr-cli-3.4
    drwxr-xr-x  13 user  staff   416 Nov 29 05:17 cisco-asa-cli-6.6
    drwxr-xr-x  13 user  staff   416 Dec 12 21:11 cisco-asa-cli-6.7
    drwxr-xr-x  12 user  staff   384 Nov 29 05:17 cisco-ios-cli-3.0
    drwxr-xr-x  12 user  staff   384 Nov 29 05:17 cisco-ios-cli-3.8
    drwxr-xr-x  13 user  staff   416 Dec 13 22:58 cisco-ios-cli-6.42
    drwxr-xr-x  13 user  staff   416 Nov 29 05:17 cisco-iosxr-cli-3.0
    drwxr-xr-x  13 user  staff   416 Nov 29 05:17 cisco-iosxr-cli-3.5
    drwxr-xr-x  13 user  staff   416 Nov 29 05:17 cisco-nx-cli-3.0
    drwxr-xr-x  14 user  staff   448 Dec 18 09:09 cisco-nx-cli-5.13
    drwxr-xr-x  13 user  staff   416 Nov 29 05:17 dell-ftos-cli-3.0
    drwxr-xr-x  10 user  staff   320 Nov 29 05:17 juniper-junos-nc-3.0

Shell Scripts

The last thing to note is the files ncsrc and ncsrc.tsch. These are shell scripts for bash and tsch that set up your PATH and other environment variables for NSO. Depending on your shell, you need to source this file before starting NSO.

A large number of pre-built supported NEDs are available which can be acquired and downloaded by the customers from . Note that the specific file names and versions that you download may be different from the ones in this guide. Therefore, remember to update the paths accordingly.

For more information on sourcing shell script, see the .

Cisco Software Download
Local Install steps
DevNet
Documentation
Examples
Network Element Drivers
Shell scripts