インストール ガイド › CA Business Service Insight のアップグレード方法

CA Business Service Insight のアップグレード方法

システム管理者は、定期的に CA Business Service Insight を更新することが重要です。 アップグレードにより、すべての新機能およびバグ修正を利用できます。

アップグレード ファイルはプログラムを実行しているサーバを認識し、必要なファイルを更新します。 最初に、Alerts サービスが含まれるアプリケーション サーバをアップグレードします。 マイグレーション スクリプトは、アラート サービスがインストールされたアプリケーション サーバ上で自動的に実行されます。

マルチサーバ環境にアップグレードするには、最初にアプリケーション サーバでアップグレード処理を実行します。 次に、Web サーバでアップグレードを実行します。 アプリケーション サーバでアップグレードすると、自動的にデータベース マイグレーションが実行されます。

このシナリオを使用し、プロセスについて段階的に説明します。

1. 前提条件の確認。
2. ファイルとフォルダのバックアップ。
3. アップグレードの準備。
4. Web ウェブサイトの存在確認。
5. CA Business Service Insight のアップグレード。
6. アップグレードの完了。
7. （オプション）プロキシ文字列の更新。
8. （オプション） API の更新。

前提条件の確認

アップグレードの実行が可能であるかを確認するには、以下の前提条件を確認します。

• CA Business Service Insight バージョン 7.0 SP1 以降がインストールされている。
• SYSDBA アクセス権限がある。
• データベースの各テーブル スペースに少なくとも 15 パーセントの未割当領域があること。

  注： autoextend がオンになっている場合、データ ファイルの maxsize がデータファイルの現在のサイズの少なくとも 15 パーセント以上になっていることを確認します。

• データベース テーブルスペースが含まれる各物理デバイスの未割当領域が、デバイスのすべてのテーブルスペースの合計サイズの少なくとも 15 パーセントであること。
• Oracle OLEDB Provider がアプリケーション サーバと Web サーバにインストールされていること。

ファイルとフォルダのバックアップ

アップグレード中に情報を失わないようにするため、以下のファイルとフォルダをバックアップします。

注： ロールバックを実行するには、すべてのバージョンをアンインストールし、前のバージョンをインストールし、バックアップ データをインポートします。

次の手順に従ってください：

1. データベース ダンプを実行します。
2. カスタマイズされたすべてのファイルをバックアップします。 以下のファイルがカスタマイズ可能です。
   • LoginCommon.asp
   • RedirectToLogin.asp
   • SilentLogin.asp
   • AcceptLogin.asp
   • Web.config
   • Registry.xml
   • Index.asp（シングル サインオン用）
   • logo.jpg
   • logo.gif
   • logobg.gif
   • logout1.gif
   • logout2.gif
   • Reportlogo （およびダッシュまたはレポート エクスポートなど、その他のロゴ）
3. （オプション）言語パッケージをバックアップします。

アップグレードの準備

アップグレードを確実に成功させるには、アップグレードを開始する前に以下のタスクを実行します。

次の手順に従ってください：

1. 英語でない地域言語設定を使用している場合、英語（米国）にそれを変更します。

   注： アップグレードに別の言語設定を使用した場合、エラーを引き起こす可能性があります。

2. すべての Oblicore サービスを停止します。
3. IIS Manager で、Web サーバを停止します。

   重要： WWW サービスまたは IIS Admin サービスを停止しないでください。

4. 分散トランザクション コーディネータ サービスを開始します。

   重要： 分散トランザクション コーディネータ サービスはアップグレード時のみに必要です。

5. oblicore_privs.sql を実行します。 スクリプトは SetupDB¥Migration フォルダのインストール CD にあります。
6. job_queue_processes パラメータが Init.ora ファイルで 2 に設定されていることを確認します。

Web サイトの存在確認

Web サイトが機能することを確認するには、サーバの Web サイトの存在を確認します。 お使いのサーバ トポロジに適用されるオプションを選択します。

次の手順に従ってください：

サーバはアプリケーション サーバとしてのみ指定されます。

1. アプリケーション サーバのレジストリを開き、以下のエントリを参照します： HKEY_LOCAL_MACHINE¥SOFTWARE¥Oblicore¥Install Data
2. WWWRootFolderLocation 文字列値が存在する場合は、削除します。

サーバがアプリケーション サーバとしてのみ指定されることはありません。

1. Web または Web サービス サーバのレジストリを開き、以下のエントリを参照します： HKEY_LOCAL_MACHINE¥SOFTWARE¥Oblicore¥Install Data
2. WWWRootFolderLocation 文字列値が存在することを確認します。
3. この文字列値のデータに Web フォルダのフォルダ パスが含まれていることを確認します。

注： 64 ビット システムでは、エントリは次のとおりです： HKEY_LOCAL_MACHINE¥SOFTWARE¥WOW6432node¥Oblicore¥Install Data

CA Business Service Insight のアップグレード

CA Business Service Insight の新しい機能を利用するには、最新のバージョンにアップグレードします。

次の手順に従ってください：

1. サーバ フォルダの Cloud_Insight_Server_8.2.5.exe をダブルクリックし、［次へ］をクリックします。
2. インストール言語を選択し、［OK］をクリックします。
3. ［インストール］をクリックします。
4. インストール ウィザードの［次へ］をクリックします。
5. 使用許諾契約に同意し、［次へ］をクリックします。
6. サードパーティ CD の場所を選択し、［次へ］をクリックします。
7. （オプション）インストーラにより以前の JBoss コンポーネントをクリーンアップする指示が表示された場合は、クリーンアップを選択し、［次へ］をクリックします。

   注： JBoss の旧バージョンがインストールされている場合にのみ、このプロンプトが表示されます。

   アップグレード ダイアログ ボックスが開きます。

8. 開いたダイアログ ボックスごとに、各パラメータの値を入力し、［次へ］をクリックします。

   注： 詳細については、「アップグレード ダイアログ ボックス」を参照してください。

9. 設定が正しいことを確認し、［次へ］をクリックします。

   インストールが開始されます。

   ［マイグレーション スクリプトの実行］を選択した場合、手順に従います。

10. ［完了］をクリックしてアップグレードを確定します。

    システムが再起動します。

アップグレード ダイアログ ボックス

インストール ウィザードには、情報を更新するために CA Business Service Insight が使用するダイアログ ボックスが含まれます。 選択する機能に関連するダイアログ ボックスのみが開きます。

以下の表は、アップグレード ダイアログ ボックスと関連するパラメータおよび値を一覧にまとめたものです。

重要： ダブル ダガー（‡）が付いているエントリにはダブル バイト文字を使用することができません。

注： Oracle の命名規則では、特定の文字の使用がサポートされていません。 Oracle の特定の要件（ASCII など）および制限（特殊文字やダブル バイト文字など）については、Oracle の資料を参照してください。

設定ファイルとそれに関連したパラメータを以下の表に示します。

重要： 以下の設定テーブルで、いずれのエントリに対してもダブル バイト文字を割り当てないでください。

注： * マークが付いているパラメータの値は、一重引用符で始まり、円記号と一重引用符で終わる必要があります（例： 'C:¥Temp¥'）。

アップグレードの完了

アップグレードを完了するには、以下のタスクを実行します。

重要： CA Business Service Insight をアップグレードした後に sadmin としてログインします。 デフォルトのパスワードは「sadmin」です。

次の手順に従ってください：

1. すべてのサーバを再起動します。
2. IIS Manager で、Web サーバを起動します。
3. （オプション）パブリック シノニムからプライベート シノニムに変更するには、データベースで以下のいずれかのプロシージャを呼び出します。

   begin
   prc_recreate_all_synonyms ('YES');
   end
   

   または

   exec prc_recreate_all_synonyms ('YES');
   

4. （オプション）データベースで oblidbadmin アカウントをロックします。 データベースに接続し、以下のコマンドを実行します。

   alter user oblidbadmin account lock;
   

5. （オプション） oblidbadmin パスワードを変更します。 データベースに接続し、以下のコマンドを実行します。

   alter user oblidbadmin identified by ‘<new_password>’;
   

6. 選択したタイム ゾーンに時間オフセットが一致することを確認します。
7. 夏時間の日付がお住まいの場所に一致することを確認します。

   これで CA Business Service Insight が最新のバージョンになりました。

プロキシ文字列の更新

リバース プロキシは Web サイトにサポート リクエストを転送します。 リクエストは web.config ファイルの AppSettings セクションの ProxyPrefix およびキーの値にプレフィックス文字列を入れます。 このプレフィックス文字列は、プロキシ設定で Web サイトにリクエストをルーティングするように設定されています。 リバース プロキシを使用するには、プロキシ文字列を更新します。

次の手順に従ってください：

1. Web サイトがリバース プロキシに正しくルーティングされることを確認します。 プロキシ値のスペルが正しく、2 つのスラッシュ間に入力されていること（"/prefix/"）を確認します。

   たとえば、Web サイトにマッピングされたプレフィックスが「ca」の場合、web.config ファイルは以下のように更新されます。

   <appSettings>
   <add key="ProxyPrefix" value="/ca/" />
   </appSettings>
   

   ProxyPrefix キーが存在しない場合やその値が空の文字列の場合、Web サイトは標準モードで動作します。

2. プロキシ設定にヘッダを追加します。 ヘッダ キーは、「X-Forwarded-CA-Oblicore-Proxy」と指定する必要があります。

   たとえば、Oblicore Web アプリケーションのプロキシ アクセス URL が http://proxy/ca/ の場合（ca はプレフィックス）、web.config ファイルは以下のように更新されます。

   <appSettings>
   <add key="ProxyPrefix" value="/ca/" />
   </appSettings>
   

   この更新のほかに、「X-Forwarded-CA-Oblicore-Proxy」というキー名の新しいヘッダがプロキシ Web アプリケーション設定ファイルに追加されます。

API の更新

8.1 より前のバージョンの API コードを使用するには、API インターフェースを更新します。

注： 詳細については、「CA Business Service Insight SDK Guide」の「API Backwards Compatibility」を参照してください。

次の手順に従ってください：

1. 8.2.5 の WSDL を使用し、契約サービス、ポートフォリオ サービス、リポジトリ サービスのプロキシ クラスを作成します。 最後のインストールからの WSDL を 8.0 より前のバージョンに使用します。
2. API コードを再コンパイルします。

   注： コンパイル エラーがある場合、手動で変更する必要があるコードを探します。 新しい API に加えられた変更（フィールドの順序や型）に従ってコードを更新します。 これらを変更した後で API コードを再コンパイルします。