#Domino Server
標記為 #Domino Server · 15 篇文章
- dircat 的雙重身份:你以為它只在建通訊錄目錄,Domino 12 起它還兼了授權稽核
在 show tasks 看到 dircat(Directory Cataloger),多數人想到的是「通訊錄目錄」——把多個 Domino Directory 聚合成一份好查的目錄。那是它的本業。但從 Domino 12 起,這支 task 悄悄兼了第二份差:把各 server 的 entitlement 資料聚合到 entitlements.nsf,屬於授權合規稽核,跟通訊錄毫無關係。這篇講 dircat 的本業(condensed vs extended 目錄、DIRCAT5.NTF 別選成 CATALOG.NTF)、它 Domino 12 起的隱藏第二身份,以及一支 task 兩個職責會怎麼咬人。
2026.09.25 - 誰是 domain administration server?Domino 一個 ACL 設定,牽動 entitlement 聚合、CertMgr 與 AdminP
一台 additional server 冷啟動後每 5 秒噴一次「Error connecting to server…」,逐台想連 domain 內每台 server。追到最後,兇手不是 entitlement 設定,而是一個把它悄悄變成「domain administration server」的 ACL 設定。這篇講 Domino 裡「管理伺服器」到底有幾個意思、domain admin 身份由誰決定、又暗地牽動了哪些機制(entitlement 跨-domain 聚合、CertMgr、AdminP),以及怎麼把這些混在一起的職責拆開。
2026.09.24 - 把 Domino IQ RAG 接上遠端模型:certstore 信任、API Key、HTTPS 端點怎麼設
Domino 14.5.1 FP1 讓 RAG 多了 Remote 模式——站上 FP1 總覽那篇已經介紹過「改了什麼」。這篇不重講,只補實際接線的那一段:Remote mode 設定文件怎麼填、HTTPS-only 端點與 API Key、以及最容易踩的一關——遠端 AI server 的信任根要加進 certstore.nsf,而不是 DRAPI 那條路吃的 JVM truststore。
2026.09.23 - 刪掉的文件為什麼會自己回來:deletion stub、purge interval 與兩個復活原因
刪掉一份文件,過幾天它又自己冒出來——不是鬧鬼。Domino 刪除不是把文件抹掉,而是留下一個 deletion stub(刪除殘根),讓複寫把「這份被刪了」傳到其他 replica。殘根會依 purge interval(預設 90 天)被清掉。文件「復活」通常是兩個原因:殘根在傳出去之前就被清掉、或同一份在一邊被改一邊被刪時「改贏了刪」。這篇把機制與兩個原因講清楚,並給避免的設定原則。
2026.09.19 - updall、fixup、compact:資料庫壞了、肥了、view 不對,該跑哪一個
Domino 三個資料庫維護指令最容易被亂槍打鳥:view 顯示過期就想 fixup、資料庫肥了就 fixup、開不起來就 compact——結果白跑一場。其實它們各治不同的病:updall 管索引(view/全文),fixup 修損毀(文件/結構),compact 收空間(變肥就它)。這篇按「什麼症狀跑哪個」講清楚,並附官方的損毀升級順序:先 updall、再 fixup、最後 compact -c。
2026.09.18 - Domino 伺服器排錯:先別重啟整台,這幾個 console 指令先看清楚狀況
伺服器怪怪的——某個功能不通、好像卡住、記憶體或磁碟吃緊。反射動作往往是「重啟整台」,但那太粗魯、也可能蓋掉現場。這篇把最常用的 Domino console 排錯指令按「你遇到什麼問題」整理:show tasks 看誰在跑/卡住、show server 看整體健康、restart task <task> 只重啟出問題的那個 task(例如 restart task http,而不是整台)、tell http show thread state 抓卡住的 thread、dbcache show/flush/disable 處理資料庫快取。先看清楚,再決定要不要動手。
2026.09.17 - XPages 檔案上傳失效:xspupload 暫存夾被 Windows cleanmgr 清掉的根源與解法(含 14.0 修復)
XPages 的檔案上傳控制項按了沒反應、使用者端沒錯誤、server console 卻報 IOFileUploadException「The system cannot find the path specified」。根源是 Domino 上傳用的暫存夾 xspupload 不見了——常常是 Windows 的磁碟清理 cleanmgr 在 Domino 執行中把它連同 temp 檔一起清掉。這篇把官方 KB 與實務串起來:症狀與根源、暫存夾為什麼會消失、以及從「每晚上下 http」這種 band-aid 到 notes_tempdir、程式化檢查重建、升級 14.0(defect 已修)的幾種解法。
2026.09.12 - 開發者很少注意的 ODS:Domino 資料庫格式版本演進,與「什麼時候會升、由什麼決定」
你整天寫 LotusScript / XPages,大概從來沒在意過資料庫的 ODS(on-disk structure)版本 — 直到某個功能(像 LargeSummary)需要特定 ODS,或你把一顆舊 DB 在 server 之間搬動,搞不清楚 ODS 會不會跟著變。本文從開發者角度整理 ODS 的版本對應、最反直覺的一點(升 server 版本不等於升 ODS),以及 ODS 到底「什麼時候會變、由什麼決定」,最後回答一個具體情境:R9 的 ODS51 資料庫用 R12 client 新複製到 R12 server,ODS 會自動異動嗎?
2026.06.21 - 「Field is too large (32K)」在騙你:真正的牆通常是 64K summary buffer
一個 XPages 存檔錯誤:訊息寫「32K」,但你檢查每個欄位都沒破 32K(最大才 26K),照樣存不了。因為它指的數字常常不是你的問題 — 真正撞到的是「整份文件 summary 資料合計 64K」這道牆。本文先建立 summary / non-summary 與兩道大小限制的心智模型,再講 ODS 與 LargeSummary 為什麼是兩件事,最後用「這資料該不該是 summary」這個問題分流出兩種解法。
2026.06.21 - 在 HCL 官方支援範圍外把 Domino 9.0.1 包進 Container — 社群可行性 PoC + 5 個一定會撞的坑
HCL 官方只發 Domino 10.0.1 FP3 起的 container image — 還在跑 9.0.x 想用容器做 dev/test、migration 預演、legacy server 保存的話官方沒路。本篇介紹一份社群可行性研究:RHEL UBI 7.9 base、兩階段 build、~1.48 GB image,跑得起 Domino 9.0.1 FP10、能加入既有 Domino domain、HTTP/NRPC/LDAP/IMAP/POP3/SMTP 全部正常。研究過程踩了 5 個 HCL docs 沒提的關鍵坑(Perl namespace bug / FP installer 不吃 -silent / J9 JVM heap 不夠 / setup 完成 marker 不對 / server.id 密碼 stdin block),每個都有實際 error message + workaround。完整 build script 跟 troubleshooting 在 bryanHsiao/build-hcl-domino9-container repo。
2026.05.22 - HCL Domino 容器化部署的兩條路 — 拉 pre-built image,或自己 build 客製版
把 Domino 包進 container 在 IBM 時代(V9)就有社群在做、HCL 從 V10 起正式提供官方 pre-built container image 下載。現在 HCL 雙管齊下:要快上線可以從 My HCLSoftware Portal 下載官方 pre-built image TAR 直接 docker load;要彈性可以用 HCL 在 GitHub 上開源的 domino-container 專案、跑互動式 build.sh menu 自己 build 客製 image,挑你要的模組(Domino / Traveler / Verse / Nomad / REST-API / Leap / Domino IQ / OnTime / C-API SDK / LP)+ add-on。這篇介紹兩條路怎麼選、build.sh 能客製到什麼程度、典型部署場景,跟想試試看的人怎麼起步。
2026.05.21 - Domino IQ RAG:把 NSF 直接掛上本地 LLM 的內建管線
Domino 14.5.1 在 Domino IQ 加入 RAG(Retrieval-Augmented Generation)支援,把 LLM 推論、Embedding 模型、向量資料庫全部跑在 Domino server 上,本地處理、原生繼承 ACL 與 Readers field 權限。本文整理啟用前提、dominoiq.nsf 兩階段設定、updall 向量化、LotusScript 怎麼呼叫 LLMReq,以及為什麼這跟「外接 OpenAI + Pinecone」是不同物種。
2026.05.05 - Domino IQ 入門:把 LLM 跑進 Domino server 是什麼概念
Domino 14.5 引入 Domino IQ — 把 AI 推論引擎內建到 Domino server 後台,從 LotusScript 用 NotesLLMRequest / NotesLLMResponse 直接送 prompt 給本地 LLM。本文整理架構、硬體需求、安裝流程、dominoiq.nsf 兩階段設定、Command 與 System Prompt 文件,並對比為什麼選這條路而非外接 OpenAI。
2026.05.05 - Domino V12 起 notes.ini 支援多個 HTTPAdditionalRespHeader
舊版 Domino 的 notes.ini 只能塞一個 HTTPAdditionalRespHeader,第二行會把第一行蓋掉。HCL 在 V12.0.x 加了編號式的 HTTPAdditionalRespHeader01、02 寫法,讓你能用純 notes.ini 設好整套安全標頭——尤其是當網頁伺服器(HTTP task)起不來、Internet Site 文件也用不了的時候,這是唯一的後備路徑。
2026.04.28 - HCL Domino 2026 發布亮點
HCL Domino 2026(版本 14.5.1)於 2026 年 3 月 19 日正式發布,帶來了多項新功能和改進,包括 Domino IQ、AutoUpdate、OIDC 支援等。
2026.04.27