Directory Proxy Serverインスタンスの操作

Directory Proxy Serverのインスタンスを作成すると、インスタンスで必要なファイルおよびディレクトリが指定したパスに作成されます。

この手順では、dpadmコマンドを使用して、ローカル・ホスト上にサーバー・インスタンスを作成します。さらに、dpconfコマンドを使用して、インスタンスを構成します。

root以外のユーザーでもサーバー・インスタンスを作成できます。

Directory Proxy Serverインスタンスは、データ・ビューを介して、データソースへディレクトリ・クライアント・アプリケーション・リクエストをプロキシするよう構成する必要があります。インスタンスを起動または停止するときは、ディレクトリ・クライアント・アプリケーション・リクエストをプロキシするサーバー・プロセスを起動または停止します。

dpadmコマンドにより、ローカル・ホスト上のDirectory Proxy Serverインスタンスとそのインスタンスに属するファイルを管理できます。このコマンドではネットワーク上のサーバーを管理できません。ローカル・ホストでの直接管理のみとなります。dpadmコマンドには、主要な各管理タスク用のサブコマンドがあります。詳細は、「dpadm(1M)」を参照してください。

dpconfコマンドはLDAPクライアントです。このコマンドでは、実行中のDirectory Proxy Serverインスタンスのほぼすべてのサーバー設定を、コマンドラインから構成できます。サーバーは、ローカル・ホストに配置するか、またはネットワーク全体でアクセス可能な別のホストに配置するかを設定できます。dpconfコマンドには、主要な各構成タスク用のサブコマンドがあります。詳細は、dpconf(1M)を参照してください。

Directory Proxy Serverインスタンスを作成するには:

このタスクの実行には、DSCCが使用できます。詳細は、「Directory Service Control Centerのインタフェース」およびDSCCのオンライン・ヘルプを参照してください。

DSCCを使用して新しいサーバー・インスタンスを作成する場合は、既存のサーバーからサーバー設定の一部またはすべてをコピーするよう選択できます。

1. Directory Proxy Serverのインスタンスを作成します。

   $ dpadm create -p port instance-path

   たとえば、ディレクトリ/local/dpsに新しいインスタンスを作成するには、次のコマンドを使用します。

   $ dpadm create -p 2389 /local/dps

   インスタンスの他のパラメータを指定するには、dpadm(1M)のマニュアル・ページを参照してください。

2. パスワードを入力します(必要な場合)。
3. インスタンスのステータスを確認して、インスタンスが作成されたことを確認します。

   $ dpadm info instance-path

4. (オプション)ネイティブ・パッケージを使用して、Directory Proxy Serverがインストールされており、かつオペレーティング・システムがサービス管理ソリューションを提供する場合は、次の表に示すサービスとしてサーバーを管理できます。
   

   オペレーティング・システム コマンド Solaris 10 dpadm enable-service --type SMF instance-path Solaris 9 dpadm autostart instance-path Windows dpadm enable-service --type WIN_SERVICE instance-path

5. (オプション)次のいずれかの方法で、DSCCにサーバー・インスタンスを登録します。
   • DSCCにログインし、「プロキシサーバー」タブの既存のサーバーの登録アクションを使用します。

     アプリケーション・サーバー構成により、http://hostname:8080/dscc7またはhttps://hostname:8181/dscc7を使用して、DSCCにアクセスします。

   • コマンドdsccreg add-serverを使用します。

     $ dsccreg add-server -h hostname --description "My Proxy" /local/dps
     Enter DSCC administrator's password:
     /local/dps is an instance of DPS
     Enter password of "cn=Proxy Manager" for /local/dps:
     Connecting to /local/dps
     Enabling DSCC access to /local/dps
     Registering /local/dps in DSCC on hostname.

     このコマンドの詳細は、「dsccreg(1M)」を参照してください。

Directory Proxy Serverインスタンスのステータスを検索するには:

このタスクの実行には、DSCCが使用できます。詳細は、「Directory Service Control Centerのインタフェース」およびDSCCのオンライン・ヘルプを参照してください。

• Directory Proxy Serverのインスタンスのステータスを検索します。

  $ dpadm info instance-path

Directory Proxy Serverを起動および停止するには:

このタスクの実行には、DSCCが使用できます。詳細は、「Directory Service Control Centerのインタフェース」およびDSCCのオンライン・ヘルプを参照してください。

• Directory Proxy Serverを起動または停止するには、次のいずれかを行います。

  • Directory Proxy Serverを起動するには、次を入力します。

    $ dpadm start instance-path

    たとえば、/local/dpsでインスタンスを起動するには、次のコマンドを使用します。

    $ dpadm start /local/dps

  • Directory Proxy Serverを停止するには、次を入力します。

    $ dpadm stop instance-path

    たとえば、次のようになります。

    $ dpadm stop /local/dps

すべての実行中インスタンスをリストするには:

• 次のコマンドを使用して、ホストで実行中のインスタンスをリストします。

  dpadm list-running-instances [--all]

  -–allオプションにより、すべてのインストール・パスの実行中インスタンスがリストされます。

実行中インスタンスを停止するには:

• 次のコマンドを使用して、ホストで実行中のインスタンスを停止します。

  dpadm stop-running-instances [-i] [--force]

  詳細は、「dpadm(1M)」を参照してください。

Directory Proxy Serverインスタンスを再起動する必要があるかどうかを確認するには:

構成の変更を有効にするには、サーバーの再起動が必要となる場合があります。次の手順を使用して、構成変更後にDirectory Proxy Serverインスタンスを再起動する必要があるかどうかをチェックします。

• サーバーを再起動する必要があるかどうかを確認します。

  $ dpconf get-server-prop -h host -p port is-restart-required

  • コマンドがtrueを返す場合、Directory Proxy Serverインスタンスを再起動する必要があります。

  • コマンドがfalseを返す場合、Directory Proxy Serverインスタンスを再起動する必要はありません。

Directory Proxy Serverを再起動するには:

このタスクの実行には、DSCCが使用できます。詳細は、「Directory Service Control Centerのインタフェース」およびDSCCのオンライン・ヘルプを参照してください。

• Directory Proxy Serverを再起動します。

  $ dpadm restart instance-path

  たとえば、/local/dpsでインスタンスを再起動するには、次のコマンドを使用します。

  $ dpadm restart /local/dps

Directory Proxy Serverインスタンスを削除するには:

このタスクの実行には、DSCCが使用できます。詳細は、「Directory Service Control Centerのインタフェース」およびDSCCのオンライン・ヘルプを参照してください。

1. (オプション)Directory Proxy Serverインスタンスを停止します。

   $ dpadm stop instance-path

   ユーザーがインスタンスを停止しない場合は、削除コマンドにより自動的に停止します。ただし、サービス管理ソリューションでインスタンスを有効にしている場合、手動で停止する必要があります。

2. (オプション)以前よりDSCCを使用してサーバーを管理していた場合は、コマンドラインを使用してサーバーの登録を解除します。

   $ dsccreg remove-server /local/dps
   Enter DSCC administrator's password:
   /local/dps is an instance of DPS
   Enter password of "cn=Proxy Manager" for /local/dps:
   Unregistering /local/dps from DSCC on localhost.
   Connecting to /local/dps
   Disabling DSCC access to /local/dps

   詳細は、dsccreg(1M)のマニュアル・ページを参照してください。

3. (オプション)以前にサービス管理ソリューションでサーバー・インスタンスを有効にした場合、サービスとしてのサーバーの管理を無効にします。
   

   オペレーティング・システム コマンド Solaris 10 dpadm disable-service --type SMF instance-path Solaris 9 dpadm autostart --off instance-path Windows dpadm disable-service --type WIN_SERVICE instance-path

4. インスタンスを削除します。

   $ dpadm delete instance-path