手順: Marketing Operations の高速アップグレード

Marketing Operations のアップグレード前

このタスクについて

注:

JBOSS + 11.1 にアップグレードする既存の顧客は、次の手順を実行する必要があります。
- すべてのユーザーの最新項目リストを消去します。注: 管理者: JBOSS に移行する前に、それぞれの最新項目を消去するすべてのユーザーに通知してください。
- ディレクトリー <plan_home>/recentdata を消去します。
- JBOSS + 11.1 に移行します。
新規顧客で JBOSS + 11.1 をインストール中の場合は、何も変更する必要はありません。この場合、最新項目は存在しないからです。
新規顧客で JBOSS + 11.1 をインストール中の場合は、何も変更する必要はありません。この場合、最新項目は存在しないからです。

手順

古いバージョンの Marketing Operations システム・テーブルのバックアップを、クリーン 11.1 環境で使用されるシステム・テーブル・スキーマにインポートします。
ソースと宛先の次のフォルダーのファイル・システム・バックアップを作成します。
「MarketingOperations_HOME/ accountattachments」ディレクトリー。

「MarketingOperations_HOME/ approvalitems」ディレクトリー。

「MarketingOperations_HOME/ assets」ディレクトリー。

「MarketingOperations_HOME/ componentattachments」ディレクトリー。

「MarketingOperations_HOME/ images」ディレクトリー。

「MarketingOperations_HOME/ invoiceattachments」ディレクトリー。

「MarketingOperations_HOME/ planattachments」ディレクトリー。

「MarketingOperations_HOME/ programattachments」ディレクトリー。

「MarketingOperations_HOME/ projectattachments」ディレクトリー。

「MarketingOperations_HOME/ templates」ディレクトリー。
11.1 で、ステップ 2 で示したすべてのファイルを、ソース・フォルダーから宛先の Marketing Operations の各フォルダーにコピー/マージします。
11.1 環境で「MarketingOperations_HOME/ conf/ plan_log4j.xml」および「MarketingOperations_HOME/ conf/ plan_ehcache.xml」もソースから宛先の各フォルダーにコピーします。
宛先サーバーでパス「<PLAN_HOME>\messages\com\ibm\umo\」に新しいフォルダー ext_data を作成します。
宛先のこの新しいフォルダーには、新しくインストールした 11.1 の <UMOConfigurationMessages_<locale>.properties > ファイルを格納します。
注: この手順は、バージョン 11.0 からバージョン 11.1 への高速アップグレードには適用されません。
11.1 環境で <UMOConfigurationMessages_<locale>.properties> および <UMOMktObjectConfigurationMessages_<locale>.properties> をソース「MarketingOperations_Home/messages/com/ibm/umo/ext」フォルダーから各宛先フォルダー (MarketingOperations_Home/messages/com/ibm/umo/ext ) にコピーします。
注: この手順は、バージョン 11.0 からバージョン 11.1 への高速アップグレードには適用されません。
ソース・セットアップにマーケティング・オブジェクトがある場合、<MarketingOperations_Home>/conf/en_US 内の
mo_creatives_state.xml、globalstates.xml、sysmenu.xml、および sysmodules.xml をソースから 11.1 にコピーします。
Marketing Operations をインストールし、手動データベースを選択した場合、この手順を実行します。自動データベースを選択した場合、この手順は無視してください。
1. Marketing Operations を登録解除します - ./configTool.sh -u Plan
2. 8.6 構成に登録します (8.6 は既存のソース・バージョンに置き換えてください):
  ./configTool.sh -r Plan -f "MarketingOperations_Home/conf/plan_registration.xml"
  
  次のコマンドを使用します。
  
  ./configTool.sh -vp -p "Affinium" -f“MarketingOperations_Home/conf /plan_registration.xml"
- 次の JVM パラメーターが存在することを確認してください。存在しない場合、追加します。
  - -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector
  - -Dlog4j2.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml
  - -Dlog4j.configuration=file:/// <Plan_home>\conf\plan_log4j_1x.xml
  注:
  - plan_log4j.xml とは別に plan_log4j11.1.xml ファイルがある場合、plan_log4j11.1.xml を使用します。
  - Dlog4j2.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml 設定で、plan_log4j.xml をカスタマイズし、組織に合うように変更を行った場合、配置した Dlog4j2.configurationFile に従い、ここに示されている plan_log4j.xml でそれらの設定を行ったことを確認します。plan_log4j11.1.xml ファイルを使用している場合、そのファイルで変更を行います。
  - Windows では、パスにバックスラッシュが含まれます。それに対し、UNIX ではスラッシュを含む必要があります。

Marketing Operations のアップグレード

JDBC ファイルの更新

このタスクについて

11.1 クリーン・インストールに使用された Plan スキーマを再使用せず、別のユーザー・スキーマを使用する場合、以下の追加手順に従います。

手順

11.1 環境の jdbc.properties ファイル (MarketingOperations/tools/bin /umo_jdbc.properties) をバックアップします。umo_jdbc.properties ファイルで、11.1 Platform システム・データベースのユーザー名/スキーマ名を更新します。
umo_jdbc.properties の例:
# Name:

#umo_data_source.url

# Description:

#URL reference for the IBM Marketing Operations system table database.

#

# Example values for supported databases are:

#

# SQL Server:

#jdbc:sqlserver://sqlserverHost:1433;databaseName=databaseName

# IBM DB2:

#jdbc:db2://db2Host:50000/databaseName

# Oracle:

#jdbc:oracle:thin:@oracleHost:1521:databaseName

umo_data_source.url=jdbc:oracle:thin:@<databaseHostName>:1521:<sid>

# Name:

#umo_data_source.login

# Description:

#Name of login for IBM Marketing Operations database-

#login account must have database administrative rights.

# Name of login for IBM Marketing Operations database.

#login account must have database administrative rights.

umo_data_source.login=xmsp

# Name:

#umo_data_source.password

#Description:

#Password for IBM Marketing Operations database

#for login id provided in umo_data_source.login property

umo_data_source.password=ENC(+1Kd731xEuzqdDfqjQ9wnw==)
注: Platform と Marketing Operations で同じユーザーを使用した場合、Platform/tools/bin/jdbc.properties ファイルから暗号化されたパスワードを取得できます。
MarketingOperations_Home/tools/bin 内の setenv.bat ファイルを更新して、パラメーター DBDRIVER_CLASSPATH に対して正しい DB ドライバー・パスを使用します。

11.1 構成へのアップグレード

このタスクについて

注: この手順は、バージョン 11.0 からバージョン 11.1 への高速アップグレードには適用されません。

手順

8.6 plan_registration.xml をソースから各宛先の UMO_HOME\conf フォルダーにコピーします。(8.6 は既存のソース・バージョンに置き換えてください。)
Platform_Home/tools/bin で以下のコマンドを実行します:
./configTool.sh -vp -p "Affinium|Plan|umoConfiguration" -f MarketingOperations_Home/conf/plan_approvals_settings_10.0.0.2.xml"
./configTool.sh -vp -p "Affinium|Plan|umoConfiguration" -f MarketingOperations_Home/conf/plan_workflowservice_settings_10.0.0.2.xml"
MarketingOperations_Home/tools/bin で config_migration.sh を実行します。
前提条件: config_migration.sh ファイルで UMO_HOME を設定/更新します。
./config_migration.sh -p MarketingOperations_Home -b 8.6.0.0. (8.6 は既存のソース・バージョンに置き換えてください。)
次のコマンドを実行して encodeCSV 機能を有効にします:
configTool -vp -p "Affinium|Plan|umoConfiguration" -f MarketingOperations_Home\conf\Plan_encodeProperty_11.1.xml

Marketing Operations データベースのアップグレード

手順

11.1 Marketing Operations のフレッシュ・インストールを含む VM のソース・システム・テーブルを格納するデータベースをインポートします。
1. tools/bin から umouilistupgrade ユーティリティーを実行して、8.6 と 11.1 の UMOConfigurationMessages_<locale>.properties と UMOMktObjectConfigurationMessages_<locale>.properties をマージします。
  このユーティリティーにはパラメーターはありません: umouilistupgrade.bat
2. umodbsetup ユーティリティーを実行してデータベースを 11.1 にアップグレードします:
  umodbsetup.bat –t upgrade –m –b 8.6 –L en_US
  (コマンド・プロンプトで上記のコマンドを入力します。コピーして貼り付けると、エラーが発生することがあります。)
3. 次のコマンドを実行します: umodbsetup.bat –t upgrade –b 8.6
  このコマンドが動作しない場合、MO データベースで umo_upgrade_[8.6.0.0.0]_[11.1.0.0].sql ファイルを実行できます。このファイルは MarketingOperations_Home\tools にあります。注: 8.6 は既存のソース・バージョンに置き換えてください。

Marketing Operations のアップグレード後

Marketing Operations の構成の変更

このタスクについて

MarketingOperations 11.1.0 war を配置し、次の手順に従い Marketing Operations の Java アップグレードを実行します。

注:

log4j のアップグレードについて

11.1 より前、Plan ソースでは log4j1x API が使用されていました (このために使用されていた構成ファイルは plan_log4j.xml でした)。

11.1 の場合

Plan ソースでは log4j2x API が使用されています (このために使用される構成ファイルは、フレッシュ・インストールの場合は plan_log4j.xml であり、アップグレードの場合は plan_log4j.11.1.xml です)。
Plan JVM 内の unica_common.jar では、log4j1x API がまだ使用されています。これは、(結果として unica_common になる) Platform ソースが log4j2x を使用するように変更されていないためです。

したがって、log4j1x 構文に準拠した plan_log4j_1x.xml も追加で提供しています。このファイルは、MO のソース・コードでは使用されません。

11.1 の場合

log4j1x 設定に関連する既存のシステム・プロパティーは使用しないでください。代わりに、新しい追加のシステム・プロパティーを使用してください。

手順

管理ユーザーとしてログインします。
(Affinium|Plan|umoConfiguration) で、以下にリストされているノードの場所を更新します:
templates
attachmentFolders
integrationServices
Affinium|Plan|umoConfiguration|notifications で notifyPlanBaseURL を更新します。
Affinium|Plan|navigation で serverURL を更新します。
新しいアプリケーション URL が古いアプリケーション URL と異なる場合、MO データベースに接続し、UAP_WS_ALERTS テーブルにアクセスする必要があります。このテーブル内のレコードに、アップグレード前のアプリケーション URL が含まれている場合があります。このテーブルを更新し、古いアプリケーション URL を新しいアプリケーション URL に置き換える必要があります。
アプリケーション・サーバーを再始動します。
「設定」->「Marketing Operations」->「Marketing Operations のアップグレード」に移動します。
すべてのチェック・ボックスにチェック・マークを付けます。
「アップグレード」ボタンをクリックします。

Marketing Operations の設定 – ヘルプの「バージョン情報」>「バージョン」

このタスクについて

Marketing Platform の登録で Marketing Operations のバージョンを変更します。

手順

クリーン 11.1 環境で次のコマンドを使用してバージョン構成をエクスポートします:
configTool.sh -x -p "Affinium|Plan|about" -f <PLATFORM_HOME>/conf/plan_about.xml
上記のコマンドで生成された plan_about.xml ファイルを編集します。バージョンを 11.1.0.0.GA_BUILD に変更します。
<property id="xxxxxx" name="releaseNumber" type="string_property" width="40">

<value>11.1.0.0.GA_BUILD</value>

</property>
次のコマンドを使用して、編集したこの xml ファイルをインポートします:
configTool.sh -v -i -o -p "Affinium|Plan" -f <PLATFORM_HOME>/conf/plan _about.xml

Marketing Operations のアップグレード後の機能チェック

このタスクについて

Marketing Operations アプリケーションで UAT を実行します。すべての計画、プログラム、プロジェクト、タスク、承認が開くこと、およびデータが正常にインポートされることを確認します。すべての構成ノードが使用可能かどうか確認します。