05-27-2020 02:01 PM
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
05-28-2020 07:39 AM
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.
05-28-2020 08:13 AM
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
05-28-2020 08:33 AM
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
Discover and save your favorite ideas. Come back to expert answers, step-by-step guides, recent topics, and more.
New here? Get started with these tips. How to use Community New member guide