# 安装 TOPIO

您可按照以下步骤,下载安装 TOPIO:

  1. 配置服务器
  2. 下载并安装 TOPIO
  3. 验证安装结果
  4. 配置环境变量(可选)

# 配置服务器

配置一台用于运行 TOPIO 的服务器。建议您租用云服务器,然后在您个人计算机上通过 SSH 终端远程访问。

# 操作系统要求

操作系统 版本
Linux CentOS 7,64 位,内核 3.10 及以上版本(含 CentOS 8)
Ubuntu 16.04,64 位,内核 4.4 及以上版本

# 服务器最低配置

不同的类型矿工对服务器的配置要求不同,最低配置请参见下表。

矿工类型 最低硬件配置
边缘矿工(edge) 1CPU/1GB mem
40GB SSD
100Mb/s
验证矿工(validator) 2CPU/2GB mem
60GB SSD
100Mb/s
高级矿工(advance) 2CPU/4GB mem
100GB SSD
200Mb/s

# 配置流入端口

对以下端口流入公网放行,否则节点将无法加入 TOP Network 网络:

  • TCP:9000、19081、19082、19085

  • UDP:9000

# 安装"wget"下载工具

连接服务器,在 SSH 终端页面执行以下命令安装"wget"下载工具。

CentOS 和 Ubuntu 安装命令分别如下,根据您的服务器操作系统使用相应的命令。

  • CentOS
sudo yum install wget -y
  • Ubuntu
sudo apt install wget -y

# 下载并安装 TOPIO

执行以下命令下载并安装 TOPIO。

wget https://github.com/telosprotocol/TOP-chain/releases/download/v1.1.4/topio-1.1.4-release.tar.gz -O topio-1.1.4-release.tar.gz && tar zxvf topio-1.1.4-release.tar.gz && cd topio-1.1.4-release && sudo sh install.sh

# 验证安装结果

验证安装是否成功。

# 安装成功

当安装页面打印以下信息时:

install topio done
now run command to check md5:  topio -v
now run command for help info: topio -h

执行 topio -v 验证 TOPIO 是否安装成功,如果输出以下信息,证明安装成功。

topio version: 1.1.4
git commit info: 6f35e7b
build date: Mar 20 2021 06:43:48
MD5:b700bf5c4f0a89ebeb1325ab4d4459e6

注意

如 MD5 码与官网展示的对应安装包 MD5 码不一致,您虽然安装成功,但是安装文件存在被篡改的可能性!

# 安装失败

在任一目录下执行 topio -v 验证安装是否成功,如果输出以下信息,证明安装失败。

-bash: topio: 未找到命令

以上示例基于支持中文的 Linux 操作系统。

如安装失败,请重新执行安装命令。

# 配置环境变量(可选)

TOPIO 安装完成后,您可以执行以下命令配置环境变量,将以下命令中的 /opt/topnetwork 设置成您的权限目录。

echo "export TOPIO_HOME=/opt/topnetwork" >> ~/.bashrc && source ~/.bashrc

如不配置环境变量,您将使用系统默认目录作为 TOPIO 的工作目录:

  • root 用户,默认目录为 /root/topnetwork

  • 非 root 用户,默认目录为 /home/user/topnetwork,其中 user 是您登录服务器的用户名。