Installation

To obtain expansion-diff-tool, 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 Expansion Diff Tool 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 NS Expansion Diff Tool.

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/index.json -u my-nexus-username -p my-nexus-password
  3. Install ns-initializer with or without 3rd party dependencies (Java, Maven, ...):
     • With dependencies:

       choco install expansion-diff-tool
     • Without dependencies:

       choco install expansion-diff-tool.install
• Download using Maven:

  mvn dependency:copy "-Dartifact=net.democritus.tools:expansion-diff-tool-windows-installer:2.0.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 expansion-diff-tool

Other

For other operating systems, you can download the archive version of NS Expansion Diff Tool and install it manually.

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

  mvn dependency:copy "-Dartifact=net.democritus.tools:expansion-diff-tool:2.0.0:zip:full" "-DoutputDirectory=."

NS Expansion Diff Tool 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 nsdiff script.