Oracle® Fusion Middleware Oracle Directory Server Enterprise Editionアップグレードおよび移行ガイド 11gリリース1 (11.1.1.7.0) B72438-01 |
|
![]() 前 |
![]() 次 |
dsmig
コマンドを使用した自動移行Oracle Directory Server Enterprise Edition11gリリース1 (11.1.1.7.0)には、Directory Server 5.2インスタンスからODSEE 11gリリース1 (11.1.1.7.0)インスタンスへの移行を支援をするコマンドラインによる移行ツールが用意されています。この移行ツールは、「自動または手動移行の判断」で説明する自動移行の要件がデプロイメントで満たされている場合のみ使用することができます。
移行ツールでは、インスタンスごとに移行を行うことができます。同じサーバー・ルートにインスタンスが複数ある場合、インスタンスごとに移行ツールを実行する必要があります。
この章では、移行ツールの使用方法を次の内容で説明します。
移行ツール、dsmig
はDirectory Server Enterprise Edition 11gリリース1 (11.1.1.7.0)とともに配布されます。これらのODSEEがインストールされると、dsmig
はinstall-path
/bin
に配置されます。
dsmig
コマンドは、新しいDirectory Serverインスタンスが配置されるマシンで実行する必要があります。コマンドを実行すると、新しいインスタンス・ディレクトリ(new-instance-path
/migration
)に移行ディレクトリが作成されます。このディレクトリは、移行で生成されたログ・ファイルや移行ステータス・ファイルなどのためのデータ・リポジトリになります。
dsmig
コマンドには、「移行手順の概要」で説明している個々の移行手順に対応するサブコマンドおよびオプションのセットがあります。dsmig
の使用方法の詳細は、dsmigに関する説明を参照してください。
dsmig
を実行するための前提条件この項では、古いインスタンスは5.2インスタンスのことを指し、新しいインスタンスはDirectory Server 11gリリース1 (11.1.1.7.0)のインスタンスを指します。
インスタンスを移行するためにdsmig
を使用する前に、次の作業が実行済であることを確認してください。
Directory Server Enterprise Edition 11gリリース1 (11.1.1.7.0)がインストール済です。
Directory Server Enterprise Edition 11gリリース1 (11.1.1.7.0)は、古いインスタンスがある同じマシンにも別のマシンにもインストールできます。
古いインスタンスを正しく停止しています。
古いインスタンスを順を追ってシャットダウンしていない場合、移行で問題が発生する場合があります。古いインスタンスと新しいインスタンスが別のマシンにある場合でも、移行の開始前に古いインスタンスを停止している必要があります。
dsmig
が古いインスタンス・ファイルにアクセスできます。
古いインスタンスと新しいインスタンスが別のマシン上にある場合、新しいインスタンスをホストするマシンに古いインスタンスの完全なイメージが作成されています。
完全なイメージには、インスタンスの移行に必要なすべてのファイル(スキーマ、構成、セキュリティおよびデータベース・ファイル)が含まれます。完全なイメージ・ファイルは、元のサーバー・ルートと同じディレクトリに配置する必要があります。これを実現するには、サーバー・ルート外にいかなるファイルも再配置していないことを条件に、cp -r
を実行できます。
新しいインスタンスの作成および起動は手動で実行できますが、dsmig
の実行前に新しいインスタンスを必ず作成する必要はありません。dsmig
では、新しいDirectory Serverインスタンスが指定のパスに存在するか確認します。新しいインスタンスが存在する場合、このインスタンスに対してコマンドが実行されます。新しいインスタンスが存在しない場合、インスタンスは自動的に作成されます。
新しいインスタンスは、古いインスタンスがあった場所を除く任意の場所に作成できます。
注意:
|
新しいインスタンスを作成する際、ディレクトリ・マネージャのDNとパスワードは、cn=config
下のnsslapd-rootdn
およびnssalpd-rootpw
属性に保存されます。これらの属性には新しいインスタンスの値がすでにあるので、移行時には古いインスタンスの値は伝播されません。nsslapd-secureport
およびnsslapd-port
属性に対しても同じ動作が取られます。
dsmig
の使用Directory Server 5.2のスキーマ・ファイルはserverRoot
/slapd-
instance-path
/config/schema
に配置されています。Directory Server 11gリリース1 (11.1.1.7.0)のスキーマ・ファイルは、INSTANCE-PATH
/config/schema
に配置されています。
Directory Server 11gリリース1 (11.1.1.7.0)には、パスワードのポリシー属性を含む00ds6pwp.ldif
というスキーマ・ファイルがあります。これに加え、特定の構成属性が追加された00core.ldif
があります。
スキーマを自動的に移行するには、次のコマンドを実行します。
$ dsmig migrate-schema old-instance-path new-instance-path
このコマンドを実行すると、99user.ldif
ファイルにカスタム・スキーマが定義されている場合、それが新しいインスタンスにコピーされます。新しいインスタンスがすでに本番環境にあり、新しいインスタンスの99user.ldif
ファイルをすでに変更している場合、dsmig
では2つのファイルが最適にマージされます。他の任意のファイルに定義されたカスタム・スキーマも、新しいインスタンスにコピーされます。
詳細は、dsmigに関する説明を参照してください。
dsmig
の使用セキュリティ設定を自動的に移行するには、次のコマンドを実行します。
$ dsmig migrate-security old-instance-path new-instance-path
セキュリティ設定の移行時に、dsmig
は次のタスクを実行します。
新しいインスタンスの証明書およびデータベース・ファイルをバックアップします。
証明書データベースおよびキー・データベース・ファイルを古いインスタンスから新しいインスタンスにコピーします。
パスワード・ファイルを古いインスタンスから新しいインスタンスにコピーします。
証明書マッピング・ファイルを古いインスタンスから新しいインスタンスにコピーします。
セキュリティ・モジュール・データベースをコピーします。
詳細は、dsmigに関する説明を参照してください。
dsmig
の使用Directory Server 5.2の構成はserverRoot
/slapd-
instance-path
/config/dsee.ldif
ファイルに指定されています。Directory Server 11gリリース1 (11.1.1.7.0)の構成は、instance-path
/config/dsee.ldif
ファイルに指定されています。
構成を自動的に移行するには、次のコマンドを実行します。
$ dsmig migrate-config old-instance-path new-instance-path
この手順では、dsmig
は古いインスタンスの構成ファイル(dsee.ldif
)のLDIFのエントリをそれぞれ読み取ります。対応するDirectory Server 11gリリース1 (11.1.1.7.0)の構成ファイルにこれらのエントリがある場合、その値は更新されます。
注意:
$ dsconf set-server-prop read-write-mode:read-only |
構成の移行はLDAPを介して実行されます。dsmig
は、デフォルトではStartTLSを発行して新しいインスタンスをセキュアにバインドします。
注意: Windowsでは、StartTLSはデフォルトでは有効ではありません。Windowsで |
詳細は、dsmigに関する説明を参照してください。移行される具体的な構成属性の詳細は、「特定の構成属性の移行」を参照してください。
dsmig
では、Directory Serverの一部のプラグインのみを移行します。ほとんどのシステム・プラグインの構成データは、自動では移行されません。
dsmig
では次のシステム・プラグインを移行します。
CoS
7ビット検索
DSML Frontend
パススルー認証
参照整合性
レトロ変更ログ
UID一意性
構成をverboseモードで移行した場合、dsmig
ではどのシステム・プラグイン構成が移行されないかを示す警告を発行します。
ユーザーが作成したプラグインは移行されません。ただし、ユーザーのプラグインの構成データは、移行時にnew-instance-path
/migration/old_userplugins_conf.ldif
ファイルにダンプされます。これらのプラグインは、移行の完了後に再コンパイルする必要があります。
複数のバックエンドを持つサフィックスの構成データは移行されません。dsmig
がサフィックスに複数のバックエンドがあることを検出した場合、そのサフィックスに属する構成設定は移行されません。これらは、マッピング・ツリー、レプリカ、レプリケーション承諾、LDBMインスタンス、インデックスおよび暗号化属性の構成エントリです。かわりに、これらのすべてのエントリはnew-instance-path
/migration/old_distribution_conf.ldif
ファイルにダンプされます。
old_distribution_conf.ldif
ファイルのエントリは、古いインスタンスのものであるため、新しいインスタンスには直接インポートしないようにする必要があります。配布の詳細は、『Oracle Directory Server Enterprise Edition管理者ガイド』の第21章のDirectory Proxy Serverの配布に関する説明を参照してください。
レプリケーションの構成データは、デフォルトでは移行されません。これらのデータを移行するには、-R
オプションとともにdsmig
を使用します。データは、デフォルトでnew-instance-path
/migration/old_replication_conf.ldif
ファイルにダンプされます。必要に応じて、このファイルのレプリケーションの構成データは移行後にインポートできます。
o=netscapeRoot
の構成データo=NetscapeRoot
サフィックスの構成データはデフォルトでは移行されません。この情報が必要な場合、構成データの移行に-N
オプションを使用します。-N
オプションを使用しない場合、データはnew-instance-path
/migration/old_netscape_conf.ldif
のファイルにダンプされます。必要に応じて、このファイルの構成データは移行後にインポートできます。
dsmig
が移行しない構成属性次の一般的な構成属性は、自動では移行されません。
このリストは、すべてを網羅したものではありません。手動で移行する必要のある構成属性は、他にも使用している可能性があります。
ds-hdsml-dsmlschemalocation ds-hdsml-soapschemalocation dsKeyedPassword dsMappedDN dsMatching-pattern dsMatching-regexp dsSaslPluginsEnable dsSaslPluginsEnable dsSaslPluginsPath dsSearchBaseDN dsSearchFilter nsabandonedsearchcheckinterval nsbindconnectionslimit nsbindretrylimit nsbindtimeout nschecklocalaci nsconcurrentbindlimit nsconcurrentoperationslimit nsconnectionlife nshoplimit nsMatchingRule nsmaxresponsedelay nsmaxtestresponsedelay nsoperationconnectionslimit nspossiblechainingcomponents nspossiblechainingcomponents nspossiblechainingcomponents nspossiblechainingcomponents nspossiblechainingcomponents nspossiblechainingcomponents nsproxiedauthorization nsreferralonscopedsearch nsslapd-db-durable-transaction nsslapd-db-home-directory nsslapd-db-replication-batch-val nsslapd-db-transaction-logging nsslapd-directory nsslapd-disk-full-threshold nsslapd-disk-low-threshold nsslapd-exclude-from-export nsslapd-localhost nsslapd-localuser nsslapd-mode nsslapd-port nsslapd-rewrite-rfc1274 nsslapd-secureport nsslapd-security nsSSL2 nsSSL3 nsSSLActivation nsSSLServerAuth nsSSLSessionTimeout nsState nstransmittedcontrols plugin-order-preoperation-finish-entry-encode-result
dsmig
の使用Directory Server 5.2では、データはserverRoot
/slapd-
instance-name
/db
に格納されます。Directory Server 11gリリース1 (11.1.1.7.0)では、ユーザー・データはinstance-path
/db
に格納されます。
データを自動的に移行するには、次のコマンドを実行します。
$ dsmig migrate-data old-instance-path new-instance-path
デフォルトでは、o=netscapeRoot
サフィックスを除くすべてのサフィックスが移行されます。dsmig
では、データ、インデックス、トランザクション・ログがコピーされます。データベースの状態であるデータベース・コンテキストは移行されません。
Directory Serverの管理モデルには、構成ディレクトリ・サーバーは存在しません。つまり、デプロイメントにIdentity Synchronization for Windowsが含まれている場合の除き、o=netscapeRoot
サフィックスはもはや不適切です。デフォルトでdsmig
は、特に要求しないかぎり、o=netscapeRoot
データベースは移行しません。o=netscapeRoot
データベースを移行するには、migrate-data
サブコマンドとともに-N
オプションを使用します。
詳細は、dsmigに関する説明を参照してください。
注意: Directory Serverでは、データの移行時に、ネストされたグループの定義が30レベルを超えるか確認します。深いネストは、ネストされたグループに親でもあるグループが含まれる、循環グループ定義を意味する場合があります。ネスト・レベルが30を超えるグループがある場合、Directory Serverではそれ以降のレベルの Directory Serverではこれが発生するたびにエラーをログに記述します。これらのエラーは無視しても問題がありませんが、循環定義の可能性があるために、エラーに記載されているグループの定義は検証する必要があります。 |
dsmig migrate-data
の実行後、新しいインスタンスのエラー・ログに多数のエラー・メッセージが含まれる場合、次の手順を実行します。
実行中のDirectory Serverのインスタンスをすべて停止します。
dsee.ldif
ファイルから、nsslapd-infolog-area
およびnsslapd-infolog-level
を完全に削除します。
Directory Serverインスタンスを起動します。
ldapmodify
コマンドを使用してパスワードを変更した際にエラーが発生した場合、移行手順後に次の手順を実行します。
次のコマンドを使用し、pwd-compat-mode
を確認します。
dsconf get-server-prop pwd-compat-mode
pwd-compat-mode
がDS-6 mode
に設定されている場合、ldapmodify
コマンドを使用しパスワードを変更する際にはpwdPolicy
オブジェクト・クラスを使用する必要があります。
サーバーを自動的に移行するために、dsmig
を使用した場合、次の2つの移行後タスクのみを完了する必要があります。
ユーザー・プラグインをカスタマイズした場合、これらを再コンパイルし、新しいサーバーに追加する必要があります。
移行したサーバーがレプリケーション・トポロジの一部であった場合は、「レプリケート対象のサーバーの移行に関する問題」を参照してください。