【教程】如何配置简单的webase-front中间件

正文

下载java（下载了就不用下了）

sudo apt install -y default-jdk

配置java_home

 短暂

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64/

长期

vim /etc/profile/

在文末添加上面那个短期的java_home命令就行了 刷新

 source /etc/profile

拉取webase-front包

wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/WeBASE/releases/download/v1.5.4/webase-front.zip

解压

unzip webase-front.zip

拷贝证书 

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

将节点所在目录nodes/${ip}/sdk下的所有文件拷贝到当前conf目录，供SDK与节点建立连接时使用

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

cp -rf nodes/127.0.0.1/sdk/* webase-front/conf/

服务启停命令：

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

状态检查

成功部署后，可以根据以下步骤确认各个子服务是否启动成功

1. 检查各子系统进程

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

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

检查节点进程

$ ps -ef | grep node

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

$ ps -ef | grep webase.front 

2. 检查进程端口

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

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

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

$ netstat -anlp | grep 20200

$ netstat -anlp | grep 5002

3. 检查服务日志

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

• 如果节点前置异常，如检查不到进程或端口监听，则需要webase-front/log中查看日志的错误信息
• 如果检查步骤出现检查不到进程或端口监听等异常，或者前置服务无法访问，可以按以下顺序逐步检查日志：
  • 检查webase-front/log中查看节点前置日志的错误信息，如果无错误，且日志最后出现application run success字样则代表运行成功
  • 检查nodes/127.0.0.1/nodeXXX/log中的节点日志

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

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

$ cd webase-front
$ grep -B 3 "main run success" log/WeBASE-Front.log

访问

访问 http://{deployIP}:{frontPort}/WeBASE-Front，示例：

```
http://localhost:5002/WeBASE-Front 
```

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

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