简介蓝凌标准产品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、端口、库名要换成你实际环境的。如果是 OracleURL 会变成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/resourceLinux 下改成/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 配置都强制走一遍“备份→改配置→重启→验证→再备份”的流程。希望帮到你。本文还有配套的精品资源点击获取