Installation

To obtain the ns-initializer, you need to have a valid NSX Nexus account.

Prerequisites

Both Java 17 (or higher) and a local Maven installation is required for the NS initializer 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 the initializer.

Instructions

Windows

• Download directly from Nexus
• Install with Chocolatey:
  1. Install Chocolatey if needed.
  2. 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
  3. Install ns-initializer with or without 3rd party dependencies (Java, Maven, ...):
     • With dependencies:

       choco install ns-initializer
     • Without dependencies:

       choco install ns-scripting.install ns-initializer.install
• Download using Maven:

  mvn dependency:copy "-Dartifact=net.democritus.initializer:ns-initializer-windows-installer:4.38.0:exe" "-DoutputDirectory=."

Ubuntu

On Ubuntu (or other Debian-based distributions), you can install from the APT repository.

• Install with APT:
  1. 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"
  2. Execute the command to install:

     sudo apt install ns-initializer

Other

For other operating systems, you can download the archive version of the initializer and install it manually.

• Download the latest zip Download archive directly from Nexus
• Download using Maven:

  mvn dependency:copy "-Dartifact=net.democritus.initializer:ns-initializer:4.38.0:zip" "-DoutputDirectory=."

The NS initializer 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 nsinit script.