手動マイグレーションによるバージョン 9.0 からのアップグレード
Marketing Platform アップグレード・インストーラーにより、アップグレードに必要なすべてのデータ・マイグレーションを自動的に実行できます。ただし、組織のポリシーで自動的なマイグレーションが許可されない場合、Marketing Platform を手動でアップグレードするためのマイグレーション手順を実行する必要があります。
始める前に
同じディレクトリー内に以下のインストーラーがあることを確認します。
- IBM® マスター・インストーラー
- Marketing Platform インストーラー
Marketing Platform バージョン 11.1.0 に手動でアップグレードする場合、SQL スクリプトを実行し、コマンド・ライン・ユーティリティーをいくつか実行してシステム・テーブルにデータを設定する必要があります。Marketing Platform のインストール済み環境が正常に機能し、ユーティリティーを実行できることを確認してください。これらのユーティリティーの使用に関する詳しい情報 (共通タスクのコマンド例を含む) は、以下のトピックで参照できます。
ユーティリティーは、Marketing Platform インストール済み環境の下の tools\bin ディレクトリーにあります。
他のバージョンからのアップグレードに関する情報は、Marketing Platform のアップグレード・シナリオを参照してください。
手順
- Marketing Platform システム・テーブル・データベースのバックアップ・コピーを作成します。 重要: このステップはスキップしないでください。アップグレード操作が失敗した場合、データベースをロールバックすることはできず、データが破損します。
- Marketing Platform 配置を配置解除します。
- IBM Marketing Software マスター・インストーラーを実行します。 IBM Marketing Software マスター・インストーラーが開始します。IBM Marketing Software マスター・インストーラーの開始後は、以下の指示に従います。
- インストール・ディレクトリーの選択を求めるプロンプトが IBM Marketing Software マスター・インストーラーから出されたら、ルート・インストール・ディレクトリーを選択します (このルート・ディレクトリーの下にある Marketing Platform インストール・ディレクトリーではありません)。
- Marketing Platform データベース接続情報の入力を求めるプロンプトが IBM Marketing Software マスター・インストーラーから出されたら、現行の Marketing Platform システム・テーブルに関する情報を入力します。
IBM Marketing Software マスター・インストーラーが一時停止し、Marketing Platform インストーラーが開始します。
- Marketing Platform インストーラーの実行中に、以下のステップを実行します。
- インストール・ディレクトリーを求めるプロンプトが Marketing Platform インストーラーから出されたら、現行の Marketing Platform インストールのディレクトリー (通常 Platform という名前) を選択します。
- インストーラーが、Marketing Platform の前のインストール済み環境のバックアップ・コピーを作成することを許可します。
- 「手動データベース・セットアップ」を選択します。
- 「Platform の構成の実行」チェック・ボックスをクリアします。
- インストール・ウィザードの残りのステップに従い、要求される情報を入力します。
- システム・テーブルに対して以下のスクリプトを実行します。 DB_Type は、データベースのタイプです。
表 1. バージョン 9.0 からアップグレードするための SQL スクリプト ファイル詳細 ファイルの場所 ManagerSchema_DB_Type_91upg.sql Marketing Platform インストール済み環境の db\upgrade90to91 ディレクトリー ManagerSchema_DB_Type_911upg.sql Marketing Platform インストール済み環境の db\upgrade91to911 ディレクトリー ManagerSchema_DB_Type_10upg.sql Marketing Platform インストール済み環境の db\upgrade912to10 ディレクトリー DB_Type_QRTZ_Scheduler_10_upgrade_Script.sql Marketing Platform インストール済み環境の db\upgrade912to10 ディレクトリー ManagerSchema_DB_Type_10002upg.sql Marketing Platform インストール済み環境の db\upgrade10001to10002 ディレクトリー ManagerSchema_DB_Type_101upg.sql Marketing Platform インストール済み環境の db\upgrade10002to101 ディレクトリー ManagerSchema_DB_Type_11upg.sql Marketing Platform インストール済み環境の db\upgrade101to11 ディレクトリー ManagerSchema_DB_Type_111upg.sql Marketing Platform インストール済み環境の db\upgrade1101to111 ディレクトリー - upgrade90to91 バッチまたはシェル・スクリプトを実行します。 これは、Marketing Platform インストール済み環境の tools\bin\upgrade90to91 ディレクトリー内にあります。
- populateDb ユーティリティーを使用して、システム・テーブルにデフォルトの Marketing Platform 構成プロパティー、ユーザーとグループ、およびセキュリティーの役割と権限のデータを設定します。
populateDb ユーティリティーは、Marketing Platform インストール済み環境の tools\bin ディレクトリーにあります。コマンド例: populateDb -n Manager
- 以下の説明に従い、configTool ユーティリティーを使用して構成プロパティーをインポートします。 重要: 次の表に示す順序でインポートを実行します。
表 2. バージョン 9.0.0 からアップグレードするための構成プロパティー ファイル詳細 コマンド例 - ファイル: is_clustered.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade90to91 ディレクトリー
- 目的:Marketing Platform インスタンスがクラスター化されている場合に指定するブール値プロパティー。クラスター化されたデプロイメントに Marketing Platform をインストールする場合、このプロパティーを True に設定します。それ以外の場合、デフォルト値の False のままにします。
configTool.bat -i -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade90to91\is_clustered.xml" - ファイル: taskNotificationNavImport.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade90to91 ディレクトリー
- 目的:「設定」メニュー下の「マイ・ジョブ通知」ナビゲーション・オプションのインポート
configTool.bat -i -p "Affinium|suite|uiNavigation|settingsMenu" -f "C:\Unica\Platform\conf\upgrade90to91\taskNotificationNavImport.xml" - ファイル: taskNotification.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade90to91 ディレクトリー
- 目的: スケジュール通知で通知されるグループを入力できる「グループ名」フィールドのインポート
configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations|
Campaign|flowchart" -f "C:\Unica\Platform\conf\upgrade90to91\
taskNotification.xml"configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations|
Campaign|mailing" -f "C:\Unica\Platform\conf\upgrade90to91\
taskNotification.xml"configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations|
Campaign|optimize" -f "C:\Unica\Platform\conf\upgrade90to91\
taskNotification.xml"configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations|
InteractionHistory|ETL" -f "C:\Unica\Platform\conf\upgrade90to91\
taskNotification.xml"configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations|
AttributionModeler|TrainingRun" -f "C:\Unica\Platform\conf\upgrade90to91\
taskNotification.xml"configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations|
AttributionModeler|ScoringRun" -f "C:\Unica\Platform\conf\upgrade90to91\
taskNotification.xml"- ファイル: cognos.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade90to91 ディレクトリー
- 目的: Cognos バージョンの更新
configTool.bat -i -o -p "Affinium|Report|integrations|cognos10" -f "C:\Unica\Platform\conf\upgrade90to91\cognos.xml" - ファイル: scheduler.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade90to91 ディレクトリー
- 目的: のスケジューラー機能を有効または無効にするブール値プロパティー Marketing Platform
configTool.bat -i -p "Affinium|suite|scheduler" -f "C:\Unica\Platform\conf\upgrade90to91\scheduler.xml" - ファイル: unknownPolling.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade90to91 ディレクトリー
- 目的: クイック・リンク・ダッシュボード・ポートレットのプロパティーのインポート
configTool.bat -i -p "Affinium|suite|scheduler" -f "C:\Unica\Platform\conf\upgrade90to91\unknownPolling.xml" - ファイル: 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"
- ファイル:emm_spss_navigation.xml から emm_spss_configuration.xml
- 場所:Marketing Platform インストール済み環境の conf ディレクトリー
- 目的:IBM SPSS® Modeler Advantage Enterprise Marketing Management Edition 構成プロパティーのインポート
configTool.bat -i -o -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "C:\Unica\Platform\conf\emm_spss_navigation.xml"
configTool.bat -i -o -p "Affinium" -f "C:\Unica\Platform\conf\emm_spss_configuration.xml"
- ファイル: AuditEvents.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade91to911 ディレクトリー
- 目的:IBM Marketing Platform | 監査イベント構成ノードのインポート
configTool.bat -i -p "Affinium|suite" -f C:\Unica\Platform\conf\upgrade91to911\ AuditEvents.xml - ファイル: FederatedAuthentication.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade91to911 ディレクトリー
- 目的:IBM Marketing Platform | セキュリティー | フェデレーテッド認証構成ノードのインポート
configTool.bat -i -p "Affinium|suite|security" -f C:\Unica\Platform\conf\upgrade91to911\ FederatedAuthentication.xml - ファイル: MO_bulk_deactivation_scheduler.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade91to911 ディレクトリー
- 目的: の一括非活動化スケジュール機能の構成ノードのインポート Marketing Operations
configTool.bat -i -p "Affinium|suite|scheduler| taskRegistrations" -f C:\Unica\Platform\conf\upgrade91to911\MO_bulk_deactivation_scheduler.xml - ファイル: emm_audit_navigation.xml
- 場所:Marketing Platform インストール済み環境の conf ディレクトリー
- 目的: 監査イベント・レポートの「分析」>「Marketing Platform」メニュー項目のインポート
configTool.bat -i -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f C:\Unica\Platform\conf\emm_audit_navigation.xml - ファイル: APISecurity.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade911to912 ディレクトリー
- 目的:IBM Marketing Platform | セキュリティー | API 管理 (API management) 構成ノードのインポート。
configTool.bat -i -p "Affinium|suite|security" -f C:\Unica\Platform\conf\upgrade911to912\APISecurity.xml - ファイル: APISecurity.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade912to10 ディレクトリー
- 目的:IBM Marketing Platform | セキュリティー | API 管理 (API management) 構成ノードのインポート。
configTool.bat -vp -p "Affinium|suite|security" -f C:\Unica\Platform\conf\upgrade912to10\APISecurity.xml このバージョンの APISecurity.xml ファイルは、前の行に示しているものとは別のファイルであり、場所も異なることに注意してください。
- ファイル: SAMLAuthentication.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade912to10 ディレクトリー
- 目的:IBM Marketing Platform | セキュリティー | SAML2.0 構成ノードのインポート
configTool.bat -vp -p "Affinium|suite|security" -f C:\Unica\Platform\conf\upgrade912to10\SAMLAuthentication.xml - ファイル: SAMLAuthenticationDetails.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade912to10 ディレクトリー
- 目的:IBM Marketing Platform | セキュリティー | ログイン方法の詳細 | SAML 2.0 構成ノードのインポート
configTool.bat -vp -p "Affinium|suite|security|loginModes" -f C:\Unica\Platform\conf\upgrade912to10\SAMLAuthenticationDetails.xml - ファイル: ExternalScheduler.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade912to10 ディレクトリー
- 目的:IBM Marketing Platform | スケジューラー | スケジュール登録 (Scheduler registrations) | IBM Marketing Platform 構成ノードのインポート
configTool.bat -vp -p "Affinium|suite|scheduler| taskRegistrations" -f C:\Unica\Platform\conf\upgrade912to10\ExternalScheduler.xml - ファイル: JWTAuthentication.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade912to10 ディレクトリー
- 目的:IBM Marketing Platform | セキュリティー | JWT 認証 (JWT authentication) 構成ノードのインポート
configTool.bat -vp -p "Affinium|suite|security" -f C:\Unica\Platform\conf\upgrade912to10\JWTAuthentication.xml - ファイル: SecureSuiteStaticContent.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade912to10 ディレクトリー
- 目的:「IBM Marketing Platform」構成ノードの下の「すべてのアプリケーションの静的コンテンツにセキュリティーを適用」プロパティーのインポート
configTool.bat -vp -p "Affinium|suite" -f C:\Unica\Platform\conf\upgrade912to10\SecureSuiteStaticContent.xml - ファイル: APISecurity_interactCollection.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade10to1001 ディレクトリー
- 目的:IBM Marketing Platform | セキュリティー | API 管理 | IBM Campaign 構成ノードのインポート
configTool.bat -vp -p "Affinium|suite|security|apiSecurity|campaign" -f <Platform_Home>\conf\upgrade10to1001\APISecurity_interactCollection.xml - ファイル: APISecurity_triggeredMessages.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade10to1001 ディレクトリー
- 目的:IBM Marketing Platform | セキュリティー | API 管理 | IBM Campaign 構成ノードのインポート
configTool.bat -vp -p "Affinium|suite|security|apiSecurity|campaign" -f <Platform_Home>\conf\upgrade10to1001\APISecurity_triggeredMessages.xml - ファイル: supportServer_config.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade10to101 ディレクトリー
- 目的:「IBM Marketing Software」構成ノードのインポート
configTool.bat -vp -p "Affinium" -f <Platform_Home>\conf\upgrade10to101\supportServer_config.xml - ファイル: cognos11_integration.xml
- 場所:Marketing Platform インストール済み環境の conf\upgrade101to11 ディレクトリー
- 目的:Affinium | レポート | 統合 | cognos11 構成ノードのインポート
configTool.bat -vp -p "Affinium|Report|integrations" -f <Platform_Home>/conf/upgrade101to11/cognos11_integration.xml - ファイル: watsonAssistant_navigation.xml
- 場所:Marketing Platform インストール済み環境の <PLATFORM_HOME>\conf\watsonAssistant_navigation.xml ディレクトリー
- 目的: Affinium | スイート | uiNavigation | mainMenu | Analytics|
Watson Assistant 構成ノードのインポート
configtool.bat -vp -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "<PLATFORM_HOME>\conf\watsonAssistant_navigation.xml" - 前のステップで構成プロパティーをインポートしたら、変更を適用するために、Marketing Platform を配置した Web アプリケーション・サーバーを再始動してください。
- 以下のステップを実行して、「ヘルプ」>「バージョン情報」ページを更新します。
- configTool ユーティリティーを使用して、「Affinium | Manager | about」カテゴリーをエクスポートします。 注: 「Affinium | Manager | about」カテゴリーは、非表示としてマークされているので、「構成」ページには表示されません。例 (Windows):
configTool.bat -x -p "Affinium|Manager|about" -f "C:\Unica\Platform\conf\about.xml"
- 直前で作成したエクスポート XML ファイル (例の about.xml) を編集して、 バージョン番号および表示名を変更します。
releaseNumber プロパティーを見つけ、 値を Marketing Platform の現行バージョンに変更します。copyright プロパティーの値を該当する著作権の年に変更します。
以下の例では、リリース番号を 9.0.0.0.0 から 11.1.0.0.0 に変更し、著作権を 2019 に変更します。<property name="releaseNumber" type="string"> <displayNameKey>about.releaseNumber</displayNameKey> <value>9.0.0.0.0.build_number</value> </property> </property> <property id="541" name="copyright" type="string_property" width="40"> <value>2016</value> </property>
- configTool ユーティリティーを使用して、変更されたファイルをインポートします。
-o オプションを使用して、ノードを上書きする必要があります。インポートする際には、親ノードを指定する必要があります。
例 (Windows):configTool.bat -vp -i -p "Affinium|Manager" -f "C:\Unica\Platform\conf\about.xml" -o
- configTool ユーティリティーを使用して、「Affinium | Manager | about」カテゴリーをエクスポートします。
- Marketing Platform の配置の説明に従って、インストール済み環境を配置して、検証します。