获取和安装 TSS Node 软件包

TSS Node 软件包根据部署方式,分为两个版本:

  • SGX 安全加强版本,适用于 SGX 服务器部署,软件包名称为 cobo-tss-node-linux-sgx-<VERSION>.tgz

  • 通用版本,适用于通用服务器或者 Apple MacBook 部署,软件包名称为 cobo-tss-node-generic-<VERSION>.tgz

请根据部署方式,确定 TSS Node 软件包版本,联系 Cobo 销售专员获取软件包。

以通用服务器版本为例,软件包如下:

cobo-tss-node-generic-<VERSION>.tgz (软件包)
cobo-tss-node-generic-<VERSION>.tgz.sha256(软件包哈希文件)

请先校验软件包是否正确,计算软件包 SHA256SUM 值:

sha256sum cobo-tss-node-generic-<VERSION>.tgz

备注:若在 Apple MacBook 环境执行:

shasum -a 256 cobo-tss-node-generic-<VERSION>.tgz

请确认与软件包哈希文件中的值一致。

示例:

$ cat cobo-tss-node-generic-<VERSION>.tgz.sha256 
7e2ba53dfc79458ab30b8e8ce8278e2fd93932e10bb6af725b0beb055965d1f2  cobo-tss-node-generic-<VERSION>.tgz
$ sha256sum cobo-tss-node-generic-<VERSION>.tgz
7e2ba53dfc79458ab30b8e8ce8278e2fd93932e10bb6af725b0beb055965d1f2  cobo-tss-node-generic-<VERSION>.tgz

校验正确后,使用下面的命令解压软件包。

tar -xzf cobo-tss-node-generic-<VERSION>.tgz

TSS Node 软件压缩包解压的目录结构:

cobo-tss-node-generic
├── configs
│   └── cobo-tss-node-config.yaml.template (默认配置文件模板)
└── tss-node.sh (启动脚本)

如无特殊说明,本文后续全部命令,都在 TSS Node 解压后的根路径下执行,例如 cobo-tss-node-generic 路径。

关于 TSS Node 命令说明

三种部署环境下的 TSS Node 命令相同,但是三种部署环境下执行 TSS Node 命令有所区别。

  • 通用服务器与 SGX 服务器环境下,部署和运维 TSS Node 需要具有 sudo 权限,执行 TSS Node 命令时,需要加 sudo 权限,例如:

sudo ./tss-node.sh status
  • Apple MacBook 环境下不需要管理员权限,例如:

./tss-node.sh status

如无特殊说明,本文后续全部命令,均以通用服务器环境下操作为例。

安装 TSS Node 镜像

接下来,请执行下面命令,检查系统各项依赖的软件或驱动是否已经准备就绪。同时,如果是首次安装,会自动拉取最新的 TSS Node 容器镜像。

sudo ./tss-node.sh status

示例:

$ sudo ./tss-node.sh status
[sudo] password for ubuntu:   (ubuntu账户密码)
Checking docker engine ... OK, version: 20.10.22
Checking container image ... Image not found: coboglobal/tss-node:v0.3.0

Going to pull container image coboglobal/tss-node:v0.3.0 ...

Login Succeeded
v0.3.0: Pulling from coboglobal/tss-node
4e7e0215f4ad: Pull complete
7fd35d9d7f31: Pull complete
86c277e0f34d: Pull complete
4f4fb700ef54: Pull complete
Digest: sha256:9dd6c67522b6f36df61e2a945d6093683fd4c980e5e15d3bcdd661ca8e062578
Status: Downloaded newer image for coboglobal/tss-node:v0.3.0
docker.io/coboglobal/tss-node:v0.3.0
Checking container image ... OK, id: sha256:8ab0c7353f5b62cdff5bdc6d9a436f0d99079d404b080aa6a61f594fe6446ba8

Checking TSS-node daemon ... not running

Please use './tss-node.sh start' to start the daemon.
Please use './tss-node.sh init' if the tss-node is not initialized yet.

至此,TSS Node 软件包及所有依赖已经准备就绪。

TSS Node 安装包说明与配置

默认配置文件模板:configs/cobo-tss-node-config.yaml.template

TSS Node 默认连接开发环境,无需配置文件也可以正常运行。

如果要连接正式环境,您需要修改配置文件,并且初始化 TSS Node,生成新的 Node ID。

首先,您需在 configs 目录下,手动复制文件 cobo-tss-node-config.yaml.template ,并重命名为 cobo-tss-node-config.yaml ,完成后即可编辑需要修改的配置项。配置文件参数的具体含义,请参考【TSS Node 配置方式说明】。修改配置文件后,必须重启 TSS Node 才能生效。

启动脚本:tss-node.sh

启动脚本的作用是:

  • 检查依赖的软件或驱动是否安装,并拉取 TSS Node 容器镜像

  • 管理 TSS Node 容器的运行状态

除了个别由启动脚本提供的命令外,启动脚本会将大部分命令和参数传递到容器内的 TSS Node 主程序。

Last updated