一键部署¶
标签：区块链浏览器 部署
本文档试用于v2.1.0及之后版本一键部署。v2.1.0之前版本一键部署可参考文档。
1.前提条件¶
| 环境 | 版本 |
|---|---|
| Java | JDK8或以上版本 |
| MySQL | MySQL-5.6或以上版本 |
| Python | Python3.5+ |
| PyMySQL | 使用python3时需安装 |
检查环境¶
平台要求¶
推荐使用CentOS 7.2+, Ubuntu 16.04及以上版本, 一键部署脚本将自动安装openssl, curl, wget, git, nginx相关依赖项。
其余系统可能导致安装依赖失败，可自行安装openssl, curl, wget, git, nginx依赖项后重试
PyMySQL部署（Python3.5+）¶
Python3.5及以上版本，需安装PyMysql依赖包：
CentOS
sudo yum -y install python36-pip sudo pip3 install PyMySQL
Ubuntu
sudo apt-get install -y python3-pip sudo pip3 install PyMySQL
CentOS或Ubuntu不支持pip命令的话，可以使用以下方式：
git clone https://github.com/PyMySQL/PyMySQL
cd PyMySQL/
python3 setup.py install
2.拉取安装脚本¶
获取部署安装包：
wget https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/fisco-bcos-browser/releases/download/v2.2.2/browser-deploy.zip
解压安装包：
unzip browser-deploy.zip
进入目录：
cd browser-deploy
3.修改配置（没有变化的可以不修改）¶
① 可以使用以下命令修改，也可以直接修改文件（vi common.properties）
② 数据库需要提前安装（数据库安装请参看 数据库部署）
③ 服务端口不能小于1024
数据库IP：sed -i "s/127.0.0.1/${your_db_ip}/g" common.properties
数据库端口：sed -i "s/3306/${your_db_port}/g" common.properties
数据库用户名：sed -i "s/dbUsername/${your_db_account}/g" common.properties
数据库密码：sed -i "s/dbPassword/${your_db_password}/g" common.properties
数据库名称：sed -i "s/db_browser/${your_db_name}/g" common.properties
前端服务端口：sed -i "s/5100/${your_web_port}/g" common.properties
后端服务端口：sed -i "s/5101/${your_server_port}/g" common.properties
例子（将数据库IP由127.0.0.1改为0.0.0.0）：sed -i "s/127.0.0.1/0.0.0.0/g" application.yml
4.部署¶
部署所有服务：
python3 deploy.py installAll
停止所有服务：
python3 deploy.py stopAll
启动所有服务：
python3 deploy.py startAll
单独启停命令和说明可查看帮助：
python3 deploy.py help
备注： 部署过程出现问题可以查看 常见问题
6.日志路径¶
部署日志：log/
后端日志：server/log/
前端日志：web/log/
7.附录¶
7.1 Java环境部署¶
此处给出OpenJDK安装简单步骤，供快速查阅。更详细的步骤，请参考官网。
② 配置环境变量¶
- 修改/etc/profile
sudo vi /etc/profile
- 在/etc/profile末尾添加以下信息
JAVA_HOME=/software/jdk-11
PATH=$PATH:$JAVA_HOME/bin
CLASSPATH==.:$JAVA_HOME/lib
export JAVA_HOME CLASSPATH PATH
- 重载/etc/profile
source /etc/profile
③ 查看版本¶
java -version
7.2. 数据库部署¶
此处以Centos安装MariaDB为例。MariaDB数据库是 MySQL 的一个分支，主要由开源社区在维护，采用 GPL 授权许可。MariaDB完全兼容 MySQL，包括API和命令行。其他安装方式请参考MySQL官网。
① 安装MariaDB¶
- 安装命令
sudo yum install -y mariadb*
- 启停
启动：sudo systemctl start mariadb.service
停止：sudo systemctl stop mariadb.service
- 设置开机启动
sudo systemctl enable mariadb.service
- 初始化
执行以下命令：
sudo mysql_secure_installation
以下根据提示输入：
Enter current password for root (enter for none):<–初次运行直接回车
Set root password? [Y/n] <– 是否设置root用户密码，输入y并回车或直接回车
New password: <– 设置root用户的密码
Re-enter new password: <– 再输入一次你设置的密码
Remove anonymous users? [Y/n] <– 是否删除匿名用户，回车
Disallow root login remotely? [Y/n] <–是否禁止root远程登录，回车
Remove test database and access to it? [Y/n] <– 是否删除test数据库，回车
Reload privilege tables now? [Y/n] <– 是否重新加载权限表，回车
② 授权访问和添加用户¶
- 使用root用户登录，密码为初始化设置的密码
mysql -uroot -p -h localhost -P 3306
- 授权root用户远程访问
mysql > GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '123456' WITH GRANT OPTION;
mysql > flush PRIVILEGES;
- 创建test用户并授权本地访问
mysql > GRANT ALL PRIVILEGES ON *.* TO 'test'@localhost IDENTIFIED BY '123456' WITH GRANT OPTION;
mysql > flush PRIVILEGES;
安全温馨提示：
- 例子中给出的数据库密码（123456）仅为样例，强烈建议设置成复杂密码
- 例子中root用户的远程授权设置会使数据库在所有网络上都可以访问，请按具体的网络拓扑和权限控制情况，设置网络和权限帐号
③ 测试连接和创建数据库¶
- 登录数据库
mysql -utest -p123456 -h localhost -P 3306
- 创建数据库
mysql > create database db_browser;
7.3. Python部署¶
python版本要求使用python3.x, 推荐使用python3.5及以上版本
CentOS
sudo yum install -y python36 sudo yum install -y python36-pip
Ubuntu
// 添加仓库，回车继续 sudo add-apt-repository ppa:deadsnakes/ppa // 安装python 3.6 sudo apt-get install -y python3.6 sudo apt-get install -y python3-pip
8.常见问题¶
8.1 数据库安装后登录报错¶
腾讯云centos mysql安装完成后，登录报错：Access denied for user ‘root’@’localhost’
① 编辑 /etc/my.cnf ，在[mysqld] 部分最后添加一行
skip-grant-tables
② 保存后重启mysql
service mysqld restart
③ 输入以下命令，回车后输入密码再回车登录mysql
mysql -uroot -p mysql
8.2. Python命令出错¶
- SyntaxError报错
File "deploy.py", line 62
print helpMsg
^
SyntaxError: Missing parentheses in call to "print". Did you mean print(helpMsg)?
- 找不到fallback关键字
File "/home/ubuntu/webase-deploy/comm/utils.py", line 127, in getCommProperties
value = cf.get('common', paramsKey,fallback=None)
TypeError: get() got an unexpected keyword argument 'fallback'
答：检查Python版本，推荐使用python3.5及以上版本
8.3 使用Python3时找不到pymysql¶
Traceback (most recent call last):
...
ImportError: No module named 'pymysql'
答：需要安装PyMySQL，安装请参看 pymysql
8.4 部署时数据库访问报错¶
...
checking database connection
Traceback (most recent call last):
File "/data/temp/browser/fisco-bcos-browser/deploy/comm/mysql.py", line 21, in dbConnect
conn = mdb.connect(host=mysql_ip, port=mysql_port, user=mysql_user, passwd=mysql_password, charset='utf8')
OperationalError: (1045, "Access denied for user 'root'@'localhost' (using password: YES)")
答：确认数据库用户名和密码
8.5 Server启动失败¶
答：1: 请检查是否设置了JAVA_HOME。 2: 检查gradle版本是否在5.0以上。 3: 检查jdk版本，如果使用的是jdk9或者更高版本，需要在项目启动时加入 –add-modules java.xml.bind 后缀，但是这种方法只能在JDK9或者10去使用。修改位置：server/start.sh文件，start()函数，nohub $JAVA_HOME/bin/java 语句之后加上 –add-modules java.xml.bind
8.6 server启动成功，但提示启动失败¶
答：将openjdk换成oracle jdk，因为openjdk中缺少一些组件。