旧バージョンからのアップグレード

Reflection for the Web 5.x または 6.x

ローカルコンピュータやサーバに古いバージョンの Reflection for the Web がインストールまたはキャッシュされている場合は、以下の手順に従って最新バージョンの Reflection for the Web にアップグレードしてください。アップグレードする場合は、以下に示す手順を、その順序で実行することをお勧めします。

Reflection for the Web 5.x または 6.x からアップグレードするには、以下の手順に従います。

Reflection for the Web 5.x または 6.x のアンインストール
Reflection for the Web 9.5 のコンポーネントのインストール
古いファイルのアップグレード

ステップ 1: Reflection for the Web 5.x または 6.x コンポーネントのアンインストール

注意: インストールの方法にかかわらず、Deployment Director の [外字] セクションを使用してカスタム文字を EBCDIC 値に割り当てていた場合、これらのマッピングを保持するには、[Reflection 管理サーバのインストール先]/ReflectionData/ ディレクトリにある udc.xml ファイルをコピーおよび保存してください。

注意:インストールの方法にかかわらず、Reflection セッションで [キー割り当てのエクスポート] コマンドを使用してキーボード割り当てファイルをエクスポートした場合は、バージョン 5.x または 6.x. をアンインストールする前に、キーボード割り当てファイルをアップグレードしてください。詳細については、「外部キーボード割り当てファイルのアップグレード」を参照してください。

Reflection for the Web 5.x または 6.x のファイルをサーバから削除します。以前のバージョンをアンインストールするには、以下の手順に従います。

自動インストーラを使用した場合は、以下のいずれかの手順に従います。
- Windows:[スタート] - [プログラム] - [WRQ Reflection for the Web] - [WRQ Reflection for the Web Uninstallation] をクリックします。
- Windows: [インストール先フォルダ]\_uninst\ フォルダから uninstaller.exe を実行します。
- Linux または Solaris: [インストール先フォルダ]/utilities/ ディレクトリから uninstaller.sh を実行します。ディレクトリに移動し、次のコマンドを入力します。
  
  ./uninstaller.sh
上記のいずれかの操作を実行することで、Reflection 管理サーバおよびセキュリティプロキシサーバの構成が維持されます。アンインストール時に、変更したファイルを保存するよう要求されます。
アーカイブファイルを使用してインストールした場合は、これらのファイルとフォルダを保存してから、次のようにアンインストールを実行します。
1. Reflection 管理サーバ:
  
  [Reflection 管理サーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rweb/WEB-INF/ ディレクトリ
  にある web.xml ファイルをコピーして保存します。
  
  [Reflection 管理サーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rweb/ または
  [Reflection 管理サーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rweb/WEB-INF/jsp/ ディレクトリ
  のカスタマイズしたすべてのファイルをコピーして保存します。
  
  [Reflection 管理サーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rweb/session/ ディレクトリ
  の非保護の静的セッションをコピーして保存します。
  これらのセッションは、webapps ディレクトリ内のほかのディレクトリに保存されている場合もあります。
  
  [Reflection 管理サーバのインストール先]/ReflectionData/ ディレクトリ
  をコピーして保存します。
  
  cacerts をコピーして
  [Reflection 管理サーバのインストール先]/_jvm/lib/security/ ディレクトリに保存します。
2. セキュリティプロキシサーバ:
  
  [セキュリティプロキシのインストール先]/conf/ ディレクトリおよび
  [セキュリティプロキシのインストール先]/keystores/ ディレクトリ
  をコピーおよび保存します。
  これにより、server.properties ファイルおよび証明書が保存されます。
3. メータリングサーバ:
  
  [メータリングサーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rwebmeter/WEB-INF/ ディレクトリ
  にある web.xml ファイルをコピーして保存します。
4. サーブレット起動スクリプト:
  
  [Tomcat のインストール先]/jakarta-tomcat-[バージョン番号]/conf/ ディレクトリ
  にある Tomcat キーストアをコピーおよび保存します。
5. Reflection for the Web コンポーネントをインストールしたディレクトリを削除します。

ステップ 2: Reflection for the Web 9.5 のコンポーネントのインストール

次に、Reflection for the Web 9.5 のコンポーネントをインストールします。以前のバージョンからアップグレードする場合は、以下の手順に従います。

Web サーバからアクセスできない場所に Reflection for the Web 9.5 をインストールします。必ず、Web サーバからアクセスできないディレクトリを選択する必要があります。Reflection for the Web 9.5 を Reflection for the Web 5.x または 6.x と同じディレクトリ構造にインストールします。
　インストール手順を選択して、その指示に従ってください。

ステップ 3: 古いファイルのアップグレード

自動インストーラを使用してインストールを行った場合:

Reflection 管理サーバおよびサーブレット起動スクリプトの設定は維持されています。ファイルをカスタマイズしたり、管理サーバの信頼されている証明書一覧に証明書を追加していなければ、これ以上のアップグレード手順は必要ありません。カスタマイズした設定の維持やインポートした証明書の維持を行う場合は、以下で説明されている手順に従います。JCE ポリシーファイル、UDC ファイル、その他のカスタマイズ済みファイル、または証明書をアップグレードするには、「すべてのインストールタイプについて」の手順に従います。セッションマネージャを使用して保存しなかったセッションまたは手動で編集したセッションをアップグレードするには、「静的セッションのアップグレード」の手順に従います。

セキュリティプロキシサーバのアップグレードは完了しています。セッションマネージャで既存の安全なセッションを編集したり、安全なセッションを新規作成できるように、セキュリティプロキシサーバ設定を管理者用 Web ステーションにエクスポートします。セキュリティプロキシウィザードを実行します。[保存] をクリックして設定を保存します。管理サーバに設定をエクスポートするよう要求されます。管理サーバ名、ポート、およびコンテキストが正しいことを確認してから、[エクスポート] をクリックします。

メータリングサーバのアップグレードは、このインストール処理ではサポートされていません。以前のインストールの設定を新しいインストールでも使用するには、テキストエディタで web.xml ファイルを開きます。この情報を参照し、メータリング構成インタフェースを使用して、バージョン 9.5 のメータリングサーバを構成します。構成の詳細については、「メータリングコンポーネントの設定」を参照してください。

アーカイブファイルを使用してインストールした場合:

次のファイルが正しくコピーおよび編集されていることを確認します。

Reflection 管理サーバ:
1. 元の ReflectionData ディレクトリを Reflection 管理サーバの新しいディレクトリ構造にコピーします。
2. [Reflection 管理サーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rweb/WEB-INF/
  に新しい web.xml ファイルが作成されています。
  新しいファイルをテキストエディタで開きます。
3. 新しい web.xml ファイルの
  rwebdata_location_placeholder および
  https_port_placeholder に、ステップ 1 で保存した web.xml ファイルでの値を入力します。保存してあったファイルから切り取って貼り付けるか、直接入力します。
4. 新しい web.xml ファイルを保存します。
5. 古い cacerts を
  [Reflection 管理サーバのインストール先]/_jvm/lib/security/ ディレクトリにコピーします。
セキュリティプロキシサーバ:

ステップ 1 で保存した /conf/ および /keystores/ ディレクトリを、新しいセキュリティプロキシのインストールディレクトリにコピーします。

セッションマネージャで既存の安全なセッションを編集したり、安全なセッションを新規作成できるように、セキュリティプロキシサーバ設定を管理者用 Web ステーションにエクスポートします。セキュリティプロキシウィザードを実行します。[保存] をクリックして設定を保存します。管理サーバに設定をエクスポートするよう要求されます。管理サーバ名、ポート、およびコンテキストが正しいことを確認してから、[エクスポート] をクリックします。
サーブレット起動スクリプト:

保存した Tomcat キーストアを
[インストール先のパス]/jakarta-tomcat-[バージョン番号]/conf/ にコピーします。

テキストエディタで、[インストール先のパス]/jakarta-tomcat-[バージョン番号]/conf/server.xml を開きます。
HTTP ポートまたは HTTPS ポートに必要な変更を加えます。

すべてのインストールタイプについて:

JCE ポリシーファイル:

以前のバージョンの Reflection における 192 ビットおよび 256 ビットの AES 暗号化をサポートするために、Sun の Web サイトから JCE 無制限強度ポリシーファイルをインストールした場合、この時にダウンロードしたファイルは、自動アンインストールの際に通知なしで管理サーバからアンインストールされます。自動インストール機能を使用してインストールした場合は、JRE バージョン 5.0 がインストールされています。192 ビットと 256 ビットの AES 暗号化を引き続きサポートするには、最新バージョンの JCE 無制限強度ポリシーファイルを Sun の Web サイトからダウンロードしてインストールする必要があります。詳細については、セキュリティプロキシウィザードのヘルプを参照してください ([セキュリティプロキシウィザード] - [プロキシ] - [追加] または [変更] - [追加] または [変更] - [ヘルプ] を選択)。
外字の割り当てツール:

ステップ 1 で udc.xml ファイルを保存し、外字の割り当てを保存した場合は、バージョン 9.5 の新しい ReflectionData ディレクトリにその udc.xml ファイルをコピーします。
JNLP セッション:

バージョン 5.x で JNLP を作成した場合は、Reflection for the Web バージョン 9.5 で機能させるために、セッションを修正する必要があります。JNLP セッションの実行と修正の詳細については、技術ノート 1729 を参照してください。 (技術ノートは英語のみです)。
サーブレット起動スクリプト:

tomcat.zip をインストールしている場合は、JDK を Java 2 (バージョン 5.0 推奨) にアップグレードします。
メータリングサーバ:

web.xml ファイル内の設定を使用して新しいメータリングサーバを構成します。web.xml ファイルをテキストエディタで開き、これらの設定を参照して、バージョン 9.5 のメータリングサーバを構成します。構成の詳細については、チュートリアルの「メータリングサーバの設定」を参照してください。
信頼されている証明書:

自動インストールの場合:証明書を管理サーバの信頼されている証明書一覧に追加している場合、インポートされた証明書は cacerts ファイルに保存されています。このファイルは、以前のバージョンのアンインストール時に Reflection 管理サーバのインストール先のルートに自動的に保存され、名前が変更されています。新しい名前は、cacerts_000 のように、アンダースコアと 3 桁の数字が元のファイル名に追加されて作成されます。このファイルを新しい [Reflection 管理サーバのインストール先]/_jvm/lib/security/ ディレクトリにコピーし、ファイル名を cacerts に変更します。
カスタマイズされたファイル:

保護されていない静的セッションを保存するには、「静的セッションのアップグレード」を参照してください (技術ノートは英語のみです)。

バージョン 6.x の LauncherHTML.jsp ファイルを保存してある場合に、その設定を維持するには、以下の手順に従います。
1. テキストエディタで元の LauncherHTML.jsp を開きます。このファイルは、バージョン 6.x では
  [Reflection 管理サーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rweb/WEB-INF/jsp/ にあります。
2. 元のファイルの最初の 2 行を次の行に置き換えます。
  
  <%@ page import="com.wrq.java13plus.management.core.GmAsset" %> <%@ page import="com.wrq.java13plus.management.gm.LauncherStartAction" %>
3. LauncherHTML.jsp を新しい Reflection for the Web のインストール先である [Reflection 管理サーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rweb/gm/ に保存します。
バージョン 5.1 の ReflectionClient.html ファイルを保存してある場合に、その設定を維持するには、以下の手順に従います。
1. テキストエディタで元の ReflectionClient.html を開きます。このファイルは、バージョン 5.1 では
  [Reflection 管理サーバのインストール先]/ReflectionData/ にあります。
2. テキストエディタで、新しい LauncherHTML.jsp を開きます。このファイルは、
  [Reflection 管理サーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rweb/gm/ にあります。
3. 色、余白、およびフォントの設定を ReflectionClient.html から LauncherHTML.jsp へコピーします。
4. JSP ファイルを保存します。
バージョン 5.0 の LoginPage.jsp ファイルを保存してある場合に、その設定を維持するには、以下の手順に従います。
1. テキストエディタで元の LoginPage.jsp を開きます。このファイルは、バージョン 5.0 では
  [Reflection 管理サーバのインストール先]/jakarta-tomcat-4.0.1/webapps/rweb/ にあります。
2. テキストエディタで、新しい LauncherHTML.jsp を開きます。このファイルは、
  [Reflection 管理サーバのインストール先]/jakarta-tomcat-[バージョン番号]/webapps/rweb/gm/ にあります。
3. 色、余白、およびフォントの設定を LoginPage.jsp から LauncherHTML.jsp へコピーします。
4. JSP ファイルを保存します。
IIS の統合:

以前インストールした Reflection for the Web が IIS と統合されている場合、統合の検出と設定の再構成は自動インストーラによって既に完了されています。これらの設定を変更する必要がある場合、またはアーカイブファイルを使用してインストールした場合は、IIS ウィザードを開きます ([スタート] - [プログラム] - [Attachmate Reflection for the Web (Attachmate Reflection for the Web)] - [ユーティリティ] - [IIS ウィザード] を選択)。詳細については、「IIS ウィザードの実行」を参照してください。 HTTPS ポート番号を入力し、[次へ]、[完了] の順にクリックします。
BEA ポータル統合:

Reflection for the Web バージョン 6.x を BEA ポータルと統合していた場合は、ポートレット JSP の既存のコードを変更します。セッションを表示するコードは、次のようになります。

..... <%= new com.wrq.java13plus.management.portal.RWebBrokerWLP().getContent(request, "<RWeb URL>/RWebSession.do?link=<セッション名>&portal=true&appletOnly=true") %> .....

エンドユーザのリンク一覧を表示するには、次のコードを追加します。

..... <%= new com.wrq.java13plus.management.portal.RWebBrokerWLP().getContent(request, "<RWeb URL>/LoginPage.do&appletOnly=true") %> .....

次に必要な手順

管理者用 Web ステーションの起動
セキュリティプロキシサーバの設定 (オプション)
メータリングサーバの設定 (オプション)

インストールガイドホーム

 準備インストールアップグレード Web ステーションの起動構成削除