簡介藍(lán)凌標(biāo)準(zhǔn)產(chǎn)品V16.0管理員手冊-admin.do配置面向企業(yè)信息化系統(tǒng)的運(yùn)維與管理人員幫助其快速掌握藍(lán)凌V16.0后臺各項(xiàng)參數(shù)的配置方法與排錯思路。手冊圍繞admin.do配置入口展開涵蓋數(shù)據(jù)庫連接、全局參數(shù)、消息機(jī)制、存儲與附件、Redis緩存、全文索引、MQ、JMX服務(wù)、日志參數(shù)、運(yùn)營日志采集及GZIP壓縮等模塊并延伸至系統(tǒng)安全中的身份驗(yàn)證與會話管理目錄結(jié)構(gòu)清晰便于按模塊查閱。資源為1個PDF文檔壓縮包約2.65MB內(nèi)容完整、層級分明適合作為日常運(yùn)維的案頭參考。目前已有954人學(xué)習(xí)下載讀者可據(jù)此完成從基礎(chǔ)環(huán)境搭建到緩存、索引、消息隊(duì)列等中間件配置的全流程落地并借助安全與日志章節(jié)排查常見問題提升系統(tǒng)穩(wěn)定性與運(yùn)行效率。1. 從一次凌晨三點(diǎn)的故障說起這份 admin.do 配置手冊到底能救什么急去年冬天某公司運(yùn)維群里炸了鍋——EKP 集群里一臺節(jié)點(diǎn)重啟后所有用戶被強(qiáng)制下線待辦消息全部卡死。排查到天亮才發(fā)現(xiàn)是 Redis 緩存配置沒勾選“會話管理集群”那一項(xiàng)導(dǎo)致多服務(wù)器 SSO 令牌環(huán)失效。這種血淚經(jīng)驗(yàn)在藍(lán)凌標(biāo)準(zhǔn)產(chǎn)品 V16.0 的 admin.do 配置里幾乎每個選項(xiàng)背后都藏著類似的坑。這份管理員手冊本質(zhì)上是一份“后臺黑匣子操作指南”。admin.do 頁面集中了數(shù)據(jù)庫連接、Redis 緩存、附件存儲、消息機(jī)制、全文索引、多服務(wù)器驗(yàn)證等底層配置項(xiàng)全部是全局性、必須重啟才生效的硬核參數(shù)。它適合兩類人一是剛接手 EKP 運(yùn)維、面對 admin.do 滿屏字段不敢下手的初級管理員二是需要排查集群故障、調(diào)優(yōu)性能的一線工程師。手冊只有 20 頁但每一頁的配置項(xiàng)都直接關(guān)聯(lián)系統(tǒng)能否正常啟動、用戶能否登錄、附件能否上傳下載。如果你正在部署或維護(hù)藍(lán)凌 V16.0這份文檔就是你的“后悔藥”——前提是你得先看懂它。2. 基礎(chǔ)配置數(shù)據(jù)庫、Redis 與附件存儲的硬核參數(shù)怎么填2.1 數(shù)據(jù)庫配置連接類型與 URL 的選型邏輯數(shù)據(jù)庫配置是 admin.do 里第一項(xiàng)必須填對的參數(shù)填錯直接導(dǎo)致系統(tǒng)無法啟動。手冊里給了兩種連接類型JDBC 和 JNDI。我一般無腦選 JDBC因?yàn)?JNDI 依賴容器上下文遷移或升級時容易找不到數(shù)據(jù)源而 JDBC 把連接串寫死在配置里出問題一眼就能看到 URL 對不對。數(shù)據(jù)庫類型支持 SQLserver、ORACLE、MYSQL、DB2、神通、達(dá)夢。URL 格式是標(biāo)準(zhǔn)的 jdbc 形式比如 SQLserver 用 jtds 驅(qū)動時寫成jdbc:jtds:sqlserver://192.168.1.146:1433/ekp注意這里的 IP、端口、庫名要換成你實(shí)際環(huán)境的。如果是 OracleURL 會變成jdbc:oracle:thin:IP:1521:ORCL這種格式。填完后一定要點(diǎn)“測試數(shù)據(jù)庫連接”這個 Test 是一次性無損測試不做數(shù)據(jù)讀寫放心點(diǎn)。但測試通過不代表生產(chǎn)沒問題——我遇到過測試通、啟動報錯的案例原因是數(shù)據(jù)庫用戶權(quán)限沒給全缺少建表或序列權(quán)限。所以測試通過后還要確認(rèn)賬號有 DDL 和 DML 權(quán)限。2.2 Redis 緩存配置啟動順序與宕機(jī)風(fēng)險Redis 配置是 admin.do 里最容易翻車的地方。手冊明確寫了Redis 宕機(jī)會導(dǎo)致 EKP 無法使用。這不是危言聳聽我見過 Redis 服務(wù)被誤停后整個 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進(jìn)去set foo bar驗(yàn)證。但生產(chǎn)環(huán)境別用默認(rèn)配置裸跑要改redis.conf里的bind、requirepass和maxmemory。綁定 IP 別寫0.0.0.0密碼必須設(shè)內(nèi)存上限根據(jù)附件緩存量估算一般給物理內(nèi)存的 60%。Redis 在系統(tǒng)里有三個用途緩存機(jī)制非必須、會話管理集群必須、令牌環(huán)存儲多服務(wù)器驗(yàn)證必須。勾選“緩存機(jī)制”后系統(tǒng)緩存走 Redis不勾選就用本地緩存。但只要你啟用了集群或多服務(wù)器 SSO會話管理必須勾選否則用戶登錄狀態(tài)無法跨節(jié)點(diǎn)共享。注意配置后的啟動順序是先啟 Redis再啟 EKP。如果 Redis 掛了EKP 重啟也起不來必須先把 Redis 拉起來。2.3 附件存儲與轉(zhuǎn)換服務(wù)路徑權(quán)限與金格控件附件配置分兩塊附件存放位置和附件轉(zhuǎn)換服務(wù)。存放位置默認(rèn)是c:/landray/kmss/resourceLinux 下改成/usr/local/landray/kmss/resource。這里有個坑目錄必須具有可寫權(quán)限而且不要放在系統(tǒng)盤根目錄否則磁盤滿了他會先崩。附件大小限制分普通附件和圖片附件。大圖寬度默認(rèn) 1024 像素小圖寬度默認(rèn) 512 像素超過就壓縮。設(shè)為 0 表示不壓縮但別這么干除非你不在乎用戶打開列表頁卡成 PPT。不允許上傳的附件類型默認(rèn)包含.js;.bat;.exe;.sh這是安全底線別手賤刪掉。只允許上傳的類型按需配格式用分號分隔比如.docx;.xlsx;.txt;.pdf。注意 WPS 文件的實(shí)際擴(kuò)展名可能是.wps或.jar別漏了。金格控件配置是附件在線編輯的關(guān)鍵。iWebOffice2015 支持多瀏覽器但第一次使用必須先用 IE 安裝控件Chrome 無法提醒下載。如果 Chrome 加載失敗讓客戶端手動運(yùn)行開始菜單里 iWebOffice2015 目錄下的“修復(fù)配置”。還有個細(xì)節(jié)EKPV15B2 之后支持 iWebOffice2003但選了 OFFICE 就得把所有 word、excel、PPT 改成.doc/.xls/.ppt選了 WPS 就得改成.wps/.et/.dps混編會報錯。3. 系統(tǒng)安全與集團(tuán)應(yīng)用多服務(wù)器驗(yàn)證、三員管理與多語言配置3.1 多服務(wù)器驗(yàn)證令牌環(huán)配置與 Redis 有效期多服務(wù)器驗(yàn)證用于跨 EKP 登錄多套系統(tǒng)共享令牌環(huán)瀏覽器或 APP 登錄一次進(jìn)入其它系統(tǒng)免登。手冊以 Domino 的 LtpaToken 方式為例配置項(xiàng)包括密鑰類型、作用域、有效期、令牌環(huán)名稱、密鑰、登錄關(guān)鍵字。密鑰類型可選 Domino 令牌環(huán)或 EKP 自主 LRToken根據(jù)對接系統(tǒng)選。作用域一般填直接后綴可以填多個域共用。有效期指定令牌環(huán)有效時間過期后重新登錄。如果勾選了“使用 redis 存儲有效期”必須先啟用 Redis 緩存否則不生效。用戶每次訪問會延長有效期類似 session 機(jī)制。從 Redis 取到有效期時以 Redis 為準(zhǔn)否則以令牌環(huán)有效期為準(zhǔn)。令牌環(huán)名稱多套系統(tǒng)必須保持一致密鑰可以隨機(jī)生成一組拷貝到其它系統(tǒng)或者從其它系統(tǒng)拷貝。登錄關(guān)鍵字默認(rèn)是 CN別亂改。3.2 三員管理與身份驗(yàn)證開啟后 admin.do 就進(jìn)不去了三員管理默認(rèn)關(guān)閉開啟后不能再訪問 admin.do。這是硬性限制沒有后悔藥。所以開啟前必須確保三員管理操作手冊已經(jīng)吃透并且備份好配置文件。我一般建議在測試環(huán)境先跑一遍三員管理流程確認(rèn)沒問題再上生產(chǎn)。本系統(tǒng)身份驗(yàn)證用于和第三方用戶認(rèn)證系統(tǒng)集成后LDAP、其它 EKP、AD 等。開啟禁用后本系統(tǒng)驗(yàn)證不做用戶名密碼校驗(yàn)但例外人員里的超管賬號依然在本系統(tǒng)做驗(yàn)證。注意雖然不做校驗(yàn)但兩邊必須有對應(yīng)的用戶用戶名一致否則登錄后找不到人。3.3 多語言與集團(tuán)分級授權(quán)集群通訊安全與場所隔離多語言支持開啟后登錄頁可以切換語言備選項(xiàng)來源于語言配置。官方語言是默認(rèn)所有用戶登錄的語言。語言樣式定義三項(xiàng)單屏登錄頁、多屏滑動登錄頁、隨機(jī)背景登錄頁。附加功能里有個關(guān)鍵點(diǎn)集群模式下需要開啟此項(xiàng)保證通訊安全密鑰、系統(tǒng)獨(dú)立節(jié)點(diǎn)標(biāo)識、不受干擾起始端口20 不同。這個端口偏移量是硬編碼的別想著改。集團(tuán)分級授權(quán)和場所同步涉及數(shù)據(jù)隔離。場所見數(shù)據(jù)隔離開啟后各個場所相互獨(dú)立。隔離方向有三個選項(xiàng)對本場所數(shù)據(jù)可見、對上級場所數(shù)據(jù)可見、對下級場所數(shù)據(jù)可見。機(jī)構(gòu)同步分平級同步和層級同步部門同步同步創(chuàng)建 N 級對應(yīng)的場所。管理員同步需要同步的則開啟場所漫游同步可選直屬用戶或全部用戶。多域名支持用于多線環(huán)境應(yīng)對運(yùn)營商網(wǎng)間延遲。但手冊明確說了當(dāng)前互聯(lián)網(wǎng)骨干網(wǎng)建設(shè)已基本完成延遲較低所以一般不開啟。除非你的用戶分布確實(shí)跨多個運(yùn)營商且延遲明顯否則別給自己找事。4. 避坑排查admin.do 配置里最容易翻車的五個點(diǎn)4.1 改完配置沒重啟以為保存就生效現(xiàn)象在 admin.do 里改完數(shù)據(jù)庫 URL 或 Redis 地址點(diǎn)保存后刷新頁面發(fā)現(xiàn)配置沒生效系統(tǒng)還是連舊地址。原因admin.do 里的配置都是全局性的必須重啟 EKP 才能加載新配置。手冊里用三個感嘆號強(qiáng)調(diào)“必須需要一定重啟”不是開玩笑。解決保存配置后先點(diǎn)“備份配置文件”導(dǎo)出備份然后重啟 EKP 服務(wù)。重啟順序是先 Redis 后 EKP別搞反。4.2 Redis 沒啟動就配 admin.do保存后 EKP 起不來現(xiàn)象在 admin.do 里勾選了 Redis 緩存和會話管理保存后重啟 EKP結(jié)果啟動日志報連接 Redis 超時系統(tǒng)卡在啟動階段。原因Redis 服務(wù)沒啟動或者防火墻沒放行端口EKP 啟動時連不上 Redis 直接阻塞。解決先確認(rèn) Redis 進(jìn)程在跑用redis-cli ping返回 PONG。再檢查 EKP 服務(wù)器到 Redis 服務(wù)器的網(wǎng)絡(luò)和端口。如果 Redis 有密碼admin.do 里的密碼字段別填錯。4.3 附件目錄權(quán)限不對上傳報 500現(xiàn)象用戶上傳附件時頁面報 500 錯誤后臺日志顯示Permission denied或FileNotFoundException。原因附件存放位置配置的目錄不存在或者 EKP 運(yùn)行用戶沒有寫權(quán)限。解決Linux 下用chown -R ekp用戶:ekp用戶 /usr/local/landray/kmss/resource改屬主chmod -R 755給權(quán)限。Windows 下檢查目錄是否被安全軟件鎖定。4.4 金格控件 Chrome 加載失敗以為控件壞了現(xiàn)象Chrome 瀏覽器打開附件在線編輯提示控件加載失敗但 IE 里正常。原因iWebOffice2015 第一次使用必須先用 IE 安裝控件Chrome 無法提醒下載。安裝后 Chrome 仍可能加載失敗需要手動修復(fù)配置。解決讓客戶端先打開 IE 訪問系統(tǒng)按提示安裝控件。然后在開始菜單找到 iWebOffice2015 目錄運(yùn)行“修復(fù)配置”。如果還不行檢查 admin.do 里的版權(quán)支持信息是否填了許可號。4.5 三員管理開啟后 admin.do 進(jìn)不去沒備份配置現(xiàn)象開啟三員管理后想再進(jìn) admin.do 調(diào)整參數(shù)發(fā)現(xiàn)頁面直接拒絕訪問。原因三員管理開啟后 admin.do 入口被禁用這是設(shè)計如此。解決開啟三員管理前務(wù)必先點(diǎn)“備份配置文件”導(dǎo)出備份。如果已經(jīng)開啟且沒備份只能通過三員管理操作手冊里的流程用三員賬號登錄后走特定入口。所以我的習(xí)慣是任何涉及 admin.do 的變更先備份再操作。5. 日志參數(shù)與運(yùn)營日志采集容量估算與備份策略日志參數(shù)配置分本地文件存儲和數(shù)據(jù)庫存儲默認(rèn)是數(shù)據(jù)庫存儲。本地文件存儲需要參考日志系統(tǒng) Elastic 安裝部署手冊。運(yùn)營日志比操作日志記錄更詳細(xì)用于熱點(diǎn)分析和系統(tǒng)使用情況分析可以上傳到服務(wù)網(wǎng)站查看圖表。日志文件容量估算有個公式每個節(jié)點(diǎn)每天產(chǎn)生約 100M 日志文件訪問量大時到 200M。如果 5 個節(jié)點(diǎn)保留 30 天總?cè)萘渴? * (30 1) * 100M 15500M約 15G。那個“1”是當(dāng)天的日志。超過 200M 說明單臺服務(wù)器請求已經(jīng)超負(fù)荷該考慮加節(jié)點(diǎn)了。備份天數(shù)默認(rèn)應(yīng)用日志、錯誤日志、后臺日志、登錄登出日志都是 7 天7 天前的自動備份到歷史日志表。清除備份天數(shù)默認(rèn) 90 天清除 90 天前的備份數(shù)據(jù)。記錄錯誤日志條數(shù)可以設(shè)置每天超過指定數(shù)量不記錄到數(shù)據(jù)庫防止日志表被撐爆。我一般會把應(yīng)用日志備份天數(shù)改成 14 天清除備份改成 180 天給排查問題留足時間。但前提是磁盤空間夠不然日志寫滿磁盤比日志丟失更可怕。運(yùn)營日志開啟后可以禁用系統(tǒng)操作日志但禁用后不能直接從系統(tǒng)查看操作日志只能通過運(yùn)營日志平臺看。所以如果沒開通運(yùn)營日志服務(wù)別禁用操作日志。從那以后我每次改 admin.do 配置都強(qiáng)制走一遍“備份→改配置→重啟→驗(yàn)證→再備份”的流程。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取