HATS V7.5.1 へのマイグレーション

Host Publisher V4、HATS V4 LE、HATS V5 LE、HATS V4、V5、V6、V7.0、または V7.1 のいずれかのユーザーは、プロジェクトを HATS V7.5.1 にマイグレーションできます。

HATS LE からのマイグレーションについて詳しくは、HATS LE からのマイグレーションを参照してください。

V4.0 より前のバージョンの Host Publisher を使用している場合は、まず Host Publisher アプリケーションを Host Publisher V4.0 にマイグレーションする手順を実行する必要があります。http://www.ibm.com/software/awdtools/hats/support/index.html にアクセスし、検索ストリングとして「How to migrate Host Publisher (Host Publisher のマイグレーション方法)」を入力してください。詳しくは、Host Publisher ユーザーのための HATSを参照してください。

HATS のマイグレーション

前のリリースの HATS から HATS プロジェクトをマイグレーションするには、次の 2 つのステップのプロセスを実行します。

  1. プロジェクトをプロジェクト交換ファイルとしてインポートするか、コード・リポジトリー (CVS など) からチェックアウトして、HATS V7.5.1 ワークスペースに追加します。
  2. HATS マイグレーション・ウィザードを使用して、プロジェクトをマイグレーションします。

HATS プロジェクトのインポート

前のリリースの HATS がインストールされている場合は、まずプロジェクトを zip ファイルかプロジェクト交換ファイルにエクスポートしてから、HATS V7.5.1 にインポートおよびマイグレーションする必要があります。HATS プロジェクトのエクスポートについて詳しくは、前のリリースの HATS の資料を参照してください。

前のリリースの HATS からプロジェクトをエクスポートしたら、そのプロジェクトをプロジェクト交換ファイルとして HATS V7.5.1 ワークスペースにインポートする必要があります。 HATS Web プロジェクトおよび リッチ・クライアント・プロジェクトのインポートについて詳しくは、HATS Web プロジェクトのエクスポートとインポートおよびHATS リッチ・クライアント・プロジェクトのエクスポートとインポートを参照してください。

注:
WebSphere® Studio Application Developer (WSAD) V4 から zip ファイルとしてエクスポートされた HATS V4 プロジェクトは、プロジェクト交換ファイルとしてインポートできないため、その後にマイグレーションすることもできません。WSAD V5 から zip ファイルとしてエクスポートされた HATS V4 プロジェクトは、HATS V7.5.1 にインポートおよびマイグレーションすることができます。

ご使用の HATS プロジェクトを Rational® ClearCase® に保存している場合は、これらのプロジェクトが含まれるスナップショット・ビューを作成した後、「ファイル」>「インポート」>「一般」>「既存プロジェクトをワークスペースへ」を使用して、これらのプロジェクトを HATS V7.5.1 ワークスペースにインポートする必要があります。このインポート中には、「プロジェクトをワークスペースにコピーする (Copy projects into workspace)」オプションを選択しないでください。各プロジェクトがご使用の HATS V7.5.1 ワークスペースにインポートされると、オプションで HATS V7.5.1 にそれらをマイグレーションすることができます。マイグレーション中に、更新の必要があるファイルは Rational ClearCase から自動的にチェックアウトされます。

Rational SDP ワークスペースのマイグレーション

Rational SDP ワークスペース・マイグレーション・ウィザードは、プロジェクトをワークスペースにインポートしたとき、いくつかのレベルの Rational SDP マイグレーションを実行する必要がある場合に表示されます。このウィザードによって、基本の Rational SDP プロジェクトのマイグレーションがいくつか実行され、プロジェクトのターゲットがサポートされないランタイムである場合は、サポートされるターゲット・ランタイムを選択するよう強制されます。HATS マイグレーション・ウィザードを実行する準備として、まず Rational SDP ワークスペース・マイグレーション・ウィザードを実行する必要があります。

HATS マイグレーション・ウィザードの使用

HATS パースペクティブに切り替える際に、前の HATS リリースから作成されたプロジェクトが HATS V7.5.1 ワークスペースにある場合は、マイグレーションする必要のある HATS プロジェクトがワークスペースに含まれていることを示すメッセージが表示されます。

「問題」ビューに表示されるエラーを調べる前に、HATS マイグレーション・ウィザードを使用してこのプロジェクトを HATS V7.5.1 にマイグレーションする必要があります。これは、マイグレーションを行うことにより、これらのエラーの一部またはすべてが除去される可能性があるためです。

HATS マイグレーション・ウィザードを使用するには、次の手順を実行します。

  1. 「HATS プロジェクト」 ビューで、プロジェクトを右クリックし、「プロジェクトのマイグレーション」を選択します。
  2. マイグレーション対象として選択した HATS プロジェクトに関連付けられている前の HATS リリースのプロジェクトが他にもある場合、それらのプロジェクトも関連するすべての HATS .ear プロジェクトとともにマイグレーションされます。
  3. 「OK」をクリックすると、マイグレーションが開始されます。
  4. プロジェクトに関連する .ear プロジェクトがない場合は、マイグレーション後に .war プロジェクトを関連付ける必要があります。.war プロジェクトを .ear プロジェクトと関連付ける方法は、HATS Web プロジェクトを別の .ear ファイルに移動させるを参照してください。

注:
  1. マイグレーション後に、マイグレーション・レポートの詳細を確認してください。
  2. マイグレーション中の HATS Web プロジェクトまたはポートレット・プロジェクトがサポートされないターゲット・ランタイムを含むか (Rational SDP ワークスペース・マイグレーション・ウィザードを未実行)、サポートされない WebSphere ファセットを含む場合、HATS マイグレーション・ウィザードでは、ターゲット・ランタイムおよびファセットとして、Web プロジェクトの場合は、サポートされる最低の WebSphere Application Sever レベルを設定し、ポートレット・プロジェクトの場合は、サポートされる最低の WebSphere Portal サーバー・レベルを設定します。この変更を実行したことを示すメッセージが表示および記録されます。
  3. マイグレーション後に、ターゲット・ランタイムが定義されていないことを示すエラーが表示される場合、プロジェクトのプロパティーを編集し、該当するターゲット・ランタイムを選択します。これを行うには、プロジェクトを右クリックし、「プロパティー」を選択します。「プロパティー」ウィンドウから、「ターゲット・ランタイム」を選択します。「ランタイム」リストから、該当するランタイムを選択します。
  4. プロジェクトを前のリリースの HATS から HATS V7.5.1 にマイグレーションすると、元に戻すことができません。

HATS 変換のマイグレーション

HATS プロジェクトを前のリリースの HATS から HATS V7.5.1 にマイグレーションすると、プロジェクトの変換もマイグレーションされます。変換に対して行われる変更は、マイグレーション元の HAT のリリースによって異なります。すべての変換は、マイグレーションする前に MigrationBackup フォルダーに保存されます。

HATS V4 コンポーネントおよびウィジェットに関する特別な考慮事項

HATS V5 では、新しいコンポーネントとウィジェットが導入されています。HATS V4 コンポーネントおよびウィジェットは、HATS V5 および V6 の両方でサポートされていましたが、推奨されていませんでした。HATS V7.5.1 では、HATS V4 コンポーネントおよびウィジェットはサポートされません。プロジェクト内に HATS V4 コンポーネントおよびウィジェットがある場合は、マイグレーション中に、それらを HATS V7.5.1 コンポーネントおよびウィジェットにマイグレーションするか、あるいはプロジェクトのマイグレーションをキャンセルするかを選択できます。マイグレーションを選択する場合、プロジェクトのレンダリングは以前と異なる可能性があります。マイグレーション済みプロジェクトは完全にテストしてください。

HATS V4 のサブファイル・コンポーネントおよびウィジェットがある場合、それらは HATS V5 のサブファイル・コンポーネントおよびウィジェットにマイグレーションされます。HATS V5 のサブファイル・コンポーネントおよびウィジェットがある場合、それらはそのままになります。HATS V6 以降については、新規の (機能が豊富な) サブファイル・コンポーネントおよびウィジェットがあります。以前のコンポーネントおよびウィジェットの代わりに、新規のコンポーネントおよびウィジェットの使用を試すことができます。詳しくは、サブファイルを参照してください。

HATS V4 では、ファンクション・キー・コンポーネントを選択し、それをドロップダウン (選択) またはラジオ・ボタン (選択) ウィジェットでレンダリングする場合、自動実行依頼を使用するか、送信ボタンを表示するかを選択することができました。送信ボタンの表示を選択した場合は、HATS V4 プロジェクトを HATS V7.5.1 にマイグレーションすると、送信ボタンが表示されなくなります。HATS V7.5.1 では、送信ボタンを表示する機能は除去されています。

HATS V4 DefaultExtract/DefaultWidget のすべてのペアは、HATS V7.5.1 デフォルト・レンダリングにマイグレーションされます。このマッピングは本来意図した結果にならない場合があるため、HATS V7.5.1 マイグレーションでは、DefaultExtract/DefaultWidget のペアがデフォルト・レンダリングにマイグレーションされたことを示すメッセージが表示され、ログに記録されます。その場合は、変換の内容をよく調べて、必要であれば調整してください。

カスタム・コンポーネントおよびウィジェットが HATS V4 コンポーネントおよびウィジェットを拡張しているか、それらと対になっている場合、そのカスタム・コンポーネントおよびウィジェットをマイグレーションして元の結果を維持することはできません。HATS V7.5.1 マイグレーションでこれが検出された場合は、マイグレーションできない HATS V4 コンポーネントおよびウィジェットが変換に含まれていることを示すメッセージが表示され、ログに記録されます。その場合は、変換の内容をよく調べて、変換を手動でマイグレーションしてください。

特別なマイグレーションの考慮事項

自動拡張

前のバージョンの HATS で lxgwfunctions.js ファイルに行 turnAutoTabOn(); を追加することによって自動拡張機能を使用可能にした場合は、プロジェクト設定エディターの「その他」タブの「クライアント設定」セクションで「自動フィールド進行を使用可能にする」設定を使用する必要があります。詳しくは、クライアント設定を参照してください。

バックアップ・ファイル

HATS マイグレーションでは、プロジェクト・ディレクトリー内に MigrationBackup というバックアップ・フォルダーが作成されます。このフォルダーには、マイグレーション・プロセスによって上書きされる前の、古いプロジェクトのファイルのコピーが格納されています。これらのファイルは保存されるため、新規 HATS V7.5.1 ファイルと比較およびマージすることができます。問題が発生してもあまり支障はありません。これらのファイルはアプリケーションではもう使用されません。保存されたすべてのファイルの比較とマージが済んだら、MigrationBackup フォルダーを削除して構いません。

注:
MigrationBackup フォルダーを削除する前に、マイグレーション済みのプロジェクトを WebSphere Application Server に公開して、動作をテストできます。ただし、タスク・リストに示されている MigrationBackup フォルダーが原因のエラーによって、 WebSphere Application Server への公開の際に問題が発生することがあります。 この問題は、プロジェクトから MigrationBackup フォルダーを除去するか、エラーを含んだアプリケーションをサーバーに公開することを許可することによって回避できます。エラーを含んだアプリケーションのサーバーへの公開を許可するには、 Rational SDP メニュー・バーから「ウィンドウ」>「設定」>「サーバー」>「WebSphere Application Server」を選択し、「エラーを含むアプリケーションのサーバーへの公開を許可する (Allow applications containing errors to be published on a server)」を選択します。

ボタン・ウィジェット

HATS V7.0.0.2 より前のバージョンで作成されたプロジェクトをマイグレーションする場合に、「前景色を使用可能にする」オプションをインプリメントすることを選択し、blacktheme.css スタイル・シートを使用するテンプレートを使用する場合、以下のいずれかの方法で blacktheme.css スタイル・シートを手動で更新する必要があります。

  1. 次の行を input.HATSBUTTON 宣言から除去します。
    color: lime;
    これにより、前景色をファンクション・キーでレンダリングできるようになります。ただし、HATS ウィジェットで生成された他のボタンはデフォルトの色でレンダリングされるようになります。
  2. 各色ごとに色に関連する CSS 宣言を結合します。例えば、以下のように変更します。
    .HBLUE {
           color: #3c9dff;
    }
    input.HBLUE {
           white-space: normal;
           letter-spacing: normal;
    }
    これを以下に変更します。
    .HBLUE, input.HBLUE {
            color: #3c9dff;
            white-space: normal;
            letter-spacing: normal;
    }
    各色ごとにこの変更を繰り返します。

blacktheme.css スタイル・シートを手動で編集する以外に、新規のダミー・プロジェクトを作成し、そのプロジェクトからご使用のプロジェクトにテーマ CSS ファイルをコピーする方法もあります。この場合、CSS ファイルに加えられていた変更はすべて上書きされることに注意してください。

EJB Access Bean

EJB Access Bean を持つ既存の HATS V5 プロジェクトがある場合、「HPubReqCompleteEvent を解決できません。」で始まるコンパイルまたはランタイム・エラーが発生する可能性があります。このエラーを訂正するには、EJB Access Bean を再生成します。

フィールド・ウィジェット

フィールド・ウィジェットに「モノスペース・フォントを使用してレンダリング」設定を使用し、かつプロジェクトが HATS V7.0 以前のリリースで作成されている場合、CSS ファイルを以下のように更新する必要があります。

  1. 次のクラスを whitetheme.css、graytheme.css、monochrometheme.css、 tantheme.css、および blacktheme.css ファイルに追加します。
    .HF {
      font-family: courier new, monospace;
    }
  2. すべての CSS ファイルのすべての H-color (HATS カラー) クラスから、font-family: monospace を除去します。

グローバル規則

新しい設定 enforceImmediacy は、HATS V5 から HATS V7.5.1 にインポートされる任意のグローバル規則に追加されます。この設定が true の場合、「周囲のテキストによって入力フィールドを検出」パターンの 「変換」オプションで「最も近い入力フィールドのみ」が選択されていると、グローバル規則は HATS V5 の場合と同様の振る舞いをします。この設定が false (デフォルト) の場合、グローバル規則は HATS V7.5.1 の場合と同様の振る舞いをします。

新しく定義したグローバル規則の振る舞いを HATS V5 のグローバル規則と同様にするには、enforceImmediacy 設定を追加して、これを true に設定する必要があります。これを行うには、「プロジェクト設定」エディターの「ソース」 タブで、以下の設定を globalRules componentSettings タグに追加します。

<setting name="enforceImmediacy" value="true"/>

グローバル変数

HATS V7 よりも前は、「グローバル変数を入力ボックスで要求する」オプションを使用して変換へ挿入されたプロンプトに入力されたグローバル変数の値は、一部の文字が適切にエスケープされなかったために切り捨てられる場合がありました。

この HATS バージョンでは、変換によってプロンプトが出されるグローバル変数の値は、切り捨てを防ぐために適切にエスケープされます。 「グローバル変数値を静的なテキストとして表示」オプションを使用して変換に挿入されるグローバル変数は、この変更による影響を受けません。HATS V7 より前の HATS のバージョンで変換に挿入されたグローバル変数のプロンプトは、マイグレーション中に自動的には更新されないため、この変更による影響を受けません。

HTTP 圧縮

HATS V5.0.x、V6.0、および V6.0.1 からマイグレーションしたプロジェクトで HTTP 圧縮に HATS サポートを使用する場合は、圧縮フィルターを Web デプロイメント記述子ファイル (web.xml) に手動で追加する必要があります。圧縮フィルターを web.xml ファイルに追加するには、以下の手順を実行します。

  1. HATS Toolkit から、HATS パースペクティブの「ナビゲーター」ビューに切り替えます。
  2. プロジェクトの Web Content¥WEB-INF フォルダーにある web.xml ファイルを開きます。
  3. 「ソース」タブをクリックして、このファイルのソースを表示します。
  4. 最後に定義されたサーブレット・マッピング (最後の </servlet-mapping> を検索します) の後ろに、以下のステートメントをコピーします。
    <filter>
       <description>Provides compression for output from HATS entry
                    servlet</description>
       <display-name>CompressionFilter</display-name>
       <filter-name>CompressionFilter</filter-name>
       <filter-class>com.ibm.hats.runtime.filters.CompressionFilter</filter-class>
    </filter>
       
  5. 最後に定義されたフィルター・マッピング (最後の </filter-mapping> を検索します) の後ろに、以下のステートメントをコピーします。
    <filter-mapping>
       <filter-name>CompressionFilter</filter-name>
       <servlet-name>EntryServlet</servlet-name>
       <dispatcher>ERROR</dispatcher>
       <dispatcher>FORWARD</dispatcher>
       <dispatcher>INCLUDE</dispatcher>
       <dispatcher>REQUEST</dispatcher>
    </filter-mapping>
    <filter-mapping>
       <filter-name>CompressionFilter</filter-name>
       <url-pattern>/</url-pattern>
    </filter-mapping>
    <filter-mapping>
       <filter-name>CompressionFilter</filter-name>
       <url-pattern>/index.jsp</url-pattern>
    </filter-mapping>
       
  6. ファイルを保存します。
注:
サーバー上でこのプロジェクトを既に実行している場合は、WebSphere Application Server が web.xml ファイルへの変更を取得できるようにアプリケーションを再公開する必要があります。

IBM Tivoli License Manager

HATS V7.5.1 にマイグレーションされた HATS および WebFacing アプリケーション、および HATS/WebFacing 接続アプリケーションを実稼働環境に再デプロイして、新規 HATS V7.5.1 シグニチャー・ファイルに対する IBM® Tivoli® License Manager サポートを取得する必要があります。

WebFacing Web アプリケーション

ITLM は、サポート対象の WebSphere Application Server に Enterprise Archive (EAR) としてデプロイされている Web アプリケーションを検出します。WebFacing Web プロジェクトは、関連する EAR から独立して作成されるため、ITLM シグニチャー・ファイルを手動で組み込む必要があります。以下の手順を実行して、WebFacing Web アプリケーションの ITLM 検出を使用可能にします。

  1. WebFacing プロジェクトの関連 EAR の直下に itlm という名前のフォルダーを作成します。
  2. HATS プラグイン・ディレクトリーで HATS0705.sys2 という名前のシグニチャー・ファイルを見つけます。
    <shared_install_directory>\plugins\com.ibm.hats_nnn\
    ここで、shared_install_directory は IBM Installation Manager を使用して HATS オファリングをインストールした共用リソース・ディレクトリー、nnn は HATS のバージョンおよびビルド・レベルです。
  3. プラグインのシグニチャー・ファイルを上記で作成した itlm フォルダーにコピーします。
  4. プロジェクトを EAR としてエクスポートし、再デプロイします。これで、ITLM はアプリケーションを検出できるようになります。

前のバージョンの WebFacing プロジェクトで ITLM 検出を使用可能に設定していて、そのプロジェクトを V7.5.1 にマイグレーションする場合、再デプロイを行う前に、既存のシグニチャー・ファイル (例えば、前の WebFacing プロジェクトが V7.0 であれば、WDHT0700.sys2) をプロジェクトの関連 EAR から除去し、V7.5.1 のシグニチャー・ファイル (HATS0705.sys2) を追加しておく必要があります。

注:
WebFacing ポートレットは、EAR としてデプロイできないため、検出されません。

Java 2 セキュリティー

HATS V7.5.1 へのマイグレーション中に、WebSphere Application Server Java™ 2 セキュリティー was.policy ファイルが上書きされます。HATS V7.5 より前のプロジェクトで was.policy ファイルをカスタマイズした場合は、マイグレーション後にそのファイルを再度カスタマイズする必要があります。

キーボード・マッピング

以前のバージョンの HATS ホスト端末では、Pause キーはホストの [clear] アクションにマップされていました。 HATS V7 以降のホスト端末では、Esc キーがホストの [clear] アクションにマップされます。

HATS V6 より前のバージョンの HATS では、双方向セッションで画面を反転させるために Ctrl+R が使用されていました。HATS V6 以降では、Ctrl+R は双方向セッションと非双方向セッションの両方のホストの RESET にマップされ、Alt+Enter は双方向セッションの反転にマップされています。

リッチ・クライアント・アプリケーション

Lotus Notes キーボード・バインディング

Lotus® Expeditor をターゲットとする HATS V7.5 より前のリッチ・クライアント・プロジェクトを HATS V7.5.1 にマイグレーションする場合、Lotus Notes® 用のキーボード・マッピングがプロジェクトに追加されます。これらのキーボード・マッピングは、IBM Installation Manager を使用して HATS V7.5.0.x インストールを V7.5.1 に更新する場合にも、Lotus Expeditor をターゲットとするプロジェクトに追加されます。

起動構成

リッチ・クライアント・プロジェクトのマイグレーション後、それをテスト環境で起動できない場合は、テスト環境で使用する新規起動構成を作成します。これを行うには、「HATS プロジェクト」ビューで、プロジェクトを右クリックし、「実行」または「デバッグ」のいずれかを選択します。「実行」(または「デバッグ」) 構成ウィンドウが表示されます。プロジェクトが Eclipse RCP をターゲットとする場合は、「Eclipse アプリケーション」を右クリックし、「新規」を選択します。プロジェクトが Lotus Notes または Lotus Expeditor をターゲットとする場合は、「クライアント・サービス」を右クリックし、「新規」を選択します。必要な場合は、起動構成の名前と場所を変更します。このウィンドウから古い起動構成を削除することもできます。「実行」 (または 「デバッグ」) をクリックして、テスト環境のプロジェクトを起動します。

テーマ

「従来型端末エミュレーター」テーマを使用する リッチ・クライアント・アプリケーションは、マイグレーション後に「矢印キー・ナビゲーション」設定が使用可能になります。

テンプレートおよび変換での米国英語以外のストリング

HATS V7.0 または V7.0.0.1 を使用して作成された HATS リッチ・クライアント・プロジェクトのテンプレートおよび変換に含まれている米国英語以外のストリングは、プロジェクトがフィーチャーとしてエクスポートされた場合に、正しくコンパイルされません。この問題に対処するには、プロジェクトを HATS V7.5.1 にマイグレーションした後で、プロジェクトのルート・フォルダーにある build.properties ファイルを編集します。build.properties ファイルの一番下に、次の行を追加します。

javacCustomEncodings.library.jar = src/rcpproject/templates/[UTF-8],
 src/rcpproject/transformations/[UTF-8]

ここで、rcpproject は リッチ・クライアント・プロジェクトの名前です。

ランタイムの使用可能化

HATS V7.5.1 ランタイムを実稼働環境に合わせて完全に使用可能にするには、「ライセンス設定」ウィザードを使用して、ライセンス設定を指定する必要があります。この作業は、ランタイムが前のバージョンの HATS で完全に有効であったプロジェクトでも、行う必要があります。ライセンス設定の指定については、「HATS スタートアップ・ガイド」の『HATS ランタイムの使用可能化とライセンス設定 (Enabling HATS runtime and license settings)』を参照してください。

注:
ランタイムが完全に使用可能ではない HATS Web アプリケーションは、2 つのランタイム・ホスト接続のみに制限されます。ランタイムが完全に使用可能ではない HATS リッチ・クライアント・アプリケーションは、ローカル・テスト環境ではホスト接続が無制限に許可されますが、デプロイされた実稼働環境ではホスト接続は許可されません。

Secure Sockets Layer (SSL)

マイグレーション中に、HATS V7.5.1 は SSL 証明書クラス・ファイル CustomizedCAs.class を、appname-CustomizedCAs.p12 という名前で hats というパスワードの PKCS12 鍵ストア・ファイルに変換します。ここで、appname はプロジェクト名です。マイグレーション後、証明書管理ツール (IBM 鍵管理、または iKeyMan とも呼ばれる) を使用して新規鍵ストア・ファイルのパスワードを変更し、接続エディターを使用してそれらのファイルを検証する必要があります。詳しくは、セキュリティーを参照してください。

テスト・モード

HATS V7 からは、「サーバーで実行」(Web プロジェクト用) および「実行」(リッチ・クライアント・プロジェクト用) のテスト・モードを使用して、実稼働環境に展開するランタイム設定を変更およびテストすることができます。このモードでのテスト中にランタイム設定に変更が加えられた場合、その変更は保持され、HATS アプリケーションを実稼働環境に展開するときに有効になります。

「サーバーでデバッグ」(Web プロジェクト用) および「デバッグ」(リッチ・クライアント・プロジェクト用) のテスト・モードを使用して、実稼働環境に展開する設定を変更せずにランタイム設定を変更およびテストすることができます。

Web プロジェクトのランタイム設定の変更の詳細については、HATS Toolkit での管理コンソールの開始を参照してください。リッチ・クライアント・プロジェクトのランタイム設定の変更の詳細については、HATS リッチ・クライアント・アプリケーションの管理を参照してください。

URL ホスト・コンポーネント

HATS V7 より前のバージョンでは、URL ホスト・コンポーネントは入力フィールドと保護フィールドの両方の中を検索していました。HATS V7 からは、URL ホスト・コンポーネントは保護された非隠しフィールド内のみを検索します。

Web 高速ログオン (WEL)

HATS Web プロジェクトが関連 EAR をともなわずに HATS V7.5.1 にマイグレーションされると、Web 高速ログオン (WEL) は正しく機能しません。 Web プロジェクトの WEL 構成情報は、その関連 EAR プロジェクト内に保持されています。関連 EAR プロジェクトがインポートおよびマイグレーションされないと、この情報は失われます。

Web プロジェクトと EAR プロジェクトをプロジェクト交換ファイルとしてワークスペースにインポートし、Web プロジェクトをマイグレーションすると、関連 EAR プロジェクトもマイグレーションされ、WEL 構成情報は失われません。

HATS V7 からは、HATS DCAS/RACF/JDBC Credential Mapper プラグインと証明書ベースの DCAS/RACF Credential Mapper プラグインの両方で、DCAS サーバーへのセキュア接続に Java Secure Socket Extension (JSSE) が使用されます。このため、プラグインの初期化パラメーターに以下の変更を行うことを検討してください。

CMPI_DCAS_KEYRING_FILE
このパラメーターは推奨されないため、使用しないでください。それでも使用する場合は、HATS V7.5.1 ではこのパラメーターは非推奨パラメーター CMPI_DCAS_KEYRING_PASSWORD と組み合わせてサポートされ、鍵リング・タイプは pkcs12 であると想定されます。代わりに CMPI_DCAS_TRUSTSTORE を使用してください。詳しくは、初期化パラメーターを参照してください。

このパラメーターは鍵リング・データベースを指定します。DCAS クライアント証明書のほか、DCAS サーバーの証明書にもアクセスできるようにするには、鍵リングを指定する必要があります。この証明書は、DCAS サーバーとのクライアント認証されたセキュア接続を確立します。このパラメーターは、使用する鍵リングに対するファイル参照です。DCAS プラグインは、DCAS クライアントです。鍵リング・ファイルは .ear ファイルに格納する必要があります。

CMPI_DCAS_KEYRING_PASSWORD
このパラメーターは推奨されないため、使用しないでください。それでも使用する場合は、HATS V7.5.1 ではこのパラメーターは非推奨パラメーター CMPI_DCAS_KEYRING_FILE と組み合わせてサポートされ、鍵リング・タイプは pkcs12 であると想定されます。代わりに CMPI_DCAS_TRUSTSTORE_PASSWORD を使用してください。詳しくは、初期化パラメーターを参照してください。

このパラメーターは、鍵リング・データベースのパスワードを指定します。

HATS V4 ポートレット

HATS V4 ポートレットのマイグレーションはサポートされません。既存の HATS V4 Web プロジェクトをポートレットとして使用する場合は、まずその Web プロジェクトを HATS V7.5.1 にマイグレーションする必要があります。プロジェクトをマイグレーションしたあと、そのプロジェクトから HATS V7.5.1 ポートレット・プロジェクトを生成できます。詳しくは、HATS Web プロジェクトからのポートレットの生成を参照してください。

HATS LE からのマイグレーション

現在 HATS LE がインストールされている場合は、まずアプリケーションをエクスポートしてから、HATS V7.5.1 にインポートする必要があります。HATS LE 管理者コンソールから .zip ファイルへ HATS LE アプリケーションをエクスポートするには、次の手順を実行します。

  1. Web ブラウザーで URL http://<server_name>/HATSLE/admin を入力して、HATS LE 管理コンソールを起動します。ここで、<server_name> は、HATS LE アプリケーションが稼働するサーバーの名前です。
  2. 「拡張」を選択します。
  3. 「パッケージ」を選択します。
  4. パッケージをダウンロードし、.zip ファイルとして保存します。

HATS LE アプリケーションが .zip ファイルとしてエクスポートされたら、次の手順に従って、それを HATS V7.5.1 にインポートします。

  1. 「ファイル」>「インポート」をクリックして、「インポート」ウィザードを開きます。
  2. 「HATS」>「HATS LE アプリケーション」を選択して、「次へ」をクリックします。
  3. 「Zip ファイル名」フィールドに、.zip ファイルの場所と名前を入力します。「参照」をクリックして、.zip ファイルを参照して選択することもできます。
  4. 「新規プロジェクト名」フィールドで、プロジェクト名を指定するか、既に入力されているプロジェクト名を受け入れます。
  5. プロジェクトのロケーションを設定するか、デフォルトのロケーションを受け入れます。
  6. 「エンタープライズ・アプリケーション・プロジェクト」フィールドで、.ear プロジェクトの名前を指定するか、ドロップダウン・リストから既存のプロジェクトを選択します。
  7. 「完了」をクリックします。
注:
  1. ご使用の HATS LE アプリケーションで SSL 接続が使用可能になっている場合、そのアプリケーションを HATS V7.5.1 にマイグレーションすると警告メッセージが表示され、SSL 証明書はマイグレーションされません。

    SSL 証明書を HATS V7.5.1 で使用可能にするには、PKCS12 鍵ストア・ファイルを作成し、SSL 証明書をそれに追加する必要があります。SSL 証明書がない場合は、Telnet サーバー管理者に連絡してください。詳しくは、SSL セキュリティーの使用可能化を参照してください。

  2. HATS V7.5.1 にマイグレーションした後は、HATS LE V5 の複数接続の機能は使用できなくなります。HATS LE V5 アプリケーションのデフォルト接続が HATS V7.5.1 プロジェクトのデフォルト接続になります。HATS LE V5 で構成されたその他の接続は、HATS V7.5.1 プロジェクトではバックグラウンド接続になります。

Host Publisher ユーザーのための HATS

IBM WebSphere Host Publisher の使用に慣れている場合は、HATS でプロジェクトを開発するためにアプローチを調整する必要があります。ここでは、プロジェクトを開発する際の HATS と Host Publisher とのアプローチの主な違いについて説明します。

注:
変更済みのテンプレートを使用して Host Publisher の統合オブジェクトを作成した場合は、HATS 統合オブジェクト・テンプレートに同じ変更を加え、マクロで統合オブジェクトを再生成することによって、統合オブジェクトを再作成する必要があります。統合オブジェクトをカスタマイズするテンプレートの使用方法の詳細については、「HATS Web アプリケーション・プログラマーズ・ガイド」を参照してください。

Host Publisher バージョン 4.0 アプリケーションをインポートする場合 (Host Publisher バージョン 4.0.1 アプリケーションではなく) は、次の手順を実行します。

Host Publisher バージョン 4 からのマイグレーション

現在 Host Publisher V4 を使用している場合は、プロジェクト全体をマイグレーションすることも、既存のプロジェクトの統合オブジェクトだけをマイグレーションすることもできます。Host Publisher の .ear ファイルをインポートした場合、統合オブジェクトは .jar ファイル内にパッケージされたままになります。

統合オブジェクトが Web モジュール内に含まれていた場合、.jar ファイルは WEB-INF/LIB ディレクトリー内にあります。統合オブジェクトが EJB モジュール内に含まれている場合、.jar ファイルは imported_classes¥IntegrationObject ディレクトリー内にあります。EJB Access Beans も、Web モジュールの WEB-INF/LIB ディレクトリーの .jar ファイル内にパッケージされたままになります。

.ear をインポートし、統合オブジェクトを作成したマクロを変更すると、インポートされた元の統合オブジェクト .jar と Java ソースが組み込まれます。HATS 用の統合オブジェクトを再生成したら、インポート済み .jar ファイルは削除して構いません。

Host Publisher V4 からマイグレーションする際の考慮事項を以下に示します。

「Host Publisher EAR のインポート」ウィザード

Host Publisher バージョン 4 プロジェクトは、新規 HATS プロジェクトとして HATS にインポートすることもできますし、既存の HATS プロジェクトの一部としてインポートすることもできます。

  1. 「ファイル」>「インポート」>「HATS」>「Host Publisher V4 EAR」をクリックして、「Host Publisher EAR ファイルのインポート」ウィザードを開きます。
  2. 「EAR ファイル名」フィールドに、インポートする EAR ファイルを指定します。
  3. 新規 HATS プロジェクトと既存の HATS プロジェクトのどちらに対して EAR ファイルを使用するかを決めます。
  4. 「オプション」セクションでは、チェック・ボックスで「警告なしでリソースを上書き」を設定できます。
  5. Host Publisher で暗号化を使用している場合は、「ユーザー・リスト暗号鍵」テキスト・ボックスに暗号鍵を入力できます。
  6. 「完了」をクリックします。

Host Publisher 統合オブジェクトのインポート

個々の Host Publisher 統合オブジェクトを既存の HATS プロジェクトにインポートすることもできます。

  1. 「ファイル」>「インポート」>「HATS」>「Host Publisher V4 統合オブジェクト」をクリックして、「Host Publisher 統合オブジェクトのインポート」ウィザードを開きます。
  2. 「Host Publisher 統合オブジェクト・ディレクトリー」フィールドに、インポートする統合オブジェクトの場所を指定します。
  3. 「インポートする統合オブジェクトを選択してください」 フィールドで、インポートする統合オブジェクトを選択します。
  4. 「HATS プロジェクトを選択してください」 ドロップダウン・ボックスで、HATS プロジェクトを選択します。
  5. 「警告なしでリソースを上書き」または 「インポートした統合オブジェクトを再生成します」 チェック・ボックスをオンにすることができます。
    注:
    チェーニング統合オブジェクトがある場合は、必ず 「インポートした統合オブジェクトを再生成します」 オプションをオンにしてください。これによって、チェーニングされた情報が確実に保持されます。チェーニングされた統合オブジェクトをインポートした後、状態情報は Java ソースに置かれ、「チェーニング統合オブジェクトの作成」ウィザードの使用時には情報が事前入力されます。チェーニングされた統合オブジェクトの詳細については、統合オブジェクト・チェーニングを参照してください。
  6. 「完了」をクリックします。
注:
統合オブジェクトをインポートすると、統合オブジェクトに関連する接続設定が HATS プロジェクトに追加されます。

Host Publisher バージョン 4 ポートレットのマイグレーション

WebSphere Portal Server バージョン V6.x に同梱されているクリッピング・ポートレットには、Host Publisher バージョン 4 ポートレットと同等の機能が備わっています。統合オブジェクト・ベースの HATS アプリケーション、または Host Publisher バージョン 4 からマイグレーションされたアプリケーションを指すクリッピング・ポートレットを作成し、Host Publisher バージョン 4 ポートレットと置き換えることができます。Host Publisher バージョン 4 ポートレットは、現在はサポートされていません。

統合オブジェクト・ベースのアプリケーションと WebSphere Portal とのより緊密な統合については、「HATS Web アプリケーション・プログラマーズ・ガイド」を参照してください。

J2EE マイグレーション

HATS プロジェクトの J2EE サポートのレベルをマイグレーションするには、以下の手順を実行してください。

  1. Rational SDP で、「ナビゲーター」ビューに切り替えます。
  2. HATS プロジェクトを含む .ear プロジェクトを右クリックして、「Java EE」>「J2EE マイグレーション・ウィザード」を選択します。
  3. 「ようこそ」ページのパネルで、「次へ」をクリックします。
  4. 「エンタープライズ・アプリケーション」パネルで、適切な J2EE バージョンを選択して、「すべてのモジュール・プロジェクトをマイグレーションする」ボックスをクリアします。
    注:
    このボックスをクリアすると、マイグレーションするプロジェクトに個別にチェック・マークを付けることができます。.ear プロジェクトに HATS EJB プロジェクトが含まれている場合、.ear プロジェクトを正常にマイグレーションするためには、その HATS EJB プロジェクトを選択しないでください。
  5. 「EJB モジュール」パネル (表示された場合) では、HATS EJB プロジェクトを選択しないでください。
  6. 「Web プロジェクト」パネルで、すべての HATS Web プロジェクトを選択します。
  7. 「完了」をクリックします。