系统安装-如何安装部署O2OA 平台?
本篇按先决条件、架构核对、下载部署、初始化与排错的顺序，讲清 O2OA 平台在自有服务器上的安装全过程。文中给出最低配置建议与支持的操作系统范围，强调目录名不能含中文和空格，也说明内置库与外部库的选择差异。常见故障集中在内存不足、默认端口被占用和防火墙未放行，可按文中命令定位进程并改配置端口，云主机还需放通安全组。初始化结束后建议尽快更换管理员口令。
本篇简要描述从官网下载服务器、进行部署与启动的流程，并说明部署过程中常见的问题与报错、云服务器安全策略配置，以及 O2OA 平台服务器端口的修改方式。
O2OA 平台的服务器部署要求不高，通常使用 4C8G 以上的服务器均可正常运行。O2OA 的安装过程非常简单，并不需要预先准备 Java 运行环境、中间件等环境，服务器只需要安装好操作系统即可完成最小化部署。平台安装部署的相关内容还可参考下文。
一、先决条件
1、服务器配置：CPU4核以上，预留内存 4G 以上，硬盘 10G 以上，建议使用 SSD 或其他高速硬盘；
2、已安装好操作系统。支持 WindowsServer、Linux（Radhat、Ubuntu、CentOS 等）、麒麟 V7+、统信 UOS 等操作系统。
二、检查芯片架构
由于不同的芯片架构所支持的 JVM 不一样，所以在下载安装程序之前，需要先确认需要部署的目标服务器的芯片架构。
Windows 服务器：
在 Windows 操作系统上，使用 systeminfo 命令或者其他 CPU 信息查看软件，即可确定 CPU 芯片架构，一般是 x86 或者 arm 芯片。
Linux 服务器：
执行命令：arch
根据服务器芯片架构选择合适的 O2OA 服务器版本进行下载
如果为 X86_64 下载 Linux 版
如果为 ARM 下载 ARM 版
如果为 mips64 下载 MIPS 版
三、服务器安装包下载及部署
访问O2OA 官方网站，在网站顶部导航里点击“获取产品”，进入 O2OA 官方服务器下载界面，如下图所示：
点击“服务器下载”
O2OA 支持 windows/linux/macos/aix 操作系统，下载对应的安装包版本。
以下以 Windows 系统为例：
1) 下载 windows x86 对应程序包。
2) 将下载的压缩包解压到任意目录（注意：根据 Java 应用规范，请勿使用含中文和空格的目录名，建议直接使用某盘的根目录）
3) 为确保服务器能正常启动，请确认服务器的 80 端口未被占用；如果使用云服务器，请确认端口可以被访问（注意：需已加入到安全控制策略，或者防火墙允许以上端口被访问）
4) 打开 o2server 文件夹，选择 start_windows.bat 双击运行（如有必要，请以管理员身份运行 start_windows.bat），如下图所示：
四、初始化 o2server 服务器
打开 o2server 文件夹，选择 start_windows.bat 双击运行（如有必要，请以管理员身份运行 start_windows.bat），命令提示窗口如下图所示：
启动完成后可通过本地服务器 http://127.0.0.1或者http://localhost 登陆O2OA平台，如果在服务器上部署，可使用服务器IP进行访问。如果没有修改过端口，控制台给出的初始化地址端口应该为80。另外，如果控制台给出的IP不正确，请在服务器上使用本地服务访问的方式尝试初始化，如：
在浏览器中访问如下地址：
（请勿关闭启动服务器的命令窗口，关闭窗口即代表服务器停止）
使用控制台给出的服务器初始化地址，访问服务器初始化页面。
1）初始化管理员（xadmin）密码，如下图所示界面：
请注意：
O2OA V8.1 之后，系统将不再存在默认密码，新设置的管理员密码请一定牢记（写到小本本上）。
由于管理员权限过大，密码丢失后将无法找回。
输入管理员密码并确认后，点击“下一步”，开始设置系统连接的数据库，如下图所示：
在此界面可以选择 H2 内置数据库，也可以使用其他数据库；O2OA 支持的数据库种类很多，不限于系统所列出的这些。
如果选择 MySQL 数据库，则可以填写数据库连接字符串（可自行百度 MySQL 的数据库连接信息），如下图所示：
数据库信息设置完成后，点击“下一步”开始数据初始化工作，如下图所示：
O2OA V8.1 支持在启动过程中恢复此前系统备份的数据，系统启动完成后将包含所恢复的数据内容。（此处略去数据恢复的操作过程，后续将在其他文档中说明）。如果没有需要恢复的数据，可点击“下一步”，系统会给出初始化信息总结，如下图所示：
确认初始化信息无误后，点击执行，系统将继续启动服务器并完成管理员所选择的初始化内容，直至系统完全启动，如下图所示：
服务器初始化完成，如下图所示：
系统初始化完成后，点击“进入系统登录页面”访问系统，如下图所示：
使用管理员账号登录系统（账号：xadmin，密码：自定义的密码），如下图所示：
返回服务器控制台，可以看到控制台界面如下：
至此，O2OA 的部署工作已完成，用户可通过服务器 IP 地址（加端口号）访问 O2OA 系统。
五、如何停止服务器
方式一：直接在命令窗口输入 stop
方式二：直接关闭命令窗口，进程将被直接结束
六、常见的启动报错
1、中文目录报错
Java 虚拟机（JVM）不允许在含中文和空格的目录下运行，建议将 o2server 目录放置在不含中文和空格的文件夹内后再运行，如：d:/o2server
2、内存不足
com.x.base.core.project.Context - com.x.base.core.project.x_organization_assemble_personal loading datas, entity size:12.
./start_linux.sh: 行 151: 10773 已杀死
setsid ${current_dir}/jvmnux/bin/java -javaagent:${current_dir}/console.jar -server -Djava.awt.headless=true -Xms2g -Xmx4g -Duser.timezone=GMT+08 -XX:+UseG1GC -XX:+HeapDumpOnOutOfMemoryError -jar ${current_dir}/console.jar解决方法：
限制 o2server Java 虚拟机使用的最小或者最大内存，以降低服务器性能来保证 o2server 正常运行。
解决步骤：
使用文本编辑工具（记事本，notepad++ 等）打开 o2server/start_windows.bat 或者 o2server/start_linux.sh，修改最后一行，根据服务器实际空余内存情况设置 JVM 可用内存大小，即可解决该问题。
"%~dp0jvmwindows_java11injava" -javaagent:"%~dp0console.jar" -server -Xms2g -Dnashorn.args=--no-deprecation-warning --add-exports jdk.scripting.nashorn/jdk.nashorn.internal.runtime=ALL-UNNAMED --add-exports jdk.scripting.nashorn/jdk.nashorn.internal.runtime.arrays=ALL-UNNAMED --add-opens java.base/java.lang=ALL-UNNAMED -Duser.timezone=GMT+08 -XX:+HeapDumpOnOutOfMemoryError -jar "%~dp0console.jar"
注意，服务器物理内存并不等于 JVM 可用的内存空间，很可能已被其他应用占用，导致 JVM 内存不足。
linux 可使用 top 命令监控内存使用情况：
Windows 可使用任务管理器查看内存使用情况：
3、服务器端口冲突处理
服务器上很可能已有其他服务占用 80 端口，如 IIS、Apache、Ngnix 等。此时需要修改 O2OA 默认的 Web 服务端口。
出现下图所示错误时，根据 O2OA 的服务启动顺序可发现 20020 端口已绑定完成，说明 web 端口 80 已被占用。
application server start completed. prot:20020 ************************************** java.io.IOException: Failed to bind to 0.0.0.0/0.0.0.0:80 at ort......
解决方式有两种：
一、查询端口占用情况，结束占用该端口的应用程序；二、修改服务器端口配置
a. 查询端口占用情况及结束占用端口的应用程序
(1）首先查询端口监听程序所在的进程号（PID），即打开命令提示符，输入命令：netstat-aon|findstr "80"，如下图：
(2）在 Windows 任务栏上使用右键（或者快捷键 CTRL+SHIFT+ESC）打开任务管理器，在详细栏中根据 PID 将所有应用程序排序，然后找到 2744 对应的应用程序，如下图：
如果任务管理器中未显示如 PID，可以在列表头部右键添加 PID 的显示设置：
关闭相应的应用程序，或直接右键结束任务即可；也可根据实际情况对相应应用程序作出处理。
b. 修改服务器端口配置避免端口冲突
O2OA 服务器端口配置文件所在位置：/o2server/config/node_127.0.0.1.json, 若目录中没有该文件或文件夹，可从 configSample 目录中 COPY 一个到 config 目录下，目录下的配置文件才会生效；若没有 config 目录，可新建一个。如下图：
打开 o2server/config/node_127.0.0.1.json 文件，找到 centerpplicationweb 节点的端口（port）配置，将端口 80 修改为其他未占用的端口即可，如下图：
修改完成后重新启动服务器即可（即双击 start_windows.bat）。
七、关于服务器防火墙
服务器启动完成后，请配置防火墙，使服务器的【80】或指定端口可以被访问，或者关闭防火墙，否则服务器可能仍无法正常访问。
如果是 Redhat 或 CentOS 操作系统，可以使用以下命令关闭服务器防火墙。
关闭防火墙 systemctl stop firewalld 禁用防火墙 systemctl disable firewalld
八、关于云服务器安全策略配置
如果使用的是阿里云和华为云主机，请参考以下文章完成服务器安全策略配置：
在华为 ECS 和麒麟(Kylin)系统部署开源 O2OA 开发平台
温馨提示：为了保障信息安全，安装部署后建议修改 xadmin 的默认密码。教程：《密码管理-超级管理员密码修改》
以上内容概述了 O2OA 平台的安装部署流程与常见问题。
相关问题讨论
「O2OA 企业协同业务开发实战」公开培训今天开播！干货满...
本篇主要简要描述从官网下载服务器，进行部署，启动的过程，并且描述在部署过程中常见的问题与报错以及云服务器安全策略配置和 O2OA 平台服务器端口修改的方式。
查看原帖讨论 · 17,375 次浏览
相关内容
浙公网安备33010602013943号