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 プロジェクトをマイグレーションするには、次の 2 つのステップのプロセスを実行します。
前のリリースの HATS がインストールされている場合は、まずプロジェクトを zip ファイルかプロジェクト交換ファイルにエクスポートしてから、HATS V7.5.1 にインポートおよびマイグレーションする必要があります。HATS プロジェクトのエクスポートについて詳しくは、前のリリースの HATS の資料を参照してください。
前のリリースの HATS からプロジェクトをエクスポートしたら、そのプロジェクトをプロジェクト交換ファイルとして HATS V7.5.1 ワークスペースにインポートする必要があります。 HATS Web プロジェクトおよび リッチ・クライアント・プロジェクトのインポートについて詳しくは、HATS Web プロジェクトのエクスポートとインポートおよびHATS リッチ・クライアント・プロジェクトのエクスポートとインポートを参照してください。
ご使用の 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 プロジェクトのマイグレーションがいくつか実行され、プロジェクトのターゲットがサポートされないランタイムである場合は、サポートされるターゲット・ランタイムを選択するよう強制されます。HATS マイグレーション・ウィザードを実行する準備として、まず Rational SDP ワークスペース・マイグレーション・ウィザードを実行する必要があります。
HATS パースペクティブに切り替える際に、前の HATS リリースから作成されたプロジェクトが HATS V7.5.1 ワークスペースにある場合は、マイグレーションする必要のある HATS プロジェクトがワークスペースに含まれていることを示すメッセージが表示されます。
「問題」ビューに表示されるエラーを調べる前に、HATS マイグレーション・ウィザードを使用してこのプロジェクトを HATS V7.5.1 にマイグレーションする必要があります。これは、マイグレーションを行うことにより、これらのエラーの一部またはすべてが除去される可能性があるためです。
HATS マイグレーション・ウィザードを使用するには、次の手順を実行します。
HATS プロジェクトを前のリリースの HATS から HATS V7.5.1 にマイグレーションすると、プロジェクトの変換もマイグレーションされます。変換に対して行われる変更は、マイグレーション元の HAT のリリースによって異なります。すべての変換は、マイグレーションする前に MigrationBackup フォルダーに保存されます。
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 フォルダーを削除して構いません。
HATS V7.0.0.2 より前のバージョンで作成されたプロジェクトをマイグレーションする場合に、「前景色を使用可能にする」オプションをインプリメントすることを選択し、blacktheme.css スタイル・シートを使用するテンプレートを使用する場合、以下のいずれかの方法で blacktheme.css スタイル・シートを手動で更新する必要があります。
color: lime;これにより、前景色をファンクション・キーでレンダリングできるようになります。ただし、HATS ウィジェットで生成された他のボタンはデフォルトの色でレンダリングされるようになります。
.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 を持つ既存の HATS V5 プロジェクトがある場合、「HPubReqCompleteEvent を解決できません。」で始まるコンパイルまたはランタイム・エラーが発生する可能性があります。このエラーを訂正するには、EJB Access Bean を再生成します。
フィールド・ウィジェットに「モノスペース・フォントを使用してレンダリング」設定を使用し、かつプロジェクトが HATS V7.0 以前のリリースで作成されている場合、CSS ファイルを以下のように更新する必要があります。
.HF {
font-family: courier new, 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 のバージョンで変換に挿入されたグローバル変数のプロンプトは、マイグレーション中に自動的には更新されないため、この変更による影響を受けません。
HATS V5.0.x、V6.0、および V6.0.1 からマイグレーションしたプロジェクトで HTTP 圧縮に HATS サポートを使用する場合は、圧縮フィルターを Web デプロイメント記述子ファイル (web.xml) に手動で追加する必要があります。圧縮フィルターを web.xml ファイルに追加するには、以下の手順を実行します。
<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>
<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>
HATS V7.5.1 にマイグレーションされた HATS および WebFacing アプリケーション、および HATS/WebFacing 接続アプリケーションを実稼働環境に再デプロイして、新規 HATS V7.5.1 シグニチャー・ファイルに対する IBM® Tivoli® License Manager サポートを取得する必要があります。
ITLM は、サポート対象の WebSphere Application Server に Enterprise Archive (EAR) としてデプロイされている Web アプリケーションを検出します。WebFacing Web プロジェクトは、関連する EAR から独立して作成されるため、ITLM シグニチャー・ファイルを手動で組み込む必要があります。以下の手順を実行して、WebFacing Web アプリケーションの ITLM 検出を使用可能にします。
<shared_install_directory>\plugins\com.ibm.hats_nnn\ここで、shared_install_directory は IBM Installation Manager を使用して HATS オファリングをインストールした共用リソース・ディレクトリー、nnn は HATS のバージョンおよびビルド・レベルです。
前のバージョンの WebFacing プロジェクトで ITLM 検出を使用可能に設定していて、そのプロジェクトを V7.5.1 にマイグレーションする場合、再デプロイを行う前に、既存のシグニチャー・ファイル (例えば、前の WebFacing プロジェクトが V7.0 であれば、WDHT0700.sys2) をプロジェクトの関連 EAR から除去し、V7.5.1 のシグニチャー・ファイル (HATS0705.sys2) を追加しておく必要があります。
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® 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 V7.5.1 は SSL 証明書クラス・ファイル CustomizedCAs.class を、appname-CustomizedCAs.p12 という名前で hats というパスワードの PKCS12 鍵ストア・ファイルに変換します。ここで、appname はプロジェクト名です。マイグレーション後、証明書管理ツール (IBM 鍵管理、または iKeyMan とも呼ばれる) を使用して新規鍵ストア・ファイルのパスワードを変更し、接続エディターを使用してそれらのファイルを検証する必要があります。詳しくは、セキュリティーを参照してください。
HATS V7 からは、「サーバーで実行」(Web プロジェクト用) および「実行」(リッチ・クライアント・プロジェクト用) のテスト・モードを使用して、実稼働環境に展開するランタイム設定を変更およびテストすることができます。このモードでのテスト中にランタイム設定に変更が加えられた場合、その変更は保持され、HATS アプリケーションを実稼働環境に展開するときに有効になります。
「サーバーでデバッグ」(Web プロジェクト用) および「デバッグ」(リッチ・クライアント・プロジェクト用) のテスト・モードを使用して、実稼働環境に展開する設定を変更せずにランタイム設定を変更およびテストすることができます。
Web プロジェクトのランタイム設定の変更の詳細については、HATS Toolkit での管理コンソールの開始を参照してください。リッチ・クライアント・プロジェクトのランタイム設定の変更の詳細については、HATS リッチ・クライアント・アプリケーションの管理を参照してください。
HATS V7 より前のバージョンでは、URL ホスト・コンポーネントは入力フィールドと保護フィールドの両方の中を検索していました。HATS V7 からは、URL ホスト・コンポーネントは保護された非隠しフィールド内のみを検索します。
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) が使用されます。このため、プラグインの初期化パラメーターに以下の変更を行うことを検討してください。
このパラメーターは鍵リング・データベースを指定します。DCAS クライアント証明書のほか、DCAS サーバーの証明書にもアクセスできるようにするには、鍵リングを指定する必要があります。この証明書は、DCAS サーバーとのクライアント認証されたセキュア接続を確立します。このパラメーターは、使用する鍵リングに対するファイル参照です。DCAS プラグインは、DCAS クライアントです。鍵リング・ファイルは .ear ファイルに格納する必要があります。
このパラメーターは、鍵リング・データベースのパスワードを指定します。
HATS V4 ポートレットのマイグレーションはサポートされません。既存の HATS V4 Web プロジェクトをポートレットとして使用する場合は、まずその Web プロジェクトを HATS V7.5.1 にマイグレーションする必要があります。プロジェクトをマイグレーションしたあと、そのプロジェクトから HATS V7.5.1 ポートレット・プロジェクトを生成できます。詳しくは、HATS Web プロジェクトからのポートレットの生成を参照してください。
現在 HATS LE がインストールされている場合は、まずアプリケーションをエクスポートしてから、HATS V7.5.1 にインポートする必要があります。HATS LE 管理者コンソールから .zip ファイルへ HATS LE アプリケーションをエクスポートするには、次の手順を実行します。
HATS LE アプリケーションが .zip ファイルとしてエクスポートされたら、次の手順に従って、それを HATS V7.5.1 にインポートします。
SSL 証明書を HATS V7.5.1 で使用可能にするには、PKCS12 鍵ストア・ファイルを作成し、SSL 証明書をそれに追加する必要があります。SSL 証明書がない場合は、Telnet サーバー管理者に連絡してください。詳しくは、SSL セキュリティーの使用可能化を参照してください。
IBM WebSphere Host Publisher の使用に慣れている場合は、HATS でプロジェクトを開発するためにアプローチを調整する必要があります。ここでは、プロジェクトを開発する際の HATS と Host Publisher とのアプローチの主な違いについて説明します。
Host Publisher バージョン 4.0 アプリケーションをインポートする場合 (Host Publisher バージョン 4.0.1 アプリケーションではなく) は、次の手順を実行します。
現在 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 バージョン 4 プロジェクトは、新規 HATS プロジェクトとして HATS にインポートすることもできますし、既存の HATS プロジェクトの一部としてインポートすることもできます。
個々の Host Publisher 統合オブジェクトを既存の HATS プロジェクトにインポートすることもできます。
WebSphere Portal Server バージョン V6.x に同梱されているクリッピング・ポートレットには、Host Publisher バージョン 4 ポートレットと同等の機能が備わっています。統合オブジェクト・ベースの HATS アプリケーション、または Host Publisher バージョン 4 からマイグレーションされたアプリケーションを指すクリッピング・ポートレットを作成し、Host Publisher バージョン 4 ポートレットと置き換えることができます。Host Publisher バージョン 4 ポートレットは、現在はサポートされていません。
統合オブジェクト・ベースのアプリケーションと WebSphere Portal とのより緊密な統合については、「HATS Web アプリケーション・プログラマーズ・ガイド」を参照してください。
HATS プロジェクトの J2EE サポートのレベルをマイグレーションするには、以下の手順を実行してください。