手動マイグレーションでバージョン 8.2.0.7 以降の 8.2.x バージョンからアップグレードするには

この手順は、Marketing Platform バージョン 8.2.0.7 以降の 8.2.x バージョンからのアップグレードにのみ当てはまります。

他のバージョンからのアップグレードに関する情報は、Marketing Platform のアップグレードのシナリオを参照してください。

IBM® マスター・インストーラー

また、Marketing Platform 8.x のインストール済み環境が正常に機能すること、およびコマンド・ライン・ツールを実行できることも確認してください。この手順では、Marketing Platform インストール済み環境の tools/bin ディレクトリーにある 3 つの Marketing Platform ユーティリティーを使用する必要があります。これらのユーティリティーの使用に関する詳しい情報 (共通タスクのコマンド例を含む) は、以下から入手できます。

populateDb ユーティリティー

configTool ユーティリティー

alertConfigTool ユーティリティー

1.	IBM® EMM にログインして、「設定」>「構成」ページにナビゲートし、「LDAP BaseDN 定期検索が有効」という名前のプロパティー (「Platform \| セキュリティー \| ログイン方法の詳細 \| LDAP 同期」カテゴリー) が存在するかどうかを判別します。

この情報は後のステップで使用します。

2.	Marketing Platform システム・テーブル・データベースのバックアップを作成します。

このステップはスキップしないでください。アップグレードが失敗した場合に、データベースをロールバックすることができず、データが破損します。

3.	現行バージョンを配置解除します。

4.	IBM® マスター・インストーラーを実行します。

IBM® マスター・インストーラーが開始します。 IBM® マスター・インストーラーで、以下のガイドラインに従います。

Marketing Platform データベース接続情報の入力を求めるプロンプトが IBM® マスター・インストーラーから出されたら、現行の Marketing Platform システム・テーブルに関する情報を入力します。

インストール・ディレクトリーを選択するように求めるプロンプトが IBM® マスター・インストーラーから出されたら、ルート・インストール・ディレクトリーを選択します (このルート・ディレクトリーの下にある Marketing Platform インストール・ディレクトリーではありません)。

IBM® マスター・インストーラーは Marketing Platform インストーラーを一時停止し、起動します。

5.	Marketing Platform インストーラーで、以下のガイドラインに従います。

インストール・ディレクトリーを求めるプロンプトが Marketing Platform インストーラーから出されたら、現行の Marketing Platform インストールのディレクトリー (通常 Platform という名前) を選択します。

インストーラーに前のインストールをバックアップさせます。

「手動データベース・セットアップ」を選択します。

「Platform の構成の実行」チェック・ボックスを選択解除します。

Marketing Platform インストーラーの残りのすべてのステップに従い、要求されるすべての情報を入力します。

6.	すべてのインストーラーが完了した後、configTool ユーティリティーを使用して以下の手順を実行することにより、この後のステップで実行する SQL スクリプトが正しく実行できるようにします。

a.	ルート・ノード Affinium から、すべての構成プロパティーをエクスポートします。

例えば、以下のコマンドは、プロパティーを config_property_export.xml というファイルにエクスポートします。このファイルは、Marketing Platform インストール済み環境の install ディレクトリーに作成されます。これは Windows での例です。

configTool.bat -x -p "Affinium" -f "C:¥Unica¥Platform¥install¥config_property_export.xml

b.	ルート・ノード Affinium から、すべての構成プロパティーを削除します。

例えば、以下のコマンドはプロパティーを削除します。これは Windows での例です。

configTool.bat -d -o -p "Affinium"

c.	エクスポートした構成プロパティーをインポートします。

例えば、以下のコマンドは、プロパティーを、Marketing Platform インストール済み環境の install ディレクトリーにある config_property_export.xml というファイルからインポートします。これは Windows での例です。

configTool.bat -i -o -f "C:¥Unica¥Platform¥install¥config_property_export.xml

7.	Marketing Platform インストール済み環境の db¥upgrade82to85 ディレクトリーで、SQL スクリプトを次のように編集します。

a.	編集する SQL スクリプトは ManagerSchema_DB_Type_86upg.sql です (DB_Type はご使用のシステム・テーブル・データベースのデータベース・タイプ)。

b.	すべてのデータベース・タイプについて、次のステートメントを削除します。

ALTER TABLE USCH_RUN ADD PAYLOAD NVARCHAR(4000);

c.	ご使用のデータベースが DB2 の場合は、以下のステートメントも削除します。

ALTER TABLE qrtz_job_details ALTER COLUMN job_data SET DATA TYPE blob(4000);

ALTER TABLE qrtz_triggers ALTER COLUMN job_data SET DATA TYPE blob(4000);

8.	以下の中の該当する表を使用して、新しい Marketing Platform インストール済み環境で提供されている SQL スクリプトを探し、ご使用の Marketing Platform システム・テーブル・データベースに対するものを見つけます。示されている順序で SQL スクリプトを実行します。

バージョン 8.2.0.7 以降の 8.2.x バージョンからアップグレードする場合に使用するテーブル
スクリプト名	場所
ManagerSchema_DB_Type_85upg.sql。DB_Type は、システム・テーブル・データベースのデータベース・タイプです。	db¥upgrade82to85
insert_new_85_locales.sql	db¥upgrade82to85
ManagerSchema_DB_Type_86upg.sql。DB_Type は、システム・テーブル・データベースのデータベース・タイプです。	db¥upgrade85to86
insert_new_8601_locales.sql	db¥upgrade86to8601
active_portlets.sql	db
ManagerSchema_DB_Type_90upg.sql DB_Type は、システム・テーブル・データベースのデータベース・タイプです。	db¥upgrade86to90

9.	upgrade86to90 バッチまたはシェル・スクリプトを実行します。これは、Marketing Platform インストール済み環境の tools¥bin¥upgrade86to90 ディレクトリーにあります。

10.	populateDb ユーティリティーを使用して、システム・テーブルにデフォルトの Marketing Platform 構成プロパティー、ユーザーとグループ、およびセキュリティーの役割と権限のデータを設定します。

このユーティリティーは、Marketing Platform インストールの下の tools/bin ディレクトリーにあります。

例: populateDb -n Manager

11.	次の表の説明に従い、configTool ユーティリティーを使用して構成プロパティーをインポートします。コマンドの例は Windows システムの場合です。

configTool ユーティリティーは、Marketing Platform インストール済み環境の tools/bin ディレクトリーにあります。コマンドの例は Windows システムの場合です。

コマンドの例は Windows システムの場合です。

構成プロパティーの機能について詳しくは、「設定」>「構成」ページのオンライン・ヘルプか、「IBM® Marketing Platform 管理者ガイド」を参照してください。

バージョン 8.2.0.7 以降の 8.2.x バージョンからアップグレードする場合に使用するテーブル

ファイル名、場所、目的

コマンド例

「LDAP BaseDN 定期検索が有効」というプロパティーが、「Platform | セキュリティー | ログイン方法の詳細 | LDAP 同期」カテゴリーの下に存在する場合は、このインポートをスキップしてください。これは、この手順のステップ 1 で確認したプロパティーです。

このプロパティーが存在しない場合は、次のインポートを実行します。

ファイル: Ldap_Auto_Sync_BaseDN_Settings.xml

場所: Marketing Platform インストール済み環境の conf¥upgrade86to90 ディレクトリー

目的: DN による LDAP インポート検索を有効にする構成プロパティーのインポート

configTool.bat -i -p "Affinium|suite|security|ldapSynchronization|ldapProperties" -f C:¥Unica¥Platform¥conf¥upgrade86to90¥ Ldap_Auto_Sync_BaseDN_Settings.xml

ファイル: interaction_history_scheduler.xml

場所: Marketing Platform インストール済み環境の conf/upgrade85to86 ディレクトリー

目的: Interaction History で必要なスケジューラー構成プロパティーのインポート

configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations" -f C:¥Unica¥Platform¥conf¥upgrade85to86¥ interaction_history_scheduler.xml

ファイル: attribution_modeler_scheduler.xml

場所: Marketing Platform インストール済み環境の conf/upgrade85to86 ディレクトリー

目的: Attribution Modeler で必要なスケジューラー構成プロパティーのインポート

configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations" -f C:¥Unica¥Platform¥conf¥upgrade85to86¥ attribution_modeler_scheduler.xml

ファイル: coremetrics_configuration.xml および coremetrics_navigation.xml

場所: Marketing Platform インストール済み環境の conf ディレクトリー

目的: IBM® Digital Analytics でのシングル・サインオンに必要な構成プロパティーのインポート

configTool.bat -i -p "Affinium" -f C:¥Unica¥Platform¥conf¥coremetrics_configuration.xml

configTool.bat -i -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f C:¥Unica¥Platform¥conf¥coremetrics_navigation.xml

ファイル: cognos10_integration.xml

場所: Marketing Platform インストール済み環境の conf/upgrade85to86 ディレクトリー

目的: レポート作成に必要な構成プロパティーのインポート

configTool.bat -i -p "Affinium|Report|integrations" -f C:¥Unica¥Platform¥conf¥upgrade85to86¥cognos10_integration.xml

ファイル: ファイルなし - プロパティーの削除

目的: 使用されなくなった JMS 構成プロパティーの削除

configTool.bat -d -o -p "Affinium|suite|jmsServer"

configTool.bat -d -o -p "Affinium|suite|jmsPort"

ファイル: LDAP_Anonymous_bind.xml

場所: Marketing Platform インストール済み環境の conf/upgrade85to86 ディレクトリー

目的: バージョン 8.2.0 以降からのアップグレードの場合のみ。新しい LDAP 構成プロパティーのインポート

configTool.bat -d -o -p "Affinium|suite|jmsServer"

configTool.bat -d -o -p "Affinium|suite|jmsPort"

ファイル: quicklinks_category.xml

場所: Marketing Platform インストール済み環境の conf¥upgrade86to90 ディレクトリー

目的: クイック・リンク・ダッシュボード・ポートレットのプロパティーのインポート

configTool.bat -i -o -p "Affinium|suite" -f C:¥Unica¥Platform¥conf¥upgrade86to90¥quicklinks_category.xml

ファイル: communication_email.xml

場所: Marketing Platform インストール済み環境の conf¥upgrade86to90 ディレクトリー

目的: E メール通知を有効にするための構成プロパティーのインポート

configTool.bat -i -o -p "Affinium|Manager" -f C:¥Unica¥Platform¥conf¥upgrade86to90¥communication_email.xml

ファイル: notification.xml

場所: Marketing Platform インストール済み環境の conf¥upgrade86to90 ディレクトリー

目的: 通知機能のための構成プロパティーのインポート

configTool.bat -i -o -p "Affinium|suite" -f C:¥Unica¥Platform¥conf¥upgrade86to90¥notification.xml

ファイル: manager_alerts_registration.xml

場所: Marketing Platform インストール済み環境の conf ディレクトリー

目的: アラート・メニュー項目を作成する構成プロパティーのインポート

configTool.bat -i -o -p "Affinium|suite|uiNavigation|alerts -f C:¥Unica¥Platform¥conf¥manager_alerts_registration.xml

ファイル: disablePageTagging.xml

場所: Marketing Platform インストール済み環境の conf¥upgrade82to85 ディレクトリー

目的: IBM® が、製品の全体的な使用傾向を記録する基本的な統計を収集できるかどうかを決定する構成プロパティーのインポート

configTool.bat -i -o -p "Affinium|suite" -f C:¥Unica¥Platform¥conf¥upgrade82to85¥disablePageTagging.xml

ファイル: coremetrics_configuration.xml および coremetrics_navigation.xml

場所: Marketing Platform インストール済み環境の conf ディレクトリー

目的: IBM® Digital Analytics でのシングル・サインオンに必要な構成プロパティーのインポート

configTool.bat -i -o -p "Affinium" -f C:¥Unica¥Platform¥conf¥coremetrics_configuration.xml

configTool.bat -i -o -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f C:¥Unica¥Platform¥conf¥coremetrics_navigation.xml

ファイル: coremetrics_configuration.xml および coremetrics_navigation.xml

場所: Marketing Platform インストール済み環境の conf ディレクトリー

目的: IBM® Digital Analytics でのシングル・サインオンに必要な構成プロパティーのインポート

configTool.bat -i -o -p "Affinium" -f C:¥Unica¥Platform¥conf¥coremetrics_configuration.xml

configTool.bat -i -o -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f C:¥Unica¥Platform¥conf¥coremetrics_navigation.xml

12.	alertConfigTool ユーティリティーを使用し、次のようにして、Marketing Platform のアラートと通知を登録します。

alertConfigTool ユーティリティーは、Marketing Platform インストール済み環境の tools¥bin ディレクトリーにあります。

このユーティリティーを tools¥bin ディレクトリーから実行します。このとき、Marketing Platform インストール済み環境の conf ディレクトリーにある Platform_alerts_configuration.xml ファイルを参照します。

コマンド例 (Windows): alertConfigTool.bat -i -f C:¥Platform¥conf¥Platform_alerts_configuration.xml

13.	ダッシュボードをアップグレードするために、Marketing Platform インストール済み環境の tools¥bin ディレクトリーにある upgrade85Dashboard スクリプトを実行します。

14.	以下に従って、「ヘルプ」>「バージョン情報」ページを更新します。

a.	configTool ユーティリティーを使用して、「Affinium \| Manager \| about」カテゴリーをエクスポートします (このカテゴリーは非表示としてマークされているため、「構成」ページには表示されません)。

例 (Windows™): configTool.bat -x -p "Affinium|Manager|about" –f C:¥Unica¥Platform¥conf¥about.xml

b.	以下のように、直前で作成したエクスポート XML ファイル (例の about.xml) を編集して、バージョン番号および表示名を変更します。

releaseNumber プロパティーを見つけ、値を Marketing Platform の現行バージョンに変更します。以下の例の 8.0.0 をご使用の新規バージョンに変更します。

<displayNameKey>about.releaseNumber</displayNameKey>

</property>

c.	configTool ユーティリティーを使用して、変更されたファイルをインポートします。 –o オプションを使用して、ノードを上書きする必要があります。インポートする際には親ノードを指定する必要があります。

例 (Windows™): configTool.bat –i –p "Affinium|Manager" –f "about.xml" -o

15.	IBM Marketing Platform の配置の章の説明に従って、インストール済み環境を配置して、検証します。

IBM® EMM アプリケーションをアップグレードした後、「IBM® EMM Reports インストールおよび構成ガイド」を参照して、レポート作成をアップグレードするために必要な追加の手順を実行してください。