Installation
To obtain ns-scripting, you need to have a valid NSX Nexus account.
Prerequisites
Both Java 17 (or higher) and a local Maven installation is required for NSScript to run correctly. The path to the maven installation directory should be set in the MAVEN_HOME variable, if this is not the case, the mvn executable should be available on the system path. A Maven settings.xml file must also be set up in one of the search locations for Maven with configuration to access the repository which distributes NSScript.
Instructions
- Windows
- Ubuntu
- Other
- Download directly from Nexus
- Install with Chocolatey:
- Install Chocolatey if needed.
- Set up Chocolatey with a new source:
choco source add -n nsx-nexus -s https://nexus.normalizedsystems.org/repository/nuget-choco-public/ -u my-nexus-username -p my-nexus-password - Install ns-initializer with or without 3rd party dependencies (Java, Maven, ...):
- With dependencies:
choco install ns-scripting - Without dependencies:
choco install ns-scripting.install
- With dependencies:
- Download using Maven:
mvn dependency:copy "-Dartifact=net.democritus.scripting:ns-scripting-windows-installer:1.12.1:exe" "-DoutputDirectory=."
On Ubuntu (or other Debian-based distributions), you can install from the APT repository.
- Install with APT:
- If you have not yet set up APT sources for NS tooling:
sudo bash -c "wget -q -O - https://foundation.stars-end.net/files/setup-nsx-apt.sh | bash <(cat) </dev/tty" - Execute the command to install:
sudo apt install ns-scripting
- If you have not yet set up APT sources for NS tooling:
For other operating systems, you can download the archive version of NSScript and install it manually.
- Download the latest zip Download archive directly from Nexus
- Download using Maven:
mvn dependency:copy "-Dartifact=net.democritus.scripting:ns-scripting-engine:1.12.1:zip:full" "-DoutputDirectory=."
NSScript comes packaged together with batch/shell/powershell scripts. To manually set it up, extract the directory containing the distribution to the filesystem and add it to your PATH variable on Windows. On Linux/Mac create a link in /usr/local/bin to the nss script.