快速入门搭建

    • WeBASE lab版本已适配FISCO-BCOS 3.0.0版本，相关文档与代码仓库可跳转至 WeBASE-lab分支查看

    节点搭建的方法建议使用。

    前提条件

    备注：部署出现问题请查看问题记录。

    1. 下载安装包

    2. 解压

      2. cd webase-front

    3. 拷贝sdk证书文件（build_chain的时候生成的）

      将节点所在目录nodes/${ip}/sdk下的所有文件拷贝到当前conf目录，供SDK与节点建立连接时使用（SDK会自动判断是否为国密，且是否使用国密SSL）

      • 链的sdk目录包含了ca.crt, sdk.crt, sdk.key和gm文件夹，gm文件夹包含了国密SSL所需的证书
      • 拷贝命令可使用cp -r nodes/${ip}/sdk/* ./conf/

    4. 服务启停

      服务启停命令：

      1. 启动： bash start.sh
      2. 停止： bash stop.sh
      3. 检查： bash status.sh

    启动成功将出现如下日志：

    1. ...
    2.     Application() - main run success...

    通过ps命令，检查节点与节点前置的进程是否存在

    • 包含：节点进程，节点前置进程webase.front

    检查方法如下，若无输出，则代表进程未启动，需要到webase-front/log中查看日志的错误信息，并根据错误提示或根据进行错误排查

    检查节点进程

    1. $ ps -ef | grep node

    输出如下，此处部署了两个节点node0, node1

    检查节点前置webase-front的进程

    1. $ ps -ef | grep webase.front

    输出如下

    1. root     31805     1  0 17:24 pts/2    00:01:30 /usr/local/jdk/bin/java -Djdk.tls.namedGroups=secp256k1 ... conf/:apps/*:lib/* com.webank.webase.front.Application

    通过netstat命令，检查节点与节点前置的端口监听情况

    检查方法如下，若无输出，则代表进程端口监听异常，需要到webase-front/log中查看日志的错误信息，并根据错误提示或根据WeBASE-Front常见问题进行错误排查

    检查节点channel端口(默认为20200)是否已监听

    1. $ netstat -anlp | grep 20200

    输出如下

    1. tcp        0      0 0.0.0.0:20200           0.0.0.0:*               LISTEN      29069/fisco-bcos

    输出如下

    1. tcp6       0      0 :::5002                 :::*                    LISTEN      2909/java

    日志中若出现报错信息，可根据信息提示判断服务是否异常，也可以参考并根据错误提示或根据进行错误排查

    • 如果节点进程已启用且端口已监听，可跳过本章节
    • 如果节点前置异常，如检查不到进程或端口监听，则需要webase-front/log中查看日志的错误信息
    • 如果检查步骤出现检查不到进程或端口监听等异常，或者前置服务无法访问，可以按以下顺序逐步检查日志：
      • 检查nodes/127.0.0.1/nodeXXX/log中的节点日志

    查看运行成功日志：webase-front运行成功后会打印日志main run success，可以通过搜索此关键字来确认服务正常运行。

    如，检查webase-front日志，其他webase服务可进行类似操作

    2. $ grep -B 3 "main run success" log/WeBASE-Front.log

    输出如下：

    1. 2020-12-09 15:47:25.355 [main] INFO  ScheduledAnnotationBeanPostProcessor() - No TaskScheduler/ScheduledExecutorService bean found for scheduled processing
    2. 2020-12-09 15:47:25.378 [main] INFO  TomcatEmbeddedServletContainer() - Tomcat started on port(s): 5002 (http)
    3. 2020-12-09 15:47:25.383 [main] INFO  Application() - Started Application in 6.983 seconds (JVM running for 7.768)
    4. 2020-12-09 15:47:25.383 [main] INFO  Application() - main run success...

    启动失败或无法使用时，欢迎到WeBASE-Front提交Issue或到技术社区共同探讨

    • 提交Issue或讨论问题时，可以在issue中配上自己的环境配置，操作步骤，错误现象，错误日志等信息，方便社区用户快速定位问题

    访问 

    1. ```
    2. http://localhost:5002/WeBASE-Front 
    3. ```

    注：若服务启动后无异常，但仍然无法访问，可以检查服务器的网络安全策略：

    • 开放节点前置端口：如果希望通过浏览器(Chrome Safari或Firefox)直接访问webase-front节点前置的页面，则需要开放节点前置端口frontPort（默认5002）

    WeBASE提供结合FISCO BCOS节点与WeBASE-Front的Docker镜像，通过镜像快速部署需要的步骤如下：

    • 通过build_chain建链脚本（指定 -d docker模式）生成节点所需证书、配置文件等
      • 如生成4节点bash build_chain.sh -l 127.0.0.1:4 -p 30300,20200,8545 -o nodes -d
    • 拉取镜像： docker pull fiscoorg/fisco-webase:v2.7.2
    • 启动容器：需要将生成的nodes目录的node0的配置、SDK证书挂载到容器中，并将容器内的日志挂载到/nodes/127.0.0.1/node0/front-log中