手動マイグレーションによるバージョン 9.1.1 からのアップグレード
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.1.1 からアップグレードするための SQL スクリプト ファイル詳細 ファイルの場所 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 ディレクトリー - populateDb ユーティリティーを使用して、システム・テーブルにデフォルトの Marketing Platform 構成プロパティー、ユーザーとグループ、およびセキュリティーの役割と権限のデータを設定します。
populateDb ユーティリティーは、Marketing Platform インストール済み環境の tools\bin ディレクトリーにあります。コマンド例: populateDb -n Manager
- 以下の説明に従い、configTool ユーティリティーを使用して構成プロパティーをインポートします。 重要: 次の表に示す順序でインポートを実行します。
表 2. バージョン 9.1.1 からアップグレードするための構成プロパティー ファイル詳細 コマンド例 - ファイル: 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.1.1.0.0 から 11.1.0.0.0 に変更し、著作権を 2018 に変更します。<property name="releaseNumber" type="string"> <displayNameKey>about.releaseNumber</displayNameKey> <value>9.1.1.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 の配置の説明に従って、インストール済み環境を配置して、検証します。