WorkPlus SE专业版部署说明
1. 环境准备
1.1 硬件环境
最低配置如下：
- CPU >= 8核
- 内存 >= 16G（用于正式环境建议32G以上）
- 磁盘 >= 50GB（用于正式环境建议1TB以上）
1.2 操作系统
目前支持以下Linux操作系统版本：
- CentOS 7 / 8
- Debian 10 / 11
- Ubuntu 20.04 / 22.04
- Fedora 36 / 37
- OpenCloudOS 8.5 / 8.6
- TencentOS Server 2.4 / 3.1
Tips：图形包不建议安装，时区选择上海时区
1.3 网络环境及要求
重要！！！防火墙不能关闭，影响docker端口转发。
重要！！！如需手机等设备外网访问，请将下列端口映射到外网。
WorkPlus SE专业版目前使用到以下端口：
- 8020 转发协议TCP
- 8021 转发协议TCP
- 9000 转发协议TCP
- 9001 转发协议TCP
- 8000 转发协议TCP
2. 安装部署
目前WorkPlus SE专业版以Docker方式安装部署。
2.1 Docker安装
WorkPlus SE专业版安装脚本会自动安装最新的Docker社区版，如果您对Docker版本有特殊需求，可查阅Docker文档自行安装。
2.2 服务安装
在准备工作完成后，可通过执行以下脚本安装WorkPlus SE专业版：
2.2.1 在线部署方式
/bin/bash -c "$(curl -fsSL https://get.workplus.io/install-se.sh)"
2.2.2 离线部署方式
1.下载离线资源并上传到服务器任意目录（仅适用于CentOS 7.9操作系统）
https://get.workplus.io/docker/docker-ce-20.10.21-3.el7.x86_64.tar.gz
https://get.workplus.io/docker/workplus-se-pro-5.2.0.tar.gz
https://get.workplus.io/docker/workplus-db-5.2.0.tar.gz
https://get.workplus.io/docker/workplus-env.tar.gz
https://get.workplus.io/docker/import-images.sh
https://get.workplus.io/install-se.sh
2.解压离线资源(必须解压到/opt目录)
tar xf docker-ce-20.10.21-3.el7.x86_64.tar.gz -C /opt/
tar xf workplus-se-pro-5.2.0.tar.gz -C /opt/
tar xf workplus-db-5.2.0.tar.gz -C /opt/
tar xf workplus-env.tar.gz -C /opt/
3.开始安装
yum localinstall -y /opt/docker-ce-20.10.21-3.el7.x86_64/*.rpm
yum localinstall -y /opt/workplus-env/*.rpm
systemctl start docker
systemctl enable docker
/bin/bash import-images.sh install
/bin/bash install-se.sh
脚本安装过程中会提示输入一些关键信息，说明如下：
[This is Important!!!] Enter external hostname or ip for visit WorkPlus, current is 192.168.0.1
输入外部访问HOST，默认为当前机器IP。
重要！！！如果需要外网访问，部署的时候提示输入的IP，需要填写公网IP或域名。
重要！！！如果需要外网访问，部署的时候提示输入的IP，需要填写公网IP或域名。
重要！！！如果需要外网访问，部署的时候提示输入的IP，需要填写公网IP或域名。
选择想要安装的版本，当前最新版本为5.2.0。
然后就等待安装完成，这个过程中使用Docker下载大量镜像，您只需要耐心等候。
见到如下输出，则说明安装完成：
Thank you for installing WorkPlus. Please visit http://192.168.0.1:9000 to initialize WorkPlus. Please use http://192.168.0.1:9001 for building Android, iOS, PC clients. In case you have any questions contact us via 400-966-9672 or visit at https://www.workplus.io
2.3 服务与镜像
安装完成后，会有以下服务：
| 容器名 | 容器镜像 | 说明 |
|---|---|---|
| wp-server | workplus/se-server:5.2.0 | 核心服务，监听8020/8021 |
| wp-http | workplus/se-http:5.2.0 | API服务，监听9001 |
| wp-dash | workplus/se-dash:5.2.0 | 后台服务，监听9000 |
| app-bpm | workapps/app-bpm:2.6.3 | 流程大师 |
| app-form | workapps/app-form:2.6.3 | 智能表单 |
| app-html | workapps/app-html:2.6.3 | 流程大师/智能表单前端服务，监听8000 |
| db-mongo | workdbs/mongo:4.2 | MongoDB服务 |
| db-mysql | workdbs/mysql:8.0 | MySQL服务 |
| db-redis | workdbs/redis:5.0.7 | Redis服务 |
镜像版本可能会有所不同
2.3.1 服务管理
可通过以下方式，启动/停止服务：
docker [start|stop|restart] 容器名
2.3.2 服务日志
可通过以下方式，查看服务日志：
docker logs -f 容器名
2.4 数据维护
所有相关服务数据都映射在本机的/app目录下：
| 目录 | 说明 |
|---|---|
| /home/workplus/mongo | MongoDB数据目录 |
| /home/workplus/mysql | MySQL数据目录 |
| /home/workplus/redis | Redis数据目录 |
| /home/workplus/fdfs | 文件存储目录 |
| /home/workplus/bpm | 流程大师存储目录 |
| /home/workplus/form | 智能表单存储目录 |
2.4.1 MongoDB维护
- MongoDB Shell
docker exec -ti db-mongo sh -c 'exec mongo -u "$MONGO_INITDB_ROOT_USERNAME" -p "$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase "admin"'
- 数据备份
docker exec db-mongo sh -c 'exec mongodump -d workplus -u "$MONGO_INITDB_ROOT_USERNAME" -p "$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase "admin" --archive' > 备份文件
2.4.2 MySQL维护
- MySQL Shell
docker exec -ti db-mysql sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD"'
- 数据备份
docker exec db-mysql sh -c 'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' > 备份文件
3. 初始化
安装完成后需进行初始化方可使用，初始化会向WorkPlus SE专业版官方申请到一个免费的License。
初始化，需要填写一些手机号，创建新的域及组织。
免费的License为20人，有效期1年，可免费续期（若无法在线激活，可联系客服提供离线License手动导入）。
你可以联系商务申请更高人数License。
4. 开始体验
完成上述步骤后，你可以开始访问http://ip:9000/来登录域管理帐号或组织管理帐号，使用WorkPlus SE专业版后台。
5.常用命令
- 进入数据库
docker exec -ti db-mysql sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD"'
- 清除雇员限制
use workplus;
truncate table org_quotas;
- 清除Redis缓存
docker exec -ti db-redis sh -c 'redis-cli'
flushall