O2OA使用手册
第1章 功能简介及概述
第6章 平台部署与配置
  • 6.1 安装部署-在Windows系统中部署O2OA开发平台
  • 6.2 安装部署-在Linux系统中部署O2OA开发平台
  • 6.3 安装部署-在宝塔/PHPStudy中部署O2OA开发平台
  • 6.4 安装部署-O2OA开发平台之HTTP端口规划
  • 6.5 安装部署-平台服务器版本升级操作说明
  • 6.6 安装部署-私有化部署服务器架构推荐
  • 6.7 安装部署-O2OA开发平台集群部署配置及操作说明
  • 6.8 安装部署-在线部署自定义应用的WAR包和JAR包
  • 6.9 服务器配置与管理-​O2OA主要配置文件说明
  • 6.10 服务器配置与管理-服务器端口冲突和端口修改
  • 6.11 服务器配置与管理-如何修改服务器内存占用率?
  • 6.12 服务器配置与管理-如何访问和操作H2内置数据库
  • 6.13 服务器配置与管理-​如何在O2OA中使用MySQL数据库?
  • 6.14 服务器配置与管理-如何修改平台支持的数据库驱动包
  • 6.15 服务器配置与管理-O2OA使用openGauss(华为高斯数据库)配置
  • 6.16 服务器配置与管理-O2OA开发平台平台数据库配置信息样例
  • 6.17 服务器配置与管理-配置O2OA服务器连接O2云
  • 6.18 服务器配置与管理-O2OA实现服务器随操作系统自动启动
  • 6.19 服务器配置与管理-文件存储服务器配置
  • 6.20 服务器配置与管理-工作日节假日配置
  • 6.21 服务器配置与管理-为平台增加全文检索功能
  • 6.22 服务器配置与管理-消息提醒配置说明
  • 6.23 服务器配置与管理-自定义消息提醒
  • 6.24 服务器配置与管理-定制消息通知的内容
  • 6.25 服务器配置与管理-消息通知过滤
  • 6.26 服务器配置与管理-为待办创建配置邮件通知
  • 6.27 服务器配置与管理-待办待阅数据的查询操作和管理
  • 6.28 服务器配置与管理-​自动执行平台数据的备份与恢复
  • 6.29 服务器配置与管理-数据导出导入与系统数据备份
  • 6.30 ​服务器配置与管理-定期自动执行数据备份与恢复
  • 6.31 系统安全-O2OA作为认证中心实现基于OAUTH2单点认证
  • 6.32 系统安全-O2OA基于Nginx的SSL跳转、转发配置
  • 6.33 O2OA(翱途)开发平台如何基于nginx上下文分发的方式快速集群部署
  • 6.34 系统安全-访问日志相关配置
  • 6.35 系统架构-平台集群化部署之基于Nginx端口分发机制实现集群部署
  • 6.36 系统安全-审计日志相关配置
  • 6.37 系统安全-平台日志文件说明
  • 6.38 系统架构-基于nginx快速集群部署-上下文分发
  • 6.39 系统安全-O2OA日志输出设置log4j2.xml
  • 6.40 系统安全-用户密码初始化规则的设定
  • 6.41 系统安全-启用HTTPS(百度云版)
  • 6.42 系统安全-启用HTTPS(腾讯云版)
  • 6.43 系统安全-自签名SSL证书验证HTTPS功能
  • 6.44 系统安全-登录密码RSA加密
  • 6.45 系统安全-用户登录IP限制
  • 6.46 系统安全-在用户登录过程中启用图形验证码
  • 6.47 系统安全-平台部署之使用非root用户运行服务
  • 6.48 系统安全-O2Server启用国密加密设置
  • 6.49 系统安全-日志应用使用说明
  • 6.50 系统安全-用户重置密码操作
  • 6.51 系统安全-超级管理员(xadmin)密码修改
  • 6.52 系统安全-使用Web端运行服务器管理命令
  • 6.53 系统安全-o2server无法正常显示验证码解决办法
  • 6.54 O2OA(翱途)开发平台前端安全配置建议(一)
  • 第16章 开发知识及常见问题
  • 16.1 常见问题-SQLServer中创建新数据库使用哪个中文编码?
  • 16.2 如何替换登录页面二维码中默认的logo图标
  • 16.3 O2OA(翱途)流程引擎中如何修改,定制流程的流转记录
  • 16.4 mysql数据库备份
  • 16.5 domain不正确的时候如何强制设置成正确的
  • 16.6 配置文件中使用密文存储密码
  • 16.7 常见问题-连接MySQL出现 Public Key Retrieval is not allowed 的错误
  • 16.8 常见问题-查看表结构
  • 16.9 常见问题-7.2及以上版本开启web代理后请求中没有正确使用web端口问题解决方式
  • 16.10 linux环境libreoffice安装及使用
  • 16.11 在O2OA中使用网络会议(二):Openmeetings与O2OA认证配置
  • 16.12 在O2OA中使用网络会议(一):Openmeetings-5.1.0亲手安装整理 Step-By-Step
  • 16.13 藕粉社区问答系列1
  • 16.14 藕粉社区问答系列2
  • 16.15 藕粉社区问答系列3
  • 16.16 快速入门-平台相关资料汇总
  • 16.17 快速入门-服务器总体介绍汇总
  • 16.18 快速入门-流程表单载入基础数据
  • 16.19 快速入门-常用表单脚本样例汇总
  • 16.20 快速入门-自定义表数据分页样例
  • 16.21 OEM白标-如何修改平台中的Logo图标和文字
  • 16.22 云服务器-阿里云ECS服务器的端口启用
  • 16.23 开发知识-React篇:在O2OA平台框架中使用React
  • 16.24 开发知识-React篇:在O2OA门户页面中使用React
  • 16.25 开发知识-Vue篇:在Vue应用中集成O2OA
  • 16.26 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 16.27 开发知识-Vue篇:在O2门户页面中使用Vue
  • 16.28 平台中使用Druid数据库连接及监控
  • 16.29 开发知识-在PAAS平台上部署O2OA开发平台
  • 16.30 开发知识-如何使用Tomcat架设webdav服务器
  • 16.31 开发知识-单个端口模式的Nginx和系统配置
  • 16.32 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 16.33 开发知识-O2OA平台启用Eruda进行移动端调试
  • 16.34 开发知识-神通数据库安装
  • 16.35 开发知识-人大金仓数据安装
  • 16.36 开发知识-中标麒麟安装达梦数据库(DM8)
  • 16.37 开发知识-中标麒麟安装人大金仓详细步骤
  • 16.38 开发知识-使用VNC连接中标麒麟V7操作系统
  • 16.39 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 16.40 开发知识-数据优化知识点
  • 16.41 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 16.42 消息队列-配置activeMQ、kafka消息队列
  • 16.43 常见问题-数据导出或者导入时发生OOM异常
  • 16.44 常见问题-如何让用户在首次登录时,必须对初始密码进行修改
  • 16.45 常见问题-如何在模块部署中控制模块的访问权限
  • 16.46 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 16.47 常见问题-如何使用服务管理调用WebService
  • 16.48 常见问题-如何使用脚本调用外部服务
  • 16.49 常见问题-如何使用脚本控制流程自动流转
  • 16.50 常见问题-如何通过脚本调用系统内服务
  • 16.51 常见问题-接口代码疑惑解答汇总
  • 16.52 常见问题:Maven编译o2server错误: Java Heap Space
  • 16.53 常见问题-集群配置后启动报错:NullPointerException
  • 16.54 常见问题-服务器错误:can not decrypt token
  • 16.55 常见问题-IOS移动办公无法收到验证码
  • 16.56 常见问题-服务器和日志时间相差12小时的问题
  • 16.57 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 16.58 藕粉社区问答系列4
  • 16.59 开发知识-React篇:在React应用中集成O2OA

  • 服务器下载及私有云部署

    时间:2022-08-03   

    本篇主要简要描述从官网下载服务器,进行部署,启动的过程,并且描述在部署过程中常见的问题与报错以及云服务器安全策略配置和O2OA服务器端口修改的方式。使用华为云+麒麟操作系统部署的详细文档请见《华为云服务器部署O2OA-麒麟操作系统》


    O2OA部署的服务器要求不高,一般使用4C8G以上的服务器均可正常运行。


    一、检查芯片架构

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


    Windows服务器:

    Windows操作系统直接使用systeminfo命令或者其他CPU信息查看的软件即可确定CPU芯片架构,一般是x86或者arm芯片。


    Linux服务器:

    执行命令:arch


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

    如果是X86_64      下载 Linux

    如果是ARM          下载 ARM

    如果是mips64      下载MIPS

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

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

    image.png

    O2OA支持windows/linux/macos/aix操作系统,下载相应的安装包版本。这里以Windows系统为例:

    下载安装包并且解压到目录

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

    2) 解压下载后的压缩包到任意目录(注意:为了避免JVM异常,按照JAVA开发规范,请避免使用有中文目录和空格的目录名),如下图所示:

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

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

    如果作为正式环境使用,建议您使用拥有更高性能并且更加稳定的商用级别数据库。

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


    启动o2server服务器

    打开o2server文件夹,选择start_windows.bat双击打开(如有必要,请使用管理员身份打开start_windows.bat),命令提示窗口如下图所示:


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


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


    可以修改服务器端口设置后,再重新启动服务器:


    初始化o2server服务器

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

    1)初始化管理员(xadmin)密码,如下图所示界面:

    请注意:

    O2OA V8.1之后,系统将不存在默认密码,新设置的管理员密码请一定牢记(写到小本本上)。

    由于权限过大,管理员密码丢失之后将无法找回。


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


    在此界面,可以选择H2内置数据库,也可以使用其他的数据库,O2OA可以支持的数据库有很多,不限于系统所展现出来的这些。

    如果选择MySQL数据库,则可以填写数据库连接字符串(可以百度一下MySQL的数据库连接信息),如下图所示:

    数据库信息设置完成之后,点击“下一步”进行数据初始化工作,如下图所示:

    O2OA V8.1支持在启动过程中恢复之前系统备份出来的数据,这样在系统启动完成之后,系统将包含所恢复的数据内容。(在此处略过数据恢复的操作过程,以后再其他文档里进行相关说明)。如果没有需要恢复的数据,可以点击“下一步”,系统会给出初始化信息总结,如下图所示:


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

    服务器初始化完成,如下图所示:

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

    使用管理员账号登录系统(账号:xadmin,密码:自定义的密码),如下图所示:

    至此,O2OA的部署工作已经完成,用户可以使用服务器IP地址(加端口)号来访问O2OA系统


    三、常见的启动报错

    1、中文目录报错

    image.png

    Java虚拟机(JVM)不允许在含有中文和空格的目录下运行,请将o2server放置到不含有中文和空格的文件夹内后再运行。如:d:/o2server


    2、内存不足

    image.png

    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使用内存的大小后即可解决该问题。

    image.png

    注意,服务器物理内存不代表JVM可使用的内存空间,很有可能已经被其他应用占用了内存导致JVM内存不足。

    linux可以使用top命令来监控内存使用情况:

    image.png

    Windows可以使用任务管理器来查看内存使用情况:

    image.png


    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......

    image.png

    解决方式有两种:

    一、查询端口占用情况,结束占用该端口的应用程序

    二、修改服务器端口配置

    a. 查询端口占用情况及结束占用端口的应用程序

    (1)首先查询端口监听程序所在的进程号(PID),即打开命令提示符,使用命令:netstat-aon|findstr "80",如下图:

    1595557504498-57cccc44-8069-4247-b002-a93f5844ef28.png

    1595557483188-f2eb1cb9-deb9-494c-86c0-642761a62195.png

    (2)在Windows任务栏上使用右键(或者快捷键CTRL+SHIFT+ESC)打开任务管理器,在详细栏里,根据  PID将所有的应用程序排序,之后找到2744对应的应用程序,如下图:

    1595557543257-613c311e-7d09-4620-9c2a-131dee0cd056.png

    关闭相应的应用程序,或者直接右键结束任务即可。也可以根据实际情况对相应的应用程序做出处理。


    b. 修改服务器端口配置

    O2OA服务器端口配置文件所在位置:o2server/config/node_127.0.0.1.json, 如果目录里没有该文件

    可以从configSample目录里COPY一个到config目录下。如果没有config目录,可以新建一个。如下图:

    1595557682215-0fed6f93-6115-4cbb-94f1-af4477067130.png

    打开o2server/config/node_127.0.0.1.json文件,找到web配置,将端口80修改为其他未占用的端口即可,如下图:

    1680832142807367.png

    修改完成后,重新启动服务器即可(即双击start_windows.bat)。


    启动完成,访问服务

    当出现如下图信息时,表示安装完毕,可通过本地服务器

    http://127.0.0.1或者http://localhost (如果在服务器上部署,可使用服务器IP进行访问)

    web server is started in the application server.
    port:80
    ***********************************

    image.png

    关于服务器防火墙

    在服务器上启动完成后,请配置防火墙,使服务器的80、20020、20030端口可以被访问,或者关闭防火墙。不然服务器可能仍然无法正常访问到。

    如果是Redhat或者CentOS操作系统,可以使用以下命令关闭服务器防火墙。

    关闭防火墙
    systemctl stop firewalld

    禁用防火墙
    systemctl disable firewalld


    关于云服务器安全策略配置

    如果使用的是阿里云和华为云主机,请参考以下文章完成服务器安全策略配置:

    使用华为弹性云服务器部署O2OA V5

    阿里云ECS服务器的端口启用

    温馨提示:为了保障信息安全,安装部署后建议修改xadmin的默认密码。