Installation

overview this guide is intended to provide detailed instructions on the process of setting up nodes in the new octaspace cube system pre requisites hardware octaspace nodes can range from a raspberry pi to cpu only nodes to multi gpu machines, each of which can be used for different types of services please check the minimum overview docid\ xmpm0euboemnh0j g4ehz based on the service you wish to provide operating system octaspace node software runs on linux distributions and supports both x86 and arm64 architectures you can find the list of supported os under overview docid\ xmpm0euboemnh0j g4ehz before proceeding further, please ensure that you have set up one of the supported operating systems hiveos in cases where nvidia gpus are used, you must ensure that driver version 550 or newest is installed it is crucial that the nvidia driver and the libnvidia gl or libnvidia gl server packages have the same minor version for example, if the driver version is 550 127 05, the libnvidia gl 550 package must also have the same version to check this run the following command apt show libnvidia gl 550 in some cases docker may not start correctly due to ipv6 disable to enable ipv6 edit /etc/default/grub file and remove ipv6 disable=1 in grub cmdline linux default option after run update grub command and restart machine service ports and firewall configuration service ports are primarily used for facilitating the vpn service and providing direct access to services via a web interface that runs on nodes in cases where service ports are not configured, all traffic between the node and the end user is, by default, directed through dedicated proxy servers located in the geographical regions closest to the node location configuration of service ports is an optional process only if not providing a vpn service configuring service ports offers benefits such as improved network speeds between the node and the end user, and provides more direct access to the node, resulting in enhanced service quality if you do not intend to support vpn or prefer that services be routed through a proxy, you may proceed directly to the installation step configuration for service ports to function, a node must have a static public ip address depending on your network configuration, if the node is behind a nat, you will need to configure port forwarding for a range of service ports on the router additionally, if the server has a firewall with a drop policy for all incoming traffic, you will need to allow traffic to the service ports by default, the service port range is 51800–51816 ensure that these ports are forwarded or opened for both tcp and udp protocols installation and configuration all commands must be run under root user gpu drivers if you intend for your node to provide rental or render services, ensure that the latest gpu drivers are installed for nvidia cards, install version 550 or newer, if available storage configuration you can skip storage configuration if you don't require any special settings the installation script will automatically allocate 80% of the free disk space on the root filesystem for docker data if you prefer to configure storage manually, you can disable the automatic setup by setting the skip fs config variable export skip fs config=1 every service node need to have disk storage configured the storage requirements can vary depending on the services that are run on the node, therefore it's important to ensure ample storage is configured storage size depends on services provided by node, please consult overview docid\ xmpm0euboemnh0j g4ehz the disk space will be used for various purposes including, docker images, container data as well as support octastorage service providing ample storage will ensure improved support of services storage partition should be formatted in xfs filesystem and mounted on /var/lib/docker directory depending on the machine configuration, the number of physical disks, and the presence of a raid controller, there are multiple ways to configure storage for a service node below, we outline several common examples prior to proceeding further, ensure you have installed xfsprogs package apt install y xfsprogs file based partition through loop device this method is useful for when a node does not have non allocated disk partitions we will create file on existing filesystem and mount as partition in this example we assume that root filesystem (/) has enough free disk space and will use it to store our file based partition create a 200gb file that will be used for storage if you have more spare disk space, set the amount as much as possible fallocate l 200g /docker data img format it in xfs filesystem mkfs t xfs /docker data img mount and make it mounted on system start echo "/docker data img /var/lib/docker xfs defaults,quota,prjquota,pquota,gquota 0 0" >> /etc/fstab mkdir /var/lib/docker; mount /var/lib/docker install service node software install distribution curl https //install octa space | bash at the end of the installation, you will be given a unique node token use this token to register new node on https //cube octa computer to make node available on marketplace it is necessary to specify reward address in profile settings this address used to receive rewards when node is rented click on avatar, then on profile and select settings tab update service node software stop node service systemctl stop osn update curl https //install octa space | bash uninstall service node software stop and uninstall node service systemctl stop osn systemctl disable osn rm f /etc/systemd/system/osn service remove user and data userdel r octa