可视化部署

    可视化部署，需要先部署依赖服务，包括管理平台（WeBASE-Web）、节点管理子系统（WeBASE-Node-Manager）、签名服务（WeBASE-Sign）。

    然后通过 WeBASE 管理平台（WeBASE-Web）的界面在填入的主机中部署节点（FISCO-BCOS 2.5.0+）和节点前置子系统（WeBASE-Front 1.4.0+）。

    使用可视化部署搭建一个 至少2 节点 的区块链服务，WeBASE(WeBASE-Node-Manager + WeBASE-Sign)至少配置 1G 空闲内存（用于节点管理服务与签名服务）、每个节点+前置的镜像配置至少2G空闲内存（CPU内核数与节点数正相关，如4核可配置4节点），在进行可视化部署时会进行主机的可用内存检测。

    注意：

    • 在企业级部署时，为了安全，推荐将签名服务（WeBASE-Sign）放在内网中，与管理平台、管理子系统分开部署。此处为了方便演示，因此将签名服务（WeBASE-Sign）部署在同一台主机。

    具体配置

    操作系统

    部署节点的主机操作系统需要满足安装 Docker 服务的最低版本要求；

    端口开放

    主机防火墙需要开放以下端口。如果是云服务器，需要配置云服务器安全组策略中的端口开放规则。

    默认使用22作为SSH登录端口，若需要修改，在Ansible hosts配置中可指定SSH端口

    注，需要确保链节点的端口对彼此开放，如P2P端口(默认30300)、节点前置的端口(默认5002)。

    配置系统依赖分成宿主机（Node-Manager所在主机）与节点主机（节点所在主机）两种：

    • 宿主机：安装WeBASE-Node-Manager的主机，配置Ansible、配置Ansible免密登录节点机
    • 节点主机：用于安装节点的主机，配置docker及docker用户组、配置Ansible用户的sudo权限、安装FISCO BOCS节点依赖

    注：宿主机也需要安装节点时，则需要同时配置

    配置Ansible

    Ansible配置包括以下三步：

    • 宿主机安装Ansible
      • 仅在宿主机安装节点时，则仅需安装Ansible，无需完成下面两步host与免密配置
    • 配置Ansible host列表
    • 配置Ansible免密登录到节点主机

    安装Ansible

    注：Ansible只需要安装在宿主机上，节点主机无需安装Ansible，只需配置宿主机到节点主机的免密登录

    CentOS

    Ubuntu

    2. apt-add-repository ppa:ansible/ansible
    3. apt-get update
    4. apt-get install ansible

    安装完成后，可以通过--version检查是否安装成功

    1. $ ansible --version
    2. ansible 2.9.15
    3.   config file = /etc/ansible/ansible.cfg
    4.   configured module search path = [u'/root/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules']
    5.   ansible python module location = /usr/lib/python2.7/dist-packages/ansible
    6.   executable location = /usr/bin/ansible
    7.   python version = 2.7.17 (default, Sep 30 2020, 13:38:04) [GCC 7.5.0]

    仅在宿主机安装节点时，无需操作下文的Ansible host配置和免密配置，直接进入章节，并在部署节点时，添加主机的IP为127.0.0.1

    配置Ansible host_key_checking

    配置Ansible的Host key checking，将自动确认连接到远程主机

    1. vi /etc/ansible/ansible.cfg
    3. # 找到host_key_checking选项
    4. ···
    5. host_key_checking = False

    免密登录配置

    在节点管理台进行可视化部署时，节点管理（WeBASE-Node-Manager）服务会为每个节点生成相应的配置文件，然后通过Ansible的免密登录远程操作，在远程的节点主机中执行系统命令来操作节点。

    下面介绍配置免密登录的各个步骤

    重要

    1. 配置 WeBASE-Node-Manager 主机到其它节点主机的 SSH 免密登录；
    2. 配置Ansible的hosts列表并配置免密登录私钥路径
    3. 注意免密登录的账号sudo权限，否则会造成Docker服务启动、检测端口占用失败；
    4. 如果免密账号为非 root 账号，保证账号有 sudo 免密 权限，即使用 sudo 执行命令时，不需要输入密码；参考本章节的[sudo账号配置]

    免密登录配置方法

    重要

    1. 如果 WeBASE-Node-Manager 所在主机已经生成过秘钥对，建议使用命令 ssh-keygen -t rsa -m PEM 重新生成；

    • 登录 WeBASE-Node-Manager 所在主机：

      1. ssh root@[IP]

    • 检查 ~/.ssh/ 目录是否已经存在 id_rsa 私钥文件和对应的 id_rsa.pub 公钥文件。如果存在，备份现有私钥对

      1. mv ~/.ssh/id_rsa ~/.ssh/id_rsa.bak
      2. mv ~/.ssh/id_rsa.pub ~/.ssh/id_rsa.pub.bak

    • 执行命令 ssh-keygen -t rsa -m PEM，然后直接两次回车即可生成（提示输入密码时，直接回车）

      1. ssh-keygen -t rsa -m PEM

    • 将公钥文件上传到需要免密登录的主机（替换 [IP] 为节点主机的 IP 地址），然后输入远程主机的登录密码

      1. ssh-copy-id -o StrictHostKeyChecking=no -i ~/.ssh/id_rsa.pub root@[IP]

    • 输出结果出现 Number of key(s) added: 1 结果，表示免密登录配置成功

    • 检查从部署 WeBASE-Node-Manager 服务的主机是否能成功免密登录部署节点的主机（替换 [IP] 为主机的 IP 地址）

      1. ssh -o StrictHostKeyChecking=no root@[IP]

    切记妥善保管免密登录的私钥，否则当前主机与ssh免密登录的主机均会被控制

    此处配置宿主机免密登录到节点主机完成后，记住宿主机中id_rsa私钥的路径，下一步进行Ansible中hosts的免密配置

    配置Ansible Hosts与免密登录

    在/etc/ansible/hosts文件中添加IP组webase，并配置节点主机的IP、免密登录账号和私钥路径、SSH端口。

    注：若后续需要添加新的主机，需要将新主机的IP添加到此处

    添加以下内容：此处假设节点机IP为127.0.0.1，免密登录账户为root，且id_rsa免密私钥的路径为/root/.ssh/id_rsa，ssh端口使用22端口，添加名为webase的IP组

    1. vi /etc/ansible/hosts
    3. ···
    4. [webase]
    5. 127.0.0.1 ansible_ssh_private_key_file=/root/.ssh/id_rsa  ansible_ssh_user=root  ansible_ssh_port=22
    6. {your_host_ip} ansible_ssh_private_key_file={ssh_private_key}  ansible_ssh_user={ssh_user}  ansible_ssh_port={ssh_port}

    测试Ansible

    执行Ansible的--list-hosts命令查看是否已添加成功

    1. ansible webase --list-hosts
    2.   hosts (2):
    3.     XXX.XXX.XXX.1
    4.     XXX.XXX.XXX.2

    执行Ansible的ping命令，检测添加到hosts中各个节点主机IP能否被访问，免密配置是否已生效

    • 若出现IP | SUCCESS的则代表该IP可连通
    • 如果出现FAILED代表该IP无法连接，需要根据上文的免密登录配置进行ssh -o StrictHostKeyChecking=no root@[IP]检测

    对ansible中的webase ip组进行ping检测

    1. ansible webase -m ping
    3. xxx.xxx.xxx.1 | SUCCESS => {
    4.     "ansible_facts": {
    5.         "discovered_interpreter_python": "/usr/bin/python"
    6.     }, 
    7.     "changed": false, 
    8.     "ping": "pong"
    9. }
    10. xxx.xxx.xxx.2 | SUCCESS => {
    11.     "ansible_facts": {
    12.         "discovered_interpreter_python": "/usr/bin/python"
    13.     }, 
    14.     "changed": false, 
    15.     "ping": "pong"
    16. }

    配置Docker

    配置Docker需要在每个安装节点的主机上都要执行，否则将导致节点远程安装失败。包括以下几个步骤

    • 安装Docker并启动Docker
    • 配置Docker用户组

    安装Docker

    安装 Docker 服务，请参考下文常见问题中：

    如果使用云服务器，推荐使用操作系统镜像模板的方式创建主机，即在一台主机上安装 Docker 后，然后使用安装 Docker 服务后的操作系统做一个镜像模板。通过这个模板镜像来创建主机，这样新创建的主机就自带了 Docker 服务。

    配置docker用户组

    若执行Docker命令，如docker ps必须使用sudo才能运行，则需要按如下修改：

    检测docker ps命令

    若docker ps命令报错Permission Denied则需要配置docker用户组：

    1. # 创建docker用户组
    2. sudo groupadd docker
    3. # 将当前用户添加到docker用户组
    4. sudo usermod -aG docker $USER
    5. # 重启docker服务
    6. sudo systemctl restart docker
    7. # 切换或者退出当前账户，重新登入
    8. exit

    重新登入后，执行docker ps如有输出，未报错Permission Denied则代表配置成功

    拉取 Docker 镜像

    在WeBASE v1.4.3版本后，可视化部署支持自动从CDN拉取镜像，无需手动拉取

    若需要手动配置镜像，可以通过以下方法配置

    可视化部署需要使用FISCO BCOS + WeBASE-Front组成的节点与前置Docker镜像，并提供拉取Docker镜像的三种方式（推荐通过CDN加速服务拉取）：

    • 通过可视化部署页面，自动从CDN拉取镜像压缩包并加载镜像（推荐），需要确保wget命令能正常使用
    • 在节点主机上手动通过WeBASE CDN服务下载镜像压缩包后，通过docker load命令安装镜像

    可视化自动部署功能支持自动从 Docker 仓库拉取镜像，仅通过页面点击就可以完成Docker拉取。但是由于DockerHub的网络原因，拉取镜像的速度较慢，耗时过长，容易导致拉取镜像失败，页面的可视化部署操作失败。 因此，为了保证部署过程顺利和快速完成，可在执行可视化部署前，手动拉取镜像，并将镜像上传到每个需要部署节点服务的主机。

    拉取镜像的方法，请参考下文常见问题中：拉取 Docker 镜像

    对于依赖服务的安装，有两种方式（ 一键部署 和 手动部署 ），选择其中一种部署方式即可

    1. 一键部署依赖服务

    适合同机部署，快速体验WeBASE的情况使用

    一键部署依赖

    具体环境依赖参考一键部署-前提条件。

    拉取部署脚本

    获取部署安装包：

    1. wget https://github.com/WeBankFinTech/WeBASELargeFiles/releases/download/v1.5.4/webase-deploy.zip
    3. # 若网络问题导致长时间无法下载，可尝试以下命令
    4. wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.4/webase-deploy.zip

    解压安装包：

    1. unzip webase-deploy.zip

    进入目录：

    注意：

    • 配置可视化部署配置文件时，选择visual-deploy.properties进行配置
    • 选择部署方式时，选择 可视化部署 方式，即执行 deploy.py 脚本时，执行 python3 deploy.py installWeBASE

    修改 visual-deploy.properties 文件。

    重要

    注意： sign.ip 配置的 IP 是WeBASE-Sign签名服务对外提供服务访问的 IP 地址，供其他部署节点主机访问。

    1. # WeBASE子系统的最新版本(v1.1.0或以上版本)
    2. webase.web.version=v1.5.4
    3. webase.mgr.version=v1.5.4
    4. webase.sign.version=v1.5.3
    5. fisco.webase.docker.cdn.version=v1.5.4
    7. # 节点管理子系统mysql数据库配置
    8. mysql.ip=127.0.0.1
    9. mysql.port=3306
    10. mysql.user=dbUsername
    11. mysql.password=dbPassword
    12. mysql.database=webasenodemanager
    14. # 签名服务子系统mysql数据库配置
    15. sign.mysql.ip=localhost
    16. sign.mysql.port=3306
    17. sign.mysql.user=dbUsername
    18. sign.mysql.password=dbPassword
    19. sign.mysql.database=webasesign
    21. # WeBASE管理平台服务端口
    22. web.port=5000
    23. # 启用移动端管理平台 (0: disable, 1: enable)
    24. web.h5.enable=1
    26. # 节点管理子系统服务端口
    27. mgr.port=5001
    29. # 签名服务子系统端口
    30. sign.port=5004
    32. # WeBASE-Sign 对外提供服务的访问 IP 地址
    33. # 部署在其它主机的节点前置，需要使用此 IP 访问 WeBASE-Sign 服务
    34. # 不能是 127.0.0.1 或者 localhost
    35. sign.ip=
    37. # 是否使用国密（0: standard, 1: guomi）
    38. # 此配置决定可视化部署搭建国密或非国密的链
    39. encrypt.type=0

    完成配置文件修改后，则执行部署：

    备注：

    • 部署脚本会拉取相关安装包进行部署，需保持网络畅通。
    • 首次部署需要下载编译包和初始化数据库，重复部署时可以根据提示不重复操作
    • 部署过程中出现报错时，可根据错误提示进行操作，或根据本文档中的进行排查
    • 不建议使用sudo执行脚本，例如sudo python3 deploy.py installWeBASE（sudo会导致无法获取当前用户的环境变量如JAVA_HOME）
    • 推荐使用Python 3.6及以上版本
    1. # 部署并启动可视化部署的所有服务
    2. python3 deploy.py installWeBASE

    如果遇到docker必须使用sudo运行，报错Docker....Permission Denied，可以参考常见问题-创建docker用户组

    部署完成后可以看到deploy has completed的日志：

    1. $ python3 deploy.py installWeBASE
    2. ...
    3. ============================================================
    4.               _    _     ______  ___  _____ _____ 
    5.              | |  | |    | ___ \/ _ \/  ___|  ___|
    6.              | |  | | ___| |_/ / /_\ \ `--.| |__  
    7.              | |/\| |/ _ | ___ |  _  |`--. |  __| 
    8.              \  /\  |  __| |_/ | | | /\__/ | |___ 
    9.               \/  \/ \___\____/\_| |_\____/\____/  
    10. ...
    11. ...
    12. ============================================================
    13. ==============      deploy has completed     ==============
    14. ============================================================
    15. ==============    webase-web version  v1.5.0        ========
    16. ==============    webase-node-mgr version  v1.5.0   ========
    17. ==============    webase-sign version  v1.5.0       ========
    18. ============================================================
    • 服务部署后，需要对各服务进行启停操作，可以使用以下命令：
    1. # 可视化部署
    2. 部署并启动可视化部署的所有服务  python3 deploy.py installWeBASE
    3. 停止可视化部署的所有服务  python3 deploy.py stopWeBASE
    4. 启动可视化部署的所有服务  python3 deploy.py startWeBASE
    5. # 各子服务启停
    6. 启动WeBASE-Node-Manager: python3 deploy.py startManager
    7. 停止WeBASE-Node-Manager: python3 deploy.py stopManager
    8. 启动WeBASE-Web:          python3 deploy.py startWeb
    9. 停止WeBASE-Web:          python3 deploy.py stopWeb
    10. 启动WeBASE-Sign:        python3 deploy.py startSign
    11. 停止WeBASE-Sign:        python3 deploy.py stopSign

    2. 手动部署依赖服务

    适合多机部署，企业级的情况使用。

    具体步骤如下：

    • 签名服务（WeBASE-Sign）
    • 管理平台（WeBASE-Web）
      • 参考 部署 WeBASE-Web 服务
    • 节点管理子系统（WeBASE-Node-Manager）
      • 参考 节点管理服务 WeBASE-Node-Manager 部署文档 部署 WeBASE-Node-Manager 服务
      • 修改 WeBASE-Node-Manager/dist/conf/application.yml 配置文件示例如下：
        • 配置文件中 deployType 为 1，启用节点管理服务的可视化部署功能
        • 配置文件中 webaseSignAddress 的 IP 地址，其余节点主机需要通过此IP访问签名服务；注，此处IP不能使用127.0.0.1

    重要

    1. 注意 WeBASE-Node-Manager 服务的 webaseSignAddress 配置。WeBASE-Front 节点会使用此地址访问 WeBASE-Sign。所以不能使用 `127.0.0.1`，需要填写对外服务的 IP 地址。
    1.  constant:
    2.   # 1.4.0 visual deploy
    3.   # 部署方式修改为 1，启用可视化部署
    6.   # WeBASE-Sign 服务的访问地址，前面部署的签名服务的访问地址
    7.   # 注意 IP 地址，WeBASE-Front 会使用此 IP 地址访问签名服务
    8.   # 因此，在可视化部署中，此处不能使用 127.0.0.1或localhost
    9.   webaseSignAddress: "xxx.xx.xx.xxx:5004"

    在部署完依赖服务后，使用浏览器，访问节点管理平台页面：

    1. # 默认端口 5000
    2. http://{deployIP}:{webPort}

    具体部署步骤，请参考下文进行部署操作

    可视化部署节点时，后台服务将通过在各个主机安装FISCO BCOS + WeBASE-Front的Docker镜像，结合免密远程操作进行自动化部署节点与节点前置的过程。

    因此，正如上文步骤中“拉取Docker镜像”的阐述，此操作依赖Docker服务，并默认从CDN自动加载节点与前置的Docker镜像

    提示：

    • 在执行部署前，请提前在节点机中 手动安装 Docker 服务
      • 参考下文 常见问题 中的
    • 如果部署 国密 版本
      • 国密链需要将WeBASE-Node-Manager yml中的encryptType配置修改为1
    • 部署时，默认的链名为default_chain，默认机构名为agency1
    • 部署节点的所有操作将使用Ansible免密的免密SSH账号进行操作，请确保Ansible自检通过

    打开节点管理平台页面后，登录后修改密码，默认进入可视化部署引导页，点击右上角可以进入主机管理开始部署节点

    部署节点主要包含三步：添加并检测节点主机、初始化主机（检查Docker与安装依赖）

    首先需要选中镜像拉取方式，推荐使用自动从CDN拉取并加载方式。离线环境或网络不好的情况下，推荐使用方式，提前在各个节点主机下载并加载镜像

    （一）添加主机：

    visual-deploy-host-add

    添加主机时，需要填入主机的IP与部署节点的目录

    • 仅在宿主机（即节点管理服务所在主机）部署节点时，则添加主机必须为127.0.0.1，否则填写公网IP或内网IP需要配置Ansible host
    • 添加主机时，将检查该IP是否可以连通，同时将检查该主机的路径是否可访问，并自动创建该目录

    ../../_images/add_host.pngvisual-deploy-host-add

    （二）添加节点信息：

    visual-deploy-node-add

    节点管理，先点击“新增节点”添加节点信息

    • 可以在一台主机中指定节点数量
    • 添加多个主机的节点，需要确保填入的各个主机间的P2P端口和前置端口互通，否则将影响节点正常运行

    ../../_images/deploy_node_info.pngvisual-deploy-node-info

    （三）检查主机：

    visual-deploy-start-check

    添加节点信息后，将自动检查一下依赖

    • 检测机器的端口是否已被占用
    • 检测Docker服务是否已启用，并通过hello-world的镜像进行测试

    ../../_images/host_check_suc.pngvisual-deploy-host-check

    检测失败的信息将在操作日志中显示，只有添加的节点信息全部通过才可以开始下一步“初始化”

    • 如果提示内存不足(Free memory too low)，则可以释放主机内存，一节点至少 1G 可用内存(Free memory)
    • 如果提示端口被占用，可根据提示的端口号，在主机释放端口或删除填入的节点信息，修改后重新填入
    • 如果提示Docker相关错误，需要到主机确认已并已启用，是否已配置Docker组，确保能拉取并运行hello-world镜像
    • 部分虚拟机缺少bc依赖(bc command not found)，需要手动安装bc

    visual-deploy-host-check-fail

    排除错误原因后，可以点击“检测”按钮，再次检测

    （四）初始化主机：

    点击“初始化”按钮进行主机初始化，将自动完成以下操作，初始化成功后才能进行下一步的部署操作，“初始化”按钮将变成“部署”按钮

    • 自动检测并安装相关系统依赖，如netstat, wget等
    • 加载节点镜像：根据选中的镜像加载方式进行加载（若手动加载则检测镜像已存在于节点主机）
    • 自动加载镜像时，会在节点主机指定目录中创建download目录，并下载镜像的tar包保存于此；若已存在同名tar包将不重复下载，直接使用已有tar包(docker-fisco-webase.tar)

    ../../_images/host_init.pngvisual-deploy-host-init

    • 初始化操作预计在两到三分钟内完成，若网速过慢或不稳定建议通过方式拉取 若初始化失败，则需要结合操作日志排查上述步骤的错误原因，排除主机中存在的问题后，重新执行检测，初始化操作

    （五）部署：

    添加的主机状态都为“初始化成功”后，点击“部署”按钮后，将自动完成以下操作

    • 根据填入的节点信息自动生成链配置与证书
    • 通过SCP将节点与前置的配置文件、证书传输到各个主机的指定目录下

    visual-deploy-config-start

    • 生成配置与传输配置完成后，将自动进入链初始化页面，届时将自动启动各个主机的节点，此过程预计需要几分钟时间，直到链状态为“运行”

    ../../_images/chain_deploying.pngvisual-deploy-config-ing

    若出现启动失败，需要结合报错提示，检查节点主机状态正常，各个节点主机间端口互通，网速过慢或网络丢包严重等等，排查后，点击“删除链”重置当前的链后，重新尝试建链

    如始终无法部署，可以结合Node-Manager日志排查错误原因，并在github上提交配上日志和环境信息的issue

    新增节点

    节点新增，也称作节点扩容，指在已有的区块链服务中，在新的主机上，添加一个新的节点。

    提示：

    • 新主机需要按照中的节点机进行配置
      • 参考上文的配置 SSH 免密登录，配置宿主机到新主机的免密登录
      • 参考上文的，把新主机的IP加到Ansible的hosts配置中
      • 参考下文常见问题中的 安装 Docker
    • 新增的节点，默认处于游离状态，需要手动变更节点为共识或者观察节点后，新节点开始从原有节点同步区块数据。

    具体操作：

    新增节点与部署时是同样的三个步骤：添加并检测节点主机、初始化主机（检查Docker与安装依赖）、启动节点并重启链

    添加主机：

    若需要添加新的主机时，填入主机的IP与部署节点的目录

    visual-deploy-host-add

    • 点击新增节点按钮

    ../../_images/add_node_index.pngvisual-deploy-add-node-index

    添加主机信息，与部署链时相似的操作

    • 选择 Docker 拉取方式，推荐使用CDN拉取，离线环境或网络不好的情况下，推荐使用方式，提前在各个节点主机下载并加载镜像
    • 选择“新增节点”添加信息，选择主机与节点的端口、节点数量等；
    • 注，若需要添加新的主机，则按文档的环境要求准备新的主机，并到“主机管理”添加主机

    依次执行同相同的检测、初始化、部署即可

    visual-deploy-add-node

    点击“部署”后将生成并传输新的节点的配置文件到目标主机，同时新增节点比部署链会多出以下操作

    • 自动在链的其他节点中添加新节点的P2P连接配置，并在新节点的P2P配置中添加本次新增节点的IP与已有的非游离节点的IP
    • [可选]配置完成后，需要手动“重启”已有节点才能使新的P2P配置在已有节点中生效，即双向互联；新节点会默认连接已有的所有节点，此操作可视具体情况自行操作
    • 若新节点启动失败，将新节点删除并重新尝试添加即可

    ../../_images/add_node_restart.pngvisual-deploy-add-node-restart

    重启完成后，需要创建私钥或使用已有私钥，将新节点设为共识节点或观察节点

    visual-deploy-add-node-removed

    节点操作

    节点操作，包括：节点的启停、节点共识类型切换、删除节点

    • 节点的类型切换：共识，观察和游离
      • 在可视化部署中，变更节点为游离节点时，该群组内，至少仍有两个共识节点
      • 变更节点类型，需要发送交易，请先在私钥管理 中 添加私钥账号；

    修改节点为共识节点

    ../../_images/add_node_set_sealer.pngvisual-deploy-add-node-sealer

    若需要添加私钥：

    visual-deploy-add-user-key

    • 节点的启动，停止
      • 若节点的docker容器被意外删除，通过页面点击“启动”即可完成节点重启
      • 停止或重启操作时，请确保满足链的共识容错要求。设为观察节点可避免影响共识状态
      • 每次启停操作大约需要30秒
    • 删除节点
      • 将节点设置为游离节点后，即可安全删除节点，删除后，链将会移除被删节点的P2P配置，并重启链
      • 删除节点时，节点必须处于停止状态

    ../../_images/node_stopped.pngvisual-deploy-add-node-stopped

    安装 Docker

    在 Debian/Ubuntu/CentOS/RHEL，直接执行命令：

    1. # 该脚本是 Docker 官方提供的 Linux 自动安装脚本
    2. bash <(curl -s -L get.docker.com)

    在 CentOS/RHEL 8.x 中，使用上面的自动脚本安装时，会出现下面的错误：

    要解决这个问题，需要手动安装 containerd.io后，在执行自动安装脚本

    1. # 下载最新的 containerd.io 安装包
    2. wget https://download.docker.com/linux/centos/8/x86_64/stable/Packages/containerd.io-1.2.13-3.2.el7.x86_64.rpm 
    4. # 手动安装 containerd.io 
    5. yum localinstall containerd.io-1.2.13-3.2.el7.x86_64.rpm

    拉取 Docker 镜像

    镜像版本：

    • v2.8.0

    提示：

    • 最近的镜像版本，请参考：

    拉取方式

    • 检查本地是否已有镜像
    1. # 检查本地是否有镜像
    2. docker images -a |grep -i "fiscoorg/fisco-webase" | grep -i v2.8.0
    4. # 如果有如下输出，表示本地已有镜像；否则表示本地没有镜像
    5. fiscoorg/fisco-webase   v2.8.0     bf4a26d5d389  5 days ago   631MB

    • 如果本地没有镜像（如果本地有镜像，跳过）

    • 如果需要替换镜像，执行docker rmi [ImageId]删除镜像即可

      • 从 CDN 拉取镜像压缩包
      1. # 从 CDN 拉取镜像 tar 文件
      2. # 非国密
      3. wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.4/docker-fisco-webase.tar
      5. # 解压镜像 tar 文件
      6. docker load -i docker-fisco-webase.tar
      • 从 Docker 官方拉取镜像
      1. # 执行 Docker 拉取命令
      2. docker pull fiscoorg/fisco-webase:v2.8.0

    • 压缩镜像到 tar 文件

    1. # 压缩镜像为 tar 文件
    2. docker save -o docker-fisco-webase.tar fiscoorg/fisco-webase:v2.8.0
    • 发送镜像 tar 文件到部署节点的主机
    1. # 发送镜像 tar 文件到需要部署节点的主机
    2. scp docker-fisco-webase.tar root@[IP]:/root/
    • 解压镜像 tar 文件
    1. # 登录需要部署的主机，解压 tar 文件
    2. docker load -i docker-fisco-webase.tar
    • 节点主机检查是否已经成功拉取镜像
    1. # 检查是否成功拉取镜像
    2. docker images -a |grep -i "fiscoorg/fisco-webase"
    4. # 如果有如下输出，表示拉取成功
    5. fiscoorg/fisco-webase   v2.8.0  bf4a26d5d389  5 days ago   631MB

    手动下载 TASSL

    FISCO BCOS 国密版本需要使用 TASSL 生成国密版本的证书，部署工具会自动从GitHub或CDN下载，解压后放置于 ~/.fisco/tassl(文件名为tassl)，如果碰到下载失败，请尝试从https://gitee.com/FISCO-BCOS/LargeFiles/blob/master/tools/tassl.tar.gz 下载并解压后，放置于 ~/.fisco/tassl

    没有进入可视化部署界面

    在登录区块链管理平台后，没有进入可视化部署页面。此时，修改 WeBASE-Node-Manager 服务中的 dist/conf/application.yml 文件中的 deployType 的值是否为 1 后，重启 WeBASE-Node-Manager 服务即可。

    SSH 登录新主机，使用 docker images -a |grep -i "fiscoorg/fisco-webase" 命令检查是否有镜像。

    • 如果不存在，请参考上文： 常见问题 中的 拉取 Docker 镜像
    • 如果存在，请检查新主机中 SSH 账号的是否已经。

    部署失败以及区块链重置

    如果在部署区块链服务时，出现了部署失败的问题，可以使用重置功能，重置区块链服务，然后进行重新部署。

    如果要重置当前区块链，点击重置按钮，等待重置完成。

    执行重置操作，并 不会真正物理删除节点的数据（但会删除WeBASE数据库中链相关数据），而是使用 mv 命令，将区块链的整个数据移动到临时目录。

    • WeBASE-Node-Manager 服务的临时目录
      • WeBASE-Node-Manager/dist/NODES_ROOT_TMP 目录中存放了所有重置节点的节点配置文件
      • 不包含具体的节点数据文件
      • 文件名格式 default_chain-YYYYMMDD_HHmmSS（删除时间）：default_chain-20200722_102631
    • 节点主机中的临时目录
      • WeBASE-Node-Manager/dist/conf/application.yml 配置文件中 rootDirOnHost 配置目录下的 deleted-tmp 目录
      • 包含了节点的所有文件配置文件和节点数据文件
      • 文件名格式 default_chain-YYYYMMDD_HHmmSS（删除时间）：default_chain-20200722_102631

    docker必须使用sudo才能运行，但是sudo下系统环境变量失效

    答：可以在root用户下配置环境变量如JAVA_HOME等，或者通过下面操作，尝试创建docker用户组

    1. # 创建docker用户组
    2. sudo groupadd docker
    3. # 将当前用户添加到docker用户组
    4. sudo usermod -aG docker $USER
    5. # 重启docker服务
    6. sudo systemctl restart docker
    7. # 切换或者退出当前账户，重新登入
    8. exit

    sudo账号免密配置

    节点主机 sudo 账号免密配置方法

    1. # 切换到 root 或者有权限账户
    2. vi /etc/sudoers
    4. # 添加下面一行并保存
    5. # 替换 user 为 SSH 免密登录账号
    6. user   ALL=(ALL) NOPASSWD : ALL

    注，可视化部署中需要使用sudo权限执行script/deploy目录中的host_init_shell进行依赖安装，host_docker_check在docker未启动情况下启动docker服务，host_check_port通过sudo netstat检查端口占用情况

    页面中只能部署或添加“国密”节点或“非国密”节点

    答：需要修改Node-Manager的yml中encryptType配置项后重启即可（0为非国密，1为国密）。

    注：不支持修改已搭建链的类型，若需要修改，则需要重置链后重新进行可视化搭建。

    可视化部署如何升级节点版本

    答：可视化部署暂未支持节点升级。

    节点主机检测报错可用内存不足(free memory)

    答：每个“节点+节点前置”至少需要1G的可用内存，建议增大主机的机器内存，或释放更多的可用内存(Free memory)。

    在root用户下执行以下操作可以释放available内存转为free内存

    1. sync; echo 1 > /proc/sys/vm/drop_caches
    2. sync; echo 2 > /proc/sys/vm/drop_caches
    3. sync; echo 3 > /proc/sys/vm/drop_caches

    参考：

    答：参考环境依赖，将相关依赖都安装好之后

    • 部署时选择手动拉取节点的Docker镜像，并在节点主机手动配置镜像，
    • 安装docker run hello-world所需的hello-world的docker镜像用于主机检测
    • 下载TASSL包解压后放到~/.fisco/目录中(文件名为tassl)，可以参考手动配置TASSL

    链部署失败或节点添加失败排查

    页面提示请求超时，如添加主机、初始化主机等

    • 登录主机检查主机是否卡顿或存在异常

    若点击初始化按钮后，显示“加载Docker镜像”时，初始化主机失败或提示超时

    • 检查主机网速，默认的超时时间为60s，如果网速过慢或丢包严重，可以尝试手动下载cdn镜像包查看网速，并建议通过手动加载镜像方式，提前下载镜像并加载到节点主机

    若出现部署链或节点时，需要结合报错提示，通过以下步骤排查：

    • 检查节点主机状态正常，如top命令检查CPU或内存使用率正常
    • 若在部署或检查过程均频现失败，通过ping命令检查宿主机到节点主机的延迟，延迟过高需要排除问题后再次尝试
    • 检查主机硬盘余量是否充足
    • 链显示运行中，但是节点异常时，需要确保各个节点主机间端口互通，如节点主机之间的P2P端口互通（保证共识），宿主机到节点主机的Front端口互通（保证WeBASE服务）等
    • 部署链失败时
    • 新增节点失败时

    欢迎给WeBASE的文档提交 Pull Request 补充更多的 Q&A