本章介绍FISCO BCOS所需的必要装置和配置。本章通过在单机上部署一条4节点的FISCO BCOS联盟链，帮忙用户把握FISCO BCOS部署流程。

1. 搭建单群组FISCO BCOS联盟链

本节以搭建单群组FISCO BCOS链为例操作。应用开发部署工具 build_chain.sh脚本在本地搭建一条4 节点的FISCO BCOS链，以Ubuntu 16.04 64bit零碎为例操作。

*注解

  • 若需在已有区块链上进行降级，请转至版本及兼容章节。
  • 搭建多群组的链操作相似。
  • 本节应用预编译的动态fisco-bcos二进制文件，在CentOS 7和Ubuntu 16.04 64bit上通过测试。
  • 应用docker模式搭建 ，供有丰盛docker教训和容器化部署需要的用户参考。

第一步. 装置依赖

开发部署工具 build_chain.sh脚本依赖于openssl, curl，依据您应用的操作系统，应用以下命令装置依赖。

装置macOS依赖

最新homebrew默认下载的为openssl@3，须要指定版本openssl@1.1下载brew install openssl@1.1 curlopenssl versionOpenSSL 1.1.1n  15 Mar 2022

装置ubuntu依赖

sudo apt install -y openssl curl

装置centos依赖

sudo yum install -y openssl openssl-devel

第二步. 创立操作目录, 下载安装脚本

## 创立操作目录cd ~ && mkdir -p fisco && cd fisco## 下载脚本curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.9.1/build_chain.sh && chmod u+x build_chain.sh

*注解

  • 如果因为网络问题导致长时间无奈下载build_chain.sh脚本，请尝试： 
    curl -#LO osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/… && chmod u+x build_chain.sh

第三步. 搭建单群组4节点联盟链

在fisco目录下执行上面的指令，生成一条单群组4节点的FISCO链。请确保机器的3030030303，2020020203，8545~8548端口没有被占用。

*注解

  • 国密版本请执行：bash build_chain.sh -l 127.0.0.1:4 -p 30300,20200,8545 -g -G
  • 其中-g示意生成国密配置，-G示意应用国密SSL连贯
bash build_chain.sh -l 127.0.0.1:4 -p 30300,20200,8545

*注解

  • 其中-p选项指定起始端口，别离是：p2p_port,channel_port,jsonrpc_port
  • 出于安全性和易用性思考，v2.3.0版本最新配置将listen_ip拆分成jsonrpc_listen_ip和channel_listen_ip，但仍保留对listen_ip的解析性能
  • 为便于开发和体验，channel_listen_ip参考配置是 0.0.0.0 ，出于平安思考，请依据理论业务网络状况，批改为平安的监听地址，如：内网IP或特定的外网IP

命令执行胜利会输入All completed。如果执行出错，请查看nodes/build.log文件中的错误信息。

Checking fisco-bcos binary...Binary check passed.==============================================================Generating CA key...==============================================================Generating keys ...Processing IP:127.0.0.1 Total:4 Agency:agency Groups:1==============================================================Generating configurations...Processing IP:127.0.0.1 Total:4 Agency:agency Groups:1==============================================================[INFO] Execute the download_console.sh script in directory named by IP to get FISCO-BCOS console.e.g.  bash /home/ubuntu/fisco/nodes/127.0.0.1/download_console.sh==============================================================[INFO] FISCO-BCOS Path   : bin/fisco-bcos[INFO] Start Port        : 30300 20200 8545[INFO] Server IP         : 127.0.0.1:4[INFO] Output Dir        : /home/ubuntu/fisco/nodes[INFO] CA Key Path       : /home/ubuntu/fisco/nodes/cert/ca.key==============================================================[INFO] All completed. Files in /home/ubuntu/fisco/nodes

第四步. 启动FISCO BCOS链

  • 启动所有节点

bash nodes/127.0.0.1/start_all.sh

启动胜利会输入相似上面内容的响应。否则请应用netstat -an | grep tcp查看机器的30300 ~ 30303，20200 ~ 20203，8545 ~ 8548端口是否被占用。

try to start node0try to start node1try to start node2try to start node3 node1 start successfully node2 start successfully node0 start successfully node3 start successfully

第五步. 查看过程

  • 查看过程是否启动

ps -ef | grep -v grep | grep fisco-bcos

失常状况会有相似上面的输入；如果过程数不为4，则过程没有启动（个别是端口被占用导致的）

fisco       5453     1  1 17:11 pts/0    00:00:02 /home/ubuntu/fisco/nodes/127.0.0.1/node0/../fisco-bcos -c config.inifisco       5459     1  1 17:11 pts/0    00:00:02 /home/ubuntu/fisco/nodes/127.0.0.1/node1/../fisco-bcos -c config.inifisco       5464     1  1 17:11 pts/0    00:00:02 /home/ubuntu/fisco/nodes/127.0.0.1/node2/../fisco-bcos -c config.inifisco       5476     1  1 17:11 pts/0    00:00:02 /home/ubuntu/fisco/nodes/127.0.0.1/node3/../fisco-bcos -c config.ini

第六步. 查看日志输入

如下，查看节点node0链接的节点数

tail -f nodes/127.0.0.1/node0/log/log*  | grep connected

失常状况会不停地输入连贯信息，从输入能够看出node0与另外3个节点有连贯。

info|2019-01-21 17:30:58.316769| [P2P][Service] heartBeat,connected count=3info|2019-01-21 17:31:08.316922| [P2P][Service] heartBeat,connected count=3info|2019-01-21 17:31:18.317105| [P2P][Service] heartBeat,connected count=3

执行上面指令，查看是否在共识

tail -f nodes/127.0.0.1/node0/log/log*  | grep +++

失常状况会不停输入++++Generating seal，示意共识失常。

info|2020-12-22 17:24:43.729402|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generating seal on,blkNum=1,tx=0,nodeIdx=1,hash=2e133146...info|2020-12-22 17:24:47.740603|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generating seal on,blkNum=1,tx=0,nodeIdx=1,hash=eb199760...

2. 配置及应用控制台

在控制台链接FISCO BCOS节点，实现查问区块链状态、部署调用合约等性能，可能疾速获取到所须要的信息。2.6版本控制台指令具体介绍参考这里，1.x版本控制台指令具体介绍参考这里。

第一步. 筹备依赖

  • 装置java （举荐应用java 14）.
# ubuntu零碎装置javasudo apt install -y default-jdk#centos零碎装置javasudo yum install -y java java-devel
  • 获取控制台并回到fisco目录
cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v2.9.1/download_console.sh && bash download_console.sh

*注解

  • 如果因为网络问题导致长时间无奈下载，请尝试：cd ~/fisco && curl -#LO gitee.com/FISCO-BCOS/… && bash download_console.sh
  • 拷贝控制台配置文件

若节点未采纳默认端口，请将文件中的20200替换成节点对应的channel端口。

# 最新版本控制台应用如下命令拷贝配置文件cp -n console/conf/config-example.toml console/conf/config.toml
  • 配置控制台证书

*注解
应用1.x版本控制台时：

  • 搭建国密版时，如果应用国密SSL请执行：
    cp nodes/127.0.0.1/sdk/gm/* console/conf/
  • 搭建国密版时，请批改applicationContext.xml中encryptType批改为1
cp -r nodes/127.0.0.1/sdk/* console/conf/

第二步. 启动并应用控制台

  • 启动

cd ~/fisco/console && bash start.sh

输入下述信息表明启动胜利 否则请查看conf/config.toml中节点端口配置是否正确

=============================================================================================Welcome to FISCO BCOS console(2.6.0)！Type 'help' or 'h' for help. Type 'quit' or 'q' to quit console. ________  ______   ______    ______    ______         _______    ______    ______    ______|        |      \ /      \  /      \  /      \       |       \  /      \  /      \  /      | $$$$$$$$ $$$$$$|  $$$$$$|  $$$$$$|  $$$$$$\      | $$$$$$$|  $$$$$$|  $$$$$$|  $$$$$$| $$__      | $$  | $$___$$| $$   $$| $$  | $$      | $$__/ $$| $$   $$| $$  | $$| $$___$$| $$  \     | $$   $$    \ | $$      | $$  | $$      | $$    $$| $$      | $$  | $$ $$    | $$$$$     | $$   _$$$$$$| $$   __ | $$  | $$      | $$$$$$$| $$   __ | $$  | $$ _$$$$$$| $$       _| $$_ |  __| $$| $$__/  | $$__/ $$      | $$__/ $$| $$__/  | $$__/ $$|  __| $$| $$      |   $$ \ $$    $$ $$    $$ $$    $$      | $$    $$ $$    $$ $$    $$ $$    $$ $$       $$$$$$  $$$$$$   $$$$$$   $$$$$$        $$$$$$$   $$$$$$   $$$$$$   $$$$$$=============================================================================================

若1.x控制台启动失败，参考 Web3SDK启动失败场景

  • 用控制台获取信息
# 获取客户端版本[group:1]> getNodeVersionClientVersion{    version='2.6.0',    supportedVersion='2.6.0',    chainId='1',    buildTime='20200819 15:47:59',    buildType='Darwin/appleclang/RelWithDebInfo',    gitBranch='HEAD',    gitCommitHash='e4a5ef2ef64d1943fccc4ebc61467a91779fb1c0'}# 获取节点信息[group:1]> getPeers[    PeerInfo{        nodeID='c1bd77e188cd0783256ee06838020f24a697f9af785438403d3620967a4a3612e3abc4bbe986d1e9dddf62d4236bff0b7d19a935a3cd44889f681409d5bf8692',        ipAndPort='127.0.0.1:30302',        agency='agency',        topic=[        ],        node='node2'    },    PeerInfo{        nodeID='7f27f5d67f104eacf689790f09313e4343e7887a1a7b79c31cd151be33c7c8dd57c895a66086c3c8e0b54d2fa493407e0d9646b2bd9fc29a94fd3663a5332e6a',        ipAndPort='127.0.0.1:57266',        agency='agency',        topic=[            _block_notify_1        ],        node='node1'    },    PeerInfo{        nodeID='862f26d9681ed4c12681bf81a50d0b8c66dd5b6ee7b0b42a4af12bb37b1ad2442f7dcfe8dac4e737ce9fa46aa94d904e8c474659eabf575d6715995553245be5',        ipAndPort='127.0.0.1:30303',        agency='agency',        topic=[        ],        node='node3'    }][group:1]>

3. 部署及调用HelloWorld合约

第一步. 编写HelloWorld合约
HelloWorld合约提供两个接口，别离是get()和set()，用于获取/设置合约变量name。合约内容如下:

pragma solidity ^0.4.24;contract HelloWorld {    string name;    function HelloWorld() {        name = "Hello, World!";    }    function get()constant returns(string) {        return name;    }    function set(string n) {        name = n;    }}

第二步. 部署HelloWorld合约

为了不便用户疾速体验，HelloWorld合约曾经内置于控制台中，位于控制台目录下contracts/solidity/HelloWorld.sol，参考上面命令部署即可。

# 在控制台输出以下指令 部署胜利则返回合约地址[group:1]> deploy HelloWorldtransaction hash: 0xd0305411e36d2ca9c1a4df93e761c820f0a464367b8feb9e3fa40b0f68eb23facontract address:0xb3c223fc0bf6646959f254ac4e4a7e355b50a344

第三步. 调用HelloWorld合约

# 查看以后块高[group:1]> getBlockNumber1# 调用get接口获取name变量 此处的合约地址是deploy指令返回的地址[group:1]> call HelloWorld 0xb3c223fc0bf6646959f254ac4e4a7e355b50a344 get---------------------------------------------------------------------------------------------Return code: 0description: transaction executed successfullyReturn message: Success---------------------------------------------------------------------------------------------Return values:[    "Hello,World!"]---------------------------------------------------------------------------------------------# 查看以后块高，块高不变，因为get接口不更改账本状态[group:1]> getBlockNumber1# 调用set设置name[group:1]> call HelloWorld 0xb3c223fc0bf6646959f254ac4e4a7e355b50a344 set "Hello, FISCO BCOS"transaction hash: 0x7e742c44091e0d6e4e1df666d957d123116622ab90b718699ce50f54ed791f6e---------------------------------------------------------------------------------------------transaction status: 0x0description: transaction executed successfully---------------------------------------------------------------------------------------------OutputReceipt message: SuccessReturn message: Success---------------------------------------------------------------------------------------------Event logsEvent: {}# 再次查看以后块高，块高减少示意已出块，账本状态已更改[group:1]> getBlockNumber2# 调用get接口获取name变量，查看设置是否失效[group:1]> call HelloWorld 0xb3c223fc0bf6646959f254ac4e4a7e355b50a344 get---------------------------------------------------------------------------------------------Return code: 0description: transaction executed successfullyReturn message: Success---------------------------------------------------------------------------------------------Return values:[    "Hello,FISCO BCOS"]---------------------------------------------------------------------------------------------# 退出控制台[group:1]> quit

文章起源：FISCO BCOS
文章原题目：《搭建第一个区块链网络》
如有侵权请与咱们分割删除。