第 10 章 amadmin コマンド行ツール

この章では、amadmin コマンド行ツールについて説明します。この章は、次の節で構成されています。

amadmin コマンド行実行可能ファイル

コマンド行ツール amadmin の第一の目的は、XML サービスファイルを Directory Server にロードして、DIT で管理タスクのバッチ処理を実行することです。amadmin は、IdentityServer_base/SUNWam/bin にあり、次の目的に使用します。

XML サービスファイルのロード - 管理者は sms.dtd で定義された XML サービスファイル形式を使用するサービスを Identity Server にロードします。すべてのサービスは amadmin を使用してロードする必要がありますが、Identity Server コンソールでインポートすることはできません。



注	XML サービスファイルは、Identity Server で参照される XML データの静的なかたまりとして Directory Server に格納されます。この情報は、LDAP だけを使用できる Directory Server では使用されません。

DIT に対するアイデンティティオブジェクトのバッチ更新の実行 - 管理者は amadmin.dtd に定義されたバッチ処理用 XML ファイル形式を使用して、Directory Server DIT に対するバッチ更新を実行できます。たとえば管理者が組織を 10、ユーザーを 1000、およびグループを 100 作成する場合、この要求を 1 つ以上のバッチ処理用 XML ファイルに置いて、amadmin でロードすることで、1 回で作成できます。詳細については、『Identity Server Developer's Guide』の「Service Management」の章を参照してください。



注	amadmin は、Identity Server コンソールの機能の一部だけをサポートしており、コンソールの代わりに使用することは想定していません。比較的小規模な管理作業にはコンソールを使用し、比較的大規模な管理作業には amadmin を使用することをお勧めします。

amadmin の構文

amadmin を使用するために従わなくてはならない構造的な規則があります。amadmin ツールの一般的な構文は次のとおりです。

amadmin -h | --help

amadmin -n | --version



注	2 連続するハイフンは、構文に示すとおりに入力する必要があります。

amadmin のオプション

次に、amadmin コマンド行パラメータオプションの定義を説明します。

--runasdn (-u)

--runasdn は、LDAP サーバーに対してユーザーを認証します。引数は、amadmin を実行できるように承認されたユーザーの識別名 (DN) の値です。たとえば次のようになります。

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 ファイルが 3 つあり、最初の XML ファイルがエラーになった場合、amadmin では残りのファイルをロードし続けます。

--session (-m)

--session (-m) は、セッションを管理したり、現在のセッションを表示したりします。--runasdn を指定するときは、AMConfig.properties のスーパーユーザーの DN、または最上位の管理ユーザーの ID と同じでなければなりません。

次の例では、特定のサービスホスト名に対するすべてのセッションを表示します。

セッションを中断するには、対応するインデックス番号を入力します。複数のセッションを中断するには、複数のインデックス番号をスペース区切りで入力します。

パターンには、ワイルドカード (*) も使用できます。このパターンにワイルドカード (*) を使用する場合は、メタ文字 (¥) を使ってシェルからエスケープする必要があります。

--debug (-d)

--debug は、/var/opt/SUNWam/debug ディレクトリに作成される amAdmin ファイルにメッセージを書き込みます。このメッセージは技術的には詳細なものですが、i18n 互換ではありません。amadmin の操作ログを生成するには、データベースのログ書き込み時に、データベースドライバのクラスパスを手作業で追加する必要があります。たとえば、mysql にログを書き込むときに、amadmin に次の行を追加します。

--verbose (-v)

--verbose は、amadmin コマンドの処理状況の全体を画面に出力します。ファイルには詳細な情報を出力しません。コマンド行のメッセージ出力は、i18n 互換です。

--data (-t)

--data は、インポートされるバッチ処理用 XML ファイルの名前の値です。1 つ以上の XML ファイルを指定できます。この XML ファイルではさまざまなディレクトリオブジェクトを作成、削除、および読み取ることができるほか、サービスを登録および登録解除できます。このオプションに渡される XML ファイルの種類の詳細については、『Identity Server Developer's Guide』の「Service Management」の章を参照してください。

--schema (-s)

--schema は、Identity Server サービスの属性を Directory Server にロードします。サービス属性が定義されている XML サービスファイルを引数に取ります。この XML サービスファイルは、sms.dtd を基にしています。1 つ以上の XML ファイルを指定できます。

--deleteservice (-r)


注	DIT に対するバッチ更新を設定するか、サービススキーマおよび設定データをロードするかによって、--data または --schema オプションを指定する必要があります。

--deleteservice は、サービスとそのスキーマだけを削除します。

--serviceName

--serviceName は、XML サービスファイルの Service name=... タグに指定されているサービス名の値です。この部分をコード例 10-1 に示します。

コード例 10-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)

--version (-n)

--version は、ユーティリティ名、製品名、製品バージョン、および法律上の通知を表示する引数です。

amadmin を連携管理に使用する

この節では、連携管理で使用する amadmin のパラメータを示します。連携管理の詳細は『Identity Server Federation Management Guide』を参照してください。

Liberty のメタに準拠した XML を Directory Server にロードする

--runasdn (-u)

--password (-w)

--passwordfile (-f)

ユーザーのパスワードが書かれているファイルの名前です。

--encrypt (-e)

エンティティ名。たとえば、 http://www.example.com などです。エンティティは、1 つの組織に属していなければなりません。

--import (-g)

メタ情報を保持する XML ファイルです。このファイルは Liberty のメタ仕様と XSD に従わなければなりません。

エンティティをデジタル署名なしで XML ファイルにエクスポートする

-w|--password <パスワード> または -f|--passwordfile <パスワードファイル>

--runasdn (-u)

--password (-w)

--passwordfile (-f)

ユーザーのパスワードが書かれているファイルの名前です。

--encrypt (-e)

--export (-o)

エンティティの XML が書かれているファイルの名前です。XML は Liberty のメタ XSD に準拠していなければなりません。

エンティティをデジタル署名つきで XML ファイルにエクスポートする

--runasdn (-u)

--password (-w)

--passwordfile (-f)

ユーザーのパスワードが書かれているファイルの名前です。

--encrypt (-e)

--export (-o)

エンティティの XML が書かれているファイルの名前です。このファイルはデジタル署名されています。XML は Liberty のメタ XSD に準拠していなければなりません。

リソースバンドルに amadmin を使用する

以下の節では、amadmin 構文を使ってリソースバンドルの追加、検索、および削除を行う方法を説明します。

リソースバンドルを追加する

amadmin -u|--runasdn <ユーザーのDN> -w|--password <ユーザーのパスワード>

リソース文字列を得る

amadmin -u|--runasdn <ユーザーのDN> -w|--password <ユーザーのパスワード>

リソースバンドルを削除する

amadmin -u|--runasdn <ユーザーのDN> -w|--password <ユーザーのパスワード>

前へ目次索引次へ
Sun Java System Identity Server 2004Q2 管理ガイド