Host Utility¶

The NodeZero^® host virtual machine comes with a script for setup and maintenance of the host. To invoke it, type n0 into the command prompt and a menu like the one below will be presented.

Run n0 with user nodezero

It is recommended to run n0 script while logged in as user nodezero on the host. If not using nodezero user a warning message will be shown when running n0

$ n0

0) Version
1) Check environment
2) System info
3) Configure Static IP
4) Configure network proxy
5) Update
6) Set Timezone
7) Simple Network Scan
8) Set Hostname
9) Set NTP server
10) Show Runners
q) Exit

Choose an option: _

The following sections provide more information on what these options do.

Version Info¶

Prints the version of n0 being used

Check Environment¶

This runs NodeZero's checkenv.sh script to verify the host has the required configuration and settings as well as access externally to the required sites.

System Info¶

Displays basic system information about the host such as CPUs, Memory and Network settings

Example:

Terminal showing basic system information.

Configure Static IP / Configure DHCP¶

By default the NodeZero host virtual machine comes with DHCP enabled. The option here will toggle between Configure Static IP and Configure DHCP.

This defaults to Configure Static IP to switch from using DHCP to static ips. Once selected follow the prompts to configure a new IP address, Subnet, Gateway and DNS nameserver

If there is a need to switch back to DHCP, it can be selected with same option number which will show Configure DHCP

Configure Network Proxy¶

To have NodeZero use a proxy for your network provide your proxy setting in the prompt. This command updates values for proxy settings in these files:

/etc/environment

/root/.docker/config.json

/etc/systemd/system/docker.service.d/http-proxy.conf

/etc/docker/daemon.json

For Changes To Take Effect

After setting the proxy, the user must logout and back in before the changes takes effect.

Update¶

This does three things:

Updates the underlying OS, mostly for getting the latest security patches
Pulls the latest h3-cli while preserving the current configuration
Updates the n0 utility itself.

Ensure Latest Updates

It is suggested to run the update option two times back-to-back to ensure the latest updates are retrieved and implemented

Set Timezone¶

Allows for setting the timezone on the host.

Simple Network Scan¶

This runs a simplified network scan using zmap against a the top used ports. This scan is throttled to 150 packets/sec and bandwidth is restricted to 2 Megabits/sec to prevent disrupting the network. This is not to be used to replace running a Segmentation Test which is much more comprehensive in scanning and detecting systems and services.

A complete list of the hosts found is located in ~/.h3/host_list.txt

Set Hostname¶

Easy way to change the hostname on the host

Set NTP server¶

Sets the NTP server in /etc/systemd/timesyncd.conf

Show Runners¶

Prints the list of runners found on host using ps command

Exit¶

Exits the prompt inface of n0