|
| Sun ONE Portal Server 6.0 管理者ガイド |
Sun™ ONE Portal Server 製品は、グラフィカルユーザインタフェースに加えて一連のコマンド行ユーティリティを提供します。
コマンド行ユーティリティは表 12-1 に一覧表示されています。また、これらのコマンド行ユーティリティは、管理タスクだけに適用します。 次の表では、コマンド名とその説明を一覧表示します。
iPlanet™ Directory Server Access Management Edition 管理用のコマンド行インタフェース amadmin も使用できます。 amadmin ツールの主な目的は、管理者が Directory Server 上で実行するバッチ管理処理を支援することです。たとえば、新しいサービスの作成、登録、有効化、および組織、ピープルコンテナ、グループ、ロール、ユーザーの作成、削除、読み取り (取得)を支援します。 詳細については、『 iPlanet Directory Server Access Management Edition 5.1 プログラマーズガイド』を参照してください。
dpadmin
説明
dpadmin コマンドとサブコマンドを使用することで、ディスプレイプロファイルオブジェクトを取得、追加、変更、ディスプレイプロファイルドキュメントから削除できます。 ディスプレイプロファイルオブジェクトとの対話は、すべてネイティブ XML フォーマットにする必要があります。 dpadmin コマンドでは、単一の表示プロファイルドキュメントでのみ操作できます。
dpadmin コマンドには次の項目が必要です。
- サブコマンド (「サブコマンド」を参照)。
- ディレクトリサーバーにアクセスするためのユーザー識別名およびパスワード。
- 対象となっている表示プロファイルドキュメント。
- グローバルレベルのディスプレイプロファイルドキュメント用の LDAP ノードまたは --global (-g) オプションを識別するための識別名。
構文
この節では、dpadmin コマンド構文について説明します。 長い名前のオプションと短い名前のオプションを、1 つのコマンド行に同時に使用することはできません。
短い名前の形式
$ dpadmin list|modify|add|remove [command-specific options] -u uid
-w password {-g|-d dn} [-l locale] [-r] [-b] [-h] [file]$ dpadmin batch [-c] -f batch-script-filename [-l locale] [-b] [-h]
長い名前の形式
$ dpadmin list|modify|add|remove [command-specific options] --runasdn uid --password password {--global|--dn dn} [--locale locale] [--dryrun] [--verbose] [--help] [file]
$ dpadmin --version
$ dpadmin batch [--continue] --file batch-script-filename [--locale locale] [--verbose] [--help]
サブコマンド
dpadmin コマンドには次のようなサブコマンドがあります。
list
説明
このサブコマンドを使用して、指定されたディスプレイプロファイルドキュメントから、特定のディスプレイプロファイルノードオブジェクトを取得します。 ディスプレイプロファイルノードオブジェクトが何も指定されていない場合は、ディスプレイプロファイルドキュメント全体が取得されます。 ディスプレイプロファイルオブジェクトは、ネイティブ XML フォーマットで標準出力に表示されます。
list サブコマンドには次のようなオプションがあります。
- -u または --runasdn 、および -w または --password オプションをそれぞれ使用して、 LDAP データベースにアクセスするための管理者の識別名とパスワードを指定します。 これらのオプションは必須です。
- グローバルレベルノードの場合は -g または --global オプション、特定の非グローバルレベルノードの場合は -d あるいは --dn オプションとともに、表示するためのディスプレイプロファイルノードオブジェクトを指定します。 -g または -d オプションは必須です。 コマンド固有の -n または --name オプションが存在しない場合は -d または --dn オプションは、ディスプレイプロファイルドキュメント全体を表示します。 -g または --global オプションは、ルートディスプレイプロファイルドキュメント全体を表示します。
- -n または --name オプションは、ディスプレイプロファイルノードオブジェクトの名前を指定する。
- -r または --dryrun オプション。 このオプションはサブコマンド dryrun または test を実行します。 -r または --dryrun オプションで実行されたサブコマンドは、サブコマンドのエラーまたは成功を sysout に報告しますが、LDAP のサブコマンド変更は行いません。
構文
$ dpadmin list -u|--runasdn uid -w|--password password {(-g|--global)|(-d|--dn dn)} [-n|--name name] [-r|--dryrun]
$ dpadmin list -h|--help
オプション
表 12-2 ではサポートされるオプションを説明します。list サブコマンドで使用できるオプション、引数、またはオペランドとその簡単な説明が示されています。
例
例 1
$ dpadmin list -n TemplateTableContainer -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
この例ではo=sesta.com 組織ノードから、TemplateTableContainer オブジェクトを取得し、標準出力に出力します。
例 2
$ dpadmin list -n mailcheck -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -g
この例ではグローバルレベルで、mailcheck オブジェクトを取得し取得できた場合に標準出力に出力します。
例 3
$ dpadmin list -n TemplateTableContainer/Bookmark2 -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
この例ではコンテナTemplateTableContainer にあるBookmark2 というチャネルを取得し、標準出力に出力します。
modify
説明
このサブコマンドは、既存のディスプレイプロファイルオブジェクトの値を変更します。 標準入力またはコマンドの引数に指定されたファイルから、オブジェクト用のデータを読み取ります。
この XML データには、変更するディスプレイプロファイルオブジェクトを一意に定義する一連の名前と適切な XML ヘッダーが必要になります。 適切な XML ヘッダーの例を次に示します。
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
modify サブコマンドの動作は、変更されるディスプレイプロファイルオブジェクトのタイプに応じて異なります。 combine オプションを指定すると、ディスプレイプロファイルオブジェクト内の新しい (プロパティなどの) エレメントが、既存のエレメントを置き換えるのではなく、既存のエレメントと結合されます。 modify サブコマンドの種類には、次のものがあります。
- ディスプレイプロファイル − ディスプレイプロファイルドキュメント全体を、ファイルを使用して指定した新しいオブジェクト値に変更できます。 combine オプションを指定すると、ディスプレイプロファイルドキュメント内の各ディスプレイプロファイルオブジェクトが再帰的に結合されます。 各ディスプレイプロファイルオブジェクトに対してcombine オプションがどのように機能するかの詳細については、以下を参照してください。
- チャネルまたはコンテナ − チャネルまたはコンテナを新しいオブジェクト値に変更できます。 チャネルまたはコンテナを変更する場合、parent オプションの指定によって次のように処理されます。
- parent オプションが指定されている場合、新しいディスプレイプロファイルオブジェクト名に一致するチャンネルまたはコンテナで、指定された親コンテナが検索されます。 検出されると、新しいディスプレイプロファイルオブジェクトで置き換えられます。
- parent オプションがない場合、ルートディスプレイプロファイルオブジェクトが親コンテナとして扱われます。 したがって、新しいディスプレイプロファイルオブジェクト名に一致するチャンネルまたはコンテナで、ルートディスプレイプロファイルオブジェクトが検索されます。 検出されると、新しいディスプレイプロファイルオブジェクトで置き換えられます。
combine オプションを指定すると、プロパティ、使用可能、選択済みの既存オブジェクトが新しいディスプレイプロファイルオブジェクトと結合されます。
- プロパティ − ディスプレイプロファイルオブジェクトのプロパティを新しい値に変更できます。 ディスプレイプロファイルオブジェクトのプロパティを変更するには、parent オプションが必要です。 指定した名前に一致するディスプレイプロファイルノードオブジェクト (チャンネルまたはコンテナ) またはディスプレイプロファイルプロバイダオブジェクトが、指定した parent オプションで検索されます。 検出されると、オブジェクトのプロパティオブジェクトが新しいディスプレイプロファイルオブジェクトで置き換えられます。 combine オプションを指定すると、既存のプロパティが新しい表示プロファイルオブジェクトと結合されます。
- 使用可能または選択済み − コンテナ内の 「使用可能」 リストまたは 「選択済み」 リストは、新しいディスプレイプロファイルオブジェクトと置き換えることができます。 このタイプのディスプレイプロファイルオブジェクトを変更するには、parent オプションが必要です。 親の名前に一致するディスプレイプロファイルコンテナが検索されます。 次に、選択済みまたは使用可能オブジェクトが、新しいディスプレイプロファイルオブジェクトで置き換えられます。 combine オプションを指定すると、既存の選択済みまたは使用可能オブジェクトが、新しいディスプレイプロファイルオブジェクトと結合されます。
- 文字列、論理値、整数、集合、またはロケール − ディスプレイプロファイルオブジェクト内の文字列、論理値、整数、集合、またはロケールのプロパティが、新しいディスプレイプロファイルオブジェクトプロパティと置き換えられます。
parent オプションを指定すると、指定した名前に一致するディスプレイプロファイルノード (チャネルまたはコンテナ) またはディスプレイプロファイルプロバイダがこの順に検索されます。 検出されると、新しいプロパティの名前に一致するプロパティが検索されます。 また、ディスプレイプロファイルオブジェクト内のプロパティが、新しいディスプレイプロファイルオブジェクトプロパティで置き換えられます。
parent オプションが指定されていない場合は、ディスプレイプロファイルのルートノードが使用され、そのルートノードでプロパティが挿入されます。
combine オプションを指定すると、既存の集合またはロケールオブジェクトが新しいディスプレイプロファイルオブジェクトと結合されます。 文字列、論理値および整数などの不可分なディスプレイプロファイルプロパティでは、combine オプションはサポートされません。
文字列、論理値、および整数などの不可分なディスプレイプロファイルプロパティには、名前は必要ありません。 名前をつけないと、値の文字列表記が名前になります。 たとえば、次の 2 つの表示プロファイル整数オブジェクトは、同じ名前になります。
<Integer value="3"/>
<Integer name="3" value="4"/>
- プロバイダ − 既存のディスプレイプロファイルプロバイダオブジェクトは、同じ名前のディスプレイプロファイルプロバイダと置き換えることができます。 新しいディスプレイプロファイルプロバイダオブジェクトの名前と一致するディスプレイプロファイルプロバイダオブジェクトが、ディスプレイプロファイルのルートノード内で検索されます。 検出されると、新しいディスプレイプロファイルプロバイダオブジェクトが、ディスプレイプロファイルのルートオブジェクトの下に挿入され、同じ名前の既存のディスプレイプロファイルプロバイダが置き換えられます。 プロバイダは暗黙的にコンテナであるルートノードにだけ存在するので、parent オプションを指定する必要はありません。
modify サブコマンドには次のオプションがあります。
- -u または --runasdn 、および -w または --password オプションをそれぞれ使用して、 LDAP データベースにアクセスするための管理者の識別名とパスワードを指定します。 これらのオプションは必須です。
- グローバルレベルノードの場合は -g または --global オプション、特定の非グローバルレベルノードの場合は -d あるいは --dn オプションとともに、表示するためのディスプレイプロファイル ノードオブジェクトを指定します。 -g または -d オプションは必須です。 コマンド固有の -n または --name オプションが存在しない場合は -d または --dn オプションは、ディスプレイプロファイルドキュメント全体を表示します。 -g または --global オプションは、ルートディスプレイプロファイルドキュメント全体を表示します。
- file 引数は入力 XML ファイル名。この引数はオプションです。 XML 入力を使用しない場合、標準入力から使用されます。
- -p または --parent オプションは変更される表示プロファイルオブジェクトの親の完全修飾名を指定する。
- -r または --dryrun オプション。 このオプションはサブコマンド dryrun または test を実行します。 -r または --dryrun オプションで実行されたサブコマンドは、サブコマンドのエラーまたは成功を sysout に報告しますが、LDAP のサブコマンド変更は行いません。
- -m または --combine オプション。 このオプションは表示プロファイルオブジェクトのマージを実行します。
構文
$ dpadmin modify -u|--runasdn uid -w|--password password {(-g|--global)|(-d|--dn dn)} [-p|--parent parent] [-r|--dryrun] [-m|--combine] file|<<EOF
$ dpadmin modify -h|--help
dpadmin modify コマンドへのデータは、ファイルまたはコマンドに続く XML フ ラグメントとして標準入力から提供されます。
オプション
表 12-3はサポートされるオプションを説明します。modify サブコマンドで使用できるオプション、引数、またはオペランドとその簡単な説明が示されています。
例
例 1
$ dpadmin modify -p TemplateTableContainer -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp" <<EOF
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
<Channel name="NewNews" provider="newsprovider">
<Properties>
<String name="title" value="News Channel"/>
<String name="description" value="This channel is all about news"/>
</Properties>
</Channel>
EOF
この例では、コンテナ TemplateTableContainer にあるチャネル NewNews を標準入力の XML テキストとして指定された値と変更または置き換えます。
例 2
$ dpadmin modify -p TemplateTableContainer/NewNews -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp" farble.xml
この例では、farble.xml でネーミングされたプロパティを farble.xml の新しいオブジェクトに置き換えます。farble.xml には次のものが含まれます。
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
<String name="welcome" value="Hi, welcome to farble land!!!!"/>
例 3
$ dpadmin list -n TemplateTableContainer -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
...
<Collection name="news">
<Collection name="bar">
<String name="msg" value="hi"/>
</Collection>
</Collection>
...
$ dpadmin modify -p TemplateTableContainer -u "uid=amAdmin,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp" -m <<EOF
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
<Collection name="news">
<Collection name="bar">
<String name="msg2" value="woo hoo"/>
</Collection>
</Collection>
EOF
$ dpadmin list -n TemplateTableContainer -u "uid=amAdmin,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
...
<Collection name="news">
<Collection name="bar">
<String name="msg" value="hi"/>
<String name="msg2" value="woo hoo"/>
</Collection>
</Collection>
...
この例では、combine オプションを使用して、新しいプロパティ msg2 を、集合 bar に追加します。 既存のプロパティ msg が結果として残っていることを確認します。
例 4
$ dpadmin list -n test -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
<Container name="test" provider="testprovider">
<Properties>
<String name="title" value="test"/>
</Properties>
<Available/>
<Selected/>
<Channels>
<Channel name="test1" provider="test1provider">
<Properties>
<Collection name="news">
<String name="msg1" value="blah"/>
<Collection name="bar">
<String name="msg2" value="hi"/>
</Collection>
</Collection>
</Properties>
</Channel>
</Channels>
</Container>
$ dpadmin modify -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp" -m <<EOF
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
<Container name="test" provider="testprovider">
<Properties>
<String name="title" value="Test Container"/>
</Properties>
<Available>
<Reference value="test1"/>
</Available>
<Selected>
<Reference value="test1"/>
</Selected>
<Channels>
<Channel name="test1" provider="test1provider">
<Properties>
<Collection name="news">
<String name="msg1" value="123"/>
<Collection name="bar">
<String name="msg3" value="123/>
</Collection>
</Collection>
</Properties>
</Channel>
</Channels>
</Container>
EOF
$ dpadmin list -n test -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
<Container name="test" provider="testprovider">
<Properties>
<String name="title" value="Test Container"/>
</Properties>
<Available>
<Reference value="test1"/>
</Available>
<Selected>
<Reference value="test1"/>
</Selected>
<Channels>
<Channel name="test1" provider="test1provider">
<Properties>
<Collection name="news">
<String name="msg1" value="123"/>
<Collection name="bar">
<String name="msg2" value="hi"/>
<String name="msg3" value="123"/>
</Collection>
</Collection>
</Properties>
</Channel>
</Channels>
</Container>
この例では、title および msg1 の値が、新しい値で置き換えられます。 Available および Selected の両方に、Reference value が追加されました。 news 集合が msg3 を追加しました。 この例では、必要に応じて結合および置き換えを行うために、-m または combine オプションを modify サブコマンドとともに使用できることを示しています。
add
説明
このサブコマンドは、ディスプレイプロファイルに新しいディスプレイプロファイルオブジェクトを追加します。このサブコマンドを使用するには、 追加されるオブジェクトが、ディスプレイプロファイルに存在しない必要があります。 add サブコマンドは、標準入力またはコマンドの引数に指定されたファイルから、新しいオブジェクト用のデータを読み取ります。 新しいオブジェクト用のデータは、XML であり、Sun ONE Portal Server ディスプレイプロファイル DTD に適合する必要があります。
この XML データには、変更するディスプレイプロファイルオブジェクトを一意に定義する一連の名前と適切な XML ヘッダーが必要になります。 適切な XML ヘッダーの例を次に示します。
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
注 付録 B には、表示プロファイル DTD が含まれます。
add サブコマンドの動作は、追加されるディスプレイプロファイルオブジェクトのタイプに応じて異なります。 add サブコマンドの種類には次のものがあります。
- ディスプレイプロファイル − ディスプレイプロファイルドキュメント全体を指定した LDAP ノードに追加できます。 ドキュメントがすでにノードにある場合は、エラーが報告されます。 新しいディスプレイプロファイルドキュメントを追加する場合は、parent オプションを指定しないでください。
- チャネルまたはコンテナ − チャネルまたはコンテナを追加できます。parent オプションが存在する場合、親ディスプレイプロファイルオブジェクトは親コンテナ内を特定の名前で検索され、指定されたチャネルまたはコンテナが追加されます。 parent オプションがない場合、親ディスプレイプロファイルオブジェクトはディスプレイプロファイルのルートオブジェクトとみなされ、ルートの下に指定されたチャンネルまたはコンテナオブジェクトが追加されます。
- プロパティ - すべてのディスプレイプロファイルノードおよびディスプレイプロファイルプロバイダオブジェクトに対して、プロパティバンドルが必要であるために、それらはすでに存在し、新たに追加することはできません。 modify サブコマンドを使用します。
- 使用可能または選択済み - ディスプレイプロファイルコンテナに対して、使用可能または選択済みオブジェクトが必要であるため、それらのオブジェクトはすでに存在し、新たに追加することはできません。 modify サブコマンドを使用します。
- 文字列、論理値、整数、集合、またはロケール − ディスプレイプロファイルオブジェクト内の文字列、論理値、整数、集合、ロケールのプロパティは追加することができます。 このタイプの表示プロファイルオブジェクトを追加するには、parent オプションを指定する必要があります。 指定された parent オプション内で、名前が一致するディスプレイプロファイルノードオブジェクト (チャネルまたはコンテナ) またはディスプレイプロファイルプロバイダがこの順に検索されます。 見つかると、指定されたディスプレイプロファイルプロパティが、ディスプレイプロファイルノードオブジェクトまたはディスプレイプロファイルプロバイダオブジェクトに追加されます。
文字列、論理値、および整数などの不可分なディスプレイプロファイルプロパティには、名前は必要ありません。 名前をつけないと、値の文字列表記が名前になります。
- プロバイダ - ディスプレイプロファイルプロバイダがルートノードの下に挿入されます。 プロバイダはルートノードにだけ存在するので、parent オプションを使用しないでください。 同じ名前のオブジェクトがすでに存在する場合は、エラーが報告されます。
add サブコマンドには次のオプションがあります。
- -u または --runasdn 、および -w または --password のそれぞれのオプションを使用して、LDAP データベースにアクセスするための管理者の識別名およびパスワードを指定します。 これらのオプションは必須です。
- 追加するディスプレイプロファイルドキュメント、またはオブジェクトを追加する必要のあるディスプレイプロファイルドキュメント (-d または --dn オプション)。 -g または --global オプションを使用してグローバルレベルノードで定義された、追加するためのディスプレイプロファイルオブジェクト。 -g または -d オプションは必須です。
- 入力 XML 入力が含まれるファイル名 (file 引数)。
- 追加される、または追加先になるディスプレイプロファイルノードオブジェクトの親の完全修飾名 (-p または --parent オプション)。
- -r または --dryrun オプション。 このオプションはサブコマンド dryrun または test を実行します。 -r または --dryrun オプションで実行されたサブコマンドは、サブコマンドのエラーまたは成功を sysout に報告しますが、LDAP のサブコマンド変更は行いません。
構文
$ dpadmin add -u|--runasdn uid -w|--password password {(-g|--global)|(-d|--dn dn)} [-p|--parent parent] [-r|--dryrun] file|<<EOF
$ dpadmin add -h|--help
dpadmin add コマンドへのデータは、ファイルまたはコマンドにつづく XML フ ラグメントとして標準入力から提供されます。
オプション
表 12-4はサポートされるオプションを説明します。 add サブコマンドで使用できるオプション、引数、またはオペランドとその簡単な説明が示されています。
例
$ dpadmin add -p SampleTabPanelContainer/Postal -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp" <<EOF
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
<Collection name="zipCodes">
<Integer value="98012"/>
<Integer value="98036"/>
<Integer value="94025"/>
<Integer value="95112"/>
</Collection>
EOF
この例では、標準入力に指定された zipCodes という名前の集合プロパティを、SampleTabPanelContainer という名前のコンテナにあるPostal という名前のチャネルに追加します。
remove
説明
このサブコマンドは、既存のディスプレイプロファイルオブジェクトを、ディスプレイプロファイルから削除します。 削除するオブジェクトが指定したディスプレイプロファイルドキュメントに存在しないと、エラーが報告されます。 このサブコマンドは、type、parent、および name オプションを使用します。
type オプションは、削除するディスプレイプロファイルオブジェクトのタイプを指定します。 parent オプションは、削除するディスプレイプロファイルオブジェクトの親ディスプレイプロファイルオブジェクトの完全修飾名を指定します。 親ディスプレイプロファイルオブジェクトのタイプは、削除されるディスプレイプロファイルオブジェクトのタイプに応じて異なります。 name オプションは、削除するオブジェクトの名前を指定します。
parent および name オプションの動作は、削除されるディスプレイプロファイルオブジェクトのタイプに応じて異なります。表 12-5 タイプオプションで使用できる値とどのオブジェクトが削除されるかの簡単な説明が示されています。
remove サブコマンドには次のオプションがあります。
- -u または --runasdn および -w または --password のそれぞれのオプションを使用して、LDAP データベースにアクセスするための管理者の識別名とパスワードを指定します。 これらのオプションは必須です。
- -n または --name オプションは削除するための、ディスプレイプロファイルノードオブジェクトの名前を指定します。type=rootの場合以外は、このオプションは必須です。
- -d (--dn) または -g (--global) オプションを使用して、削除するオブジェクトを含むディスプレイプロファイルドキュメントが置かれている LDAP データベースの表示プロファイルドキュメントノードオブジェクトを指定します。 -d (--dn) または -g (--global) オプションのどちらかが必要です。
- -t または --type オプションは削除するための、ディスプレイプロファイルノードオブジェクトのタイプを指定します。 このオプションは必須です。
- -p または --parent オプションは削除されるディスプレイプロファイルノードオブジェクトの親の完全修飾名を指定します。
- -r または --dryrun オプション。 このオプションはサブコマンド dryrun または test を実行します。 -r または --dryrun オプションで実行されたサブコマンドは、サブコマンドのエラーまたは成功を sysout に報告しますが、LDAP のサブコマンド変更は行いません。
構文
$ dpadmin remove -u|--runasdn uid -w|--password password {(-g|--global)|(-d|--dn dn)} [-n|--name name] [-p|--parent parent][-r|--dryrun] -t|--type type
$ dpadmin remove -h|--help
オプション
表 12-6はサポートされるオプションを説明します。remove サブコマンドで使用できるオプション、引数、またはオペランドとその簡単な説明が示されています。
例
例 1
$ dpadmin remove -t property -p Bookmarks -n locations -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
この例では、 Bookmarks という名前のチャネルまたはコンテナから locations という名前のプロパティを削除します。
例 2
$ dpadmin remove -t provider -n "test1" -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -g
グローバル表示プロファイルから、プロバイダ test1 を削除します。
例 3
$ dpadmin remove --type channel --parent TemplateTableContainer --name "Test" --runasdn "uid=amAdmin,ou=people,o=sesta.com,o=isp" --password joshua --dn "o=sesta.com,o=isp"
この例では、TemplateTableContainer という名前の親コンテナ内に存在する Test という名前のチャネルを削除します。
例 4
$ dpadmin list -n X -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
<Container name=ﾓXﾓ ...>
<Channels>
<Container name=ﾓYﾓ ...>
<Channels>
<Channel name=ﾓzﾓ .../>
</Channels>
</Container>
</Channels>
</Container>
チャネル z を削除するには、次のコマンドのどれかを実行します。
$ dpadmin remove -t channel -p X -n Y/z -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
$ dpadmin remove -t channel -p X/Y -n z -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
$ dpadmin remove -t channel -n X/Y/z -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua -d "o=sesta.com,o=isp"
batch
説明
batch サブコマンドを使用すると、複数の表示プロファイルコマンドの処理を最適の方法で実行できます。 サブコマンドはバッチスクリプトファイル (必須) に一覧表示され、連続して実行されます。 エラーが発生すると、デフォルトではエラーが報告されて終了します。 -c または --continue オプションは、連続プロセスモードを示します。 このモードでは、エラーが発生すると報告されて、次のサブコマンドの dpadmin を継続します。
コマンドバッチスクリプトはテキスト (ASCII) ファイルにする必要があります。また batch サブコマンドを除き、dpadmin に入力するためのサブコマンドをいくつでも含めることができます。 サブコマンドは 1 行で入力する必要があります (改行文字はコマンドの終わりを示します)。 各サブコマンドには、コマンド行に管理者の識別名およびパスワードを指定する必要があります。 サブコマンドの構文は、dpadmin 部分を除いて、サブコマンドを直接シェルに入力した場合とまったく同じになります。 スクリプトには XML を含めることができません。したがって、XML 入力を必要とするサブコマンドではファイルに含める必要があります。 識別名 (DN ) がスペースを含む場合は、前後を二重引用符で囲みます。
次はバッチスクリプトファイルの例です (各コマンドは 1 行)。
batch サブコマンドには -c または --continue オプションがあります、-f または --file を使用して指定したバッチスクリプトファイルの名前が必要です。
構文
$ dpadmin batch [-c|--continue] -f|--file batch-script-file
$ dpadmin batch -h|--help
オプション
表 12-7はサポートされるオプションを説明します。batch サブコマンドで使用できるオプション、引数、またはオペランドとその簡単な説明が示されています。
オプション
表 12-8はサポートされる dpadmin コマンドオプションを要約したものです。 この表では、小見出しにサブコマンドが表示してあります。 この表には使用できるオプション、引数、またはオペランドとその簡単な説明が示されています。
par
説明
par コマンドは、指定された.par ファイルと関連する機能を実行します。 チャネルまたはプロバイダ、あるいはその両方を Sun ONE Portal Server でインポートまたはエクスポートする場合に使用できます。
構文
この節では、par コマンド構文について説明します。 長い名前のオプションと短い名前のオプションを、1 つのコマンド行に同時に使用しないようにしてください。
短い名前の形式
par containers -r uid -p password [-d] dn|global
par describe [-d] parfile
par export -r uid -p password [-m] [-d] [-v] parfile dn|global {exportfile|from=}...
par import -r uid -p password [-o] [-d] [-v] parfile [dn|global [op...]]
par import -r uid -p password -a [-d] [-v] parfile [dn|global]
長い名前の形式
par containers --runasdn uid --password password [--debug] dn|global
par describe [--debug] parfile
par export --runasdn uid --password password [--modify] [--debug] [--verbose] parfile dn|global {exportfile|from=}...
par import --runasdn uid --password password [--overwrite] [--debug] [--verbose] parfile [dn|global [op...]]
par import --runasdn uid --password password --auto [--debug] [--verbose] parfile [dn|global]
サブコマンド
次のサブコマンドを使用できます。
containers
説明
指定されたディレクトリサーバー名 (またはglobal) で示された、特定のディスプレイプロファイルドキュメント内のすべての使用可能なコンテナおよびチャネルを一覧表示します。 ほかのコマンドを構築するための補助として使用できます。
構文
par containers -r|--runasdn uid -p|--password password [-d|--debug] [-v|--verbose] dn|global
例
par containers -r "uid=amAdmin,ou=people,o=sesta.com,o=isp" -p joshua -d "o=sesta.com,o=isp"
この例では、LDAP ノード"o=sesta.com,o=isp" にあるディスプレイプロファイルドキュメント内の使用可能なコンテナを一覧表示します。
describe
説明
エントリおよびエントリに定義されたすべての組み込みの自動抽出操作を含む、指定された .par ファイルの内容を表示します。
構文
par describe parfile
例
par describe myfile.par
この例では、コマンド出力または myfile.par の表示内容は次のようになります。
クラスルート: /
プロパティベースファイルルート: /pbfiles
表示プロファイルルート: /dp
静的なコンテンツルート: /static
エントリ: mychannel
AutoExtract:dpnode=o%3Dsesta.com%2Co%3Disp,channel,entry=mychann el
DPドキュメント: this my JSP based channel.
チャネル: SampleJSP.a
インクルード: Property Based File, root templateBaseDir, path default/mychannel/samplecontent.jsp (channel)
インクルード: Property Based File, root templateBaseDir, path default/mychannel/sampledoedit.jsp (channel)
インクルード: Property Based File, root templateBaseDir, path default/mychannel/sampleedit.jsp (channel)
インクルード: Property Based File, root templateBaseDir, path default_en_US/mychannel/samplecontent.jsp
(channel)
インクルード: Property Based File, root templateBaseDir, path default_en_US/mychannel/sampledoedit.jsp
(channel)
インクルード: Property Based File, root templateBaseDir, path default_en_US/mychannel/sampleedit.jsp
(channel)
export
説明
Portal Server からプロバイダまたはチャンネル情報をエクスポートして、指定された .par ファイルを生成します。 .par ファイル、更新する必要があるディスプレイプロファイルドキュメントに関するディレクトリサーバー名 (またはキーワード global) および1 つ以上の exportfile または from 指定します。from 指定は、エクスポートファイルとまったく同じ情報を含みます。唯一の違いは、行がセミコロンで区切られていることです。
-m オプションのないpar export コマンドは、.par ファイルを作成します。 -m オプションを持つpar export コマンドは、プロバイダ、チャネル、またはコンテナを定義する既存の.par ファイルの更新または追加、あるいはその両方に使用します。
構文
par export -r|--runasdn uid -p|--password password [-d|--debug] [-v|--verbose] parfile dn|global {exportfile|from=}...
par export -r|--runasdn uid -p|--password password [-d|--debug] [-v|--verbose] -m|--modify parfile dn|global {exportfile|from=}...
例
par export -r "uid=amAdmin,ou=people,o=sesta.com,o=isp" -p joshua mychannel.par "o=sesta.com,o=isp" myexport.txt
myexport.txt コンテナの内容は次のようになります。
from: channel mychannel
directory: templateBaseDir . mychannel
description: this is my JSP based channel
この例では、mychannel のチャンネル定義およびテンプレートファイルを "o=sesta.com,o=isp" dnから、mychannel.par へエクスポートします。 また、JSPProvider チャネルの場合、directory 行は、ロケール固有バージョンを含むすべての .jsp ファイルを移行します。
import
説明
指定された.par ファイルから Portal Sever へオブジェクトをインポートします。 このコマンドには、.par ファイル、およびディレクトリサーバに示されたディスプレイノード(またはキーワード global によって示されたルート表示プロファイル)にオブジェクトをインポートするための表示プロファイルドキュメントのオプションの引数、および実行する操作を取得します。 これらが指定されていない場合は、par ファイルから取得します。 auto オプションを使用して、.par ファイルに既存の自動抽出操作の実行を指示できます。
新しいチャンネルを追加する場合は、par import コマンドを使用します。このコマンドは -o オプションとともに使用することもできます。 チャンネルがすでに存在する場合は、 -o オプションを par import コマンドとともに使用して、古いチャンネルを完全に置き換える (上書きする) 必要があります。 このサブコマンドを使用すると、チャンネルだけでなくプロバイダもインポートできます。
構文
par import -r|--runasdn uid -p|--password password [-o] [-d|--debug] [-v|--verbose] parfile [dn|global [op...]]
par import -r|--runasdn uid -p|--password password -a|--auto [-d|--debug] [-v|--verbose] parfile [dn|global]
例
例 1
par import -r "uid=amAdmin,ou=people,o=sesta.com,o=isp" -p joshua --auto myfile.par "o=sesta.com,o=isp"
この例では、myfile.par プロファイルに自動操作が定義されていた場合、コマンドはmyfile.par ファイルからチャンネルを抽出します。
例 2
par import -r "uid=amAdmin,ou=people,o=sesta.com,o=isp" -p joshua myfile.par "o=sesta.com,o=isp" "entry=mychannel,channel=anothername,avail=topcontainer"
この例では、ターゲット dn 内の異なる名前でコマンドをインストールし、コンテナ topcontainer で使用できるようにして、チャンネルを明示的に抽出します。
オプション
表 12-9 ではサポートされるオプションをアルファベット順に説明します。最初の列にはpar コマンドで使用できるオプションとその簡単な説明が示されています。
引数
表 12-10はサポートされる引数を説明します。par コマンドで使用できる引数とその簡単な説明が示されています。
表 12-10 par コマンド引数
引数
説明
dn
アクセスするディレクトリサーバ内の識別ノードを指定します。 "o=organizationName,o=organizationalUnit" の形式を使用します。
global
LDAP のグローバルレベルノードでディスプレイプロファイルドキュメントにアクセスすることを指定します。
exportfile
これらのファイルは、.par ファイル内のそれぞれのエントリ (プロバイダ、チャンネル、またはプロバイダとチャンネルの組み合わせ) に対応します。また、単に指定された .par ファイルに挿入されるデータを指定します。 情報が多すぎてコマンド行にリストできない場合は、小さなファイルにすることができます。 詳細については、「エクスポートファイル」を参照してください。
from
コマンド行に指定される 1 つの等号 ("=") があり、セミコロン (";") で区切られたその他の行がつづく「from」行を含むエクスポートファイルと同等です。行プロパティの詳細については、表 12-11 の「from」を参照してください。
op
実行する操作を指定します。詳細については、「操作」を参照してください。
parfile
操作の対象になる par ファイルを指定します。つまり、インポート、エクスポート、または表示を行う par ファイルを指定します。
エクスポートファイル
これらのファイルは、.par ファイルに挿入するデータを指定します。 このファイルは、キーワード、続いてコロンおよび空白スペースで区切られたフィールドで構成されます。 ファイルの最初の行は必ず「from:」行にする必要があります。「#」で始まる行はコメントとして扱われます。
表 12-11 では、エクスポートファイルの行プロパティを説明しています。行のキーワードとその簡単な説明を示しています。
操作
エクスポートファイルまたはコマンド行の各操作 (op) は、値 (通常はオプション) を持つキーワードのカンマで区切られたリストとして指定する必要があります。 操作は空欄またはスペースで区切られたリストです。 各操作は次の形式で表示されます。
dpnode=dn,entry=name,provider[=name],channel[=name],container=name[,av ail=name,selected]
dpnode
dpnode は、この操作のターゲットであるディスプレイプロファイルドキュメント用のディレクトリサーバ (またはキーワードglobal) 内の識別名を指定します。 指定されているコンテキストがすでに提供されている場合は、適用できない場合があります。 たとえば、import サブコマンドが識別名を定義する場合は、ファイル内の識別名は無視されます。
entry
.par ファイル内のエントリ名を指定します。 次の場合はエントリは必要ありません。
- .par ファイルがデフォルトの 1 つのエントリだけを含む場合
- 操作がエントリの自動抽出オプションなどのエントリとすでに関連付けられている場合
par ユーティリティは、エントリが指定されていない場合は最初のエントリをデフォルトにします。
provider
プロバイダの抽出が行われることを示します。 名前がない場合は、.par ファイル内でプロバイダとパッケージ化された名前を使用します。
channel
チャンネルの抽出が行われることを示します。 名前がない場合は、.par ファイル内のチャンネルと提供された名前を使用します。
Container
チャネルの抽出だけに適用され、チャンネルがどのコンテナに挿入されるかを示します。 省略されている場合、チャネルは「channel」エレメントの表示プロファイルドキュメントルートに挿入されません。
avail
チャンネルの抽出だけに適用され、「avail」 (使用可能) リストが新しいチャンネルのリファレンスを受け取るコンテナを示します。 省略されている場合は、新しいチャンネルレファレンスが作成されます。
selected
「avail」が使用されている場合だけに適用されます。 「avail」リストがリファレンスを受け取るコンテナを示し、また「選択済み」リストにリファレンスを持ちます。
op 情報が、par import コマンドと .par ファイルの両方にある場合は、コマンド情報が優先します。
par ファイル
この節では、par ファイル形式に関する補足説明をします。 この情報は、par コマンドを実行するのには必要ありません。
par ファイルはチャネル、プロバイダ、およびそれらの関連ファイルのトランスポート用のマニフェストエントリを持つ jar ファイルです。 このファイルを使用すると、プロバイダ、チャンネル、またはその両方のインストールを柔軟に行えます。 .par ファイルには、主に次の 4 つのタイプがあります。
- ディスプレイプロファイル用のプロバイダまたはチャンネル、あるいはその両方の情報が含まれる XML ファイルドキュメントです。 このドキュメントは、ディスプレイプロファイル DTD に記述されている parEntry です。この parEntry には、チャンネルまたはプロバイダ、あるいはその両方の組み合わせが含まれます。
- プロバイダまたはチャネルに関連付けられたクラスファイル。
- プロパティベースのファイル。 チャネルまたはプロバイダ (通常はチャネル) に関連付けられた一般ファイル。これらのファイルは Portal Server 上の構成可能なルートの下に配置する必要があります。
- 静的コンテンツファイル。 ドキュメントとしてWeb サーバ上に配置されています。
par ファイルのコンテンツ
表 12-12 では、.par ファイルに含める必要のあるヘッダーを説明しています。この表はには、必要とされるグローバルヘッダーとその簡単な説明が示されています。
.par ファイルには、各 parEntry XML ファイルに名前を持つエントリが必要です。 表 12-13 には、使用できるヘッダーとその簡単な説明が示されています。 各ネーミングエントリのセクションに次のヘッダーが使用される場合があります。
.par ファイルにエントリが 1 つだけが含まれる場合は、デフォルトのエントリが使われるので、ファイルを操作する際にエントリに名前を付ける必要はありません。
rwadmin
説明
rwadmin コマンドを使用すると、ユーザーは iPlanet Directory Server Access Management Edition リライタサービスで使用できるリライタデータを管理できます。
構文
この節では、rwadmin コマンド構文について説明します。
短い名前の形式
rwadmin list -u uid -w password [-l locale] [-b] [-h]
rwadmin store -u uid -w password [-l locale] [-b] [-h] filename
rwadmin get -r rulesetname -u uid -w password [-l locale] [-b] [-h] [filename]
rwadmin remove -r rulesetname -u uid -w password [-l locale] [-b] [-h]
長い名前の形式
rwadmin list --runasdn uid --password password [--locale locale] [--verbose] [--version] [--help]
rwadmin store --runasdn uid --password password [--locale locale] [--verbose] [--version] [--help] filename
rwadmin get --rulesetid rulesetname --runasdn uid --password password [--locale locale] [--verbose] [--version] [--help] [filename]
rwadmin remove --rulesetid rulesetname --runasdn uid --password password [--locale locale] [--verbose] [--version] [--help]
サブコマンド
次のサブコマンドを使用できます。
list
説明
このコマンドは使用可能なルールセット名を一覧表示します。
構文
rwadmin list -u|--runasdn uid -w|--password password
例
rwadmin list -u ﾒuid=amAdmin,ou=people,o=sesta.com,o=ispﾓ -w joshua
この例では、使用可能なすべてのルールセットを表示します。
store
説明
このコマンドは、ローカルファイルシステムで使用できるルールをiPlanet Directory Server Access Management Editionに格納します。 DefaultRuleSet を格納するには、次のコマンドを使用します。
rwadmin store -u uid -w password /resources/DefaultRuleSet.xml
ここで、/resources/DefaultRuleSet.xml は、rewriter.jar ファイルに格納されるルールセットの場所です。 このコマンドを実行したときに、おなじ ID を持つルールセットが存在すると、新しいデータは格納されません。 既存のルールセット ID を削除してから、再度試行する必要があります。
構文
rwadmin store -u|--runasdn uid -w|--password password filename
Example
rwadmin store -u ﾒuid=amAdmin,ou=people,o=sesta.com,o=ispﾓ -w joshua /opt/data/ExampleRuleSet.xml
この例では、/opt/data/ExampleRuleSet.xml で使用できるルールをiPlanet Directory Server Access Management Edition に格納します。
get
説明
このコマンドは、iPlanet Directory Server Access Management Edition からルールセットを取得します。 filename が指定されると、取得したルールセットは指定したファイルに格納され、提供されない場合は、標準出力 (またはコンソール上) に表示されます。
構文
rwadmin get -r|--rulesetid ruleset -u|--runasdn uid -w|--password password [filename]
例
例 1
rwadmin get -r ﾒExampleRuleSetﾓ -u ﾒuid=amAdmin,ou=people,o=sesta.com,o=ispﾓ -w joshua
この例では、ExampleRuleSet という名前のルールセットを iPlanet Directory Server Access Management Edition から取得し、コンソール上に表示します。
例 2
rwadmin get -r ﾒExampleRuleSetﾓ -u ﾒuid=amAdmin,ou=people,o=sesta.com,o=ispﾓ -w joshua /tmp/abc.xml
この例では、ExampleRuleSet という名前のルールセットを iPlanet Directory Server Access Management Edition から取得し、/tmp ディレクトリのファイル abc.xml に格納します。
remove
説明
このコマンドは、iPlanet Directory Server Access Management Edition からルールセットを削除します。 このコマンドは、警告しないでルールセットを削除します。
構文
rwadmin remove -r|--rulesetid ruleset -u|--runasdn uid -w|password password
例
rwadmin remove -r ﾒExampleRuleSetﾓ -u ﾒuid=amAdmin,ou=people,o=sesta.com,o=ispﾓ -w joshua
この例では、ExampleRuleSet という名前のルールセットをiPlanet Directory Server Access Management Edition から削除します。
オプション
表 12-14 では、サポートされる rwadmin コマンドオプションをアルファベット順に要約しています。 この表には使用できるオプションとその簡単な説明が示されています。
rdmgr
説明
rdmgr コマンドは、検索サービスを制御する主要なコマンドです。 2 種類のサブコマンドがあります。 リソース記述 (RD) 管理で使用するサブコマンドと、データベースの保守管理に使用するサブコマンドです。 なお rdmgr コマンドは、通常、検索機能を有効鬼した Portal Server のインスタンスディレクトリである /server-instance-directory/deployment_uri ディレクトリで実行されます。 これは、インストール時に選択した配置 URI パスです。 デフォルトの Portal Server のインストールを選択した場合、/var/opt/SUNWps/https-servername/portal ディレクトリになります。
構文
rdmgr コマンドの一般構文は次のとおりです。
# rdmgr [subcommand] [options] [input]
RD サブコマンドはこの構文に従います。
# rdmgr [-umgdnUL] [-ACSTNPq] [-a att,att,...] [-b number]
[-c search.conf] [-i charset] [-o charset] [-j number] [-l number]
[-p progress] [-r number] [-s schema] [-y dbname] [filename|-Q query]
データベース保守サブコマンドはより厳密にこの構文に従います。
# rdmgr [-OXIERGBL] [-ASTDVNP] [-a att,att,...] [-b number]
[-c search.conf] [-j number] [-l number] [-p progress] [-r number]
[-s schema] [-y dbname]
-l number を使用すると、任意の RD またはデータベースサブコマンドにログレベル番号を設定できます。 値が 1 (デフォルト) に設定されている場合は、すべての rdmgr コマンドのログが記録されます。 値が大きくなるほど、ログファイルに含まれる情報が詳細になります。 レベルは 1 〜 100 です。このオプションが指定されていない場合、コマンドは search.conf ファイルの debug-loglevel で定義された設定内容を使用します。 ログファイル名は、search.conf ファイルのrdmgr-logfile を使用して定義します。
ここで、-c search.conf オプションは、search.conf ファイルの場所を示します。 このオプションを使用しないと、デフォルト値は現在のディレクトリの config/search.conf になります。 search.conf ファイルには、設定したすべての検索値が一覧表示されます。
-p progress を使用して、すべての RD またはデータベースサブコマンドの進行状況を表示できます。 -p だけを入力すると、進行状況は stdout 上に表示されます。
サブコマンド
次のサブコマンドを使用できます。
リソース記述サブコマンド
説明
RD サブコマンドを使用すると、RD の挿入または置換、ビューでフィルタリングされた RD のマージ、ビューでフィルタリングされた RD の取得、RD の削除、および RD のカウントなどのバッチプロセスを実行できます。表 12-15はで、最初の列にサブコマンドとその簡単な説明を示しています。
構文
# rdmgr [-umgdnUL] [-ACSTNPq] [-a att,att,...] [-b number]
[-c search.conf] [-i charset] [-o charset] [-j number] [-l number]
[-p progress] [-r number] [-s schema] [-y dbname] [filename|-Q query]
オプション
表 12-16 では、サポートされるオプションを説明しています。最初の列にオプションまたは引数、とその説明を示します。
注 サブコマンドを使用せずに rdmgr を入力すると、コマンドは -u サブコマンドが指定されたものとして動作します。 サブコマンドおよびクエリ (-Q) を指定せずに rdmgr を入力すると、コマンドは -g サブコマンドが指定されたものとして動作します。
例
例 1
環境変数LD_LIBRARY_PATH を /opt/SUNWps/lib に設定します。
/var/opt/SUNWps/https-sesta.com/portal ディレクトリで次のように入力します。
# /opt/SUNWps/bin/rdmgr -U
この例では、リソース記述のデフォルトデータベース全体が、UTF-8 SOIF 形式で stdout に出力されます。
例 2
/var/opt/SUNWps/https-sesta.com/portal のデフォルト検索ディレクトリで、次のように指定します。
# /opt/SUNWps/bin/rdmgr -d -Q java
この例では、「java」を含むすべてのリソース記述が削除されます。
データベース保守サブコマンド
説明
データベースサブコマンドを使用すると、管理者は検索データベースを最適化して、データベースの切り詰め、クリア、再インデックス化ができます。また、無効の RD を削除したり、データベースを復元させたりすることができます。 表 12-17 には、サブコマンドとその簡単な説明が示されています。
構文
# rdmgr [-OXIERGBL] [-ASTDVNP] [-a att,att,...] [-b number]
[-c search.conf] [-j number] [-l number] [-p progress] [-r number]
[-s schema] [-y dbname]
オプション
表 12-18 では、サポートされるオプションを説明しています。オプションまたは引数とその説明を示します。
例
例 1
デフォルト検索ディレクトリ内で次のように指定します。
# /opt/SUNWps/bin/rdmgr -E -j 13 -p stdout -r 5
この例では、有効期限切れとなっている最大 13 個の RD がデータベースから削除されます。 stdout への進行状況レポートは、秒単位の経過時間と 5 つのリソース記述ごとに処理された RD の数を出力します。
例 2
検索エンジンが応答しません。 デフォルト検索ディレクトリ内で次のように指定します。
# /opt/SUNWps/bin/rdmgr -R
これによりすべての検索データベースが復元され、検索エンジンを再び使用可能にします。 このコマンドを使用して、データベース内の無効なロックを解除し、未処理のデータトランザクションをロールバックします。 無効なロックおよび未処理のトランザクションは、異常終了したデータベースプロセスの結果生じたものです。
使用法メッセージおよびバージョンのサブコマンド
表 12-19 には、使用法を説明するメッセージやバージョン情報を表示するサブコマンドとその簡単な説明を示します。
表 12-19 使用法メッセージとバージョンの rdmgr サブコマンド
引数/オペランド
説明
-h または -?
使用法を説明するメッセージを表示します。
-v
バージョン情報を表示します。
リターンコード
rdmgr コマンドはリターンコードをシェルに戻します。
0 - 成功
1 - 失敗
sendrdm
説明
sendrdm コマンドは、CGI またはコマンド行ベースの検索メカニズムを提供します。 rdm (リソース記述マネージャ) リクエストは、 SOIF 形式で検索サーバに送信されます。 このコマンドは、通常の検索 Portal Server インスタンスディレクトリの /server-instance-directory/deployment_uri 上で実行されます。 これは、インストール時に選択する配置 URI パスです。 デフォルトの Portal Server のインストールを選択した場合、/var/opt/SUNWps/https-servername/portal ディレクトリになります。 servername の値は、Portal Server の完全修飾名であるデフォルトの Portal Server インスタンス名です。
注 デフォルトインストールでは、環境変数 LD_LIBRARY_PATH を /opt/SUNWps/libに設定します。
構文
sendrdm コマンドの構文は次のとおりです。
# sendrdm [-dv] [-t n] [-u uri] RDM-in [RDM-out]
オプション
表 12-20 ではサポートされる sendrdm コマンドオプションをアルファベット順に要約しています。 この表には使用できるオプションがとその簡単な説明が示されています。
例
/var/opt/SUNWps/https-servername/portal ルートディレクトリで次のように指定します。
# /opt/SUNWps/lib/sendrdm -t 3600 -u /rdm/incoming rdmquery.soif result.soif
この例では、制限時間を 1 時間にして、/rdm/incoming を使用して Compass Server 3.01x からインポートします。 rdmquery.soif の内容は次のようになります。
@RDMHEADER { -
catalog-service-id{48}: x-catalog://frankie.sesta.com:89/Compass-2
rdm-type{10}: rd-request
rdm-version{3}: 1.0
rdm-query-language{8}: gatherer
}
@RDMQUERY { -
scope{3}: all
}
StartRobot
StartRobot スクリプトは、管理者がロボットを手動で起動する場合に使用します。 通常このスクリプトは、スケジューラが指定された時間にロボットを起動するために使用します (cron ジョブ)。 StartRobot コマンドは /var/opt/SUNWps/https-servername/portal ディレクトリ内にあります。
構文
# StartRobot
オプション
オプションはありません。