Merge branch 'release-2' into dev

docs/api.md

@@ -169,6 +169,7 @@ FISCO BCOS RPC接口错误码及其对应的含义如下：
 | 0xc | GROUP_CONF_NOT_FOUND         | 调用启动群组接口时，未找到群组配置文件             |
 | 0xd | GROUP_IS_STOPPING            | 调用接口时，群组正在释放资源                     |
 | 0xf | GROUP_NOT_DELETED            | 调用恢复接口时，群组并未被删除                   |
+
 ## getClientVersion
 返回节点的版本信息
 ### 参数
@@ -1668,4 +1669,4 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"getBatchReceiptsByBlockHashAndRa
   "jsonrpc": "2.0",
   "result": "eJylUrFu3DAM3fsZmm+gRImUbiu6NEuHAJ2KDLJEpkETK7B9QIDD/XsZX4AgQIcCEWCLj+YjafKd3fQ42p+bWYc7nq/ge11/u6ODlyaaQ8XmhZmh1iiYc9XUGKRwFc9ckTy3BAGqQAqTRCipa+9YanCHa8Ifp6dJlj2lN98iTR6et9sxtt1HpULUSsAoURuUyFNtLEKlgHDO3UtoSRqoUAsRqUMuQVjRgnt4T7l+G6d5eyt0ObhtqfNa2/Yw5tu3CHf8dXZtzPapbV97X2RddwL857FquoynnTNlwQJeSJPmGGIp2hNyZWvfJy8pUias3Tj3df25St9piUs21+O4f23n7uDGaXs+XfuG3JBtIJ874ZN8pJg4cCDlEIA8RYqGEiMjVrSfQo9MSGaYRTs2FpocKOw4YzEW2c2YKGHZvcVeYE+yqGA3Y8T4rw5sPutWt9N1Ob4a3sZu52aKU/TUPNhwJ2q5dM2cpFArCpqmoByj+7D/d1GTNJ/UNBU7FRKizjqJElCcekXp4MPUJrYUHUyBKBJeK1BStu1+THszd3m5Ls5d7i5f/gLIg98l"
 }
-```
+```

docs/browser/browser.md

@@ -13,8 +13,6 @@
 
 ![](../../images/browser/overview.png)
 
-
-
 ### 1.2 主要功能模块
 
 本小节概要介绍浏览器的各个模块，方便大家对浏览器有一个整体的认识。区块链浏览器主要的功能模块有：群组切换模块，配置模块，区块链信息展示模块。
@@ -23,19 +21,19 @@
 
 群组切换主要用于在多群组场景中切换到不同群组，进行区块链信息浏览。
 
-![](../../images/browser/switch_group.jpg)
+![](../../images/browser/switch_group.png)
 
 #### 1.2.2. 配置模块
 
-主要包括群组配置，节点配置，合约配置。
+主要包括群组配置，节点配置，合约配置，用户配置。
 
 ![](../../images/browser/group_config.png)
 
 #### 1.2.3. 区块链信息展示模块
 
 区块链浏览器主要展示了链上群组的具体信息，这些信息包括：概览信息，区块信息，交易信息。
 
-![](../../images/browser/show.jpg)
+![](../../images/browser/show.png)
 
 ## 2. 使用前提
 
@@ -107,13 +105,27 @@
 
 ![](../../images/browser/contract.png)
 
+## 4.4. 添加用户
+
+支持导入链上用户，关联交易用户。此功能需要用户把本群组使用的所有链上用户导入。未导入的用户则不能关联。
+
+用户导入：
+
+![](../../images/browser/user_add.png)
+
+用户导入后，交易列表和详情就可以查看关联用户，否则不会显示关联用户：
+
+![](../../images/browser/user_link_list.png)
+
+![](../../images/browser/user_link_detail.png)
+
 ## 5. 界面展示
 
 ### 5.1. 概览
 
 #### 5.1.1 概览信息
 
-主要包括当前群组的块高，交易总量，正在处理的交易数，PBFT视图。
+主要包括当前群组的块高，交易总量，正在处理的交易数，群组下节点个数。
 
 #### 5.1.2 最近15天的交易量
 

docs/browser/deploy.md

@@ -19,21 +19,19 @@
 
 #### 平台要求
 
-推荐使用CentOS 7.2+, Ubuntu 16.04及以上版本, 一键部署脚本将自动安装`openssl, curl, wget, git, nginx`相关依赖项。
+推荐使用CentOS 7.2+, Ubuntu 16.04及以上版本, 一键部署脚本将自动安装`openssl, curl, wget, git, nginx, dos2unix`相关依赖项。
 
-其余系统可能导致安装依赖失败，可自行安装`openssl, curl, wget, git, nginx`依赖项后重试
+其余系统可能导致安装依赖失败，可自行安装`openssl, curl, wget, git, nginx, dos2unix`依赖项后重试
 
 #### 检查Java
 
-推荐JDK8-JDK13版本：
+推荐JDK8-JDK13版本，使用OracleJDK[安装指引](#jdk)：
 
 ```
 java -version
 ```
 
-- Java推荐使用[OpenJDK](#id10) ，建议从[OpenJDK网站](https://jdk.java.net/java-se-ri/11) 自行下载。
-
-- **注意：需要配置root用户的java_home**
+*注意：不要用`sudo`执行安装脚本*
 
 #### 检查mysql
 
@@ -43,23 +41,25 @@ MySQL-5.6或以上版本：
 mysql --version
 ```
 
-- Mysql安装部署可参考[数据库部署](#id14)
+- Mysql安装部署可参考[数据库部署](#mysql)
 
 #### 检查Python
 
 <span id="checkpy"></span>
 
-使用Python3.5或以上版本：
+使用Python3.6或以上版本：
 
 ```
 python3 --version
 ```
 
 - Python3安装部署可参考[Python部署](#python3)
 
-#### PyMySQL部署（Python3.5+）
+#### PyMySQL部署（Python3.6+）
+
+<span id="pymysql"></span>
 
-Python3.5及以上版本，需安装PyMysql依赖包：
+Python3.6及以上版本，需安装PyMysql依赖包：
 
 - CentOS
 
@@ -87,7 +87,7 @@ Python3.5及以上版本，需安装PyMysql依赖包：
 
 获取部署安装包：
 ```shell
-wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/fisco-bcos-browser/releases/download/v2.2.2/browser-deploy.zip
+wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/fisco-bcos-browser/releases/download/v2.2.3/browser-deploy.zip
 ```
 解压安装包：
 ```shell
@@ -102,7 +102,7 @@ cd browser-deploy
 
 ① 可以使用以下命令修改，也可以直接修改文件（vi common.properties）
 
-② 数据库需要提前安装（数据库安装请参看 [数据库部署](#id14)）
+② 数据库需要提前安装（数据库安装请参看 [数据库部署](#mysql)）
 
 ③ 服务端口不能小于1024
 
@@ -145,67 +145,162 @@ python3 deploy.py startAll
 python3 deploy.py help
 ```
 
-**备注：** 部署过程出现问题可以查看 [常见问题](#id19)
+**备注：** 部署过程出现问题可以查看 [常见问题](#q&a)
 
-## 5.访问
+## 5.状态检查
 
-例如：在浏览器输入以下访问地址，IP为部署服务器IP，端口为前端服务端口
+成功部署后，可以根据以下步骤**确认各子服务是否启动成功**
+
+### 检查子系统进程
+
+通过`ps`命令，检查各子系统的进程是否存在
+
+- 包含：后端server进程和前端的`nginx`进程
+
+检查方法如下，若无输出，则代表进程未启动，需要到该子系统的日志中[检查日志错误信息](#checklog)，并根据错误提示或本文档的[常见问题](#q&a)进行排查
+
+- 检查后端server进程
 
 ```
-http://127.0.0.1:5100/
+$ ps -ef | grep org.bcos.browser
 ```
 
-## 6.日志路径
+输出如下
+
 ```
-部署日志：log/
-后端日志：server/log/
-前端日志：web/log/
+root     91851      1  0 Mar31 ?        00:04:08 /usr/local/jdk1.8.0_181/bin/java -cp conf/:apps/*:lib/* org.bcos.browser.Application
 ```
 
-## 7.附录
+- 检查前端的nginx进程
 
-### 7.1 Java环境部署
+```
+$ ps -ef | grep browser |grep nginx       
+```
 
-此处给出OpenJDK安装简单步骤，供快速查阅。更详细的步骤，请参考[官网](https://openjdk.java.net/install/index.html)。
+输出如下
 
-#### ① 安装包下载
+```
+root      112543      1  0 Mar23 ?        00:00:00 nginx: master process /usr/sbin/nginx -c /data/home/webase/webase/browser-deploy/comm/nginx.conf
+```
 
-从[官网](https://jdk.java.net/java-se-ri/11)下载对应版本的java安装包，并解压到服务器相关目录
+### 检查进程端口
 
-```shell
-mkdir /software
-tar -zxvf openjdkXXX.tar.gz /software/
+通过`netstat`命令，检查各子系统进程的端口监听情况。
+
+检查方法如下，若无输出，则代表进程端口监听异常，需要到该子系统的日志中[检查日志错误信息](#checklog)，并根据错误提示或本文档的[常见问题](#q&a)进行排查
+
+- 检查后端server端口(默认为5101)是否已监听
+
+```
+$ netstat -anlp | grep 5101
 ```
 
-#### ② 配置环境变量
+输出如下
 
-- 修改/etc/profile
+```
+tcp        0      0 0.0.0.0:5101            0.0.0.0:*               LISTEN      91851/java
+```
+
+- 检查前端端口(默认为5100)在nginx是否已监听
 
 ```
-sudo vi /etc/profile
+$ netstat -anlp | grep 5100
 ```
 
-- 在/etc/profile末尾添加以下信息
+输出如下
 
-```shell
-JAVA_HOME=/software/jdk-11
-PATH=$PATH:$JAVA_HOME/bin
-CLASSPATH==.:$JAVA_HOME/lib
-export JAVA_HOME CLASSPATH PATH
 ```
+tcp        0      0 0.0.0.0:5100            0.0.0.0:*               LISTEN      112543/nginx: maste 
+```
+
+<span id="checklog"></span>
+
+### 检查服务日志 
+
+<span id="logpath"></span>
+
+#### 日志路径如下：
+
+```
+部署日志：log/
+后端日志：server/log/
+前端日志：web/log/
+```
+
+#### 检查服务日志有无错误信息
+
+- 如果各个子服务的进程**已启用**且端口**已监听**，可直接访问下一章节[访问](#access)
+
+- 如果上述检查步骤出现异常，如检查不到进程或端口监听，则需要按[日志路径](#logpath)进入**异常子服务**的日志目录，检查该服务的日志
 
-- 重载/etc/profile
+
+启动失败或无法使用时，欢迎到`区块链浏览器`[提交Issue](https://github.com/FISCO-BCOS/fisco-bcos-browser/issues)或到技术社区共同探讨。
+
+- 提交Issue或讨论问题时，可以在issue中配上自己的**环境配置，操作步骤，错误现象，错误日志**等信息，方便社区用户快速定位问题
+
+<span id="access"></span>
+
+## 6.访问
+
+例如：在浏览器输入以下访问地址，IP为部署服务器IP，端口为前端服务端口
 
 ```
-source /etc/profile
+http://127.0.0.1:5100/
 ```
 
-#### ③ 查看版本
+**备注：** 
+
+- 部署服务器IP和前端服务端口需对应修改，网络策略需开通
+- 区块链浏览器使用请查看[使用介绍](../browser.html#id1)
+
+## 7.附录
+
+<span id="jdk"></span>
+
+### 7.1 Java环境部署
+
+<span id="centosjava"></span>
+
+#### CentOS环境安装Java
+
+**注意：CentOS下OpenJDK无法正常工作，需要安装OracleJDK[下载链接](https://www.oracle.com/technetwork/java/javase/downloads/index.html)。**
 
 ```
+# 创建新的文件夹，安装Java 8或以上的版本，推荐JDK8-JDK13版本，将下载的jdk放在software目录
+# 从Oracle官网(https://www.oracle.com/technetwork/java/javase/downloads/index.html)选择Java 8或以上的版本下载，例如下载jdk-8u201-linux-x64.tar.gz
+$ mkdir /software
+
+# 解压jdk
+$ tar -zxvf jdk-8u201-linux-x64.tar.gz
+
+# 配置Java环境，编辑/etc/profile文件
+$ vim /etc/profile
+
+# 打开以后将下面三句输入到文件里面并保存退出
+export JAVA_HOME=/software/jdk-8u201  #这是一个文件目录，非文件
+export PATH=$JAVA_HOME/bin:$PATH
+export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
+
+# 生效profile
+$ source /etc/profile
+
+# 查询Java版本，出现的版本是自己下载的版本，则安装成功。
 java -version
 ```
 
+<span id="ubuntujava"></span>
+
+#### Ubuntu环境安装Java
+
+```
+  # 安装默认Java版本(Java 8或以上)
+  sudo apt install -y default-jdk
+  # 查询Java版本
+  java -version
+```
+
+<span id="mysql"></span>
+
 ### 7.2. 数据库部署
 
 此处以Centos安装*MariaDB*为例。*MariaDB*数据库是 MySQL 的一个分支，主要由开源社区在维护，采用 GPL 授权许可。*MariaDB*完全兼容 MySQL，包括API和命令行。其他安装方式请参考[MySQL官网](https://dev.mysql.com/downloads/mysql/)。
@@ -288,11 +383,11 @@ mysql -utest -p123456 -h localhost -P 3306
 mysql > create database db_browser;
 ```
 
-### 7.3. Python部署
-
 <span id="python3"></span>
 
-python版本要求使用python3.x, 推荐使用python3.5及以上版本
+### 7.3. Python部署
+
+python版本要求使用python3.x, 推荐使用python3.6及以上版本
 
 - CentOS
 
@@ -311,6 +406,8 @@ python版本要求使用python3.x, 推荐使用python3.5及以上版本
   sudo apt-get install -y python3-pip
   ```
 
+<span id="q&a"></span>
+
 ## 8.常见问题
 
 ### 8.1 数据库安装后登录报错
@@ -354,7 +451,7 @@ File "/home/ubuntu/webase-deploy/comm/utils.py", line 127, in getCommProperties
 TypeError: get() got an unexpected keyword argument 'fallback'
 ```
 
-答：检查[Python版本](#checkpy)，推荐使用python3.5及以上版本
+答：检查[Python版本](#checkpy)，推荐使用python3.6及以上版本
 
 ### 8.3 使用Python3时找不到pymysql
 
@@ -364,7 +461,7 @@ Traceback (most recent call last):
 ImportError: No module named 'pymysql'
 ```
 
-答：需要安装PyMySQL，安装请参看 [pymysql](#pymysql-python3-5)
+答：需要安装PyMySQL，安装请参看 [pymysql](#pymysql)
 
 ### 8.4 部署时数据库访问报错