服务器下载及私有云部署-新手体验指引-O2OA企业应用开发平台-人人都是协同系统开发专家

服务器下载及私有云部署

时间：2022-08-03

内容导读

本篇介绍从 O2OA 官网下载服务器并完成私有云部署的完整流程：先确认目标服务器的芯片架构，选择匹配的安装包；随后从官网下载并部署启动，说明常见启动报错的排查处理；启动完成后通过 http://127.0.0.1 或服务器 IP 访问服务；最后介绍防火墙配置（开放 80、20020、20030 端口）与阿里云、华为云等云服务器安全策略的配置参考。操作系统以 Windows 为主。

本篇简要介绍从官网下载服务器并完成部署、启动的过程，同时说明部署过程中常见问题与报错、云服务器安全策略配置及 O2OA 服务器端口修改方式，操作系统以 Windows 为主。使用华为云+麒麟操作系统部署的详细文档请见《华为云服务器部署 O2OA-麒麟操作系统》

O2OA 对服务器配置要求不高，一般 8C16G 以上的服务器即可正常运行。

一、检查芯片架构

因为不同的芯片架构所支持的 JVM 不一样，所以在下载安装程序之前，需要先确认咱们需要部署的目标服务器的芯片架构（可以参考此篇文档《指令集 CPU 架构 x86 x86_64 arm，linux windows 查看 CPU 信息》）

Windows 服务器：在 Windows 操作系统上，直接使用 systeminfo 命令或其他 CPU 信息查看软件即可确定 CPU 芯片架构，一般为 x86 或 arm 芯片。

Linux 服务器：Linux 版本众多，CPU 架构纷繁复杂，建议在下载 O2OA 部署介质前，先确认服务器 CPU 架构，再下载符合要求的安装介质。

执行命令 arch 查询服务器架构，如下图所示：

根据服务器芯片架构下载合适的 O2OA 服务器版本

X86_64：下载 Linux 版
ARM：下载 ARM 版
mips64：下载MIPS版

二、服务器安装包下载及部署

访问O2OA 官方网站，在网站顶部导航里点击平台下载，进入 O2OA 官方服务器下载界面，如下图所示：

O2OA 支持 windows/linux/macos/aix 操作系统，可下载相应的安装包版本。本文后续以 Windows 系统为例说明服务器安装步骤。

1. 下载安装包并解压到目录

1) 下载 o2server_x.x.x_windows.zip 程序包（x.x.x 为版本号）。

2) 将压缩包解压到任意目录（注意：为避免 JVM 异常，按照 JAVA 开发规范，请勿使用含中文或空格的目录名），如下图所示：

O2OA开发平台自带的 H2数据库是一个内嵌式的内存数据库，适合用于开发环境、功能演示环境，并不适合用作正式环境。

访问和操作 H2数据库，请参考文档《系统安装-如何访问和操作 H2内置数据库》。

如作为正式环境使用，建议使用性能更高、更稳定的商用级数据库，如 Mysql8、Oracle12C、SQLServer 2012 等。

另外，O2OA提供数据定期备份和恢复的能力，建议您开启正式环境的数据定期备份的功能，以确保数据库异常时可以进行数据恢复。

2. 启动 o2server 服务器

打开 o2server 文件夹，双击 start_windows.bat 运行（如有必要，请以管理员身份打开），命令提示窗口如下图所示：

为了服务器能正常启动，请确认服务器的80端口未被占用（80端口是服务器默认的 WEB 端口，如果80端口被占用，请修改相应的端口。具体方法请参考：系统配置-服务器端口冲突和端口修改，如果是云服务器的话，请确认以上端口可以被访问（已经加入到安全控制策略，或者防火墙允许以上端口被访问）

如果是需要公网可以访问的话，请确认服务器防火墙，或者云服务器安全策略是否开放端口80入方向的访问权限。云服务器相关安全策略操作请参考：阿里云ECS服务器的端口启用如果80端口被占用，启动服务器时，控制台会给出关于端口被占用的信息提示，如下图所示：

可先修改服务器端口设置，再重新启动服务器：

3. 初始化 o2server 服务器

使用控制台给出的服务器初始化地址，访问服务器初始化页面。

1）初始化管理员（xadmin）密码，界面如下图所示：

请注意：O2OA V8.1之后，系统将不存在默认密码，新设置的管理员密码请一定牢记（建议妥善记录保存）。由于管理员权限过大，密码丢失之后将无法找回。

2）输入并确认管理员密码后，点击“下一步”，开始设置系统连接的数据库，如下图所示：

在此界面可选择 H2 内置数据库，也可使用其他数据库。O2OA 支持的数据库很多，不限于界面中列出的这些。

（请注意：O2OA V10 开始，社区版服务器不支持内置 H2 之外的数据库；如需使用其他数据库，必须使用商用版）

如果选择 MySQL 数据库，则可以填写数据库连接字符串（可以百度一下 MySQL 的数据库连接信息），如下图所示：

3）数据库信息设置完成后，点击“下一步”进行数据初始化，如下图所示：

O2OA 支持在启动过程中恢复之前系统备份的数据，系统启动完成后即包含所恢复的数据内容（此处略过数据恢复的操作过程，将在其他文档中进行相关说明）。

如无需恢复数据，可点击“下一步”，系统将给出初始化信息总结，如下图所示：

4）确认初始化信息无误后，点击执行，系统将继续启动服务器并完成管理员选择的初始化内容，直至全部启动完成，如下图所示：

5）服务器初始化完成，如下图所示：

系统初始化完成后，点击“进入系统登录页面”访问系统，如下图所示：

6）使用管理员账号登录系统（账号：xadmin，密码：自定义密码），如下图所示：

至此，O2OA 的部署工作已完成，用户可通过服务器 IP 地址（加端口号）访问 O2OA 系统。

三、常见启动报错

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

解决方法：

使用文本编辑工具（记事本、notepad++ 等）打开 o2server/start_windows.bat 或 o2server/start_linux.sh，修改最后一行，根据服务器实际空余内存设置 JVM 使用内存的大小即可解决。

注意：服务器物理内存不等于 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......