Validate Host
Once the installation is complete, validate that your NodeZero host is ready to run operations by running the NodeZero environment validation script.
Downloads
Warning
Always verify the files you download come from Horizon3.
Download checkenv.sh
Download checkenv.sh SHA256 checkenv.sh
Validation script
The validation script ensures your NodeZero host is properly configured and ready for operations by checking key system and network requirements. The script will complete the following:
- Check for minimum requirements (2 CPUs, 8GB RAM, 40GB+ disk).
- Ensure necessary packages and libraries are installed.
- Confirm compatibility and proper configuration.
- Ensure the host can resolve external domains.
- Check for blocking configurations or restricted access.
Run validation script
To execute the validation script on the OVA host, use the following command:
curl https://downloads.horizon3ai.com/utilities/checkenv.sh | bash
The output should look similar to the following:
# curl https://downloads.horizon3ai.com/utilities/checkenv.sh | bash
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 18646 100 18646 0 0 61134 0 --:--:-- --:--:-- --:--:-- 61134
[#] Conducting pre-checks to validate the environment is NodeZero ready:
[#] Checking Proxy settings and configurations:
[+] Found 0 of 6 proxy settings in /etc/environment
[+] Found 0 of 6 proxy settings in env
[+] PASSED: Proxy is NOT configured
[#] Checking Docker functionality by running the hello-world test container:
[+] PASSED: Docker version installed meets the minimum required version 20.10.
[+] PASSED: Docker is installed and functioning properly.
[#] Checking Docker permissions to volume mount files from /home/nodezero directory:
[+] PASSED: Docker permissions are correct for the /home/nodezero directory location.
[#] Checking Operating System:
[+] PASSED: Linux is a supported Operating System.
[#] Gathering environmental variables to conduct further checks:
[+] PASSED: All environmental variables set and proceeding with next checks.
[#] Checking host time against current UTC time:
[+] PASSED: System time is within 5 minutes of UTC time.
[#] Checking HDD space requirements (20GB Recommended, 10GB Required):
[+] PASSED: There is enough space for the NodeZero container: 79GB
[#] Checking 8GB RAM requirement:
[+] PASSED: This system meets the recommended minimum RAM to support NodeZero.
[#] Checking compute resource requirements:
[+] PASSED: This system has 2 CPUs which meets the minimum logical CPU requirements to run NodeZero.
[#] Pre-check validation completed successfully.
After successful validation
After successfully running the validation script, your NodeZero host is ready for operations.
Troubleshooting
NOEXEC flag on partition
Some users report issues running the health check because they are launching from a partition that denies execution. This is why we recommend first changing to your home directory before executing, as in the example above.
Host's system time is out of sync with NodeZero®
If you are seeing this error when running the NodeZero launch script or the checkenv script
The system time is off by more than 5 minutes of UTC time.
- https://tf.nist.gov/tf-cgi/servers.cgi
- https://www.ntppool.org/
If your time syncing service is not something that can be easily repaired, you can still run NodeZero. However, certain cryptographic attacks could be affected. To ensure the successful operation of NodeZero, please deactivate any currently active time synchronization service and synchronize your system time with our servers. The below script will stop timesyncd, ntp and chrony, then sync the system time with NodeZero servers via our /time API.
# stop timesyncd
sudo timedatectl set-ntp false
# stop ntp
sudo service ntp stop
# stop chrony
sudo service chrony stop
# Sets system time
UTC=$(curl -k -s -m 3 https://api.horizon3ai.com/v1/time | cut -c17-26)
sudo date -s "@$UTC"
NodeZero Runners and sudo
Its important to remember that while the Host Check script has the ability to prompt for sudo credentials, if running automated operations with the NodeZero runner you might receive a permissions error:
[#] Checking Docker functionality by running the hello-world test container:
[+] PASSED: Docker version installed meets the minimum required version 20.10.
[!] FAILED: Failed to validate Docker. Verify this account has permissions to run Docker and retry.
If your NodeZero Host requires sudo to run docker commands, then you may need to start the Runner using sudo.
Alternatively, you can try adding the user that invokes h3 start-runner to the docker group, for example (using ubuntu user):
sudo usermod -aG docker ubuntu
sudo systemctl restart docker