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

    源码编译-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/hq1980/O2OA.git

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

    编译源码

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

    准备编译环境

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

    Node.js

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

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

    jdk

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

    maven

    3.6及以上版本

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

    切换到要编译的分支

    环境准备好后,我们打开终端或windows的命令行提示符,进入O2OA源码目录。默认情况先,现在是主分支,就是develop分支,如果我们需要编译其它分支,通过以下git命令切换,如切换到master分支:

    git checkout master

    编译

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

    npm install

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

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

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

    npm run build_ci

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


    优化编译

    等待编译过程中,我们可以先介绍一下不同的编译命令,以及优化编译速度。

    预先下载jvm和commons包

    前面我们是使用build_ci命令编译的,它会自动下载jvm和一些依赖jar包(commons),这个过程会比较长,所以为了加快编译的速度,可以先手工下载jvm和依赖jar包。

    此时您必须保证下载的commons版本和现在编译的服务器版本相匹配,否则编译后服务器运行可能会有异常

    依赖包下载:7.2及以后版本:https://download.o2oa.net/download/commons/7.2/commons.zip

     7.0之后的版本:https://download.o2oa.net/download/commons/7.0/commons.zip

     6.4之后的版本:https://download.o2oa.net/download/commons/6.4/commons.zip

                           6.3.x及之前版本:https://download.o2oa.net/download/commons/commons.zip

    下载解压后,将commons目录拷贝到o2server/目录下。

    然后,需要下载对应的JVM

    JVM 下载地址:

    选择符合您的服务器操作系统环境的jvm进行下载,解压后放到o2server/jvm目录下,如果没有该目录请自行创建该目录。

    然后我们就可以执行以下命令编译了:

    npm run build

    编译特定操作系统版本的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


    方法二:已经下载了JVM和依赖包commons

    如果已经手工下载了正确版本的JVM和依赖包commons,并放到的了o2server目录下,则使用 “build:xxx” 命令:

    此时您必须保证下载的commons版本和现在编译的服务器版本相匹配,否则编译后服务器运行可能会有异常。

    #编译windows版本
    npm run build:win
    
    #编译linux x86版本
    npm run build:linux
                    
    #编译aix版本
    npm run build:aix
    
    #编译linux arm版本
    npm run build:arm
    
    #编译windows版本
    npm run build:macos
    
    #编译linux mips版本
    npm run build:mips
    
    #编译树莓派版本
    npm run build: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

    等等。