蓝凌admin.do配置手册实战：从数据库到Redis的避坑指南

简介蓝凌标准产品V16.0管理员手册-admin.do配置面向企业信息化系统的运维与管理人员帮助其快速掌握蓝凌V16.0后台各项参数的配置方法与排错思路。手册围绕admin.do管理入口展开涵盖数据库、全局参数、消息机制、存储、附件、REDIS缓存、全文索引、MQ、JMX服务、日志参数、运营日志采集及GZIP压缩等模块并延伸至系统安全中的身份验证与会话管理目录结构清晰便于按模块查阅。资源包内含1个PDF文档压缩包约2.65MB适合作为日常运维配置的案头参考。目前已有954人学习下载读者可据此了解各配置项的作用与设置要点快速定位系统运行中的配置问题提升部署与维护效率。1. 拿到 admin.do 配置手册先别急着改这份 20 页文档到底解决什么问题很多做企业信息化运维的同行第一次拿到一份 20 页的 PDF 管理员手册第一反应是“这么薄能讲清楚什么”。但如果你手上正好有一套蓝凌标准产品 V16.0 需要部署或交接这份 admin.do 配置手册的价值恰恰在于它够薄——它把后台那个“改错一个参数就得重启、重启完还可能起不来”的配置页面按页签拆成了可对照的清单。admin.do 是这套系统里最底层的全局配置入口数据库连接、Redis 缓存、附件存储、消息通道、多语言、三员管理这些开关全在这里手册明确写了一句话所有配置保存后必须备份并重启才生效。这意味着你在这个页面上的每一次保存都是一次带风险的操作。这份文档适合两类人一是刚接手系统、需要把配置项和实际环境对上的运维二是做集成对接时要确认某个开关到底管什么用的开发。它不教你怎么装系统但能让你在改配置之前知道每个字段的边界在哪。2. 基础配置逐项拆解从数据库连接到 GZIP 的落地顺序基础配置是 admin.do 里字段最多、也最容易改出问题的页签。手册把它拆成数据库、全局参数、消息机制、存储、附件、Redis、全文索引、MQ、JMX、日志、运营日志、GZIP 共十二块。实际落地时不需要按手册顺序来但有一个依赖关系必须遵守数据库配置是第一步Redis 配置必须在 Redis 服务启动之后才能填否则保存后重启直接起不来。下面按“先能跑起来、再谈优化”的顺序把关键项过一遍。2.1 数据库配置连接类型和 URL 的写法差异数据库配置是整个系统的命门手册里字段说明写得很直白连接类型推荐 JDBC数据库类型支持 SQLserver、ORACLE、MYSQL、DB2、神通、达梦。URL 必须是 jdbc 形式的地址。这里有一个新手容易翻车的点——不同数据库的 JDBC URL 前缀不一样手册只给了一个 SQLserver 的示例实际配 MySQL 或达梦时照抄那个格式会直接连不上。# SQLserver 示例手册原文格式 jdbc:jtds:sqlserver://192.168.1.146:1433/ekp # MySQL 常见写法驱动类名不同URL 前缀不同 jdbc:mysql://192.168.1.146:3306/ekp?useUnicodetruecharacterEncodingutf8 # 达梦常见写法 jdbc:dm://192.168.1.146:5236/ekp逻辑说明连接类型选 JDBC 时系统会用你填的 URL 去建立连接池选 JNDI 则走容器托管的数据源适合已经由中间件统一管理连接的场景。参数上重点看端口和库名SQLserver 默认 1433MySQL 默认 3306达梦默认 5236写错端口报的是连接超时而不是“库不存在”排查时容易走弯路。手册里还提到一个“测试数据库连接”按钮说明是一次性 Test 连接、不做数据读写我一般会在改完 URL 后先点这个确认通了再保存重启能省掉一轮无谓的重启等待。2.2 全局参数与消息机制几个默认值建议改掉全局参数里有两个字段值得单独拎出来说。一个是“视图默认显示行数”默认 15手册建议不要太大防止使用者电脑配置差打开太慢——这个建议在实际上线后经常被忽略有人为了“一页看全”调到 50 甚至 100结果列表页加载时间翻倍。另一个是“帐户 trim() 函数”默认开启手册明确写了 trim 会引起数据库检索性能下降大用户量建议关闭但关闭后要自己检查组织架构 Excel 导入和第三方同步引入的左右空格问题。这是一个典型的“性能换数据干净度”的取舍用户量过万时我一般会关掉然后在导入环节加校验。消息机制配置管的是全系统通知通道待办、Email、短消息、DING 消息。手册里有一句提醒很关键——“默认通知方式的意思是默认勾选所有通道不建议”。原因是如果短信通道没有独立组件配合勾了也发不出去反而让用户以为通知发了。实际配置时按已采购的通道勾选没集成的不要勾。2.3 存储与附件配置加密选项和上传类型白名单存储配置提供三种方式文件存储、阿里云对象存储、F4OSS 文件存储。选文件存储时会遇到附件加密选项手册列了四种不加密、简单加密、不加密兼容简单加密和 AES、AES 加密。这里手册的措辞有点绕实际理解是——简单加密和 AES 加密都会稍微影响性能选择时要考虑历史附件的兼容性。如果系统里已经存了大量不加密附件直接切 AES 会导致老附件读不出来得走兼容模式过渡。附件配置里两个安全字段必须配不允许上传的附件类型和只允许上传的附件类型。手册给的格式是分号分隔比如.js;.bat;.exe;.sh。这里有个细节WPS 文件的实际扩展名是.wps或者.jar如果只允许上传的列表里写了.docx却没写.wps用户传 WPS 文档会被拦。附件存放位置默认是c:/landray/kmss/resourceLinux 下改成/usr/local/landray/kmss/resource手册特别标注目录需要具有可写权限——这个权限问题在 Linux 部署时是高频翻车点后面避坑章节会展开。2.4 Redis 缓存配置启动顺序是硬约束Redis 这块手册用了加粗的强调语气“Redis 宕机会导致 EKP 无法使用”“配置后的启动顺序先启动 Redis后启动 ekp”。这不是建议是硬约束。手册给的安装步骤是源码编译方式# 下载、解压、编译 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/redis-server # 用内置客户端验证 src/redis-cli redis set foo bar OK redis get foo bar逻辑说明make编译完成后可执行文件在src目录下redis-server不带配置文件启动会用默认端口 6379。set和get是验证服务是否正常的最简命令返回 OK 和 bar 说明读写通。参数上生产环境不会用默认配置直接跑但手册只给了最简启动方式实际部署时我一般会指定配置文件并设置持久化策略。Redis 在本系统里有两个用途缓存机制非必须不勾选用系统默认缓存和会话管理集群环境必须勾选多服务器 SSO 环境必须勾选。这两个用途的勾选状态直接决定集群能不能正常做单点登录。2.5 全文索引、MQ、JMX 与日志参数全文索引配置依赖蓝凌统一搜索独立组件手册里“全文索引定时任务时长”默认 28800 秒8 小时“全文索引线程数”默认 1、可设 1 到 10。线程数调太高会抢数据库资源调太低索引更新慢一般 3 到 5 是折中值。MQ 配置只有 URL、用户名、连接密码三项说明消息队列是外挂的不走 EKP 内部。JMX 服务提供管理扩展能力端口可以在这里填也可以通过 JVM 参数指定两种方式选一种就行同时配可能冲突。日志参数配置里有一组默认值需要留意应用日志、错误日志、后台日志、登录登出日志的备份天数默认都是 7 天清除备份的天数默认 90 天。手册还给了一个容量估算公式每个节点每天约产生 100M 日志文件访问量大可能到 200M。如果有 5 个节点、保留 30 天容量约5 * (30 1) * 100M 15500M。这个估算在做磁盘规划时直接能用公式里的“301”中的 1 是当天日志别漏算。3. 系统安全与集团应用身份验证、三员管理和多语言配置系统安全和集团应用这两块配置项数量不多但每一个都涉及权限边界改之前要想清楚影响范围。手册把系统安全拆成本系统身份验证、多服务器验证、三员管理三部分集团应用拆成多语言、分级授权、组织场所同步、多域名四部分。3.1 本系统身份验证与单一用户限制本系统身份验证用于和第三方用户认证系统集成后LDAP、其它 EKP、AD 等的场景。手册写了两条规则开启禁用则本系统验证不做用户名密码校验例外人员里部分超管账号依然在本系统做验证。这里有一个容易误解的地方——开启禁用后虽然不做校验但手册备注了“需要确保两边有对应的用户用户名一致”也就是说账号还是得在两边都存在只是密码不在这边验。会话管理里的“单一用户限制”适用于全系统只允许一端登录的场景。手册举的例子是A 用户在谷歌浏览器登录了另一个人用 A 的账号登录会强制下线先登录的 A 用户。例外是通过 SSO 单点的用户不会失效。启用前提写得很清楚有集群需要配置 Redis 才生效启用多服务器也需要同时启用 Redis单 EKP 不启用多服务器则直接生效。这个前提条件如果不满足勾了也不会起作用排查时先确认 Redis 状态。3.2 多服务器验证与令牌环配置多服务器验证解决的是跨 EKP 登录问题——多套系统共享令牌环浏览器或 APP 登录一次进入其它系统免登。手册以 Domino 的 LtpaToken 方式为例字段包括密钥类型、作用域、有效期、令牌环名称、密钥、登录关键字。密钥类型可选 Domino 令牌环或 EKP 自主 LRToken根据对接系统选。作用域一般填直接后缀可以填多个域共用。有效期指定令牌环有效时间过期后重新登录。这里有一个和 Redis 联动的字段“使用 redis 存储有效期”。手册说明使用该功能必须先启用 Redis 缓存不配置表示不使用。用户每次访问时会延长该有效期类似 session 的有效期。当从 Redis 取到有效期时以该有效期为准否则以令牌环有效期为准。这个逻辑在排查“为什么用户登录状态时长短于预期”时很关键——先看 Redis 里有没有值。3.3 三员管理与集团分级授权三员管理默认关闭手册有一句警告“开启三员管理后不能再访问 admin.do”。这意味着开启这个开关等于把后台配置入口锁掉后续要调整只能走三员管理操作手册里的流程。所以开启前一定要先备份配置文件手册第六章专门有一节“备份配置文件”导出后妥善保存以防泄漏。集团分级授权里的“场所见数据隔离”是一个权限方向配置隔离选项包括对本场所数据可见、对上级场所数据可见、对下级场所数据可见。组织场所同步则管机构同步平级还是层级、部门同步、场所管理员同步、场所漫游同步。这些配置直接影响用户能看到哪些数据改之前建议先在测试环境验证隔离方向是否符合组织架构的实际汇报关系。3.4 多语言支持与多域名多语言支持开启后登录页可以切换语言备选项来源于此处的语言配置官方语言是所有用户登录的默认语言。语言样式定义三项单屏登录页、多屏滑动登录页、随机背景登录页。手册还提到一个附加功能集群模式下需要开启此项保证通讯安全密钥、系统独立节点标识、不受干扰起始端口20 不同。这个“起始端口20”是集群节点间通讯的端口分配规则部署多节点时如果端口冲突先检查这里。多域名支持针对多线环境手册的说明是“当前互联网骨干网建设已基本完成延迟较低所以一般不开启此项”。这是一个明确的“默认不配”建议除非确实遇到运营商网间延迟问题否则不用动。4. 应用配置与后台配置KMS、移动端和角色分配应用配置和后台配置是 admin.do 里相对“上层”的部分管的是知识专辑、移动组件、个人中心、表单和角色。这些配置不像数据库那样一错就起不来但配错了会影响具体功能的使用体验。4.1 KMS 知识专辑与流水号兼容KMS 知识专辑配置里有三个字段值得关注。批量下载最大个数限制知识专辑的批量下载数量设太大对服务器压力大。建模日志存放路径用于存放业务建模的日志。流水号生成规则兼容配置是给老客户用的——系统默认启用新版流水号生成机制老客户会有兼容性问题可以进入对应模块重新配置编号生成规则或者勾选对应模块让它使用原有机制。这个配置在系统升级后如果发现流水号格式变了就是这里没设对。4.2 移动组件扩展与个人中心移动组件扩展配置里“扩展支持的 UA 信息”默认已适配大部分手机 UA遇到无法识别特定机型时手册给了一个排查方法在手机上访问域名/third/pda/ua.jsp获取 UA。移动终端访问域名可以分配一个专属移动端地址这样不用识别 UA 直接展现移动端。“仅允许移动端访问”启用后 PC 端不能访问“禁止本服务器的登录功能”在启用 SSO 多服务器配置后可以禁用掉此服务器的登录安全考虑。“代理服务器”用于 EKP 无法访问微信第三方时通过此处连通。个人中心配置里头像来源可选 EKP 个人头像或 KK 头像。二维码分享配置开启后在模块文档查看页面会显示二维码这个功能看场景决定是否开。4.3 表单配置与角色分配表单配置主要是移动端对自定义 JSP 的支持手册有一句操作提醒“当切换此功能请务必重新生成 JSP后台管理员工具箱中”。这是一个容易漏的步骤——改了表单配置不重新生成 JSP移动端页面不会更新。后台配置里的角色分配手册用表格列了角色名称、角色权限说明、群组角色、考勤管理员、模块管理员。模块管理员只有管理员才具有访问权限。角色分配本身不复杂但要注意的是角色和权限的对应关系在系统里有默认值调整前先确认现有角色是否已经被业务流程引用。5. 避坑与排查admin.do 配置里最容易翻车的五个点这一章把前面各环节里散落的坑集中起来按“现象 → 原因 → 解决”的格式写。这些都是实际部署和运维中反复出现的问题不是理论推演。5.1 保存配置后重启系统起不来现象在 admin.do 改完配置点保存重启 EKP 后服务无法启动日志里报连接类错误。原因最常见的是 Redis 配置在 Redis 服务未启动时保存或者数据库 URL 改错但没点“测试数据库连接”就保存了。手册明确写了 Redis 配置必须在 Redis 启动之后配置且启动顺序是先 Redis 后 EKP。解决重启前先确认 Redis 服务状态redis-cli ping返回 PONG数据库连接用测试按钮验证通过。如果已经起不来用第六章的备份配置文件回滚或者直接改回上一次的配置值。5.2 Linux 下附件上传失败报权限错误现象Windows 环境正常迁到 Linux 后上传附件报错日志提示无法写入。原因附件存放位置默认是c:/landray/kmss/resourceLinux 下要改成/usr/local/landray/kmss/resource手册标注了“目录需要具有可写权限”。很多人改了路径但没给运行账号写权限。解决确认路径后执行chown -R 运行账号:运行账号 /usr/local/landray/kmss/resource和chmod -R 755然后重启。注意不要给 777安全上不合适。5.3 单一用户限制不生效现象勾选了会话管理的单一用户限制但同一账号还是能在多处同时登录。原因手册写了启用前提——有集群需要配置 Redis 才生效启用多服务器也需要同时启用 Redis单 EKP 不启用多服务器才直接生效。如果环境是集群但 Redis 没配或没勾选这个功能就是摆设。解决先确认环境类型集群或多服务器环境必须启用 Redis 缓存并确保 Redis 服务正常然后重新保存配置并重启。5.4 附件类型白名单拦住了正常文件现象配置了只允许上传的附件类型用户传 WPS 文档或某些 Office 文件被拒绝。原因手册特别提示 WPS 文件的实际扩展名是.wps或者.jar如果白名单里只写了.docx、.xlsx而没写.wps、.et、.dpsWPS 用户就会被拦。另外如果金格控件选了 OFFICE 模式所有 Word、Excel、PPT 都要改成.doc/.xls/.ppt后缀选了 WPS 则改成.wps/.et/.dps。解决根据实际使用的办公软件类型把对应扩展名加进白名单。金格控件的模式选择要和用户实际文件格式匹配混编场景要确认版本是否支持。5.5 日志表膨胀导致查询变慢现象系统运行一段时间后日志查询越来越慢数据库磁盘占用增长快。原因日志参数配置里应用日志、错误日志、后台日志、登录登出日志的备份天数默认 7 天清除备份天数默认 90 天。如果没调整过90 天的备份日志会一直堆在历史日志表里。手册给的容量估算显示 5 节点 30 天就约 15G实际访问量大的环境增长更快。解决根据磁盘容量和合规要求调整备份天数和清除天数。如果开启了运营日志采集手册提到可以禁用系统操作日志但禁用后不能直接从系统查看操作日志需要权衡。调整后观察一段时间数据库增长趋势。6. 配置备份与版本升级时的参数迁移技巧admin.do 的配置项加起来几十个每次升级或迁移环境都靠手工对照填出错概率不低。手册第六章的“备份配置文件”功能就是为这个场景准备的——导出后妥善保存既防泄漏也防丢失。我自己的习惯是每次改动 admin.do 之前先导出一份当前配置命名带上日期和环境标识改完再导出一份两份对比就能看出这次到底动了哪些参数。升级场景下参数迁移有几个技巧。第一数据库配置和 Redis 配置是环境相关的升级包里的默认值不能直接用必须按目标环境填。第二附件存放位置和附件转换服务的端口配置如果升级前后服务器不变可以直接沿用如果换了服务器路径和端口都要重新确认。第三多服务器验证的密钥和令牌环名称多套系统之间必须保持一致升级时如果重新生成了密钥其它系统也要同步更新否则免登会失效。第四三员管理如果已开启admin.do 是访问不了的升级前要先确认三员管理的配置流程别把自己锁在外面。验证配置是否生效除了看功能是否正常还可以通过几个入口快速确认JDBC 监控在“管理员工具箱-请求监控-查看 JDBC 监控”里看能确认数据库连接池状态获取客户端 IP 地址参数可以在服务器 DNS/resource/jsp/testip.jsp页面查看用于日志分析时确认 IP 字段是否正确移动端 UA 识别问题可以通过手机访问域名/third/pda/ua.jsp获取实际 UA 来比对。有一个细节我踩过坑手册里说“部分选项因组件不具备不会显示”意思是 admin.do 页面上的字段是动态的没装某个组件就不会出现对应配置项。所以对照手册排查时如果找不到某个字段先确认对应组件是否已部署而不是怀疑手册版本不对。从那以后我每次拿到新环境都先把 admin.do 每个页签截一遍图存档升级后再截一遍对比哪些字段因为组件变化消失了、哪些新增了一目了然。希望帮到你。本文还有配套的精品资源点击获取