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