第 9 章
amadmin 指令行工具

本章提供有關 amadmin 指令行工具的資訊，包含以下小節：

amadmin 指令行工具
使用 amadmin 建立策略

---

amadmin 指令行工具可執行檔

指令行可執行檔 amadmin 的主要用途是將 XML 服務檔案載入 Directory Server，並對 DIT 執行批次管理工作。amadmin 位於 IdentityServer_base/SUNWam/bin 中，用來執行以下作業：

載入 XML 服務檔案 - 管理員將使用 XML 服務檔案格式 (在 sms.dtd 中定義) 的服務載入 Identity Server 中。必須使用 amadmin 載入所有服務；不能透過 Identity Server 主控台匯入這些服務。

註	XML 服務檔案作為供 Identity Server 參考之 XML 資料的靜態 blob 儲存在 Directory Server 中。Directory Server 不使用該資訊，它僅識別 LDAP。

對 DIT 執行身份物件的批次更新 - 管理員可使用 amadmin.dtd 中定義的批次處理 XML 檔案格式對 Directory Server DIT 執行批次更新。例如，如果管理員希望建立 10 個組織、1000 個使用者和 100 個群組，可以將這些請求放在一個或多個批次處理 XML 檔案中，然後使用 amadmin 載入這些檔案，從而一次達到上述目的。在「Sun One Identity Server Programmer’s Guide」中的「Service Management」一章中可以找到有關此作業的更多資訊。

註	amadmin 僅支援 Identity Server 主控台支援的部分功能，並不能取代主控台。建議將主控台用於小型管理工作，而將 amadmin 用於較大型的管理工作。

amadmin 語法

要使用 amadmin，必須遵循許多結構上的規則。使用該工具的一般語法如下：

amadmin -u | --runasdn dnname -w | --password password [-l | --locale localename] [[-v | --verbose] | [-d |--debug]] -t | --data xmlfile1 [xmlfile2 ...]
amadmin -u | --runasdn dnname -w | --password password [-l | --locale localename] [[-v | --verbose] | [-d | --debug]] -s | --schema xmlfile1 [xmlfile2 ...]
amadmin -u | --runasdn dnname -w | --password password [-l | --locale localename] [[-v | --verbose] | [-d | --debug]] -r | --deleteService serviceName1 [serviceName2 ...]
amadmin -u | --runasdn dnname -w | --password password or -f | --password file passwordfile [-c | --continue] [-l | --locale localename] [[-v | --verbose] | [-d | --debug]] -m | --session servername pattern
amadmin -h | --help
amadmin -n | --version
amadmin -u | --runasdn dnname -w | --password password or - f |--passwordfile passwordfile [-l | --locale localename] [[-v | --verbose] | [-d] |--debug]] -a |--addAttributes serviceName schemaType xmlfile[xmlfile2] ...

註	必須如語法中所示，準確輸入兩個連字符號。

amadmin 選項

以下是 amadmin 指令行參數選項的定義：

--runasdn (-u)

--runasdn 用於為 LDAP 伺服器認證使用者。此引數的值等於經授權執行 amadmin 的使用者之識別名稱 (DN)；例如

--runasdn uid=amAdmin,ou=People,o=iplanet.com,o=isp。

DN 亦可透過在網域元件之間插入空格並為整個 DN 加上雙引號來進行格式化，例如：--runasdn "uid=amAdmin, ou=People, o=iplanet.com, o=isp"。

--password (-w)

--password 是強制性選項，其值等於使用 --runasdn 選項指定的 DN 之密碼。

--locale (-l)

--locale 是值等於語言環境名稱的選項。此選項可用於自訂訊息語言。如果沒有提供語言環境，系統會使用預設語言環境 en_US。

--continue (-c)

--continue 是在即使出現錯誤的情況下仍將繼續處理 XML 檔案的選項。例如，如果要同時載入三個 XML 檔案，並且載入第一個 XML 檔案失敗，而 amadmin 將繼續載入其餘檔案。

--session (-m)

--session (-m) 是管理階段作業或顯示目前階段作業的選項。指定的 --runasdn 必須與 AMConfig.properties 中超級使用者的 DN 相同，或者就是頂層管理員使用者的 ID。

以下範例將顯示特定服務主機名稱的所有階段作業：

amadmin -u uid=amadmin,ou=people,dc=iplanet,dc=com -v -w 12345678 -m http://sun.com:58080

以下範例將顯示特定使用者的階段作業：

amadmin -u uid=amadmin,ou=people,dc=iplanet,dc=com -v -w 12345678 -m http://sun.com:58080 username

您可以輸入索引編號來終止相應的階段作業，還可以輸入多重索引編號 (以空格分隔) 來終止相應的多重階段作業。

使用以下選項時：

amadmin -m | --session servername pattern

pattern 可以是萬用字元 (*)。如果此式樣使用萬用字元 (*)，則必須使用圖元字元 (\) 使其從 shell 退出。

--debug (-d)

--debug 是將訊息寫入 amadmin 檔案 (於 IdentityServer_base/var/opt/SUNWam/debug 目錄之下建立) 的選項。這些訊息是技術方面的詳細說明，但不符合 i18n 標準。若要產生 amadmin 作業日誌，將資料庫驅動程式的類別路徑記錄到資料庫中時，需要將其手動加入。例如，在記錄到 amadmin 中的 mysql 時，可加入以下各行：

CLASSPATH=$CLASSPATH:/opt/IS61/SUNWam/lib/mysql-connector-java-3.0.6-stable-bin.jar

export CLASSPATH

--verbose (-v)

--verbose 是將 amadmin 指令的總體進度列印到螢幕上的選項。它不會將詳細資訊列印到檔案中。輸出到指令行的訊息符合 i18n 標準。

--data (-t)

--data 是以要匯入的批次處理 XML 檔案之名稱作為值的選項。可以指定一個或多個 XML 檔案。這種 XML 檔案可以建立、刪除和讀取各種目錄物件，還可以註冊和取消註冊服務。如需有關可將何種 XML 檔案傳送至此選項的更多資訊，請參閱「Sun ONE Identity Server Programmer’s Guide」中的「Servic Management」一章。

--schema (-s)

--schema 是將 Identity Server 服務的屬性載入 Directory Server 的選項。它以定義服務屬性的 XML 服務檔案作為引數。這種 XML 服務檔案基於 sms.dtd。可以指定一個或多個 XML 檔案。

註	必須指定 --data 或 --schema 選項，具體情況取決於是對 DIT 配置批次更新，還是載入服務綱目和配置資料。

--deleteservice (-r)

--deleteservice 是用於僅刪除服務及其綱目的選項。

--serviceName

--serviceName 是值等於在 XML 服務檔案的 Service name=... 標籤下定義的服務名稱的選項。此部分顯示在程式碼範例 9-1 中。

程式碼範例 9-1 sampleMailService.xml 的部分

... <ServicesConfiguration> <Service name="sampleMailService" version="1.0"> <Schema serviceHierarchy="/other.configuration/sampleMailService" i18nFileName="sampleMailService" i18nKey="iplanet-am-sample-mail-service-description"> ...

--help (-h)

--help 是顯示 amadmin 指令語法的引數。

--version (-n)

--version 是顯示公用程式名稱、產品名稱、產品版本和法律聲明的引數。

---

使用 amadmin 建立策略

可以透過 amadmin 管理策略，但是不能使用 amadmin 直接修改策略。若要修改策略，必須先刪除策略，然後使用 amadmin 加入修改後的策略。

若要使用 amadmin 加入策略，必須先根據 policy.dtd. 產生策略 XML 檔案。(「Sun ONE Identity Server Customization and API Guide」中描述了policy.dtd。) 開發了策略的 XML 檔案後，您可以使用以下指令載入此檔案：

IdentityServer_base/SUNWam/bin/amadmin

--runasdn "uid=amAdmin,ou=People,default_org,root_suffix"

--password password

--data policy.xml

若要同時加入多重策略，請將這些策略放在一個 XML 檔案中，這一點與在每個 XML 檔案中放一個策略相反。如果使用多重 XML 檔案連續快速載入策略，則內部策略索引可能會損毀，而且某些策略可能不參與策略評估。

透過 amadmin 建立策略時，請確保建立認證綱目條件時將認證模組註冊到組織；建立組織、LDAP 群組的主題、LDAP 角色的主題以及 LDAP 使用者的主題時，相應的 LDAP 物件 (組織、群組、角色和使用者) 已存在；建立 IdentityServerRoles 主題時，Identity Server 角色已存在；以及建立子組織參考或同級組織參考時相關的組織已存在。

請注意，SubOrgReferral、PeerOrgReferral、Organization 主題、IdentityServerRoles 主題、LDAPGroups 主題、LDAPRoles 主題和 LDAPUsers 主題中值元素的文字需要是完整的 DN。

上一個      目錄      索引      下一個

---

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