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 ファイルが 3 つあり、最初の XML ファイルがエラーになった場合、amadmin では残りのファイルをロードし続けます。continue オプションは、個別の要求のみに適用されます。

--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 サーバー名パターン

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

--debug (-d)

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

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

--verbose (-v)

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

--data (-t)

--data には、インポートされるバッチ処理用 XML ファイルの名前を指定します。1 つ以上の XML ファイルを指定できます。この XML ファイルではさまざまなディレクトリオブジェクトを作成、削除、および読み取ることができるほか、サービスを登録および登録解除できます。

--schema (-s)

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

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

--deleteservice (-r)

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

--serviceName

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

例 14–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 は、ユーティリティー名、製品名、製品バージョン、および法律上の通知を表示する引数です。