Sun logo      上一個      目錄      索引      下一個     

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 的指令。


如果與新的獨立於容器的部署一同使用,stopstart 可能無法正常運作。如果遇到這種情況,請對該容器使用 stopstart


restart

restart 是重新啟動 Identity Server 的指令。

amserver 無法停止或啟動 Directory Server。您可能需要手動重新啟動它。它僅可重新啟動 Web Server 實例。對於其他 Web 容器,此指令僅可重新啟動認證輔助程式。


將 amserver 用於多伺服器安裝程式管理 (僅適用於 Web Server 實例)

您可以使用 amserver 指令行公用程式安裝和管理多個 Identity Server 實例。安裝多個 Identity Server 實例之前,您必須以超級使用者的身份登入。以下步驟中描述的程序檔位於 IdentityServer_base/SUNWam/bin 中。

若要安裝多個實例,請:

  1. 輸入 ./amserver create 透過 amServer 建立新的伺服器實例。
  2. 例如,如果您要建立名為 instance1 的實例,該實例將偵聽 port 81,則程序檔輸出的輸出內容可能如下所示:

     

    #####################################################################

    請輸入伺服器實例的名稱:instance1

    請輸入連接埠號:81

    您要建立多個伺服器實例嗎?y/[n]

    正在安裝... 請稍候....

    ##################################################################

    1. 然後會為每個網路伺服器實例建立一個目錄。例如:
    2. IdentityServer_base/SUNWam/servers/https-instance_name

    3. Identity Server 應用程式將被部署到以下位置:
    4. IdentityServer_base/SUNWam/servers/web-apps-instance_name

    5. IdentityServer_base/SUNWam/bin 目錄具有實例特定的 amServer 版本。例如:
    6. amserver.instance_name

    7. IdentityServer_base/SUNWam/lib/AMConfig-instance_name.properties 中建立了 Identity Server 配置檔案的副本。
    8. 檔案 /etc/rc3.d 具有實例特定的初始化檔案之版本:
    9. S55amserver.instance_name

      K55amserver.instance_name


建立實例名稱時請勿使用「_」(底線) 或「.」(句點)。


  1. 可輸入以下指令來啟動所有 Identity Server 實例 (包括原先的伺服器實例):
  2. ./amserver startall

    也可以使用以下指令來啟動個別伺服器:

    IdentityServer_base/SUNWam/bin/amserver.instance_name start

    現在,您應該可以透過自己的瀏覽器呼叫所有實例的 Identity Server 登入畫面。

  3. 可輸入以下指令來停止所有伺服器實例 (包括原先的伺服器實例):
  4. ./amserver stopall

    也可以使用以下指令來停止個別伺服器:

    IdentityServer_base/SUNWam/bin/amserver.instance_name stop

  5. 可輸入以下指令來呼叫 [刪除指令] 選項:
  6. ./amserver delete

    這將移除透過 Create 指令建立的所有檔案。如果您使用 Identity Server 解除安裝公用程式,則不會移除由程序檔產生的檔案。

  7. 可輸入以下指令來指定除錯檔案的目錄:
  8. Edit IdentityServer_base/SUNWam/lib/AMConfig-instan ce_name.properties

    請確定將 com.iplanet.services.debug.directory 屬性變更為指定的目錄。

  9. 可使用以下語法呼叫 ammultiserverinstall 公用程式:
  10. ammultiserverinstall [ server-instance-name ] [ port ]

    對於需要安裝多個 Identity Server 實例,但更喜歡非互動式介面的應用程式,請使用 ammultiserverinstall 公用程式。如果 ammultiserverinstall 失敗,它將結束,且值為 1。

  11. amserver 會將伺服器實例自動加入平台伺服器清單中。
  12. 配置 Identity Server 以在 SSL 模式下執行。如需此作業的說明,請參閱本指南的附錄 B「在 SSL 模式中配置 Identity Server」
  13. 輸入以下指令來啟動所有 Identity Server 實例:
  14. ./amserver startall

    也可以使用以下指令來啟動個別 Identity Server 實例:

    ./amserver-instance start



上一個      目錄      索引      下一個     


Copyright 2003 Sun Microsystems, Inc.。版權所有。