Iagon Compute Node CLI is a CLI application which allows users to share their computational power on the Iagon network to earn rewards.
This document provides step-by-step instructions to help you install and set up Iagon Compute Node CLI on your system. Currently only Linux based OS are supported.
You can download the Official Compute Node CLI binary from the Iagon's Github Release page. Once downloaded, navigate to the CLI binary and mark it as executable:
chmod +rwx ./iag-cli-linux
Iagon Compute Node depends on 3rd party trusted packages to perform various benchmarks. These benchmarks help track the current performance and availability of the node in the Iagon Network for use. These packages don't come bundled with the Iagon Compute Node CLI binary and have to be installed by the user.
Before installing the Compute Node CLI, ensure the following prerequisites are met:
Enable port forwarding for both ssh server and the compute node binary on a static ip. These ports are to be provided during registration process and should be accessible from the internet.
OpenSSH Server is required for remote access of Compute Nodes. If not already installed, you can install it via apt:
sudo apt install openssh-server
After the installation, ensure that openssh server is running. The user is prompted to provide the ssh port and user credential duing the registration process from the CLI. For testing it is recommended to create a separate ssh user with minimum/restricted permissions.
FIO is a powerful tool for testing I/O performance. Follow the installation instructions from FIO's Github repository, or install it via apt:
sudo apt install fio
Sysbench is a versatile benchmarking tool for evaluating system CPU and memory performances. Installation instructions can be found on sysbench's Github repository, or you can install it via apt:
sudo apt install sysbench
Once the binary and the necessary dependencies are installed, you can use the Compute Node CLI. There are various commands available in the CLI to make the on-boarding/registration process easier. The user can start the node and execute various test commands to check the hardware status of the node.
Execute the following commands, as: ./iag-compute-cli some-command
-
start
Evaluate/Register the host machine as compute node or start compute node if already evaluated.
-
stop
Stop compute node (if already running)
-
status
Check running status of compute node
-
check
Check if the system adhere to prerequisite criteria
-
info
Extract basic information about the system
-
test-node
Test if the node is accessible from the internet
-
clear-config
Clear the configurations
-
benchmark-memory
Run memory tests and benchmark for the host machine
-
benchmark-cpu
Run cpu tests and benchmark for the host machine
-
benchmark-storage
Run storage i/o tests and benchmark for the host machine
-
benchmark-network
Run network tests and benchmark for the host machine
-
help
Display help for command