通过命令行体验长安链
- 1 、概述
- 2、环境依赖
- 2.1、硬件依赖
- 2.2、软件依赖
- 2.3、git安装
- 2.4、golang安装
- 2.5、gcc
- 3、环境搭建
- 3.1、源码下载
- 3.2、 源码编译
- 3.3、编译及安装包制作
- 3.4、启动节点集群
- 3.5、查看节点启动使用正常
官方文档
https://docs.chainmaker.org.cn/v2.3.1/html/quickstart/%E9%80%9A%E8%BF%87%E5%91%BD%E4%BB%A4%E8%A1%8C%E4%BD%93%E9%AA%8C%E9%93%BE.html#
本文是按照官方文档操作，做一个演示记录
1 、概述
通过本文你可以通过命令行和cmc工具搭建长安链多节点集群和部署智能合约，完成长安链的初步体验。
通过源码搭建长安链并且上链查数据需要以下步骤，本文将一一演示
-
下载长安链及证书管理工具源码
-
编译源码
-
生成节点证书
-
编译及安装包制作
-
启动节点集群
-
查看节点状态
-
使用CMC工具安装、调用、查询一个合约
2、环境依赖
2.1、硬件依赖
这个大家参考就行了，如果配置不够，也就是卡点，问题不大，加油~
| 配置 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU | 1.5GHz | 2.4GHz |
| 内存 | 8GB | 16GB |
| 核心 | 4核 | 8核 |
| 带宽 | 2Mb | 10Mb |
2.2、软件依赖
当前文档在centos7操作下完成，以下为本次演示所需的依赖 软件列表如下：
| 名称 | 版本 | 描述 | 是否必须 |
|---|---|---|---|
| git | / | 源码管理 | 是 |
| golang | 1.16-1.19 | 编译环境（需修改国内代理） | 是 |
| gcc | 7.3+ | 编译环境依赖 | 是 |
| glibc | 2.18 | 智能合约执行环境依赖 | 是 |
| tmux | / | 默认快速启动命令依赖 | 否 |
| wasmer运行时库 libwasmer_runtime_c_api.so | / | https://git.chainmaker.org.cn/chainmaker/vm-wasmer/-/tree/master/wasmer-go/packaged/lib 目录下，找到对应链分支的库，将该库路径添加至系统PATH环境变量下启动脚本默认包含，单独启动需加上如下配置： cd deployPath/lib cp xxx/main/libwasmer_runtime_c_api.so libwasmer.so export LD_LIBRARY_PATH=deployPath/lib:$LD_LIBRARY_PATH | 是 |
2.3、git安装
# 使用yum命令安装
yum install -y git
# 验证查看版本号
git --version
2.4、golang安装
推荐：版本为1.16-1.19
教程请移步： Linux 下安装 Golang
2.5、gcc
-
检查 gcc 版本
gcc --version
-
显示结果若 < 7.3，则执行下面步骤升级
sudo yum install centos-release-scl sudo yum install devtoolset-7-gcc* scl enable devtoolset-7 bash注意：第三条指令scl enable devtoolset-7 bash 只是在当前会话中升级了gcc，如果想每次登录gcc自动升级，可以把scl enable devtoolset-7 bash 放在 ~/.bash_profile 文件中。
vim ~/.bash_profile
-
如果没安装，执行命令安装即可
yum install -y gcc
3、环境搭建
下面将介绍使用脚本搭建搭建环境。
适用于Linux、MacOS
3.1、源码下载
从长安链官网下载源码：https://git.chainmaker.org.cn/chainmaker/chainmaker-go
当前为私有仓库，需要先进行账号注册
我这里源码统一放在： /data目录下
下载chainmaker-go源码到本地
$ git clone -b v2.3.1 --depth=1 https://git.chainmaker.org.cn/chainmaker/chainmaker-go.git
下载证书生成工具源码到本地
$ git clone -b v2.3.0 --depth=1 https://git.chainmaker.org.cn/chainmaker/chainmaker-cryptogen.git
3.2、 源码编译
-
编译证书生成工具
$ cd chainmaker-cryptogen $ make结果会生成 bin 和 release 目录
-
配置文件生成
将编译好的chainmaker-cryptogen，软连接到chainmaker-go/tools目录# 进入工具目录 $ cd chainmaker-go/tools # 软连接chainmaker-cryptogen到tools目录下 $ ln -s ../../chainmaker-cryptogen/ .
2.1版本之后，ChainMaker支持多种身份模式，由于不同身份模式下，配置文件的目录结构和内容差异较大，在此我们选择身份模式PermissionedWithCert（详情见身份权限管理）作为示例。 -
PermissionedWithCert
原始的身份模式，即证书模式
进入chainmaker-go/scripts目录，执行prepare.sh脚本生成单链4节点集群配置，存于路径chainmaker-go/build中prepare.sh脚本支持生成solo模式节点证书和配置，以及4/7/10/13/16节点的证书和配置
# 进入脚本目录 $ cd ../scripts # 查看脚本帮助 $ ./prepare.sh -h Usage: prepare.sh node_cnt(1/4/7/10/13/16) chain_cnt(1-4) p2p_port(default:11301) rpc_port(default:12301) eg1: prepare.sh 4 1 eg2: prepare.sh 4 1 11301 12301 # 生成单链4节点集群的证书和配置 $ ./prepare.sh 4 1 begin check params... begin generate certs, cnt: 4 input consensus type (0-SOLO,1-TBFT(default),3-HOTSTUFF,4-RAFT,5-DPOS): input log level (DEBUG|INFO(default)|WARN|ERROR): enable docker vm (YES|NO(default)) begin generate node1 config... begin generate node2 config... begin generate node3 config... begin generate node4 config... # 查看生成好的节点证书和配置 $ tree -L 3 ../build/ ../build/ ├── config │ ├── node1 │ │ ├── certs │ │ ├── chainconfig │ │ ├── chainmaker.yml │ │ └── log.yml │ ├── node2 │ │ ├── certs │ │ ├── chainconfig │ │ ├── chainmaker.yml │ │ └── log.yml │ ├── node3 │ │ ├── certs │ │ ├── chainconfig │ │ ├── chainmaker.yml │ │ └── log.yml │ └── node4 │ ├── certs │ ├── chainconfig │ ├── chainmaker.yml │ └── log.yml ├── crypto-config │ ├── wx-org1.chainmaker.org │ │ ├── ca │ │ ├── node │ │ └── user │ ├── wx-org2.chainmaker.org │ │ ├── ca │ │ ├── node │ │ └── user │ ├── wx-org3.chainmaker.org │ │ ├── ca │ │ ├── node │ │ └── user │ └── wx-org4.chainmaker.org │ ├── ca │ ├── node │ └── user └── crypto_config.yml关于自动生成的端口说明
通过prepare.sh脚本生成的配置，默认是在单台服务器上部署，故自动生成的端口号，是从一个起始端口号开始依次递增，可以通过命令行参数修改起始端口号。
主要有2个端口，p2p端口（用于节点互联）和rpc端口（用于客户端与节点通信），p2p起始端口为11301，rpc起始端口为12301。
如果生成4个节点的配置，p2p端口分别为：11301、11302、11303、11304，rpc端口分别为：12301、12302、12303、12304
如果是在多机部署，希望生成固定的端口号，请参考：【多机部署】
3.3、编译及安装包制作
生成证书（prepare.sh脚本）后执行build_release.sh脚本，将编译chainmaker-go模块，并打包生成安装，存于路径chainmaker-go/build/release中
$ ./build_release.sh
$ tree ../build/release/
../build/release/
├── chainmaker-v2.0.0-wx-org1.chainmaker.org-20210406194833-x86_64.tar.gz
├── chainmaker-v2.0.0-wx-org2.chainmaker.org-20210406194833-x86_64.tar.gz
├── chainmaker-v2.0.0-wx-org3.chainmaker.org-20210406194833-x86_64.tar.gz
├── chainmaker-v2.0.0-wx-org4.chainmaker.org-20210406194833-x86_64.tar.gz
└── crypto-config-20210406194833.tar.gz
3.4、启动节点集群
-
执行cluster_quick_start.sh脚本，会解压各个安装包，调用bin目录中的start.sh脚本，启动chainmaker节点
$ ./cluster_quick_start.sh normal
-
启动成功后，将*.tar.gz备份，以免下次启动再次解压缩时文件被覆盖
$ mkdir -p ../build/bak $ mv ../build/release/*.tar.gz ../build/bak若需要关闭集群，使用脚本：
$ ./cluster_quick_stop.sh
3.5、查看节点启动使用正常
-
查看进程是否存在
$ ps -ef|grep chainmaker | grep -v grep
-
查看端口是否监听
$ netstat -lptn | grep 1230
-
检查节点是否有ERROR日志
$ cat ../build/release/*/bin/panic.log $ cat ../build/release/*/log/system.log $ cat ../build/release/*/log/system.log |grep "ERROR\|put block\|all necessary" //若看到all necessary peers connected则表示节点已经准备就绪。
