macOS instructions
Last updated
Last updated
Overview
The NVIS App is a dock icon app that allows you to do all NVIS commands without having to use the Terminal shell. CLI. The app is loaded from a disk image (DMG) file.
The mapping to NVIS commands is reflected in this table:
Button | CLI | Privilege |
---|---|---|
There are two versions of NVIS for Mac. NVIS App is the latest for M1/M2/M3 (arm64), and x86_64 (Universal). Which you could run with Rosetta.
Either can be downloaded from https://nvis-inc.com/downloadas DMG files.
Other than that, the attached instructions are the same for both.
The Quick Start is:
Download the arm64 or x86_64 DMG
Click on DMG and it will mount the Installer. Launch it.
The installer lets you drag and drop NVIS to the Applications folder.
Launch NVIS You will see:
Press Install/Update. It will prompt you for the Admin password.
IMPORTANT: From here, you will have to go to System Settings, Privacy & Security to unblock the device driver.
You will then have to REBOOT to change the policy to load third party drivers. This is described here : https://tunnelblick.net/cKextsInstallation.html .
After rebooting, launch NVIS again. Press “Set Address” for your license. Here’s a demo license:
0x3b8a8ba0de39184c85c2a3d176acbac6eabb0e20
Press OK. It will promote you for the Admin password to save it.
9. Now it gets easy. You can press: Settings to see your NVIS IP.
10. If all is well, you can press ON.
11. To test, you can click on this URL http://10.0.1.65/You should still see Paris
App Installation
Download DMG file: “NVIS App Install <arm64, x86_64>.dmg”
From the desktop double click the DMG. You will see:
Double click and you will see:
Drag the NVIS icon to the Applications folder.
You should now see the NVIS icon in your Applications and in the Launchpad
Click the app and you will see:
The NVIS App buttons organized in the order of use:
• Install/Update – installs or updates the NVIS CLI and drivers.
• About – to verify the version of the installed software.
• Reload drivers after a power oT or cold-boot.
• Set Address – This is the “who am I “ query to the SDP using the assigned User Address for your node. It also let’s you change your identity.
• Settings – show the Group, NVIS IP for the User Address.
• NVIS IP – just show the secure IP address of your machine.
• ON – connects to your network segment / group
• OFF – disconnect from your group
The normal operation is just ON/OFF.
This button installs or updates the underlying NVIS commands and drivers.
NOTE: First time installation requires you to go to System Settings to enable the app, and Privacy and Security to enable third party driver load, then REBOOT to load the drivers.
This returns the version and platform info:
You first must do a “who am I” query to get your assigned group, network and security information for your unique address.
This button shows the current IP
This command gets configuration. First time shows the NVIS IP on the main window. Clicking it again shows all details.
The details consist of:
• Group name
• NVIS IP
• User (Universal Unique Address)
The ON button connects to the NVIS network. This requires Administrator (sudo) privileges, so a dialog will pop-up:
You may verify this in a Terminal window by pinging your own NVIS IP:
The OFF button will disconnect from the NVIS network. It also requires Administrator (sudo) privileges. After running it, if you have a Terminal window running ping, you will see that it times out until you press ON.
This button reloads the network device drivers. This may be needed after a power-oT or reboot.
NVIS includes a command line installer, nvis_macos_inst .
The CLI option to install is::
nvis_macos_inst install
The CLI option to remove the installation is:
nvis_macos_inst uninstall
After a power oT / shutdown or cold—boot, the drivers may need to be reloaded. Thii can be done by the command::
nvis_macos_inst refresh
After “Install” from the App or CLI, the following command line interface (CLI) utilities are provided:
nvis
Options:
nvis on Connect to the network.
nvis off Disconnect from the network
nvis -s Gets the current connection status
nvis -h Program Help
nvis -v NVIS Version
nvis -ga addr Add a new group identity
nvis -gl List groups
You may set or change your identity via the command “nvis -ga”, for example:
nvis -ga 0xfb3b587728da03c540b3c124b193369c1271c421
You may see your current NVIS IP using the show command:
nvis –s
The current group settings (gGoup, NVIS IP and Address) can be seeing via this command:
nvis -gl
Connect to the NVIS network. For your group/segment is easy:
nvis on
Disconnect from your group/segment:
nvis off
Install/ Update
(nvis_macos_inst install equiv)
✓
About
nvis -v
Reload
nvis_macos_inst refresh
✓
Set Address
nvis -ga <addr>
✓
Settings
nvis -gl
NVIS IP
nvis -s
ON
nvis on
✓
OFF
nvis off
✓