脚本介绍

为了方便用户使用,WeCross提供了丰富的脚本,脚本位于WeCross跨链路由的根目录下(如:~/demo/routers-payment/127.0.0.1-8250-25500/),本章节将对这些脚步做详细介绍。

启动脚本

start.sh

启动脚本start.sh用于启动WeCross服务,启动过程中的完整信息记录在start.out中。

  1. bash start.sh

成功输出:

  1. Wecross start successfully

失败输出:

  1. WeCross start failed
  2. See logs/error.log for details

停止脚本

stop.sh

停止脚本stop.sh用于停止WeCross服务。

  1. bash stop.sh

构建WeCross脚本

build_wecross.sh

生成WeCross跨链路由网络

  1. Usage:
  2. -n <zone id> [Required] set zone ID
  3. -l <ip:rpc-port:p2p-port> [Optional] "ip:rpc-port:p2p-port" e.g:"127.0.0.1:8250:25500"
  4. -f <ip list file> [Optional] split by line, every line should be "ip:rpc-port:p2p-port". eg "127.0.0.1:8250:25500"
  5. -c <ca dir> [Optional] dir of existing ca
  6. -o <output dir> [Optional] default <your pwd>
  7. -z <generate tar packet> [Optional] default no
  8. -T <enable test mode> [Optional] default no. Enable test resource.
  9. -h call for help
  10. e.g
  11. bash build_wecross.sh -n payment -l 127.0.0.1:8250:25500
  12. bash build_wecross.sh -n payment -f ipfile
  13. bash build_wecross.sh -n payment -f ipfile -c ./ca/
  • -n:指定跨链分区标识
  • -l:可选,指定生成一个跨链路由,与-f二选一,单行,如:192.168.0.1:8250:25500
  • -f:可选,指定生成多个跨链路由,与-l二选一,多行,不可有空行,例如:
  1. 192.168.0.1:8250:25500
  2. 192.168.0.1:8251:25501
  3. 192.168.0.2:8252:25502
  4. 192.168.0.3:8253:25503
  5. 192.168.0.4:8254:25504
  • -c:可选,指定跨链路由基于某个路径下的ca证书生成
  • -o:可选,指定跨链路由生成目录,默认wecross/
  • -z:可选,若设置,则生成跨链路由的压缩包,方便拷贝至其它机器
  • -T:可选,若设置,生成的跨链路由开启测试资源
  • -h:可选,打印Usage

添加账户脚本

add_account.sh

脚本add_account.sh用于在router中创建特定区块链的账户。

可通过-h查看帮助信息

  1. Usage:
  2. -t <type> [Required] type of account, BCOS2.0 or GM_BCOS2.0 or Fabric1.4
  3. -n <name> [Required] name of account
  4. -d <dir> [Optional] generated target_directory, default conf/accounts/
  5. -h [Optional] Help
  • -t:账户类型,按照插件选择,如BCOS2.0GM_BCOS2.0Fabric1.4
  • -n:指定账户名,发交易时使用,用区分不同的账户
  • -d:账户目录,默认生成在conf/accounts

不同的链有不同的操作方法,具体操作请查看(操作后,请重启router,让router重启加载配置):

添加新接入链脚本

add_chain.sh

脚本add_chain.sh用于在router中创建特定区块链的连接配置

  1. Usage:
  2. -t <type> [Required] type of chain, BCOS2.0 or GM_BCOS2.0 or Fabric1.4
  3. -n <name> [Required] name of chain
  4. -d <dir> [Optional] generated target_directory, default conf/stubs/
  5. -h [Optional] Help
  • -t:连接类型,按照插件选择,如BCOS2.0或Fabric1.4
  • -n:连接名,账户名称
  • -d:连接配置目录,默认生成在conf/chains/下

不同的链有不同的操作方法,具体操作请查看(操作后,请重启router,让router重启加载配置):

创建P2P证书脚本

create_cert.sh

创建P2P证书脚本create_cert.sh用于创建P2P证书文件。WeCross Router之间通讯需要证书用于认证,只有具有相同ca.crt根证书的WeCross Router直接才能建立连接。

可通过-h查看帮助信息:

  1. Usage:
  2. -c [Optional] generate ca certificate
  3. -C <number> [Optional] the number of node certificate generated, work with '-n' opt, default: 1
  4. -D <dir> [Optional] the ca certificate directory, work with '-n', default: './'
  5. -d <dir> [Required] generated target_directory
  6. -n [Optional] generate node certificate
  7. -t [Optional] cert.cnf path, default: cert.cnf
  8. -h [Optional] Help
  9. e.g
  10. bash create_cert.sh -c -d ./ca
  11. bash create_cert.sh -n -D ./ca -d ./ca/node
  12. bash create_cert.sh -n -D ./ca -d ./ca/node -C 10
  • c: 生成ca证书,只有生成了ca证书,才能生成节点证书。
  • C:配合-n,指定生成节点证书的数量。
  • D:配合-n,指定ca证书路径。
  • d:指定输出目录。
  • n:生成节点证书。
  • t:指定cert.cnf的路径