手動マイグレーションによるバージョン 8.5.x からのアップグレード

Marketing Platform アップグレード・インストーラーにより、アップグレードに必要なすべてのデータ・マイグレーションを自動的に実行できます。ただし、組織のポリシーで自動的なマイグレーションが許可されない場合、Marketing Platform を手動でアップグレードするためのマイグレーション手順を実行する必要があります。Marketing Platform バージョン 9.1 に手動でアップグレードする場合、特定の SQL スクリプトを実行し、必要な構成プロパティーを挿入する必要があります。

同じディレクトリー内に以下のインストーラーがあることを確認します。

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

Marketing Platform インストーラー

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

populateDb ユーティリティー

configTool ユーティリティー

alertConfigTool ユーティリティー

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

1.	以下のステップを実行して、バージョン 8.5.0 から手動でアップグレードしてください。

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

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

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

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

IBM® EMM マスター・インストーラーが開始します。 IBM® EMM マスター・インストーラーの開始後は、以下の指示に従います。

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

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

IBM® EMM マスター・インストーラーが一時停止し、Marketing Platform インストーラーが開始します。

5.	Marketing Platform インストーラーの実行中に、以下のステップを実行します。

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

b.	インストーラーが、Marketing Platform の前のインストール済み環境のバックアップ・コピーを作成することを許可します。

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

d.	「Platform の構成の実行」チェック・ボックスをクリアします。

e.	インストール・ウィザードの残りのステップに従い、要求される情報を入力します。

6.	次の表を使用して、新しい Marketing Platform インストール済み環境に用意されている SQL スクリプトのうち、Marketing Platform システム・テーブル・データベースに対応しているものを見つけます。

バージョン 8.5.x からのアップグレード用のスクリプト
スクリプト名	場所
ManagerSchema_DB_Type_86upg.sql DB_Type は、システム・テーブル・データベースのデータベース・タイプです。	db¥upgrade85to86
active_portlets.sql	db
ManagerSchema_DB_Type_90upg.sql DB_Type は、システム・テーブル・データベースのデータベース・タイプです。	db¥upgrade86to90
ManagerSchema_DB_Type_91upg.sql または ManagerSchema_DB_Type_91upg_unicode.sql DB_Type は、システム・テーブル・データベースのデータベース・タイプです。	db¥upgrade90to91

7.	以下のいずれかのコマンドを実行します。

Windows™ の場合:

installation_directory¥platform¥tools¥bin¥upgrade90to91.bat

Unix の場合:

installation_directoryplatform/tools/bin/upgrade90to91.sh

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

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

例: populateDb -n Manager

9.	次の表の説明に従い、configTool ユーティリティーを使用して構成プロパティーをインポートします。

configTool ユーティリティーは、Marketing Platform インストール済み環境の tools/bin ディレクトリー内にあります。構成プロパティーの機能について詳しくは、「構成」ページのオンライン・ヘルプか、「IBM® Marketing Platform 管理者ガイド」を参照してください。

次の表に示されるコマンド例は、Windows™ オペレーティング・システムを対象とするものです。

バージョン 8.5.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 -i -p "Affinium|suite|security|loginModes|LDAPPartitionLogin" -f C:\Unica\Platform\conf\upgrade85to86\LDAP_Anonymous_bind.xml

ファイル: quicklinks_category.xml

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

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

configTool.bat -i -o -p "Affinium|suite" -f "C:¥Unica¥Platform¥conf¥upgrade86to90¥quicklinks_category.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"

ファイル: scheduler.xml

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

目的: boolean プロパティーによる、Marketing Platform のスケジューラー機能の有効化または無効化。

configtool -i -p "Affinium|suite|scheduler" -f "C:¥Unica¥Platform¥conf¥upgrade90to91¥scheduler.xml"

ファイル: unknownPolling.xml

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

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

configtool -i -p "Affinium|suite|scheduler" -f "C:¥Unica¥Platform¥conf¥upgrade90to91¥unknownPolling.xml"

ファイル: communication_email.xml

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

目的: E メール通知を有効にするための構成プロパティーのインポート。有効にすると、Marketing Platform はユーザーに対するシステム・アラートおよび通知の E メールによる送信を試みます。

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

ファイル: notification.xml

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

目的: 通知機能のための構成プロパティーのインポート。以下のプロパティーが追加されます。

アラートを保存する日数 - 90

E メールを送信する頻度 (分単位) - 30

E メールの送信の最大再試行回数 - 1

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

ファイル: is_clustered.xml

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

目的: boolean プロパティーによる、Marketing Platform インスタンスがクラスター化されるかどうかの指定。クラスター化された配置に Marketing Platform をインストールする場合は、このプロパティーを True に設定します。それ以外の場合は、デフォルト値である False を保持します。

configtool -i -p "Affinium|suite" -f "C:¥Unica¥Platform¥conf¥upgrade90to91¥is_clustered.xml"

ファイル: taskNotification.xml

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

目的: スケジュールされた通知を受けるグループを入力する「グループ名」フィールドのインポート。

ファイル: config_data_filter_cache.xml

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

目的: データ・フィルター・キャッシュを構成可能にする。構成プロパティーが True に設定されている場合、パフォーマンス強化のためにデータ・フィルター・キャッシュが有効化されます。構成プロパティーが False に設定されている場合、キャッシングは有効化されず、すべての操作は、データ・フィルター要求ごとにデータベースに接続することによって実行されます。構成プロパティーは、ユーザー・インターフェースに表示されます。

configTool.bat -vp -p "Affinium|Manager|datafiltering" -f "C:¥Unica¥Platform¥conf¥upgrade90to91¥ Config_data_filter_cache.xml"

この値を変更した場合、Marketing Platform を再始動して、その変更を有効にする必要があります。

ファイル: Refresh_data_filter_cache.xml

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

目的: データ・フィルター・キャッシングを有効にしたときに、この構成プロパティーにより、データ・フィルター定義が変更される都度キャッシュを確実にリフレッシュする。

configTool.bat -vp -p "Affinium|Manager|datafiltering" -f "C:¥Unica¥Platform¥conf¥upgrade90to91¥ Refresh_data_filter_cache.xml"

ファイル: navigation.xml および emm_spss_configuration.xml

場所: conf¥upgrade90to91

目的: IBM® SPSS® Modeler Advantage Marketing Edition 構成プロパティーのインポート。

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

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

10.	Marketing Platform インストール済み環境の tools¥bin ディレクトリーで alertConfigTool ユーティリティーを実行し、Marketing Platform アラートおよび通知を登録します。

コマンド例 (Windows™):

alertConfigTool.bat -i -f "C:¥Platform¥conf¥Platform_alerts_configuration.xml"

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

12.	「ヘルプ」>「バージョン情報」と移動して、以下のステップを実行し、「バージョン情報」ページを更新します。

a.	configTool ユーティリティーを使用して、「Affinium \| Manager \| about」カテゴリーをエクスポートします。

「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 を、ご使用の新しいバージョンに変更します。

<property name="releaseNumber" type="string">
<displayNameKey>about.releaseNumber</displayNameKey>
<value>9.1.0.0.0.build_number</value>
</property>

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

例 (Windows™):

configTool.bat -i -p "Affinium|Manager" -f "about.xml" -o

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

アップグレード・プロセスが成功し、アプリケーションが稼働中になったら、drop-liferay-tables.sql スクリプトを使用して liferay テーブルを削除します。 drop-liferay-tables.sql は、Platform_installation/db/upgrade86to90/drop-liferay-tables.sql ディレクトリー内にあります。

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