系统安装-如何安装部署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开发平台安装部署的简要说明，希望对您有帮助。
浙公网安备 33010602009829号