"インストールおよび移行ガイド": 移行とアップグレード

ディレクトリサーバに情報を保存していた場合は、移行プロセス時に、ユーザおよびグループを移行するための特別な作業を行う必要はありません。移行終了後、Administration Server の [Global Settings] タブにある「Configure Directory Service」ページで、ディレクトリサーバへのパスを指定します。ディレクトリサーバは、バージョン 4.1 または 4.11 を使ってください。

ACL の移行
iPlanet Web Server 4.1 には、es-internal と呼ばれる新しいデフォルトの ACL が用意されています。この ACL により、ヘルプファイルや画面上のアイコンなど、iPlanet Web Server 内のファイルへの変更許可を制御することが可能になります。この ACL は、移行時に追加されます。

Administration Server 3.6 で分散管理用に ACL を設定していた場合は、この ACL は移行されないので、新しい Administration Server には手作業で追加する必要があります。

証明書の移行
キーおよび証明書は、ご使用のサーバのセキュリティが有効になっている場合のみ、移行プロセスの一部として移行されます。また、「Administration Server」ページや「Server Manager」ページの [Security] タブを使ってキーや証明書のみを移行することも可能です。

証明書は、移行プロセス時に各サーバインスタンスまたは Administration Server から移行できます。

証明書の使用方法および管理方法は、iPlanet Web Server 4.1 と Enterprise Server 3.6 では異なります。Enterprise Server 3.6 では、証明書とキーペアの参照にエイリアスが使われ、複数のサーバインスタンスが、1 つのエイリアスを共有することが可能でした。すべてのエイリアスとその中にある証明書は、Administration Server で管理されていました。

一方、iPlanet Web Server 4.1 では、各サーバインスタンス (Administration Server など) が、それぞれ独自に認証データベースと呼ばれる証明書とキーペアを持ちます。認証データベースは、サーバマネージャの [Security] タブから管理し、認証データベースには、サーバ証明書とすべての証明機関が保管されています。証明書とキーのデータベースファイルには、それらを使うサーバインスタンスに関連付けて名前が付けられます。Enterprise Server 3.6 の複数のインスタンスが同じエイリアスを使っている場合は、各インスタンスを移行する際に、移行する証明書とキーペアを選択できます。iPlanet Web Server 4.1 に移行された証明書とキーペアは、移行するたびに名前が付けられます。

移行プロセスでは、証明書だけではなく、サーバインスタンスに関連する認証データベース全体が移行されます。3.6 のデータベース内のすべての証明機関 (CA) は、4.1 のデータベースに移行されます。4.1 で CA が複製された場合は、有効期限が切れるまで 3.6 の CA を使い、その後で 4.1 の CA を使います。複製された CA は削除しないでください。

Enterprise Server 3.6 から iPlanet Web Server 4.1 に証明書を移行する際、4.1 の Administration Server のユーザが、Enterprise Server 3.6 のデータベースファイルに対して読み込みおよび書き込みパーミッションを持っていることに注意してください。このファイルは、3.6_server_root/alias ディレクトリにある alias-cert.db と alias-key.db です。

iPlanet Web Server での証明書の使用に関する詳細については、『iPlanet Web Server 管理者ガイド』を参照してください。

ノート SSL 対応サーバを移行する場合は、移行後のサーバ起動時にパスワードを指定する必要があるので、手作業で起動してください。

Web パブリッシングの移行
Enterprise Server 3.6 サーバで Web パブリッシングを使っていた場合は、コンフィグレーションファイルが移行プロセスの一部として自動的に移行されます。

Web パブリッシングのデータを確実に移行するには、「Migration Parameters」ページで次のオプションを選択する必要があります。

「Document Root」のセクションで、古いドキュメントルートを使うオプションを選択します。Web パブリッシングはパス名に依存しているので、新しいドキュメントルートを使うとパス名が変わります。古いドキュメントルートを使うオプションを選択しても、Web パブリッシングのユーザ情報は保存されます。

「Web Publishing」のセクションで、Web パブリッシングのメタデータを移行するオプションを選択します。このオプションを選択しないと、メタデータは失われます。

また、HTML 以外のドキュメントを HTML 形式に変換して Web パブリッシングおよび検索を行うフィルタをインストールする必要があります。詳細については、「アプリケーションの移行」を参照してください。

Netshare の移行
Enterprise Server 3.6 で Netshare をオンにしていた場合は、移行プロセスの一部としてそのコンフィグレーションファイルが自動的に移行されます。

Netshare のディレクトリと環境を正常に移行するには、「Migration Parameters」ページで、古いドキュメントルートを使うオプションを選択する必要があります。このオプションを選択しないと、Netshare のデータは新しいバージョンに移行されません。

検索コレクションの移行
検索コレクションがある場合は、移行するコレクションを選択する必要があります。移行するコレクションは、「Migration Parameters」ページにあるチェックボックスをオンにして選択します。サーバの移行時にコレクションを移行しないと、後で戻って移行することはできません。

古いドキュメントルートを使うオプションを選択した場合、検索コレクションは移行後に自動的に機能しますが、新しいドキュメントルートを使うオプションを選択した場合は、そのコレクションを使う前に一部のコレクションを再作成する必要があります。

iPlanet Web Server 4.1 では、マルチフォーマットコレクションをサポートしないので注意してください。

検索パターンファイルの移行
検索パターンファイルを移行するオプションがあります。デフォルトのパターンファイルをカスタマイズしている場合のみ、このオプションを使ってください。また、古いパターンファイルを新しいサーバに移行する場合および最新の検索アプレットを使っている場合に、正しい検索アプレットを呼び出すには、移行したパターンを変更する必要があります。

Netscape Enterprise Server 3.6 でのアプレットファイルの名前は applet.zip および searchapplet.zip でしたが、iPlanet Web Server 4.1 では、SearchApplet.jar および SearchAppletIE.jar です。古いアプレットファイルの参照を新しいアプレットファイルに変更してください。

アプリケーションの移行
サーバの設定およびデータの移行後は、ご使用のアプリケーションに変更を加えて iPlanet Web Server 4.1 で実行できるようにする必要があります。

サーバサイド JavaScript アプリケーションの移行
iPlanet Web Server 4.1 は、JavaScript 1.4 に対応しています。JavaScript 1.2 と 1.4 の変更点については、次のサイトにある『Core JavaScript Reference v1.4』の「New Features」のセクションを参照してください。

http://developer.iplanet.com/docs/manuals/javascript.html

サーバサイド JavaScript アプリケーションを iPlanet Web Server 4.1 で実行する前に、再コンパイルして再登録する必要があります。移行時に、古い jsa.conf 内のエントリは自動的に移行されません。デフォルトにより、サーバサイド JavaScript がオフになることにも注意してください。移行先のサーバで再びオンにする必要があります。

NSAPI アプリケーションの移行
Enterprise Server 3.6 で使っていた NSAPI プログラムの多くは、再コンパイルしなくても iPlanet Web Server 4.1 で正常に機能しますが、ドキュメント化されていないデータ構造の一部は nsapi.h から削除され、共有ではなくなります。ご使用のプラグインがこのようなデータ構造を使っている場合は、移行する際に、この構造を再度記述してアクセサを使用できるようにする必要があります。現在プライベートになっているデータ構造は、参照目的のみにこのバージョンに付属されている nsapi_pvt.h で定義されています。

これらのデータ構造および新しいアクセサ機能の詳細については、
『Programmer's Guide to iPlanet Web Server 4.1』を参照してください。

Java Servlet の移行
Enterprise Server 3.6 で実行していた Java Servlet は、サーバの移行後、再コンパイルすることなく 4.1 で実行できます。移行の際、3.6 の Servlet は元のディレクトリに保存されます。移行された Servlet は互換モードで実行されるので、他の 4.1 の Servlet に比べて遅くなる可能性があります。

また、ご使用の 3.6 の Servlet が追加ファイルを参照していた場合は、 JVM のクラスパスにこれらのファイルへのパスを追加する必要があります。クラスパスは、[Servlet] タブの [Server Manager] にある「Configure JVM Attributes」ページを使って更新します。

ノート Java サブコンポーネントをインストールする場合、インストールするコンフィグレーションファイルには、rules.properties.default のような .default で終わるファイルのセットが含まれています。これらのファイルには、Java コンフィグレーションファイルのデフォルト値が含まれています。古いバージョンの Java コンフィグレーションファイルは移行時に変更されません。古いファイルを新しい設定に更新する場合は、.default ファイルを参照してください。iPlanet Web Server 4.1 のデフォルト設定を復元する場合も、.default ファイルを参照してください。

サーバサイド Java アプレット (HttpApplets)
サーバサイド Java アプレット (HttpApplets) には対応していません。代わりに Java Servlet を使います。サーバサイド Java アプレットを Servlet として書き直し、再インストールする必要があります。

Web アプリケーションインターフェイス
Enterprise Server 3.0 ではサーバの機能を拡張するために Web Application Interface (WAI) と呼ばれる API が用意されていましたが、iPlanet Web Server 4.1 では、業界標準の Java Servlet を使ってアプリケーションを開発することをお勧めします。WAI は、iPlanet Web Server 4.1 でも使用できますが、新しいバージョンでは Java Servlet を使った開発に焦点が当てられています。

デフォルトでは、サーバのインストール時に WAI コンポーネントがインストールされないため、手作業で選択する必要があります。iPlanet Web Server 4.1 のインストール時に WAI を選択しなかった場合は、インストーラを再度起動して WAI コンポーネントのみインストールします。

また、iPlanet Web Server には ORB (Object Request Broker) が用意されていません。新しいバージョンでも WAI を使う場合は、ORB を入手する必要があります。C++ ORB の Visibroker 3.3 または Java ORBの Visibroker 3.4 を入手するには、次の URL で Inprise に連絡してください。

http://www.inprise.com/visibroker/download

Netscape Enterprise Server 3.6 から移行する場合、アップグレード済みの ORB を入手する必要があります。Enterprise Server 3.6 に付属している ORB はバージョンが古く、対応していません。

警告 ORB は、iPlanet Web Server を移行する前にインストールする必要があります。移行前にインストールしないと、移行されたサーバインスタンスを起動する際にエラーメッセージが表示されます。

iPlanet Web Server 4.0 からのアップグレード

iPlanet Web Server 4.0 から iPlanet Web Server 4.1 にアップグレードする場合、4.0 サーバがインストールされているディレクトリに 4.1 サーバをインストールする必要があります。インストール時に自動的にアップグレードされます。4.0 から 4.1 へのアップグレードには、Administration Server の「Migration」ページは使用できません。

アップグレード時に、サーバ設定とドキュメントルートは保持されます。

iPlanet Web Server 4.1 の変更
iPlanet Web Server 4.0 から iPlanet Web Server 4.1 にアップグレードすると、次の項目が変更されます。