跳转至

测试网节点0.6.0 接入教程

注意
节点接入前需要先同步当前服务器时间到最新时间 

ntpdate -u ntp.api.bz
如服务器上无ntpdate命令，可使用sudo yum install -y ntpdate(CentOS)或sudo apt-get install ntpdate -y(Ubuntu)进行安装。

节点机器配置及系统设置参考：验证节点挖矿手册（节点务必阅读此文档，尤其是**系统设置**部分）

本次发布清除了测试网所有历史数据，测试币需要重新申领，节点接入需要按以下流程完整执行。

1. 下载安装包并解压

创建目录并进入 

mkdir -p ~/LambdaIM && cd ~/LambdaIM
下载安装包 
wget https://github.com/LambdaIM/launch/releases/download/v0.6.0/lambda-0.6.0-testnet.tar.gz
如下载缓慢可使用下面的链接： 
wget http://download.lambdastorage.com/lambda/0.6.0/lambda-0.6.0-testnet.tar.gz

解压安装包 

tar zxvf lambda-0.6.0-testnet.tar.gz && cd lambda-0.6.0-testnet

2. 初始化节点

将下面命令中的[your-moniker]替换成您自定义的节点名称，不用加中括号注意：这里的 your-moniker 必须使用英文，用于P2P网络 

./lambda init [your-moniker] --chain-id lambda-chain-test6.0
如果初始化报错，可能是由于有老版本的测试网配置数据导致，可以通过下面的命令清除错误数据再重新执行上面的lambda init 
rm -rf ~/.lambda/config/config.toml ~/.lambda/config/genesis.json ~/.lambda/identity

./lambda unsafe-reset-all

注意

不要删除~/.lambda/config下的priv_validator_key.json和node_key.json文件， 如果丢失会导致节点无法再正常加入共识网络，请节点注意备份

3. 覆盖genesis.json文件

\cp -rf ./genesis.json ~/.lambda/config/genesis.json

4. 配置lambdacli

要确保机器已开启端口26656, 26657 

./lambdacli config node tcp://0.0.0.0:26657

./lambdacli config chain-id lambda-chain-test6.0

./lambdacli config trust-node true

5. 配置种子节点

修改~/.lambda/config/config.toml文件，将文件中的seeds字段的值替换如下 

vim ~/.lambda/config/config.toml

seeds = "3da3b249f4f1afd0efdd6f4676972fdc7af0ea6b@bj2.testnet.lambdastorage.com:26656"

测试网目前可选种子节点列表： 

e02882af5bdafa5aec086c32b8398c268d2337f1@bj1.testnet.lambdastorage.com:26656
3da3b249f4f1afd0efdd6f4676972fdc7af0ea6b@bj2.testnet.lambdastorage.com:26656
559f3aeb13b58e611c95fdc6b34446de81cc470d@bj3.testnet.lambdastorage.com:26656
9162e0c3494d8d32acd6c5bc48d1066f2cb362e6@bj4.testnet.lambdastorage.com:26656

注意

当前支持配置多个种子节点，通过,隔开
切换节点后需要重启节点服务

6. 配置lambda.toml

修改配置文件 

vi ~/.lambda/config/lambda.toml

minimum-gas-prices = ""

[log]
level = "info"
output_file = "stdout"

# 服务需要监听的地址
# 以本机内网IP为 192.168.10.30，端口映射的外网IP为 200.200.200.300 为例
[server]
# 对外提供服务的地址，推荐配置为内网地址做端口映射到外网IP
address = "192.168.10.30:12000"
private_address = "127.0.0.1:12001"
debug_log_traffic = "false"

[kad]
# DHT接入节点地址，存储网络提供，可填写多个
bootstrap_addr = ["bj1.testnet.lambdastorage.com:12000",
                  "bj2.testnet.lambdastorage.com:12000",
                  "bj3.testnet.lambdastorage.com:12000",
                  "bj4.testnet.lambdastorage.com:12000",]
bootstrap_backoff_max = "30s"
bootstrap_backoff_base = "1s"
db_path = "/root/.lambda/kademlia"
external_address = "200.200.200.300:12000"
alpha = 3

[kad.routing_table_config]
bucket_size = 20
replacement_cache_size = 5

[discov]
discovery_interval = "3m0s"

7. 测试磁盘性能

创建benchmark目录 

mkdir ~/benchmark && cd ~/benchmark
下载测试脚本 
wget http://download.lambdastorage.com/lambda/0.4.8/benchmark_io.sh
执行脚本 
sudo chmod +x benchmark_io.sh

sudo ./benchmark_io.sh

脚本执行需要一些时间，执行遇到问题或得到结果后可参考磁盘BenchMark测试来评估 磁盘性能

8. 启动节点

./lambda start --p2p.laddr tcp://0.0.0.0:26656 --rpc.laddr tcp://0.0.0.0:26657 --daemonize --log.file /tmp/lambda.log
说明：
--daemonize以后台方式启动
--log.file /tmp/lambda.log 日志输出/tmp/lambda.log文件里，可修改为其他目录，不添加参数则无日志输出

停止节点

如需停掉节点，执行以下命令 

./lambda stop
返回如下结果即为停止成功： 
stop daemon process from lambda.pid:28638 successfully
如停止失败，可使用以下命令停止进程： 
kill `ps aux | grep lambda |grep -v grep| awk '{print $2}'`

查看节点状态

./lambda status

返回结果如下，即节点正在运行： 

lambda.pid is running, pid is 28800
返回结果如下，即节点未运行： 
daemon have stoped

9. 添加账户

将[your-account-name]替换成您自定义的账户名称，需要设置您的账户密码，不用加中括号 

./lambdacli keys add [your-account-name]

如果是钱包创建的账户导入，则通过钱包创建账户时候的助记词进行操作 

./lambdacli keys add [your-account-name] --recover
输入命令后按照提示输入密码和助记词即可

10. 节点领取测试网测试币

需要领取测试网TBB用以进行节点测试的，可联系Lambda官方客服

11. 创建Validator

创建Validator需要如下信息:
* amount -- 节点自抵押量不得小于666.666666TBB即666666666utbb (1TBB=1000000utbb) * pubkey -- 通过命令./lambda tendermint show-validator 获取 * moniker -- 这里的moniker名称是您的Validator名称，可以使用中文(与第2步的moniker可以不同), 如果您已经创建，FAQ中也有修改该名称的命令介绍 * your-account-name -- 您在第7步中设置的账户名称

获取上述信息后，填充如下命令并执行（过程中会提示输入账号密码），即可创建Validator
注意：所有参数不需要中括号 

./lambdacli tx staking create-validator \
  --amount 666666666utbb \
  --pubkey [your-cons-pubkey] \
  --moniker "[your-moniker]" \
  --from [your-account-name] --broadcast-mode block

执行完上述命令后，会返回类似如下信息，destination-validator 即 Validtor 的操作地址 

Response:
  Height: 617
  TxHash: 9B67980CFAE286B220B912549D4288119BEDAA7B74B831FA999C3AA60089B85C
  Raw Log: [{"msg_index":"0","success":true,"log":""}]
  Logs: [{"msg_index":0,"success":true,"log":""}]
  GasWanted: 200000
  GasUsed: 121675
  Tags: 
    - action = create_validator
    - destination-validator = lambdavaloper1g2wgwnrdhj29v62jh9nj8kxml48dg3sfrujk2s
    - moniker = ohoh-11
    - identity =

Validator 的操作地址也可通过命令获取 

./lambdacli keys show [your-account-name] --bech val

12. 启动rest-server服务

rest-server服务可提供给钱包和storagecli连接 

nohup ./lambdacli rest-server --node tcp://0.0.0.0:26657 --laddr tcp://0.0.0.0:13659 >> /tmp/lambdacli.log 2>&1 &

注意

当前已经成为validator的节点，在以下情况下会被惩罚，共识网络会扣除节点质押的utbb，并且把节点移出validator集合

1.对块进行双签，惩罚为
- 扣除 1% 质押的TBB
- 监禁三天
（注意不要让节点出现双签情况！！！）
双签场景：不同机器使用同一priv_validator_key.json文件启动节点

2.在最近的10000个块中对少于500个块签名(掉线1天左右)，惩罚为
- 扣除 0.01% 质押的TBB
- jail 10分钟

被移出的节点需要做如下操作重新加入共识网络

1.如果不满足validator的最低质押要求666,666,666utbb, 需要发起质押补足扣除的utbb，可进入浏览器——验证节点——节点详情——质押列表——查看当前节点账户地址质押代币数量 即为当前已质押代币数量 命令示例参考

./lambdacli tx staking delegate [validator-address] [amount-of-utbb] --from [your-account-name]

2.发起unjail消息来重新加入共识网络 被jail之后的节点需要等待10分钟的惩罚来发起unjail命令

./lambdacli tx slashing unjail --from [your-account-name]

备份和恢复验证节点配置文件

以防配置文件丢失，请提前做好文件备份：验证节点文件备份

备份和恢复节点签名文件

注意：节点签名文件一定要提前备份，防止误删造成的资产损失
参考：备份和恢复节点签名文件

节点磁盘性能测试

为保证节点磁盘性能能够满足要求，参考： 磁盘BenchMark测试