# 安装 TOPIO

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

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

# 1. 配置服务器

配置一台用于运行 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:19081、19082、19085

  • UDP:9000

# 安装"wget"下载工具

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

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

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

# 2. 下载并安装 TOPIO

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

root 用户可直接执行以下命令,而非 root 用户需要管理员权限才可执行,您可 点击此处 查看如何对 非 root 用户添加管理员权限。

wget  https://github.com/telosprotocol/TOP-chain/releases/download/v1.6.0/topio-1.6.0-release.tar.gz -O topio-1.6.0-release.tar.gz && tar zxvf topio-1.6.0-release.tar.gz && cd topio-1.6.0-release && sudo bash install.sh && source /etc/profile && bash set_topio.sh && source ~/.bashrc && ulimit -n 65535

# 验证安装结果

验证安装是否成功。

# 安装成功

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

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.6.0
git commit info: d42df60b
git submodule: xtopcom/xbase:9bd0bf8|xtopcom/xdepends/googletest:ec44c6c1
build date: Aug 22 2022 13:00:48
build options: release
MD5:f5e831f0038a036f5646c5f25c07e482

注意

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

# 安装失败

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

-bash: topio: 未找到命令

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

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

# 下载数据库(推荐)

对于新服务器,推荐您在安装 TOPIO 后下载数据库,这样可以减少数据同步时间,尽早开始产生收益。

对于高级矿工,则必须下载数据库。

在 SSH 终端中运行以下命令:

topio db download https://nyc3.digitaloceanspaces.com/top-mainnet-space/db_20220906_adv_5391f0d4430ed1e7c5b2505cfb5e2e0a.tar.gz

在返回信息中,如果下载进度为 100%,且包含以下内容,则证明数据库下载成功:

download database ok.

md5sum check ok.

# 3. 配置环境变量(可选)

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

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

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

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

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