脚本介绍

为了方便用户使用，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.0，GM_BCOS2.0或Fabric1.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的路径