# Install TOPIO
Configure a server for TOPIO operation. It is recommended that you rent a cloud server and then remotely access it on your personal computer through an SSH terminal such as Xshell.
Download and install TOPIO.
Verify installation.
Configure environment variables(optional).
# Set Up Cloud Server
Please set up a server for TOPIO to run.
It is recommended that you rent a cloud server that can be accessed remotely from your personal computer via SSH terminals such as Xshell.
# Operating System
Operating System | Description |
---|---|
Linux | CentOS 7, 64-bit, Kernel Version 3.10 , and above |
Ubuntu 16, 64-bit, Kernel Version 4.4, and above |
# Server Minimum Configuration
Different types of miners have different requirements for server configuration. Please refer to the following table for the minimum configuration.
Miner Type | Minimum Hardware Configuration |
---|---|
edge | 1CPU/1GB mem 40GB SSD 100Mb/s |
validator | 2CPU/2GB mem 60GB SSD 100Mb/s |
advance | 2CPU/4GB mem 100GB SSD 200Mb/s |
# Inbound Rules
Please make sure that the ports below are open to whole network in inbound traffic, otherwise the miner will not be able to join the TOP Network.
TCP:9000、19081、19082、19085
UDP:9000
# Install "wget" Download Tool
Connect to the server and execute the following command on the SSH terminal page to install the "wget" download tool.
The CentOS and Ubuntu installation commands are as follows, use the corresponding commands according to your server operating system.
CentOS
sudo yum install wget -y
Ubuntu
sudo apt install wget -y
# Download And Install TOPIO
Download and install TOPIO by running:
wget https://github.com/telosprotocol/TOP-chain/releases/download/V0.9.9.0/topio_V0.9.9.0_linux64.tar.gz -O topio_V0.9.9.0_linux64.tar.gz && tar zxvf topio_V0.9.9.0_linux64.tar.gz && cd topio_0.9.9.0 && sudo sh install.sh
# Verify Installation
Verify if the installation was successful.
# Installation Success
Execute topio -v
in any directory to verify whether the installation was successful.
If the following is output, the installation is successful.
topio version: 0.9.9.0
git branch: release/Galileo
git commit: b11c3b6
build date: Nov 13 2020 22:21:42
MD5:90c4542f80837f7a5eeef143c9ba2d9c
WARNING
If the MD5 code is inconsistent with the installation package's MD5 code displayed on the official website, although the installation is successful, there is the possibility that the installation file is tampered with!
# Installation Fail
Execute topio -v
in any directory to verify whether the installation was successful.
If the following is output, the installation is failed.
command not found
If the installation fails, please redo the installation steps.
# Configure Environment Variables(optional)
After TOPIO is installed, configure environment variables with the following command, to set "/opt/topnetwork" to your authority directory.
echo "export TOPIO_HOME=/opt/topnetwork" >> ~/.bashrc && source ~/.bashrc
If you do not configure environment variables, you will use the system default directory as the working directory of TOPIO:
root user: the default directory is "/root/topnetwork";
For non-root users: the default directory is "/home/user/topnetwork", where "user" is your user name to log in to the server.