PDF(10.5 KB) View with Adobe Reader on a variety of devices
ePub(73.3 KB) View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
Mobi (Kindle)(67.9 KB) View on Kindle device or Kindle app on multiple devices
Updated:June 23, 2016
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This document describes the installation of Cisco Network Services Orchestrator (NSO), which can run natively on your MAC. This is very helpful if you want to learn NSO through the multiple examples that are present in the installer. For instance, you can use it to recreate customer issues, to play around, to view the API documentation and lots more. Moreover, the local install is only used because the system install is not supported.
There are no specific requirements for this document.
The information in this document is based on Cisco NSO software.
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.
Step 1. Download the darwin installer of the NSO.
You can find the darwin installer on the cisco.com website or on the devnet website. To download it from the Cisco.com website, you need your Cisco Connection Online (CCO) credentials.
To install NSO 3.4.2 version on your MAC, you need to download the nso_3.4.2.darwin.x86_64.installer.bin. Download the file to your MAC from any of the these sources -
Step 2. Check your installation of Java and install/upgrade if required.
Open a terminal and verify your Java version. Java Development Kit 6 (JDK6 ) and above is recommended. When JDK is installed properly, you should see a java version of 1.6 or above.
MY-MAC:~ $ java -version java version "1.8.0_51" Java(TM) SE Runtime Environment (build 1.8.0_51-b16) Java HotSpot(TM) 64-Bit Server VM (build 25.51-b03, mixed mode) MY-MAC:~ $
To upgrade, you can download the latest version of Java JDK from this link. It also updates your Java Runtime Environment (JRE). (The latest version of JDK as of writing this article is jdk-8u51-macosx-x64.dmg).
Once you have brew installed, ensure it's up to date by executing:
MY-MAC:~ $ brew update Updated Homebrew from 43037003 to 51a477de. ... MY-MAC:~ $
Once brew is installed and updated you can simply type this to install ant.
MY-MAC:~ $ brew install ant
Ant should now be installed and available through the ant command in the terminal. Verify that with this:
MY-MAC:~ $ ant -version Apache Ant(TM) version 1.9.6 compiled on June 29 2015 MY-MAC:~ $
Step 4. Install the NCS/NSO software.
These steps are taken from the installation documents on NCS/NSO and are applicable here too. From a terminal these can be exectued.
Install the NCS/NSO Software in a local directory. For example, in home directory $HOME. It is recommended to always install NCS/NSO in a directory named as the version of the release.
MY-MAC:~ $ sh NSO_3.4.2.darwin.x86_64.installer.bin /Users/rrahul/ncs-342
The installation program creates a shell script file named ncsrc in each NCS/NSO installation, which sets the environment variables. Source this file to get these settings in your shell. You may want to add this sourcing command to your login sequence, such as .bashrc.
MY-MAC:~ $ source $HOME/ncs-342/ncsrc MY-MAC:~ $
Create a runtime directory where NCS/NSO keeps its database, state files, logs etc. In these instructions you assume that this directory is $HOME/ncs-run.