Sun ONE Identity Server 6.1 管理指南 |
第 10 章
amserver 指令行工具本章提供有關 amserver 指令行工具的資訊。本章包含以下小節:
amserver 指令行可執行檔amserver 指令行可執行檔可以在 Solaris 平台上建立、啟動、停止和刪除附加 Identity Server 實例。在 Windows 2000 平台上,amserver 僅允許啟動和停止 Identity Server。
amserver 語法
此工具的一般語法如下:
./amserver { create | delete [instance_name] | startall | start | stop | stopall | version }
針對 Solaris 的 amserver 指令
建立
create 是用於建立 Identity Server 之新實例的指令。應該以超級使用者的身份執行 amserver 程序檔。若要建立實例,請執行 amserver 程序檔 ./amserver create。將 amserver 用於多伺服器安裝程式管理 (僅適用於 Web Server 實例)中描述了建立多重伺服器實例的詳細步驟。此指令僅適用於 Web Server 實例。
startall
startall 是用於啟動所有 Identity server 實例的指令。若要啟動個別實例,請執行:
IdentityServer_base/SUNWam/bin/amserver.instance_name start
stopall
stopall 是用於停止所有 Identity server 實例的指令。若要停止個別 Identity Server 實例,請執行:
/opt/SUNWam/bin/amserver.instance_name stop
delete
delete 是刪除 create 選項建立的實例的指令。
針對 Windows 2000 的 amserver 指令
在 Windows 2000 平台上,amserver 僅支援以下指令:
start
start 是啟動 Identity Server 的指令。
stop
stop 是停止 Identity Server 的指令。
restart
restart 是重新啟動 Identity Server 的指令。
amserver 無法停止或啟動 Directory Server。您可能需要手動重新啟動它。它僅可重新啟動 Web Server 實例。對於其他 Web 容器,此指令僅可重新啟動認證輔助程式。
將 amserver 用於多伺服器安裝程式管理 (僅適用於 Web Server 實例)您可以使用 amserver 指令行公用程式安裝和管理多個 Identity Server 實例。安裝多個 Identity Server 實例之前,您必須以超級使用者的身份登入。以下步驟中描述的程序檔位於 IdentityServer_base/SUNWam/bin 中。
若要安裝多個實例,請:
- 輸入 ./amserver create 透過 amServer 建立新的伺服器實例。
例如,如果您要建立名為 instance1 的實例,該實例將偵聽 port 81,則程序檔輸出的輸出內容可能如下所示:
- 然後會為每個網路伺服器實例建立一個目錄。例如:
IdentityServer_base/SUNWam/servers/https-instance_name
- Identity Server 應用程式將被部署到以下位置:
IdentityServer_base/SUNWam/servers/web-apps-instance_name
- IdentityServer_base/SUNWam/bin 目錄具有實例特定的 amServer 版本。例如:
amserver.instance_name
- IdentityServer_base/SUNWam/lib/AMConfig-instance_name.properties 中建立了 Identity Server 配置檔案的副本。
- 檔案 /etc/rc3.d 具有實例特定的初始化檔案之版本:
S55amserver.instance_name
K55amserver.instance_name
- 可輸入以下指令來啟動所有 Identity Server 實例 (包括原先的伺服器實例):
./amserver startall
也可以使用以下指令來啟動個別伺服器:
IdentityServer_base/SUNWam/bin/amserver.instance_name start
現在,您應該可以透過自己的瀏覽器呼叫所有實例的 Identity Server 登入畫面。
- 可輸入以下指令來停止所有伺服器實例 (包括原先的伺服器實例):
./amserver stopall
也可以使用以下指令來停止個別伺服器:
IdentityServer_base/SUNWam/bin/amserver.instance_name stop
- 可輸入以下指令來呼叫 [刪除指令] 選項:
./amserver delete
這將移除透過 Create 指令建立的所有檔案。如果您使用 Identity Server 解除安裝公用程式,則不會移除由程序檔產生的檔案。
- 可輸入以下指令來指定除錯檔案的目錄:
Edit IdentityServer_base/SUNWam/lib/AMConfig-instan ce_name.properties
請確定將 com.iplanet.services.debug.directory 屬性變更為指定的目錄。
- 可使用以下語法呼叫 ammultiserverinstall 公用程式:
ammultiserverinstall [ server-instance-name ] [ port ]
對於需要安裝多個 Identity Server 實例,但更喜歡非互動式介面的應用程式,請使用 ammultiserverinstall 公用程式。如果 ammultiserverinstall 失敗,它將結束,且值為 1。
- amserver 會將伺服器實例自動加入平台伺服器清單中。
- 配置 Identity Server 以在 SSL 模式下執行。如需此作業的說明,請參閱本指南的附錄 B「在 SSL 模式中配置 Identity Server」。
- 輸入以下指令來啟動所有 Identity Server 實例:
./amserver startall
也可以使用以下指令來啟動個別 Identity Server 實例:
./amserver-instance start