Zimbra 協作套件升級或遷移後,常見 mailbox 服務 (Jetty) 停止運行,zmcontrol status 顯示 zmmailboxdctl is not running。日誌顯示 stale pid 與 keystore 權限警告。本文記錄標準修復流程。
zimbra@mail:~$ zmcontrol status
Host mail.example.com
mailbox Stopped
zmmailboxdctl is not running.
... (其他服務 Running)
/var/log/mail.log 關鍵錯誤:
warning: not owned by root: /opt/zimbra/postfix-.../conf/main.cf
zmmailboxdmgr[xxxx]: stale pid 12479 found in /opt/zimbra/log/zmmailboxd_manager.pid: No such process
file /opt/zimbra/log/zmmailboxd.pid does not exist
no manager process is running
/opt/zimbra/mailboxd/etc/keystore 可能在升級/遷移後權限異常或內容不一致。zimbra:zimbra,導致服務無法讀寫 PID、日誌、資料檔。
# 1. 備份並移除舊 keystore (將由 zmcertmgr 重建)
mv /opt/zimbra/mailboxd/etc/keystore /root/keystore.old
# 2. 重新部署自簽憑證
/opt/zimbra/bin/zmcertmgr deploycrt self
# 3. 修復整個 Zimbra 目錄樹權限 (關鍵步驟)
/opt/zimbra/libexec/zmfixperms --verbose --extended
# 4. 切換 zimbra 用戶重啟全套服務
su - zimbra -c "zmcontrol restart"
zimbra@mail:~$ zmcontrol status
Host mail.example.com
antispam Running
antivirus Running
ldap Running
logger Running
mailbox Running ← 關鍵:mailbox 恢復 Running
mta Running
snmp Running
spell Running
stats Running
zmconfigd Running
若服務啟動但瀏覽器顯示錯誤 (如 500/403/憑證錯誤);
/opt/zimbra/conf/localconfig.xml 中的 zimbra_uid / zimbra_gid 是否與系統實際 zimbra 用戶 UID/GID 一致 (id zimbra 查看)。/opt/zimbra (含 LDAP 資料庫 /opt/zimbra/data/ldap)。zmfixperms --extended,修正所有檔案權限與擁有者。mailbox.log 與 zmmailboxd.out 關鍵字:OutOfMemoryError, keystore, permission denied。/opt/zimbra/bin/zmcertmgr viewdeployedcrt。核心口訣: Zimbra 故障 80% 是權限與憑證問題。
zmfixperms --extended+ 重建 keystore 是萬用鑰匙,配合localconfig.xmlUID/GID 核對,多數mailbox stopped可在 10 分鐘內修復。