蓝凌EKP V16.0 admin.do配置避坑指南：从Redis缓存到多服务器验证

简介：蓝凌标准产品V16.0管理员手册-admin.do配置面向企业信息化系统的运维与管理人员，帮助其快速掌握蓝凌V16.0后台各项参数的配置方法与排错思路。手册围绕admin.do配置入口展开，涵盖数据库连接、全局参数、消息机制、存储与附件、Redis缓存、全文索引、MQ、JMX服务、日志参数、运营日志采集及GZIP压缩等模块，并延伸至系统安全中的身份验证与会话管理，目录结构清晰，便于按模块查阅。资源为1个PDF文档，压缩包约2.65MB，内容完整、层级分明，适合作为日常运维的案头参考。目前已有954人学习下载，读者可据此完成从基础环境搭建到缓存、索引、消息队列等中间件配置的全流程落地，并借助安全与日志章节排查常见问题，提升系统稳定性与运行效率。

1. 从一次凌晨三点的故障说起：这份 admin.do 配置手册到底能救什么急

去年冬天，某公司运维群里炸了锅——EKP 集群里一台节点重启后，所有用户被强制下线，待办消息全部卡死。排查到天亮才发现，是 Redis 缓存配置没勾选“会话管理集群”那一项，导致多服务器 SSO 令牌环失效。这种血泪经验，在蓝凌标准产品 V16.0 的 admin.do 配置里，几乎每个选项背后都藏着类似的坑。

这份管理员手册，本质上是一份“后台黑匣子操作指南”。admin.do 页面集中了数据库连接、Redis 缓存、附件存储、消息机制、全文索引、多服务器验证等底层配置项，全部是全局性、必须重启才生效的硬核参数。它适合两类人：一是刚接手 EKP 运维、面对 admin.do 满屏字段不敢下手的初级管理员；二是需要排查集群故障、调优性能的一线工程师。手册只有 20 页，但每一页的配置项都直接关联系统能否正常启动、用户能否登录、附件能否上传下载。如果你正在部署或维护蓝凌 V16.0，这份文档就是你的“后悔药”——前提是你得先看懂它。

2. 基础配置：数据库、Redis 与附件存储的硬核参数怎么填

2.1 数据库配置：连接类型与 URL 的选型逻辑

数据库配置是 admin.do 里第一项必须填对的参数，填错直接导致系统无法启动。手册里给了两种连接类型：JDBC 和 JNDI。我一般无脑选 JDBC，因为 JNDI 依赖容器上下文，迁移或升级时容易找不到数据源，而 JDBC 把连接串写死在配置里，出问题一眼就能看到 URL 对不对。

数据库类型支持 SQLserver、ORACLE、MYSQL、DB2、神通、达梦。URL 格式是标准的 jdbc 形式，比如 SQLserver 用 jtds 驱动时写成：

jdbc:jtds:sqlserver://192.168.1.146:1433/ekp

注意这里的 IP、端口、库名要换成你实际环境的。如果是 Oracle，URL 会变成jdbc:oracle:thin:@IP:1521:ORCL这种格式。填完后一定要点“测试数据库连接”，这个 Test 是一次性无损测试，不做数据读写，放心点。但测试通过不代表生产没问题——我遇到过测试通、启动报错的案例，原因是数据库用户权限没给全，缺少建表或序列权限。所以测试通过后，还要确认账号有 DDL 和 DML 权限。

2.2 Redis 缓存配置：启动顺序与宕机风险

Redis 配置是 admin.do 里最容易翻车的地方。手册明确写了：Redis 宕机会导致 EKP 无法使用。这不是危言耸听，我见过 Redis 服务被误停后，整个 EKP 登录页直接 502。

配置前必须先装好 Redis。手册给的安装步骤是源码编译：

wget http://download.redis.io/releases/redis-5.0.2.tar.gz tar xzf redis-5.0.2.tar.gz cd redis-5.0.2 make cd src ./redis-server

启动后可以用./redis-cli进去set foo bar验证。但生产环境别用默认配置裸跑，要改redis.conf里的bind、requirepass和maxmemory。绑定 IP 别写0.0.0.0，密码必须设，内存上限根据附件缓存量估算，一般给物理内存的 60%。

Redis 在系统里有三个用途：缓存机制（非必须）、会话管理（集群必须）、令牌环存储（多服务器验证必须）。勾选“缓存机制”后，系统缓存走 Redis，不勾选就用本地缓存。但只要你启用了集群或多服务器 SSO，会话管理必须勾选，否则用户登录状态无法跨节点共享。

注意：配置后的启动顺序是先启 Redis，再启 EKP。如果 Redis 挂了，EKP 重启也起不来，必须先把 Redis 拉起来。

2.3 附件存储与转换服务：路径权限与金格控件

附件配置分两块：附件存放位置和附件转换服务。存放位置默认是c:/landray/kmss/resource，Linux 下改成/usr/local/landray/kmss/resource。这里有个坑：目录必须具有可写权限，而且不要放在系统盘根目录，否则磁盘满了他会先崩。

附件大小限制分普通附件和图片附件。大图宽度默认 1024 像素，小图宽度默认 512 像素，超过就压缩。设为 0 表示不压缩，但别这么干，除非你不在乎用户打开列表页卡成 PPT。

不允许上传的附件类型默认包含.js;.bat;.exe;.sh，这是安全底线，别手贱删掉。只允许上传的类型按需配，格式用分号分隔，比如.docx;.xlsx;.txt;.pdf。注意 WPS 文件的实际扩展名可能是.wps或.jar，别漏了。

金格控件配置是附件在线编辑的关键。iWebOffice2015 支持多浏览器，但第一次使用必须先用 IE 安装控件，Chrome 无法提醒下载。如果 Chrome 加载失败，让客户端手动运行开始菜单里 iWebOffice2015 目录下的“修复配置”。还有个细节：EKPV15B2 之后支持 iWebOffice2003，但选了 OFFICE 就得把所有 word、excel、PPT 改成.doc/.xls/.ppt，选了 WPS 就得改成.wps/.et/.dps，混编会报错。

3. 系统安全与集团应用：多服务器验证、三员管理与多语言配置

3.1 多服务器验证：令牌环配置与 Redis 有效期

多服务器验证用于跨 EKP 登录，多套系统共享令牌环，浏览器或 APP 登录一次，进入其它系统免登。手册以 Domino 的 LtpaToken 方式为例，配置项包括密钥类型、作用域、有效期、令牌环名称、密钥、登录关键字。

密钥类型可选 Domino 令牌环或 EKP 自主 LRToken，根据对接系统选。作用域一般填直接后缀，可以填多个域共用。有效期指定令牌环有效时间，过期后重新登录。如果勾选了“使用 redis 存储有效期”，必须先启用 Redis 缓存，否则不生效。用户每次访问会延长有效期，类似 session 机制。从 Redis 取到有效期时以 Redis 为准，否则以令牌环有效期为准。

令牌环名称多套系统必须保持一致，密钥可以随机生成一组拷贝到其它系统，或者从其它系统拷贝。登录关键字默认是 CN，别乱改。

3.2 三员管理与身份验证：开启后 admin.do 就进不去了

三员管理默认关闭，开启后不能再访问 admin.do。这是硬性限制，没有后悔药。所以开启前必须确保三员管理操作手册已经吃透，并且备份好配置文件。我一般建议在测试环境先跑一遍三员管理流程，确认没问题再上生产。

本系统身份验证用于和第三方用户认证系统集成后（LDAP、其它 EKP、AD 等）。开启禁用后，本系统验证不做用户名密码校验，但例外人员里的超管账号依然在本系统做验证。注意：虽然不做校验，但两边必须有对应的用户，用户名一致，否则登录后找不到人。

3.3 多语言与集团分级授权：集群通讯安全与场所隔离

多语言支持开启后，登录页可以切换语言，备选项来源于语言配置。官方语言是默认所有用户登录的语言。语言样式定义三项：单屏登录页、多屏滑动登录页、随机背景登录页。附加功能里有个关键点：集群模式下需要开启此项，保证通讯安全（密钥）、系统独立（节点标识）、不受干扰（起始端口+20 不同）。这个端口偏移量是硬编码的，别想着改。

集团分级授权和场所同步涉及数据隔离。场所见数据隔离开启后，各个场所相互独立。隔离方向有三个选项：对本场所数据可见、对上级场所数据可见、对下级场所数据可见。机构同步分平级同步和层级同步，部门同步同步创建 N 级对应的场所。管理员同步需要同步的则开启，场所漫游同步可选直属用户或全部用户。

多域名支持用于多线环境，应对运营商网间延迟。但手册明确说了，当前互联网骨干网建设已基本完成，延迟较低，所以一般不开启。除非你的用户分布确实跨多个运营商且延迟明显，否则别给自己找事。

4. 避坑排查：admin.do 配置里最容易翻车的五个点

4.1 改完配置没重启，以为保存就生效

现象：在 admin.do 里改完数据库 URL 或 Redis 地址，点保存后刷新页面，发现配置没生效，系统还是连旧地址。

原因：admin.do 里的配置都是全局性的，必须重启 EKP 才能加载新配置。手册里用三个感叹号强调“必须，需要，一定重启”，不是开玩笑。

解决：保存配置后，先点“备份配置文件”导出备份，然后重启 EKP 服务。重启顺序是先 Redis 后 EKP，别搞反。

4.2 Redis 没启动就配 admin.do，保存后 EKP 起不来

现象：在 admin.do 里勾选了 Redis 缓存和会话管理，保存后重启 EKP，结果启动日志报连接 Redis 超时，系统卡在启动阶段。

原因：Redis 服务没启动，或者防火墙没放行端口，EKP 启动时连不上 Redis 直接阻塞。

解决：先确认 Redis 进程在跑，用redis-cli ping返回 PONG。再检查 EKP 服务器到 Redis 服务器的网络和端口。如果 Redis 有密码，admin.do 里的密码字段别填错。

4.3 附件目录权限不对，上传报 500

现象：用户上传附件时页面报 500 错误，后台日志显示Permission denied或FileNotFoundException。

原因：附件存放位置配置的目录不存在，或者 EKP 运行用户没有写权限。

解决：Linux 下用chown -R ekp用户:ekp用户 /usr/local/landray/kmss/resource改属主，chmod -R 755给权限。Windows 下检查目录是否被安全软件锁定。

4.4 金格控件 Chrome 加载失败，以为控件坏了

现象：Chrome 浏览器打开附件在线编辑，提示控件加载失败，但 IE 里正常。

原因：iWebOffice2015 第一次使用必须先用 IE 安装控件，Chrome 无法提醒下载。安装后 Chrome 仍可能加载失败，需要手动修复配置。

解决：让客户端先打开 IE 访问系统，按提示安装控件。然后在开始菜单找到 iWebOffice2015 目录，运行“修复配置”。如果还不行，检查 admin.do 里的版权支持信息是否填了许可号。

4.5 三员管理开启后 admin.do 进不去，没备份配置

现象：开启三员管理后，想再进 admin.do 调整参数，发现页面直接拒绝访问。

原因：三员管理开启后 admin.do 入口被禁用，这是设计如此。

解决：开启三员管理前，务必先点“备份配置文件”导出备份。如果已经开启且没备份，只能通过三员管理操作手册里的流程，用三员账号登录后走特定入口。所以我的习惯是：任何涉及 admin.do 的变更，先备份，再操作。

5. 日志参数与运营日志采集：容量估算与备份策略

日志参数配置分本地文件存储和数据库存储，默认是数据库存储。本地文件存储需要参考日志系统 Elastic 安装部署手册。运营日志比操作日志记录更详细，用于热点分析和系统使用情况分析，可以上传到服务网站查看图表。

日志文件容量估算有个公式：每个节点每天产生约 100M 日志文件，访问量大时到 200M。如果 5 个节点，保留 30 天，总容量是5 * (30 + 1) * 100M = 15500M，约 15G。那个“+1”是当天的日志。超过 200M 说明单台服务器请求已经超负荷，该考虑加节点了。

备份天数默认：应用日志、错误日志、后台日志、登录登出日志都是 7 天，7 天前的自动备份到历史日志表。清除备份天数默认 90 天，清除 90 天前的备份数据。记录错误日志条数可以设置每天超过指定数量不记录到数据库，防止日志表被撑爆。

我一般会把应用日志备份天数改成 14 天，清除备份改成 180 天，给排查问题留足时间。但前提是磁盘空间够，不然日志写满磁盘比日志丢失更可怕。运营日志开启后可以禁用系统操作日志，但禁用后不能直接从系统查看操作日志，只能通过运营日志平台看。所以如果没开通运营日志服务，别禁用操作日志。

从那以后我每次改 admin.do 配置，都强制走一遍“备份→改配置→重启→验证→再备份”的流程。希望帮到你。

本文还有配套的精品资源，点击获取