cancel
Showing results for 
Search instead for 
Did you mean: 
cancel
2449
Views
5
Helpful
3
Replies

Installed nso-5.3 for linux and there is no ncs-setup program

pgaltieri
Level 1
Level 1

I downloaded and installed the nso-5.3 installer for Linux.  I followed the instructions up to source /opt/ncs/ncs-5.3/ncsrc.  So far so good.  I created the directory

/opt/ncs/ncs-5.3/ncs-run

The next step is

ncs-setup --dest /opt/ncs/ncs-5.3/ncs-run

The problem is there is no ncs-setup anywhere under /opt/ncs/ncs-5.3 except for a man page. 

 

I was trying to run the https://developer.cisco.com/learning/modules/nso-basics/nso-basics-cisco-it-102/step/1 lab.  Note that the link to the installation instructions are for a MAC, there's no link to instructions for Linux, but I can't believe they would be that different. 

So what am I missing?

 

Paolo

 

 

3 Replies 3

lmanor
Cisco Employee
Cisco Employee

So from your path to ncs-run (/opt/ncs/ncs-5.3) it looks like maybe you've installed NSO as a system-install (--system-install switch during install). 

In the case of a system-install, a run-time directory is created at /var/opt/ncs and I believe the ncs-setup script is not included in the environment setup (ncsrc)

 

The ncs-setup command is targeted toward the local-install of nso (no --system-install switch)

in which case you can create one or more run-time directories using the ncs-setup command:

 

from man page:

The ncs-setup command is used to create an initial execution environment for a "local install" of NCS..

 

The installation guide you pointed to in the cisco-it-102, instructs to install nso as a local-install:

MY-MAC:~ $ sh  NSO_3.4.2.darwin.x86_64.installer.bin /Users/rrahul/ncs-342

There is no --system-install switch.

 

 

 

The problem then is the usage message that is displayed.  The first usage message displayed shows a --local-install option, the second usage message shows the --system-install option is required.  This is very confusing.  And if the system system install doesn't require an ncs-setup then the man page shouldn't be installed.  The instructions should be clearer regarding local install vs system install.  I didn't even see the --local-install option because I saw the second usage message and not the first.

 

[pgaltieri@truckin Downloads]$ ./nso-5.3.linux.x86_64.installer.bin --help

This is the NCS installation script.

Usage: ./nso-5.3.linux.x86_64.installer.bin [--local-install] LocalInstallDir

Installs NCS in the LocalInstallDir directory only.
This is convenient for test and development purposes.

Usage: ./nso-5.3.linux.x86_64.installer.bin --system-install [--install-dir InstallDir]
[--config-dir ConfigDir] [--run-dir RunDir] [--log-dir LogDir]
[--run-as-user User] [--keep-ncs-setup] [--non-interactive]

Does a system install of NCS, suitable for deployment.
Static files are installed in InstallDir/ncs-<vsn>.
The first time --system-install is used, the ConfigDir,
RunDir, and LogDir directories are also created and
populated for config files, run-time state files, and log files,
respectively, and an init script for start of NCS at system boot
and user profile scripts are installed. Defaults are:

InstallDir - /opt/ncs
ConfigDir - /etc/ncs
RunDir - /var/opt/ncs
LogDir - /var/log/ncs

By default, the system install will run NCS as the root user.
If the --run-as-user option is given, the system install will
instead run NCS as the given user. The user will be created if
it does not already exist.

If the --non-interactive option is given, the installer will
proceed with potentially disruptive changes (e.g. modifying or
removing existing files) without asking for confirmation.

 

On another note, I did an uninstall of the system install version and that worked.  I did a local install and then tried to do an uninstall of the local install and that failed.

 

sudo /opt/ncs/bin/ncs-uninstall --install-dir /opt/ncs


ERROR ** /opt/ncs does not appear to be a NCS installation directory

 

[pgaltieri@truckin Downloads]$ ls /opt/ncs
bin/ erlang/ include/ LICENSE ncsrc.tcsh README support/
CHANGES etc/ java/ man/ netsim/ scripts/ var/
doc/ examples.ncs/ lib/ ncsrc packages/ src/ VERSION

 

Paolo

Jason Belk
Cisco Employee
Cisco Employee

Thanks for the question. That series of lab is in process of being overhauled as we speak to be aligned to the new NSO Sandbox. If you are looking to get started, I suggest checking out the new Learn NSO the Easy Way which is built to correspond to the new NSO reservable sandbox:

 

https://developer.cisco.com/learning/lab/learn-nso-the-easy-way/step/1

 

https://blogs.cisco.com/developer/nso-learning-lab-and-sandbox