运维文档、操作手册

运维文档：有客户需要使用我们的xuperchain，包括启动/关掉服务，注意事项，这些内容形成一个文档被称为运维文档以及操作手册。

1 启动服务：

1.1 启动单节点服务：

  1. 通常建议nohup方式启动，即nohup ./xchain &

1.2 启动多节点服务：

  1. 获取网络中一个节点的netURL，将netURL放到conf/xchain.yaml的bootNodes标签的下一行，然后参照单节点服务启动方式。

1.3 关闭单个节点服务

直接获取对应节点的进程ID，然后kill即可。

  1. netstat -anp | grep xchain --> 获取xchain对应的进程ID，假设为$pid
  2. kill $pid

2 注意事项：

2.1 日志监控：

定期对节点的日志进行清理，避免因为日志文件过大，从而打满磁盘，使得服务不可用。依据日志对业务的重要程度，客户可以选择对原始日志定期备份到其他磁盘。服务日志文件与conf是同级目录，日志目录名为logs，日志文件按照小时进行截断。

查看当前日志大小：

  1. du -h logs

清理某一个小时的日志(假设清理2019年7月23日15:00-16:00的日志)：

  1. rm -f logs/xchain.log.wf.201907231500  
  2. rm -f logs/xchain.log.201907231500

清理某天的日志(假设清理2019年7月23日的日志)：

  1. rm -f logs/xchain.log.wf.20190723*
  2. rm -f logs/xchain.log.20190723*

清理某个月的日志(假设清理2019年7月的日志)：

  1. rm -f logs/xchain.log.wf.201907*
  2. rm -f logs/xchain.log.201907*

清理某一年的日志(假设清理2019年的日志)：

  1. rm -f logs/xchain.log.wf.2019*  
  2. rm -f logs/xchain.log.2019*

清理全部日志：

  1. rm -f logs/*

2.2 多节点高度监控：

一个健康的区块链网络，网络中的节点账本高度应该基本一致，如果出现账本高度明显落后的节点，说明该节点是异常的，需要及时检测出这种异常节点

获取某个节点的账本高度，命令如下（$ip就是特定节点对外提供的ip地址，$port就是特定节点对外提供的tcp端口）：

  1. ./xchain-cli status -H $ip:$port | grep "Height" | awk -F': ' '{print $2}' | awk -F',' '{print $1}'