简介这份PDF面向蓝凌标准产品V16.0的系统管理员与实施运维人员聚焦admin.do后台的配置落地帮助读者解决部署与调优过程中参数设置不清、模块配置无从下手的问题属于偏实操的中高级运维文档。资源包共1个文件为单一PDF格式大小约2.65MB篇幅紧凑、便于随查随用。手册以引言与基础配置为主线依次覆盖数据库、全局参数、消息机制、存储、附件、REDIS缓存、全文索引与MQ配置并延伸至JMX服务、日志参数、运营日志采集、GZIP压缩及系统安全中的身份验证与会话管理等内容其中REDIS部分还细化了说明、安装部署与在本系统中的用途。读者可据此按模块对照完成参数设定理解各组件在系统中的职责边界减少上线前的配置返工。目前已有956人学习下载可作为日常运维与故障排查的案头参考。1. 从一次重启后全员掉线说起V16.0 的 admin.do 到底该先配哪几项去年帮一个团队做环境迁移EKP 从测试机搬到生产机数据库连接、附件目录都照原样抄了过去唯独漏了 Redis 那一段。启动日志干干净净登录页也能打开结果一到流程待办就报错会话在集群两个节点之间来回跳用户刚点开一个表单就被踢回登录页。排查了大半天才想起来admin.do 里 Redis 缓存没勾会话管理在集群下直接失效。这件事之后我养成一个习惯——凡是蓝凌标准产品 V16.0 的环境admin.do 配置一律按「数据库 → 存储附件 → Redis → 安全 → 集团应用」的顺序过一遍每改一项保存、备份、重启绝不攒着一起改。这份管理员手册讲的就是 admin.do 这个后台配置入口它管的是相对底层的全局项基础配置、系统安全、集团应用、应用配置四大页签。手册里有一句话被加粗强调了三遍——admin.do 里面的配置都是必须、需要、一定重启。配置完保存、备份配置、再重启顺序不能乱。这篇笔记按我实际部署的顺序拆开写适合第一次接手 V16.0 的运维也适合从 V14/V15 升上来、发现老配置项对不上号的老手。2. 装前把环境列清数据库、JDK 与目录权限的版本取舍2.1 数据库连接类型与 URL 写法数据库配置是 admin.do 里第一个必须填的字段也是整个系统能不能起来的地基。手册给的连接类型只有两种JDBC 方式推荐和 JNDI 方式。数据库类型覆盖 SQLserver、ORACLE、MYSQL、DB2以及国产的神通、达梦。我一般无脑选 JDBCJNDI 适合容器托管数据源的场景普通物理机部署没必要绕这一层。URL 是 jdbc 形式的地址手册给的示例是 SQLserver 走 jtds 驱动# admin.do - 基础配置 - 数据库配置 连接类型: JDBC 方式 数据库类型: SQLserver 数据库连接 URL: jdbc:jtds:sqlserver://192.168.1.146:1433/ekp 用户名: ekp_user 密码: ********这里有几个参数值得说清楚。jtds:sqlserver是 jTDS 驱动的前缀不是微软官方驱动V16.0 沿用这套写法说明它对老驱动的兼容还在1433是 SQLserver 默认端口改过端口的项目要同步改最后的/ekp是库名不是实例名。MySQL 的写法对应jdbc:mysql://host:3306/ekpOracle 走jdbc:oracle:thin:host:1521:orcl。填完先点「测试数据库连接」——手册明确说这是一次性 Test 连接不做数据读写无损测试放心点。测试通过再保存别跳过这步直接重启否则起不来只能看日志猜。2.2 全局参数里三个容易配反的开关全局参数配置是综合性参数手册列了几个关键字段我挑三个最容易配反的说。第一个是「样式调试模式」。上线测试环境建议开启样式不做缓存改完刷新就见效生产环境必须关闭降低系统访问压力。我见过测试环境忘了关、上线后带着缓存跑前端改了半天不生效最后查到这个开关。第二个是「帐户 trim() 函数」默认开启。手册写得很直白trim 函数会引起数据库检索的性能下降大用户量建议关闭。但关闭后要自主检查组织架构 Excel 导入和第三方同步引入的左右空格问题——这是个典型的性能与数据干净的取舍用户量上万再考虑关小系统开着省心。第三个是「获取客户端 IP 地址参数」和「获取 http 协议参数」都要去服务器 DNS/resource/jsp/testip.jsp页面看实际能显示的字段再填用于日志分析。别凭感觉填填错了日志里 IP 全是空的。2.3 附件目录与上传类型白名单附件配置分两块附件本身的配置和附件转换服务的配置。附件存放位置默认是c:/landray/kmss/resourceLinux 改成/usr/local/landray/kmss/resource手册特别标注目录需要具有可写权限。这一条踩坑率极高迁移时目录拷过去权限没带上传直接 500。# Linux 下给附件目录授权用户按实际运行 EKP 的账号改 chown -R ekp:ekp /usr/local/landray/kmss/resource chmod -R 755 /usr/local/landray/kmss/resource上传类型白名单是安全重点。不允许上传的附件类型格式为.js;.bat;.exe;.sh多种后缀以分号分隔只允许上传的类型同理如.docx;.xlsx;.txt;.pdf。手册提醒 WPS 文件的实际扩展名是.wps或者.jar别按.doc想当然。图片附件有大小限制大图宽度默认 1024 像素、小图宽度默认 512 像素超过就压缩设 0 表示不压缩——大图用于查看页小图用于列表页这个区分要记住。附件转换服务不配置不影响上传下载但移动端等不具备 Office 的环境要在线阅读就必须配。金格控件同理不配不影响基本使用要在线编辑批注才需要。手册提到 EKPV14 之后支持 iWebOffice2015 和 iWebOffice2009V15B2 还支持 iWebOffice2003选哪个看项目采购的控件版本。iWebOffice2015 第一次启用时Chrome 无法提醒用户下载控件必须先用 IE 装一遍Chrome 里加载失败就去开始菜单 iWebOffice2015 目录手动跑「修复配置」。这些都是血泪经验写进部署文档能省后来人半天。3. Redis 与全文索引缓存先起、索引后建3.1 Redis 5.0.2 的编译安装与启动顺序Redis 缓存这块手册给了完整的安装命令版本是 5.0.2我照抄一遍并补上编译依赖# 编译前先装 gcc 和 makeCentOS 系 yum install -y gcc make 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 # 编译产物在 src 目录前台启动 src/redis-server启动后用内置客户端验证src/redis-cli redis set foo bar OK redis get foo bar手册里有一句被标了「重点」Redis 宕机会导致 EKP 无法使用。配置后的启动顺序是先启动 Redis后启动 EKP。我一般把 Redis 做成 systemd 服务并设开机自启避免服务器重启后 EKP 先起来、Redis 还没起整个系统卡死。生产环境还要改redis.conf里的bind和requirepass手册没展开但这是合格运维的默认动作。Redis 在本系统有三个用途缓存机制非必须勾选后用 Redis 缓存不勾用系统默认缓存、会话管理集群环境必须勾选多服务器 SSO 环境必须勾选、以及配合单一用户限制。会话管理这块和第三章的安全配置是联动的后面细说。3.2 全文索引与 MQ 的参数怎么填全文索引配置服务于蓝凌统一搜索独立组件。定时任务时长按秒算一般是 28800也就是 8 小时跑一次全量线程数默认 1可设 1 到 10 左右机器核数多可以往上调但别贪大索引线程和业务抢 IO 得不偿失。搜索热词显示数量、相关搜索词显示数量、热词时间范围比如 30 天按运营需求填。「是否启用独立搜索」只对单独部署搜索应用或 KMS 自定义搜索的场景有意义和统一搜索、其他搜索引擎都无关别乱勾。MQ 配置只有三项URL、用户名、连接密码。消息队列发送不走 EKP 内部通过 MQ server 处理。JMX 服务端口有两种指定方式admin.do 里填或者通过 JVM 参数指定二选一别两边都配导致端口冲突。3.3 日志参数与运营日志的容量估算日志参数配置包括本地文件存储和数据库存储默认数据库存储。本地文件存储参考日志系统 Elastic 安装部署手册。运营日志比操作日志记录更详细用于热点分析和系统使用情况分析需要上传到服务网站才能看图表不开通就关掉采集。手册给了一个很实用的容量估算每个节点每天大约产生 100M 日志文件访问量大可能到 200M超过 200M 说明单台服务器请求已超负荷。5 个节点、保留 30 天容量约5 * (30 1) * 100M 15500M那个 1 是当天的日志。这个公式我每次规划磁盘都拿来套比拍脑袋靠谱。各类日志备份天数默认 7 天清除备份默认 90 天记录错误日志条数设了上限后超量不再入库防止错误风暴打爆数据库。4. 系统安全与集团应用会话、令牌环与多语言4.1 单一用户限制与 Redis 的联动前提本系统身份验证用于和第三方认证系统集成后LDAP、其他 EKP、AD 等。开启后本系统不做用户名密码校验但「例外人员」里的超管账号依然在本系统验证。手册备注虽然开启后不做校验但要确保两边有对应的用户用户名一致。会话管理的单一用户限制场景是全系统只允许一端登录A 用户在 Chrome 登录后别人用 A 的账号再登会强制下线前一个。例外是通过 SSO 单点的用户不会失效。启用前提写得很清楚有集群要配 Redis 才生效启用多服务器也要同时启用 Redis单 EKP 且不启用多服务器直接生效。这就是第 1 章那个掉线事故的根因——集群没配 Redis单一用户限制形同虚设。4.2 多服务器验证的令牌环参数多服务器验证用于跨 EKP 登录多套系统共享令牌环浏览器或 APP 登录一次进其他系统免登。以 Domino 的 LtpaToken 方式为例字段包括字段说明我的填法密钥类型Domino 令牌环或 EKP 自主 LRToken按对接系统选作用域一般是直接后缀可填多个域共用按实际域名有效期令牌环有效时间过期重新登录与业务会话时长对齐使用 redis 存储有效期必须先启用 Redis 缓存集群环境必开令牌环名称任意名称多套系统保持一致统一命名密钥随机生成一组拷贝到其他系统生成后立即备份登录关键字默认 CN一般不动「使用 redis 存储有效期」勾上后用户每次访问会延长有效期类似 session从 Redis 取到有效期就以它为准否则以上面的令牌环有效期为准。密钥生成后一定要备份丢了就得所有对接系统重新配一遍。4.3 多语言、分级授权与多域名多语言支持开启后登录页可切换语言备选项来源于此处的语言配置官方语言是所有用户默认语言。语言样式定义三项单屏登录页、多屏滑动登录页、随机背景登录页。集群模式下要开启附加功能保证通讯安全密钥、系统独立节点标识、不受干扰起始端口 20 不同——这条容易被忽略集群节点端口没拉开通讯就串了。集团分级授权和组织场所同步涉及数据隔离场所见数据隔离开启后各场所相互独立隔离方向可选对本场所可见、对上级可见、对下级可见。机构同步分平级同步和层级同步场所漫游同步可选直属用户或全部用户。多域名支持只在多线环境下配手册直言当前互联网骨干网建设已基本完成、延迟较低一般不开启。5. 避坑排查admin.do 配置里最容易翻车的五件事5.1 改完不重启配置像没生效现象admin.do 里改了附件大小限制前台还是按老值拦截。原因手册反复强调配置完要保存、备份、重启很多人只点了保存。解决养成「保存 → 备份配置 → 重启」三连重启后随便传个大附件验证一下。备份配置文件导出后妥善保存手册提醒防泄漏我一般放独立目录并加权限。5.2 三员管理开了之后进不去 admin.do现象手滑开启三员管理再访问 admin.do 直接被拒。原因手册明确写默认关闭开启后不能再访问 admin.do。解决三员管理配置参考专门的操作手册开启前先把 admin.do 该配的都配完并备份开启后走三员管理自己的入口。这是典型的不可逆操作动手前想清楚。5.3 附件目录没权限上传全 500现象迁移后上传附件报错日志里是写文件失败。原因Linux 下/usr/local/landray/kmss/resource目录属主或权限不对。解决按 2.3 节的 chown/chmod 处理确认运行 EKP 的账号对目录有写权限别用 root 跑应用来「绕过」。5.4 集群没配 Redis会话到处跳现象两个节点负载均衡用户登录后一会儿掉线。原因会话管理在集群下必须配 Redis 才生效没配就各节点各管各的会话。解决先起 Redisadmin.do 勾选 Redis 缓存和会话管理再起 EKP同时确认启动顺序Redis 没起 EKP 起不来。5.5 流水号兼容配置没勾老数据编号乱现象升级到 V16.0 后老模块新建单据的流水号和历史规则对不上。原因系统默认启用新版流水号生成机制老客户有兼容性问题。解决进对应模块重新配置编号生成规则或者在 KMS 知识专辑配置里勾上对应模块让它沿用原有流水号机制。升级项目一定要在测试环境先验证这一项。6. 装完怎么验证一份可复现的 admin.do 上线自检清单配置全部落完、重启之后别急着交付。我一般按下面这份清单走一遍每项都有明确的通过标准任何一项不过就回到对应章节查。# 1. 数据库连通性admin.do 里点测试连接或直接看启动日志无 SQLException # 2. Redis 存活先于 EKP 启动客户端 ping 返回 PONG src/redis-cli ping # 3. 附件目录可写用运行账号建个测试文件 sudo -u ekp touch /usr/local/landray/kmss/resource/_healthcheck echo ok # 4. 会话管理两个浏览器用同一账号登录确认前一个被强制下线 # 5. 附件上传传一个超过限制的文件确认被拦传正常文件确认成功 # 6. 全文索引触发一次索引任务搜索关键词能命中新文档逐项说下判断标准。数据库这关看启动日志里有没有连接池初始化失败的堆栈测试连接通过只是第一步真正跑起来还要看业务查询。Redis 的ping返回PONG才算活光看进程在不够。附件目录用运行账号 touch 一个文件能建能删才算权限到位root 能写不代表应用账号能写。会话管理用两个浏览器或一个正常窗口一个无痕同账号登录前一个必须被踢没被踢说明 Redis 没生效。附件上传一正一反各测一次白名单和大小限制都要覆盖。全文索引触发后搜一个新上传文档的关键词搜不到就查定时任务时长和线程数。还有两个容易漏的验证点一是 Gzip 压缩开启后用浏览器开发者工具看响应头有没有Content-Encoding: gzip开了没生效多半是前置代理又压了一遍二是运营日志如果关了采集确认「基础设置-日志参数」里的操作日志还在正常记录别把排查问题的黑匣子一起关了。这份手册本身是 PDF20 页覆盖 admin.do 四大页签的全部字段我把它当部署时的对照表用——每配一个页签翻到对应章节配完打勾。从那以后我每次交付 V16.0 环境都强制走一遍上面这份自检清单宁可多花半小时也不想再经历一次重启后全员掉线。希望帮到你。本文还有配套的精品资源点击获取