企业官网建设流程全解析

信创版干部人事档案管理系统的安装与使用

接手信创版干部人事档案管理系统的部署任务时，我一度以为这跟以前在Windows服务器上装个Tomcat、丢个WAR包进去差不多。真正动手才发现，信创环境下的部署逻辑完全换了思路——操作系统的差异只是最表层的问题，CPU架构、国产数据库的初始化参数、国产中间件的类加载机制、浏览器端的控件适配，每一步都可能让你在同一个地方卡上一整天。这篇文章把我从环境摸底到系统上线的完整过程，连同踩过的坑一起整理出来，给准备做同类项目的人一个能直接照抄的参考。

不管你是单位信息中心的运维人员，还是承接信创改造项目的集成商工程师，这篇文章覆盖的内容都适用。我会从选型分析、环境准备、部署步骤、功能使用、故障排查五个维度展开，尽量把每个"为什么这么做"也讲清楚，而不是只给一堆命令。

1. 信创环境下的档案系统选型与版本差异

1.1 信创目录适配究竟在适配什么

很多人听到"信创版"三个字，第一反应就是"能装在麒麟系统上"。这句话对了一半，真正的适配工作远比换操作系统复杂。一个干部人事档案管理系统要进入信创目录，需要在芯片、操作系统、数据库、中间件、浏览器五个层面同时完成兼容验证。

以我这次部署的环境为例，服务器用的是ARM架构的芯片（飞腾或鲲鹏系列），操作系统是银河麒麟V10，数据库是达梦DM8，中间件是东方通TongWeb。这套技术栈和传统x86 + Windows + MySQL + Tomcat的组合有本质区别，核心差异在于三个层面：

• CPU指令集不同：ARM架构下所有依赖本地编译的组件都必须重新编译，不能直接拿x86的二进制包来跑。
• 数据库语法兼容性：达梦虽然兼容Oracle语法，但默认参数、大小写敏感规则、分页写法都和MySQL有区别。
• 中间件规范差异：TongWeb虽然遵循Java EE规范，但很多配置项、控制台操作方式、日志位置都是自成一派的。

最麻烦的是，干部人事档案管理系统通常还要配套扫描控件、浏览器插件、OFD版式文件阅读器等辅助组件，这些组件在信创环境下的适配情况，往往决定了整个项目能不能顺利落地。

1.2 这类系统常见的两种交付形态

我接触过的信创版档案系统，交付形态大致分两类。搞清楚你拿到的是哪种，部署策略会完全不同。

第一种是"整体打包式"。厂商给一个ISO镜像或者一个大的安装脚本，把操作系统、数据库、应用服务全部打包好，你只要在裸服务器上跑一遍安装程序，就能得到一套完整环境。这种方式的优点是省事，缺点是升级和排障很被动——你不知道系统内部各组件的具体配置文件在哪儿，出了问题只能找厂商。

第二种是"组件分离式"。厂商只提供应用本身的安装包（通常是一个WAR包或RPM包），底层数据库、中间件、JDK都需要你自己准备和安装。这次我遇到的就是这种。虽然前期工作量大，但可维护性高，出问题的时候能自己定位，不用每次都被厂商牵着鼻子走。

选择哪种形态，要在项目启动前就确认清楚，因为它直接影响后续的资源准备和人员分工。

2. 安装前的环境核查：最容易翻车的环节

2.1 操作系统、CPU架构与JDK的三角匹配

环境核查不仔细，后面每一步都会很痛苦。第一个要确认的就是操作系统版本和CPU架构，因为国产化环境里ARM和x86并存，很多软件包是分架构的，下载错了连安装都装不上。

# 查看操作系统版本信息 cat /etc/os-release # 查看CPU架构（aarch64表示ARM，x86_64表示x86） uname -m # 查看CPU具体型号 lscpu | grep "Model name"

拿到架构信息之后，再确认JDK版本。干部人事档案管理系统大多是Java技术栈，需要JDK 8以上版本。但要注意，信创环境里不能直接用Oracle JDK，建议用开源的OpenJDK，麒麟的应用商店里也自带了麒麟版JDK，这些在ARM架构下都是有适配验证的。

# 安装OpenJDK 8 yum install -y java-1.8.0-openjdk-devel # 验证JDK版本 java -version

这里有个我踩过的坑：如果系统装了多个版本的JDK，应用服务启动时可能加载到错误的版本。建议安装完成后统一做一个符号链接指向目标版本，或者在/etc/profile里显式设置JAVA_HOME。

关键提示：数据库、中间件、应用三者的位数和架构必须一致，混合使用会引发各种莫名其妙的问题。

2.2 数据库选型与初始化参数

干部人事档案管理系统对数据安全性和事务一致性要求非常高，市面上主流的国产数据库是达梦DM8和人大金仓KingbaseES。这次我们用的是达梦DM8，因为它的Oracle兼容性好，档案系统很多SQL语句迁移成本低。

达梦数据库安装完成后，真正的难点在建库环节的初始化参数设置。dm数据库的初始化参数在建库后就不能修改了，所以前期必须规划好。其中最重要的三个参数：

# dminit参数说明 PATH # 数据文件存放路径 PAGE_SIZE # 页大小，可选4KB、8KB、16KB、32KB CHAR_CODE # 字符集，1表示UTF-8，0表示GBK CASE_SENSITIVE # 是否区分大小写，y表示区分，n表示不区分

我这次设置的参数是这样的：

dminit PATH=/dm/data PAGE_SIZE=32 CHAR_CODE=1 CASE_SENSITIVE=n

为什么要特别强调这几个参数？因为干部人事档案系统涉及大量中文文本和扫描件元数据，字符集如果用GBK，后期遇到生僻字就会乱码；页大小如果选了8KB，某些大数据量查询的性能会受到明显影响；大小写规则如果和原来系统不一致，迁移的SQL语句可能会报"表或视图不存在"。

另外，达梦数据库默认的端口是5236，如果和公司其他服务冲突，要在安装时或安装后通过dm.ini调整。连接测试可以用达梦自带的disql工具：

# 使用disql连接测试 disql SYSDBA/SYSDBA@localhost:5236

2.3 中间件、时间同步与浏览器准备

中间件选型上，东方通TongWeb是最常见的，它对国产生态适配做得比较完善。安装TongWeb之前要注意JAVA_HOME环境变量必须已经配置好，否则启动脚本会直接报找不到java。

TongWeb默认端口是9060（控制台）和8080（应用），部署前要把这两个端口在防火墙里放开。如果是内网环境，建议同时关闭不必要的端口，保证安全合规。

时间同步这个细节特别容易被忽略，但在信创环境里偏偏很重要。干部人事档案系统涉及大量审批流和审计日志，如果服务器时间和数据库时间不一致，会出现两种诡异现象：一是登录后票据校验失败，二是审批流程的时间线错乱。建议在部署前就配置好NTP时间同步：

# 配置NTP时间同步（以麒麟系统为例） timedatectl set-ntp yes timedatectl status

浏览器端也要提前确认版本。信创环境下的终端通常使用的是奇安信可信浏览器、红莲花浏览器或者360安全浏览器（信创版），这些浏览器对档案系统的插件兼容性要提前验证。我遇到过的情况是：Firefox能正常打开页面，但扫描控件的调用始终失败，换成系统内置的奇安信浏览器后问题才解决。

3. 从零开始部署：一条完整的安装链路

3.1 数据库实例创建与业务数据初始化

环境准备好之后，正式开始部署。第一步是创建数据库实例和业务表空间。达梦数据库创建完实例后，还需要创建对应的用户和表空间，档案系统一般会要求专用的业务用户，而不是直接用SYSDBA。

# 在disql中创建表空间和用户 CREATE TABLESPACE rsda DATAFILE '/dm/data/RSDA.DBF' SIZE 1024M AUTOEXTEND ON NEXT 100M MAXSIZE 8192M; CREATE USER RSDA IDENTIFIED BY "YourPassword123" DEFAULT TABLESPACE RSDA; GRANT DBA TO RSDA;

这里要注意，密码设置要符合复杂度要求，但也不要忘记密码强度与档案数据的敏感等级相匹配。

初始化脚本一般由应用厂商提供，通常是几个SQL脚本，按顺序执行即可。如果是老系统升级，还需要做数据迁移。数据迁移是最容易出现字符集问题的环节——老系统的数据可能是GBK编码，新库是UTF-8，直接导入会出现乱码。稳妥的做法是先用工具将老库数据导出为UTF-8编码的文本文件，再导入新库，导入后抽几条包含生僻字的记录验证编码是否正确。

3.2 JDK、中间件与应用包的部署

数据库就绪后，开始部署应用。先把WAR包上传到服务器，通过TongWeb的控制台部署应用。操作路径是：登录TongWeb控制台（http://服务器IP:9060/console），进入"应用管理"，选择"部署应用"，上传WAR包，指定上下文路径（一般填根路径或者rsda），然后启动。

上传和启动看起来简单，但有几个坑一定要提前避开：

• JVM内存参数：人事档案管理系统涉及大量图片处理和PDF转换，没设置JVM参数的话，跑一段时间就OOM。需要在TongWeb的启动参数里配置：

JAVA_OPTS="-Xms1024m -Xmx2048m -XX:MaxMetaspaceSize=512m"

• 文件上传大小限制：档案扫描件动辄几十MB甚至上百MB，默认的文件上传大小上限通常只有10MB，要在TongWeb里把max-post-size参数调大，否则扫进来的高分辨率材料会上传失败。

• WAR包依赖的jar冲突：国产中间件自带的类库和应用WAR包里的某些jar可能存在版本冲突。如果控制台部署时遇到ClassNotFoundException或NoSuchMethodError，多半是冲突问题，需优先检查出现冲突的类所在的jar包，排除应用包里重复的旧版本。

3.3 首次启动验证与客户端访问适配

应用启动后，别急着高兴，要按顺序做四项验证：

1. 访问地址，确认登录页面能正常打开
2. 用初始管理员账号登录，确认验证码和密码校验逻辑正常
3. 创建一个测试部门、录入一个测试人员，确认数据库读写正常
4. 上传一份PDF扫描件，确认附件存储和在线预览正常

这里面最容易出幺蛾子的是第四步。如果附件预览出现"无法加载插件"或"文件格式不支持"的情况，一般是忽略了OFD格式的支持。干部人事档案材料在信创环境下通常要求以OFD格式归档，而OFD预览需要专门的阅读器或控件。信创浏览器通常内置了OFD支持，但如果是普通Chrome内核浏览器，就需要单独安装OFD阅读插件。

另外，浏览器端的兼容模式也要提前设置好。建议将系统地址加入可信站点列表，并开启兼容模式，避免出现页面元素错位或功能按钮点了没反应的情况。

4. 使用阶段的核心业务操作

4.1 档案采集与"四性检测"

系统跑起来之后，真正的工作才刚刚开始。干部人事档案管理的核心不仅仅是"存文件"，更重要的是保证档案材料的真实性、完整性、可用性和安全性，这也是档案管理行话里常说的"四性检测"。

在采集环节，系统通常支持两种方式：批量导入和在线著录。批量导入适合首次建库，把历史纸质档案扫描成图像文件后按目录结构挂接；在线著录适合日常维护，每位干部的履历、考核、奖惩材料录入后即时归档。

这里特别提示一个操作细节：档案扫描件的命名规则一定要在采集前就定好。推荐使用"工号+姓名+材料类型+序号"的格式，因为系统内部是通过文件名来关联元数据的，命名混乱会导致后期了大量返工。另外，扫描件建议统一存为PDF或OFD格式，不要混用JPG和PDF，否则在后续OCR识别和全文检索时会增加很多麻烦。

四性检测通常是系统自动完成的，但管理员要在批量上传后主动查看检测报告。报告里会标出哪些文件MD5校验不一致、哪些文件格式非法、哪些图片清晰度不达标。如果检测结果有异常，要在一周内处理完，拖得越久越难追溯原因。

4.2 档案利用流程：借阅、审批与归还

干部人事档案的利用环节是整个系统里最敏感的部分，借阅流程设计得是否严谨，直接关系到合规性审查能否通过。常见流程是：借阅人发起申请、填写利用目的和查阅范围、部门领导审批、档案管理员审批、登记借出、归还确认。

实际操作中，我发现最容易被忽略的是"归还确认"这一步。很多人觉得系统里点击"归还"就算完成了，其实严格来说需要档案管理员核对实体档案（如果是纸质件）或电子件未被篡改后才能做归还登记。系统里也建议开启"超期未归还自动提醒"功能，比如设置15天借阅期限，到期前3天系统自动给借阅人发提醒。

批量借阅功能在高频场景下很有用。例如组织人事部门做年度考核时，需要一次性查阅一个部门所有干部的档案，如果一份一份申请，效率极低。批量申请支持按部门或按人员列表勾选，系统会自动生成一份借阅清单。

4.3 权限模型：三员分立与操作审计

干部人事档案系统对权限控制的要求，比普通OA系统严格得多。现在的主流设计是"三员分立"：系统管理员管配置和运维，安全保密管理员管安全策略，安全审计员管日志和合规审查。三个角色互相独立、互相制约，谁都不能单独完成所有操作。

我在实际配置权限时建议采用最小授权原则：

• 普通用户只能查看自己的基础信息
• 干部本人只能看到档案目录，不能查看内容
• 组织人事部门按岗位职责分配查阅范围，例如招聘岗只能看相关人员的履历部分
• 所有的查阅和打印操作都会记录到审计日志中

操作审计的日志一定不要随意清理，现在很多单位的合规审查会追溯三五年前的操作记录。建议制定日志归档策略：在线日志保留至少一年，归档日志保留至少五年。

另外提醒一点：档案系统的权限调整流程要尽量规范化。即使系统支持批量授权，也要走"申请—审批—授权—复核"的线下流程，防止误授权导致的数据泄露。

5. 运行期高频故障与排查思路

5.1 服务突然无法启动：从日志反推根因

系统运行一段时间后，最怕的就是服务突然起不来了。真遇到这种情况，先别乱，按照"看进程—看端口—看日志—看资源"的顺序排查。

# 查看Java进程是否存活 ps -ef | grep java # 查看端口是否被占用 netstat -tlnp | grep 8080 # 查看应用实时日志（以TongWeb为例） tail -f /tongweb/logs/server.log

如果进程还在但页面打不开，大概率是端口被防火墙拦截或者应用假死。如果进程已经消失，重点看日志末尾有没有OOM或致命错误。我遇到过一次比较典型的情况：磁盘空间满了，数据库无法写入临时文件，导致应用挂掉。

# 查看磁盘空间使用情况 df -h

所以建议在上线前就做好日志切割和磁盘空间监控，日志文件别全部堆在根分区，最好单独挂一块数据盘。真出问题的时候，留着一条活路很重要。

5.2 数据库连接失败与生僻字乱码的思路

应用可以正常启动，但登录时提示"无法连接数据库"，这个问题在信创环境里特别多。排查思路：

首先确认数据库服务状态：

ps -ef | grep dmserver

如果数据库进程正常，再用disql本地连一次：

disql SYSDBA/密码@localhost:5236

本地能连、远程连不上，检查防火墙和数据库的监听配置。本地都连不上，去查数据库日志，通常位于/dm/log/目录。

还有一个经典问题就是生僻字乱码。干部的姓名和档案材料里生僻字出现频率很高，如果字符集配置不一致，录入时正常但页面显示变成"?"或"锟斤拷"。这个问题的根源一般有两个方向：一是数据库字符集不是UTF-8，二是应用JVM启动参数没有指定。

# 在应用启动参数中显式指定编码 JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf-8"

排查时优先确认数据库建库时的CHAR_CODE参数。如果是已经建好的实例，字符集改不了，只能新建实例后重新导入数据，这个教训非常深刻。

5.3 页面白屏、附件预览失败与控件加载问题

页面白屏或按钮无响应，看浏览器控制台的报错类型。如果是JS报错，先清理浏览器缓存和Cookie，再尝试使用无痕模式打开系统。有些系统在第一次部署后需要重启一次浏览器端的安全服务，否则控件的初始化状态不对。

附件预览失败是另一个高频问题。先确认文件上传格式是否符合系统要求。如果是OFD文件打不开，确认终端浏览器是否安装了OFD阅读插件；如果是PDF打不开，可能是浏览器拦截了在线预览功能，需要把系统地址加入浏览器的弹窗放行列表。

扫描控件的加载失败基本是这三个原因：终端未安装控件、浏览器未开启插件权限、系统地址未加入白名单。按照这个顺序逐个排查，大多数情况下都能解决。

还有一个值得提醒的点：如果终端启用了安全防护软件，可能会拦截控件运行。需要提前把系统地址和控件进程加入信任列表，否则即使插件装上了，运行时也会被静默拦截，表现就是"疑似安装了但始终调不到扫描仪"。

5.4 容易忽视的备份与恢复演练

档案系统的数据无价，备份策略一定要认真设计。我的建议是"数据库每天全量备份+增量日志备份，归档数据每周全量备份"，备份文件采用"存储服务器本机+异地复制"的双副本策略。

但比备份更重要的是恢复演练。很多单位备份做了，但从来没试过恢复，真到关键时刻才发现备份文件损坏或恢复流程不完整。建议每季度做一次恢复演练，不用全量恢复，在一台测试机上恢复最近一个月的备份，验证数据完整性和系统可用性就够了。

6. 给后来者的几条实用建议

整个项目从环境准备到上线运行，我前后折腾了将近三周。最后分享几点实际经验，希望后来者少走弯路：

第一，提前跟厂商确认交付文档的完整度。国产化系统的交付文档质量参差不齐，有的只给一份部署手册，遇到问题就只能猜。建议在合同中明确要求提供数据库初始化脚本、配置项说明和故障排查手册，这些文档在后期维护中能救命。

第二，先做小范围试点再全面铺开。不要一上来就在所有终端装客户端，先选一个部门、一台上网终端做全流程测试，包括扫描、上传、借阅、打印，全部验证通过后再推广。信创环境下的终端品牌五花八门，某个型号的终端控件不兼容是常有的事。

第三，档案数据迁移要留足时间。如果你是从老系统升级到信创版，数据迁移的工作量往往比安装部署本身还大。历史数据的清洗、分类、格式转换、生僻字校对，每一项都是精细活，建议预留至少三分之一的项目工期。

第四，做一次完整的上线演练。上线前在准生产环境完整跑一遍"装系统—导数据—配权限—传档案—走流程"的全链路，把过程中所有异常记录下来。磨刀不误砍柴工，演练中暴露的问题比上线后再返工划算得多。

这套系统的部署和使用并不复杂，真正考验人的是对每个环节"为什么这么做"的理解。把底层逻辑搞清楚了，无论是换数据库还是换中间件，你都能从容应对。