附錄 C 對 Delegated Administrator 進行除錯

可以透過檢查由 Delegated Administrator 元件、部署 Delegated Administrator 的 Web 容器、Directory Server 和 Access Manager 產生的記錄檔來取得 Delegated Administrator 的記錄資訊。

本附錄包含以下主題︰

• 對指令行公用程式進行除錯

• Delegated Administrator 主控台記錄

• Delegated Administrator 伺服器記錄檔

• Web 容器伺服器記錄檔

• Directory Server 和 Access Manager 記錄檔

對指令行公用程式進行除錯

若要對 Delegated Administrator 公用程式 (commadmin) 進行除錯，可以透過將 -v 選項和 commadmin 指令配合使用，在用戶端顯示除錯訊息。

Delegated Administrator 主控台記錄

Delegated Administrator 主控台會建立執行階段記錄檔：

• 預設記錄檔名稱︰da.log

• 預設位置：/opt/SUNWcomm/log

您可以編輯名為 logger.properties 的記錄特性檔案來指定您自己的記錄檔。

指定您自己的 Delegated Administrator 主控台記錄檔

1. 在文字編輯器中開啟 logger.properties 檔案。

   依預設，logger.properties 檔案位於以下目錄中：

   da-base/data/da/WEB-INF/classes/com/sun/comm/da/resources

2. 可以在 logger.properties 檔案中變更以下特性︰

   • da.logging.enable=yes 或 no

     其中，yes 將啟用記錄功能，而 no 將停用記錄功能。

     依預設，記錄功能處於停用狀態。若要啟用記錄功能，必須將此值設定為 yes。

   • da.log.file=full pathname

     指定記錄敘述要寫入的目錄和檔案。此特性會將 da.log 變更為您指定的檔案名稱和位置。

3. 將已編輯的 logger.properties 檔案重新部署至 Delegated Administrator 主控台所使用的 Web 容器。

   在變更生效之前，您必須執行能將自訂 logger.properties 檔案部署至 Web 容器的程序檔。

   如需如何將自訂特性檔案部署至特殊 Web 容器的說明，請參閱若要部署自訂配置檔案。

Delegated Administrator 伺服器記錄檔

可以建立 Delegated Administrator 伺服器記錄檔，該記錄檔包含由安裝在 Web 容器中的 Delegated Administrator Servlet 產生的除錯敘述。

若要執行此作業，可以啟用 Debug Servlet 來記錄 Delegated Administrator Servlet 執行中的除錯訊息。

您可以使用 commadmin debug log 指令將 Delegated Administrator 伺服器訊息寫入除錯記錄檔。

-f 選項可指定記錄檔的完整路徑和檔案名稱。

-t 選項可讓您在「將除錯訊息寫入記錄」和「關閉除錯記錄」之間進行切換。

例如，您可以輸入以下指令：

commadmin debug log -D paul -n sesta.com -w bolton \
-t on -f /tmp/debug.log

前面的指令會將 Debug Servlet 訊息記錄至以下路徑和檔案︰

/tmp/debug.log

您只能在 /tmp/ 或 /var/tmp/ 目錄中建立記錄檔。

每次當您重新啟動 Web 容器時，都必須再次執行 commadmin debug log 指令。

Web 容器伺服器記錄檔

還可以透過檢查 Web 容器所產生的伺服器記錄檔，進一步對 Delegated Administrator 進行除錯。

Web Server 6.x

Web Server 6.x 可維護位於以下路徑的存取記錄檔和錯誤記錄檔：

web_server6_base/https-host.domain /logs

其中，

• web_server6_base 是 Web Server 6.x 軟體的安裝路徑。例如：/opt/SUNWwbsvr 。

• host.domain 為執行 Web Server 6.x 電腦的主機和網域名稱。

Web Server 7.x

Web Server 7.x 可維護位於以下路徑的存取記錄檔和錯誤記錄檔：

web_server7_config_base/https- host.domain/logs

其中，

• web_server7_config_base 為安裝 Web Server 7.x 配置和記錄檔的路徑。例如：/var/opt/SUNWwbsvr7。

• host.domain 為執行 Web Server 7.x 電腦的主機和網域名稱。

Application Server 7.x

Application Server 7.x 可維護位於以下路徑的存取記錄檔和錯誤記錄檔︰

/application_server7_base/domains/domain1/server1/logs

其中，

• application_server7_base 是 Application Server 7.x 軟體的安裝路徑。

Application Server 8.x

Application Server 8.x 可維護位於以下路徑的存取記錄檔和錯誤記錄檔。

伺服器記錄檔︰

/application_server8_base/domains/domain1/logs

存取記錄檔︰

/application_server8_base/domains/domain1/logs/access/server_access_log

其中，

• application_server8_base 是 Application Server 8.x 軟體的安裝路徑。

Directory Server 和 Access Manager 記錄檔

還可以透過檢查由 Directory Server 和 Access Manager 產生的記錄檔，進一步對 Delegated Administrator 進行除錯。

Directory Server

Directory Server 可維護位於以下路徑的存取記錄檔和錯誤記錄檔︰

/var/opt/mps/serverroot/slapd-hostname /logs

其中，

• hostname 是執行 Directory Server 的機器名稱。

Access Manager

Access Manager 可維護位於以下路徑中的記錄檔：

/var/opt/SUNWam/debug

前面的路徑包含 amProfile 和 amAuth 記錄。

/var/opt/SUNWam/logs

前面的路徑包含 amAdmin.access 和 amAdmin.error 記錄。