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

  • 源码编译-O2Server服务器源码编译教程

    时间:2022-08-03   


        

    获取源码

    O2OA是全开源的系统,完整的源码可以免费从gitee或者codechina获取。仓库地址是:

    gitee: https://gitee.com/o2oa/O2OA.git

    codechina: https://codechina.csdn.net/O2OA/o2oa.git


    gitee仓库

    我们打开gitee上的O2OA仓库,可以看到源码:(操作:浏览器打开项目仓库主页)

    (操作:展开分支)

    我们来介绍一下几个主要有的分支:

    develop

    这是主分支,也是我们的开发分支,它有最新的源码,每天都会有大量的提交,最新的功能也会在此分支上。但它没有经过详细的测试,可能会有比较多的bug,适合希望了解O2OA最新更新和希望研究源码的用户,但不建议在生产环境使用它。

    master

    master分支是最新正式发布的O2OA稳定版源码,经过详细测试,编译后可在生产环境使用。

    develop_java8

    O2OA已经升级到java11版本,为了兼容希望坚持使用java8版本的用户,我们创建了此分支,它与develop分支的更新内容保持一致。如果希望O2OA功能保持最新,但又要使用java8的用户,可以使用此分支编译服务器。

    master_java8

    最后发布的java8稳定版,版本6.2.2。不再更新了,需要Java8版本的可以使用

    develop_java8分支。

    如果你需要历史版本的源码,可以切换到对应的tag。(打开标签)

    克隆源码

    建议您先Fork源码到您自己的空间。

    然后进入自己fork的仓库,复制克隆地址:

    首先我们确保我们自己的机器上安装了git工具,如果没有的话:

    windows系统可以到下面的地址下载:https://git-scm.com/download/win

    centos使用命令:

    yum install -y git

    Ubuntu使用命令:

    sudo apt-get install git

    然后我们进入自己机器需要获取源码的目录,启动终端或使用git bash,输入以下命令clone源码:

    git clone https://xxxxx

    红色部分替换为你自己Fork的仓库地址。如:

    git clone https://gitee.com/o2oa/O2OA.git

    clone完成后,就可以看到O2OA的源码目录了。

    编译源码

    获取了源码后,我们就可以将源码编译为可运行的O2OA服务器了。

    准备编译环境

    在编译源码之前,我们需要准备编译环境,O2OA编译需要以下环境:

    Node.js

    编译脚本运行环境,14.0.0以上版本

    (建议使用Node.js v16 LTS, v17及以上版本的可能会报错)

    jdk

    根据您要编译的分支,决定使用JDK8 或者是 JDK11(推荐)

    maven

    3.6及以上版本

    上述环境安装,在此就不赘述了。

    检查当前分支是否是master分支

    环境准备好后,我们打开终端或windows的命令行提示符,进入O2OA源码目录。默认情况先,现在是主分支,就是master分支,通过以下git命令检查分支

    git status

    image.png

    编译

    切换到您需要的分支后,需要先使用npm安装编译脚本所需要的依赖包,使用以下命令安装:(安装过程可能需要几分钟)

    npm install

    如果没有安装过gulp和jsdoc,需要先执行以下命令安装:

    npm install -g gulp-cli
    npm install -g jsdoc

    然后就可以使用以下命令编译了:

    npm run build_ci

    整个编译过程大概需要30分钟。编译完成后,会在目录下生成target/o2server目录,这就是可运行的服务器目录。可以将它拷贝到服务器,运行相应start_xxx命令就可以运行O2OA了。这个等会编译完成后,我们再看。

    编译错误解决

    如果编译的过程中出现下图错误,可通过修改maven源来解决

    b4320ee7d6ad5795ffcb363b88af7332.JPG

    修改maven

    38e9e73236402200f49d59b7ca23bb64.JPG

    <mirror>
          <id>alimaven</id>
          <name>aliyun maven</name>
          <url>https://maven.aliyun.com/repository/central</url>
          <mirrorOf>central</mirrorOf>
        </mirror>

    优化编译

    编译特定操作系统版本的O2OA

    如果我们要编译指定操作系统版本的O2OA,可以使用以下命令:

    方法一:没有下载JVM和依赖包commons

    如果您没有手工下载JVM和依赖包commons,也没有关系,我们可以使用 “build_ci:xxx” 命令:

    推荐是使用此方式编译,这样可以保证编译程序找到合适的commons版本

    #编译windows版本
    npm run build_ci:win
    
    #编译linux x86版本
    npm run build_ci:linux
                    
    #编译aix版本
    npm run build_ci:aix
    
    #编译linux arm版本
    npm run build_ci:arm
    
    #编译windows版本
    npm run build_ci:macos
    
    #编译linux mips版本
    npm run build_ci:mips
    
    #编译树莓派版本
    npm run build_ci:rpi


    编译脚本功能清单

    编译脚本的功能清单如下:

    命令

    运行

    说明

    build_ci

    npm run build_ci

    编译源码,自动下载JVM和依赖包,并构建可以运行在所有支持的操作系统的服务器。

    build_ci:xxx

    npm run build_ci:win

    npm run build_ci:linux

    npm run build_ci:aix

    npm run build_ci:arm

    npm run build_ci:macos

    npm run build_ci:mips

    npm run build_ci:rpi

    编译源码,自动下载指定操作系统环境的JVM和依赖包,并构建可以运行在指定操作系统的服务器。

    build

    npm run build

    预先下载JVM和依赖包,并放到o2server目录,

    编译源码,构建可以运行在所有支持的操作系统的服务器。

    build:xxx

    npm run build:win

    npm run build:linux

    npm run build:aix

    npm run build:arm

    npm run build:macos

    npm run build:mips

    npm run build:rpi

    预先下载JVM和依赖包,并放到o2server目录,

    编译源码,构建可以运行在指定操作系统的服务器。

    build_server

    npm run build_server

    单独编译O2OA服务端

    build_web

    npm run build_web

    单独编译O2OA Web端

    build_api

    npm run build_api

    生成O2OA脚本API文档


    源码文件结构解析

    趁服务器编译的过程,我们简单介绍一下源码文件结构。(打开gitee项目主页)

    更目录下主要文件和目录:

    o2android/

    android端App源码,已经迁移到 https://gitee.com/o2oa/o2oa-android 仓库中

    将在后续App编译课程中详细介绍

    o2ios/

    ios端App源码,已经迁移到 https://gitee.com/o2oa/o2oa-ios 仓库中

    将在后续App编译课程中详细介绍

    o2server/

    服务端源码目录

    o2web/

    Web端源码目录

    Jenkins*

    Jenkins流水线文件,我们在持续发布流程中的流水线文件,

    build.xml

    maven打包文件

    gulpfile.js

    打包脚本文件

    ...

    o2web目录结构说明

    前端的源码都放置在o2web目录,其中代码部分都在o2web/source/目录下,其他一些是相关的配置和打包脚本文件,所以我们简单介绍一下o2web/source/目录的内容

    o2_core/

    O2OA前端的平台的核心代码,如一些用户认证相关,平台框架相关,服务请求相关的脚本代码。

    o2_lib/

    O2OA前端会引用到,或者可能会引用到的第三方框架或功能组件,如vue、mootools、ckeditor、echarts等

    x_component_xxxxx

    每个x_component开头的目录就是一个O2OA平台的一个应用,如:

    x_component_Org-是组织管理应用;

    x_component_portal_Portal - 是展现门户的应用;

    x_component_process_TaskCenter - 是待办中心应用;

    x_component_Meeting - 是会议管理应用;

    ……

    o2_desktop

    主要放置各种html文件,以及载入前端应用的loader脚本代码

    o2server目录结构说明

    configSample/

    存放config的配置样例,在编译过程中会根据注解自动生成默认配置文件.

    localSample/

    存放local目录的配置文件,目前只有节点标识文件node.cfg.

    x_console/

    目录存放的是启动的主程序.

    x_*_core_entity/

    实体类项目.编译后打包成jar.

    x_*_assemble_control

    业务装配模块,最终向前端提供业务服务.

    x_*_service_*/

    后台服务模块,仅对其他模块提供服务,不向前端开放.

    console_*.sh

    控制台进入脚本.

    restart_*.sh

    服务器重启脚本

    service_windows.bat

    将服务器作为windows服务的生成脚本.

    start_*.sh

    服务器启动脚本.

    stop_*.sh

    服务器停止脚本.

    此时服务器应该编译打包完成,打开源码的target/o2server目录展示,通过命令可以启动服务器:

    windows系统运行:start_windows.bat

    x86的linux系统运行: start_linux.sh

    arm的linux系统运行: start_arm.sh

    等等。