简介这是一份面向Linux运维与项目实施人员的泛微OA系统ecology9部署资源系统梳理了在Linux环境下手动部署OA系统的完整流程帮助读者解决流程复杂、配置易遗漏的问题。资源包共3个文件压缩后仅5KB包含网页说明文档、inscode配置与Git忽略规则文件便于直接查看部署流程和配置样例。内容紧扣数据库安装、应用部署、数据库初始化与系统运行四个环节数据库安装需要以root权限执行脚本、提前安装好libaio包并选择合理的安装目录应用部署则要完成目录创建、文件上传和安装脚本执行数据库初始化需通过浏览器访问配置页面进行库表创建与设置系统运行阶段关注验证码配置、附件上传和授权管理同时不能忽略防火墙策略和内存分配。这份资源更像一份浓缩的操作手册和配置参考部署人员可对照其中步骤逐项执行规避常见错误提升部署效率。目前已有482人学习适合需要独立完成OA系统部署的初中级工程师。 去年帮一家制造企业做泛微OA从Windows迁移到Linux客户给的理由很简单生产环境里所有服务器都是CentOS不想为了OA单独养一台Windows而且Windows Server补丁隔三差五就重启生产线被折腾怕了。迁移过程其实不复杂但“不复杂”是建立在细节都踩过一遍的前提下。泛微e-cology这套系统部署方式跟普通Java应用不一样版本、数据库、目录权限、容器参数任何一个环节没对齐后面就是连环坑。这篇文章以官方源码部署包为例记录我在Linux上从环境规划、数据库初始化到应用启动、功能验证的完整过程。全文主要写给两类人看一类是要把泛微OA从Windows迁到Linux的运维另一类是第一次在Linux上装这套系统的实施工程师。JDK用哪个版本最稳、MySQL和SQL Server怎么选、db.properties里每行配置什么意思、上线前哪些功能必须自检这些我都会按实际部署顺序讲清楚。1. 泛微OA放在Linux上的适用场景与整体部署思路1.1 什么场景下值得把这道题做一遍先说结论不是所有泛微项目都推荐Linux部署。如果你公司已经有成熟的Windows运维体系服务器数量少也没有集群化需求那保持Windows Server反而是性价比最高的选择。泛微官方对Windows环境的支持最完整很多低版本问题在Windows上根本不会暴露出来。真正适合Linux部署的场景我实际接触下来有三种。第一种是标准化交付。公司里所有服务器都是统一的Linux发行版和配置管理平台OA作为一个单体Java应用混进去比单独维护Windows省心得多。第二种是资源成本敏感。一台不带Windows授权的Linux虚拟机和一台Windows虚拟机在同等配置下成本差距很明显企业规模越大越在意这个。第三种是后续要做集群、容器化或者接入DevOps流水线Linux显然比Windows更容易纳入自动化体系。我给客户迁移的这个项目就属于第一种加第二种的组合。客户现有运维团队几乎全是搞Linux的Windows的补丁和杀毒策略反而没人接得住。1.2 “源码包”到底是什么意思很多刚接触泛微的同事会被“源码”两个字带偏以为需要自己编译Java源码。其实泛微官方提供的“源码部署包”指的是一个可直接放置到中间件运行的可部署目录包里面通常包含ecology应用目录、数据库初始化脚本、自定义组件以及配套的中间件容器。这和Windows上常见的“安装版”区别很大。安装版是通过图形化向导帮你把JDK、中间件、数据库脚本、配置统统处理完适合无特殊要求的快速上线而源码部署包给运维的是完整的应用目录和配置项需要手动规划JDK、中间件和数据库连接。它的优势是可控性强升级补丁、搬迁服务器、自定义参数都方便代价是部署链路里每一环都要自己把关。实际项目中我见过不少运维拿到源码包后直接解压就启动结果端口冲突、数据库连不上、License没放到位一脸懵。所以部署前把整个流程串一遍非常有必要。1.3 整体部署流程不能乱泛微OA在Linux上的部署链路并不复杂但顺序是有讲究的。我习惯按下面这个流程推进阶段核心操作交付结果环境规划确定Linux发行版、JDK版本、数据库类型、中间件版本版本清单基础安装安装JDK、创建账号、规划目录可运行环境数据库准备初始化数据库、导入官方脚本干净的ecology库应用配置修改数据源、上传License可连接配置应用部署放置ecology到中间件、调整JVM参数可启动应用启动验证启动中间件、登录、功能自检可交付状态每次我都提醒新同事不要在数据库还没初始化好之前就急着启动Tomcat。表面上启动日志没有报错但登录时会出现一堆稀奇古怪的错误排查起来比按流程走一遍慢得多。2. 环境版本匹配JDK、数据库、中间件怎么选2.1 为什么JDK必须按官方版本走不能想升就升泛微这种老牌Java应用对JDK版本非常敏感。e-cology在很长一段时间内都是基于JDK 1.8开发和调优的遇到JDK 9以上版本可能会出现类加载异常、加密模块找不到、调度任务不执行等问题。所以哪怕服务器上已经有新版本JDK我也建议单独为OA装一个JDK 1.8。在CentOS 7、Rocky Linux、Ubuntu Server上装JDK 1.8最省事的做法如下# 以 tar.gz 方式安装便于多版本共存 mkdir -p /usr/local/java tar -zxf jdk-8u202-linux-x64.tar.gz -C /usr/local/java/ cat /etc/profile.d/java.sh EOF export JAVA_HOME/usr/local/java/jdk1.8.0_202 export PATH\$JAVA_HOME/bin:\$PATH EOF source /etc/profile.d/java.sh java -version注意我这里特意选择JDK 8u202因为这是JDK 8最后一个免费商用版本后续版本需要单独评估授权策略。实际部署时版本策略要结合公司内部软件资产台账来看。安装完以后一定确认java -version输出的是1.8如果服务器上原来已经有其他Java还要在启动脚本里显式指定JAVA_HOME避免被全局环境变量干扰。2.2 数据库选型SQL Server与MySQL的部署差异泛微OA的数据库层生产环境最常见的是SQL Server其次是MySQL和Oracle。Windows环境用SQL Server最顺手但Linux环境下SQL Server还需要先装好mssql-server服务部署链路会多出一截。我这次迁移项目选的是MySQL 5.7理由是运维团队本来就有成熟的MySQL集群和备份体系。数据库选型直接影响后面的初始化脚本。泛微的源码包里有专门针对不同数据库的脚本目录例如database或sql目录下会区分mssql、mysql、oracle。千万不要把SQL Server的脚本直接扔进MySQL执行哪怕字段大部分能对上索引类型、存储引擎、字符集相关的语句一定会报错。从配置角度MySQL和SQL Server的驱动类名和连接串差别很大# SQL Server 示例 dbClasscom.microsoft.sqlserver.jdbc.SQLServerDriver dbUrljdbc:sqlserver://192.168.1.10:1433;databaseNameecology;encryptfalse # MySQL 示例 dbClasscom.mysql.cj.jdbc.Driver dbUrljdbc:mysql://192.168.1.10:3306/ecology?useUnicodetruecharacterEncodingutf8zeroDateTimeBehaviorconvertToNulluseSSLfalseserverTimezoneAsia/Shanghai不少问题出在连接串的参数上。MySQL 8.0以下版本驱动类名是com.mysql.jdbc.Driver8.0以上推荐com.mysql.cj.jdbc.Driver不配置serverTimezone启动时会报时区错误不配置characterEncodingutf8中文数据容易出现乱码。这些参数看起来不起眼但后患无穷。2.3 服务器硬件与分区规划泛微OA本身不重但Tomcat、数据库和文件上传都挤在同一台服务器时配置不能太省。我给出的项目建议配置如下项目最低配置建议配置CPU4核8核以上内存8GB16GB以上系统盘50GB80GB SSD数据盘100GB200GB以上临时目录/tmp 保留4GB以上独立tmpfs或单独分区内存分配上Tomcat堆内存建议给到物理内存的一半左右。如果服务器16GBJVM堆我给4GB到6GB剩下留给操作系统和数据库。磁盘上不要把数据库数据文件和OA附件目录放到系统盘很容易被日志和上传文件占满。我习惯单独挂一个/data分区用于存放源码包、Tomcat应用、数据库数据目录和附件这样备份和扩容都清晰。3. 部署实施目录规划、数据库初始化与配置修改3.1 创建专用账号并规划目录很多新手直接用root去跑Tomcat这在生产环境是安全大忌。泛微OA可能涉及上传文件、执行附件转换等操作一旦应用被攻破相当于直接把root权限丢给攻击者。我每次部署都会建一个专用账号例如ecology。groupadd ecology useradd -g ecology -d /data/ecology -s /bin/bash ecology mkdir -p /data/ecology/app mkdir -p /data/ecology/backup mkdir -p /data/ecology/logs chown -R ecology:ecology /data/ecology目录结构建议如下/data/ecology/ ├── app/ # 解压后的源码包含ecology目录和Tomcat ├── backup/ # 数据库和应用的备份目录 └── logs/ # 统一存放Tomcat和业务日志将源码包上传到/data/ecology/下解压时要注意tar包的权限。上传后如果发现有文件属主不对用chown -R ecology:ecology /data/ecology/app一次性修正。否则启动后写日志、写缓存、上传附件都会报权限错误这类问题在日志里往往表现为Permission denied。3.2 数据库初始化空库脚本与演示数据泛微的数据库初始化脚本在源码包里一般有独立目录。以MySQL版本为例通常会看到ecology初始化脚本.sql或类似的大体积脚本。建议先创建独立的数据库实例和专用账号再导入脚本。mysql -h localhost -uroot -p -e CREATE DATABASE IF NOT EXISTS ecology DEFAULT CHARACTER SET utf8mb4; mysql -h localhost -uroot -p -e CREATE USER ecology% IDENTIFIED BY Ecology2024; mysql -h localhost -uroot -p -e GRANT ALL PRIVILEGES ON ecology.* TO ecology%; mysql -h localhost -uroot -p ecology --default-character-setutf8mb4 ecology_install.sql这里有一个选择空库还是演示库。源码包可能同时提供正式空库脚本和带演示数据的脚本。如果企业刚刚上手还没有历史数据建议先导入空库脚本然后用系统管理员账号在界面里维护组织架构和应用模型。演示数据虽然能让你快速看到效果但清理起来很痛苦最后还是要运维手工删数据容易被误删。另外MySQL初始化时字符集一定用utf8mb4。泛微老版本的脚本如果默认是utf8遇到生僻字或特殊符号就可能报错。导入前先检查脚本第一行确认没有设置过旧的字符集。SQL Server下对应的则是排序规则一般使用Chinese_PRC_CI_AS如果排序规则选错中文查询和排序会出现诡异问题。3.3 数据源与核心配置文件修改数据库建好之后接着改应用的数据源配置。泛微e-cology的数据源配置在应用目录下的ecology/WEB-INF/prop/db.properties这个文件本质上就是一套JDBC连接参数。以MySQL为例完整内容大致如下dbClasscom.mysql.cj.jdbc.Driver dbUrljdbc:mysql://localhost:3306/ecology?useUnicodetruecharacterEncodingutf8zeroDateTimeBehaviorconvertToNulluseSSLfalseserverTimezoneAsia/Shanghai dbUserecology dbPasswordEcology2024除了db.properties同目录下还有ecology.properties、log.properties等文件。log.properties控制日志级别和输出文件生产环境建议把日志级别调到info避免debug日志把磁盘写爆。ecology.properties里如果有附件存储路径配置要确认路径和实际存在的目录一致Linux路径大小写敏感这一点和Windows不一样。改完配置之后先不要急着启动Tomcat。可以用一个简单的Java测试类或者数据库客户端确认应用服务器能访问数据库。很多连接问题在这个阶段提前发现成本最低。比如防火墙没放行3306端口、MySQL账号host限制为localhost、密码包含特殊字符未转义这些在启动Tomcat时才暴露的话日志会非常绕。4. Tomcat应用部署、服务启动与功能自检4.1 放进去之前要把Tomcat参数调好泛微e-cology源码包可以部署到Tomcat也可以使用官方配套的Resin容器。这里我以Tomcat 8.5为例因为它在Linux运维里最通用systemd管理、日志采集、监控接入都很方便。把解压后的ecology目录放到Tomcat的webapps下mv /data/ecology/app/ecology /data/ecology/app/apache-tomcat-8.5.100/webapps/ chown -R ecology:ecology /data/ecology/app/apache-tomcat-8.5.100/webapps/然后修改Tomcat的bin/catalina.sh在文件头部设置JVM参数JAVA_OPTS-server -Xms4096m -Xmx4096m -XX:MaxMetaspaceSize512m -XX:UseConcMarkSweepGC -Djava.awt.headlesstrue-Xms和-Xmx设置堆内存的最小值和最大值。生产环境最好把两个值设成一样避免运行期动态扩容带来的性能抖动。-XX:MaxMetaspaceSize512m是防止元空间无限增长。JDK 8默认元空间是无上限的跑久了可能把内存吃满。还需要检查conf/server.xml里的端口和编码。Tomcat默认端口8080一般可以保留但要注意服务器上是否有其他Java应用占用8080。另外把Connector标签加上URIEncodingUTF-8从源头避免URL中文参数乱码。4.2 License放置与首次启动泛微OA是商业软件必须有对应的License才能正常登录使用。源码部署包里通常不会自带License需要从厂商申请。拿到license.dat后放到ecology/WEB-INF/目录下然后启动Tomcat。启动分两种方式。测试环境直接调startup.shsu - ecology -c /data/ecology/app/apache-tomcat-8.5.100/bin/startup.sh但生产环境我更推荐用systemd托管。在/etc/systemd/system/ecology.service里写一个服务单元[Unit] DescriptionWeaver Ecology Tomcat Service Afternetwork.target [Service] Typeforking Userecology Groupecology EnvironmentJAVA_HOME/usr/local/java/jdk1.8.0_202 EnvironmentCATALINA_HOME/data/ecology/app/apache-tomcat-8.5.100 ExecStart/data/ecology/app/apache-tomcat-8.5.100/bin/startup.sh ExecStop/data/ecology/app/apache-tomcat-8.5.100/bin/shutdown.sh Restarton-failure [Install] WantedBymulti-user.target之后执行systemctl daemon-reload systemctl enable --now ecology。用systemd的好处是开机自启和崩溃自动拉起都解决了不用额外写crontab监控脚本。首次启动观察日志重点看两个地方一个是logs/catalina.out另一个是应用自己的ecology/log/ecology.log。看到Server startup in XXXX ms还不够一定再确认 ecology.log 里没有Exception或Error。启动过程中如果抛出数据库连接异常检查db.properties如果提示License问题检查license.dat位置和有效期。4.3 登录和功能自检清单启动成功后浏览器访问http://服务器IP:8080/wui/index.html泛微OA新版本登录页一般在这个路径。看到登录页之后用系统管理员账号登录。首次登录后立即修改初始密码并确认账号没有被锁定。上线前我有一套固定的自检清单每项都要实际点一遍功能模块检查项预期结果登录认证管理员/普通用户登录正常跳转首页组织架构新增部门、新增员工保存成功且不报错流程引擎发起一个简单审批流程流程能流转到下一节点附件功能上传图片、Word文档上传成功且能下载门户页面门户首页各栏目渲染无空白模块移动端通过浏览器访问移动端路径正常打开附件上传是Linux部署最容易翻车的环节。Windows下目录权限没那么敏感Linux下如果ecology/weaver/目录没有写权限上传过程会提示失败但日志又不一定立刻报错。所以我自检时一定会传一个超过10MB的压缩包测试不仅验证权限还验证Tomcat默认上传大小限制是否需要调整。5. 上线后的运维、日志分析与高频故障排查5.1 日志体系与排查思路泛微OA上线后不是甩手不管日志是最重要的排查入口。Linux部署下日志分散在几个地方Tomcat自身日志apache-tomcat-8.5.100/logs/catalina.out应用业务日志ecology/log/ecology.log队列与定时任务日志ecology/log/下按模块拆分数据库日志MySQL的error log和slow query log我的排查思路是先看Tomcat是否真的活着再看业务日志有没有明确异常最后才去翻数据库日志。很多实施人员一上来就打开MySQL慢查询效率非常低。如果出现“系统无法访问”第一步看端口和进程ss -lntp | grep 8080 ps -ef | grep java | grep -v grep如果是进程还在、端口没监听大概率是Tomcat启动失败如果进程都消失了看systemd设置的Restarton-failure是否触发过。接着再打开catalina.out看启动报错按时间倒序找Caused by。5.2 高频故障与解决套路我整理了几个Linux部署泛微OA的高频故障也是群里被问得最多的几类故障现象常见原因解决方向启动报 Connection refused数据库端口不通或db.properties错误检查防火墙、MySQL监听地址登录特别慢JVM堆太小或垃圾回收激烈调大-Xmx检查JVM监控附件上传失败附件目录无写权限给ecology/weaver设置属主定时任务不执行时间时区不对或任务被锁同步服务器时间、检查调度表中文乱码数据库字符集或连接串缺编码统一mysql、表、连接串均为utf8mb4Linux下页面CSS异常Tomcat静态资源压缩或缓存问题清理Tomcat缓存、确认目录权限举一个具体的例子。之前一台部署在Ubuntu Server上的泛微每天早上8点流程提醒邮件都不发查日志发现定时任务是9点才触发。原因是服务器时区是UTC系统时间比北京时间晚了8小时。Java应用的调度任务完全依赖服务器本地时区这个问题在Windows下几乎不会出现但在Linux云服务器上非常常见。解决方式就是统一时区timedatectl set-timezone Asia/Shanghai另一个容易被忽略的是上传文件权限。很多人只改了webapps的属主但ecology/weaver/是应用运行时动态创建的目录如果父目录没有写权限子目录创建失败上传功能就会“看起来一切正常一点就报错”。5.3 用systemd管理服务和备份策略生产环境建议坚持用systemd管理Tomcat不要直接写nohup java -jar之类的野路子。systemd的好处是崩溃自动重启、开机自启、日志统一走journald。但要注意如果使用TypeforkingTomcat的startup.sh会启动子进程然后退出systemd需要正确识别主进程通常Tomcat默认脚本是可以的。定期备份是运维的底线。我的备份策略是数据库每日全量备份应用目录每周备份备份保留14天。下面的脚本可以放到crontab里#!/bin/bash BACKUP_DIR/data/ecology/backup DATE$(date %Y%m%d_%H%M%S) mysqldump -uecology -pEcology2024 --single-transaction --default-character-setutf8mb4 ecology | gzip $BACKUP_DIR/ecology_$DATE.sql.gz tar czf $BACKUP_DIR/ecology_app_$DATE.tar.gz -C /data/ecology/app ecology find $BACKUP_DIR -type f -mtime 14 -delete泛微OA的附件和数据库必须一起备份才完整。服务器如果发生过磁盘故障只恢复数据库没有附件流程里的所有文件都会变成“红点”且没有自动化补救手段所以备份脚本里应用目录和数据库都要覆盖到。6. 个人经验总结6.1 三个容易忽略的坑第一是Linux下的文件权限验证。Windows部署泛微习惯了把权限问题抛在脑后Linux部署时一定要记住Tomcat进程用什么用户跑所有应用目录、日志目录、附件目录都必须是这个用户可读可写。用root启动一时爽后面遇到无数权限引发的隐性故障。第二是版本一致性。泛微的源码部署包、补丁包、数据库脚本和License版本是强绑定的。我遇到过一次奇怪的问题应用包是新版本但开局拿的是旧库初始化脚本结果登录后一堆模块报表不存在。后来重新按对应版本导入脚本才解决。所以部署前先核对包版本和脚本版本不要混搭。第三是不要盲改官方配置文件。db.properties里多一个参数、ecology.properties改一个路径都可能影响整套系统。改前先备份原文件每改一项就确认对应功能是否正常别一次性改七八个配置再启动出问题都不知道是哪一步引起的。6.2 如果让我从头做一遍如果现在再给一个新客户做泛微OA Linux部署我会把前期准备工作压缩得更极致。拿到源码包后先不看任何安装文档第一件事是整理版本清单JDK版本、数据库版本、Tomcat版本、源码包版本、补丁清单。然后创建虚拟机、装JDK、初始化数据库、配置应用、启动、自检整个过程尽量控制在半天内。中间省掉所有“先跑起来再说”的心态用系统化流程替代无效试错。Linux部署泛微OA真的不难难的是每一步都做到可追溯、可回滚、可验证。这套流程跑通之后后续再遇到升级、迁移、扩容维护心态会完全不一样。本文还有配套的精品资源点击获取
