このセクションでは、アップグレードプロセスの詳細なチュートリアルと、競合を識別して解決する手順を説明します。
ビルドのアップグレードは慎重におこなう必要があります。必ず事前にアップグレードが及ぼす影響を検討し、作業は高度なスキルを備えた人が実行するようにしてください。アップグレードを正常に完了するために、後述の手順を実行する人はエキスパートユーザーに限定してください。また、アップグレードを開始する前に Adobe カスタマーサポートに連絡することを強くお勧めします。
アップグレードの前提条件は以下のとおりです。
詳しくは、次の節を参照してください。Adobe Campaignを更新中、新しいバージョンに移行中です。
ホストされているインスタンスおよびハイブリッドインスタンスの場合、アドビのテクニカルオペレーションチームにビルドのアップグレードをリクエストする必要があります。詳しくは、このページの下にあるよくある質問の節を参照してください。ビルドアップグレードFAQも参照してください。
ビルドアップグレードを開始する前に、以下の説明に従って完全な準備を行う必要があります。
システムのアップグレード準備が整ったら、ビルドのアップグレードには少なくとも 2時間かかります。
ビルドのアップグレードをおこなうには、以下のリソースが必要です。
ビルドのアップグレードを計画する際に重要なポイントを紹介します。
ビルドのアップグレードプロセスには、次の担当者が関与する必要があります。
Adobeアーキテクト:ホストアーキテクチャまたはハイブリッドアーキテクチャの場合、アーキテクトはAdobe CampaignのClientCareと連携する必要があります。
プロジェクトマネージャー:
オンプレミスインストールの場合:お客様の社内プロジェクトリーダーは、アップグレードをリードし、ライフサイクルテストを管理します。
ホストインストールの場合:ホスティングチームは、Adobe CampaignのClientCareチームおよびお客様と提携して、すべてのインスタンスのアップグレードの日程を調整します。
Adobe Campaign 管理者::
オンプレミスインストールの場合:管理者がアップグレードを実行します。
ホストインストールの場合:ホスティングチームがアップグレードを実行します。
Adobe Campaign演算子\マーケティングユーザー:演算子は、開発、テストおよび実稼働のインスタンスに対してテストを実行します。
ビルドアップグレードを開始する前に、オンプレミスのお客様は次の準備を行う必要があります。
アップグレード前にすべての開発作業がエクスポート(パッケージとしてエクスポート)可能であることを確認する。
移行元の環境と移行先の環境のすべてのインスタンスについてデータベースの完全バックアップを作成する。
サーバー構成ファイルの最新バージョンを取得します。
また、ビルドのアップグレードを開始する前に、役に立つすべてのコマンドラインを知っておく必要があります。
以下の手順は、オンプレミスのお客様のみが実行します。 ホスト版のお客様については、ホスティングチームがこの作業を実行します。Adobe Campaignを新しいビルドに更新するには、詳細な手順を以下に説明します。
ここでは、Adobe Campaign の環境を複製する方法を説明します。これにより、移行元の環境が移行先の環境に復元され、同一の作業環境が 2 つになります。
これをおこなうには、以下の手順に従います。
移行元となる環境に含まれているすべてのインスタンス上にあるデータベースのコピーを作成します。
作成したコピーを、移行先となる環境のすべてのインスタンス上に復元します。
起動する前に、ターゲット環境でnms:freezeInstance.jsの焼灼スクリプトを実行します。 これにより、外部との対話をすべてのプロセスが停止します。ログ、トラッキング、配信、キャンペーンワークフローなど
nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run
次に示すように、注意を確認します。
唯一の配信部分が0に設定されたIDであることを確認します。
SELECT * FROM neolane.nmsdeliverypart;
配信ステータスが正しく更新されていることを確認します。
SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd;
ワークフローのステータスが正しく更新されていることを確認します。
SELECT iState, count (*) FROM neolane.xtkworkflowGROUP BY iState;
SELECT iStatus, count (*) FROM neolane.xtkworkflowGROUP BY iStatus;
すべてのファイルを新しいバージョンで置き換えるために、nlserverservice のすべてのインスタンスをシャットダウンする必要があります。
以下のサービスをシャットダウンします。
IIS で使用されている nlsrvmod.dll ファイルを新しいバージョンで置き換えることができるように、リダイレクションサーバー(webmdl)が停止したことを確認してください。
nlserver pdump コマンドを実行してアクティブなタスクがないことを確認します。タスクがない場合、出力は次のようになります。
C:\<installation path>\bin>nlserverpdump HH:MM:SS > Application Server for Adobe Campaign version x.x (build xxx) dated xx/xx/xxxx No tasks
Windowsタスクマネージャーで、すべてのプロセスが停止したことを確認します。
Setup.exeファイルを実行します。 このファイルをダウンロードする必要がある場合は、ダウンロードセンターにアクセスしてください。
インストールモードを選択します。アップデートまたは修復。
「次へ」をクリックします。
「完了」をクリックすると、インストールプログラムによって新しいファイルがコピーされます。
処理が完了したら「完了」をクリックします。
コマンドラインを開きます。
nlserver config -postupgrade -allinstances を実行して以下の作業をおこないます。
この操作は、nlserverwebアプリケーションサーバー上でのみ実行する必要があります。
1つのデータベースのみを同期するには、次のコマンドを実行します。
nlserver config -postupgrade -instance: <instance_name>
同期でエラーまたは警告が生成されたかどうかを確認します。
以下のサービスを再起動する必要があります。
クライアントコンソールは、サーバーインスタンスと同じビルド上にある必要があります。
Adobe Campaign アプリケーションサーバーがインストールされているマシン(nlserverweb)で、以下のファイルをダウンロードしてインストールします。
Setup-client-7.xxxx.exe in [path of the application]\datakit\nl\en\jsp
次回クライアントコンソールに接続したときに、ウィンドウが開いて新しい更新が利用可能なことを知らせるメッセージが表示され、その更新をダウンロードしてインストールするよう促されます。
一部の設定では、新しいビルドに更新するために特定の追加タスクが必要です。
キャンペーンインスタンスでトランザクションメッセージング(Message Center)が有効になっている場合、次の追加手順を実行してアップグレードする必要があります。
Message Center の本番サーバーを、選択したバージョンに更新します。
ポストアップグレードスクリプトを実行します。
テストを実行して E メールが Message Center の本番用インスタンスを通じて正常に受信されることを確認します。
クライアントをアップグレードし、キャッシュをクリアします。
パッケージをエクスポートします。
Message Center テンプレートをパブリッシュして、サーバーと Message Center インスタンス間のインターフェイスが機能していることを確認します。
テストを実行して、Message Center実稼働インスタンスを通じて電子メールが正常に受信されたことを確認します。
本番環境でワークフローのテストを実行して、配信が受信されることを確認します。
ミッドソーシング環境のコンテキストで、次の追加手順を実行してアップグレードする必要があります。
Adobeカスタマーケアに連絡して、ミッドソーシングサーバーのアップグレードを調整してください。
テストリンクを実行して、バージョンが更新されたことを検証します。 例:
http://[InsertServerURL]/r/test
ミッドソーシングサーバーは、常に、マーケティングサーバーと同じバージョン(または最新のバージョン)を実行する必要があります。
同期結果を確認する必要があります。 ここで紹介する手順はオンプレミス版のお客様のみを対象にしています。ホスト版のお客様については、ホスティングチームがこの作業を実行します。同期結果の表示方法は 2 つあります。
コマンドラインインターフェイスでは、エラーはトリプルシェブロン'>>'によって実現され、同期は自動的に停止します。 警告は、重複の山形「>>」によって実現され、同期が完了したら解決する必要があります。 ポストアップグレードの最後に概要がコマンドプロンプトで表示されます。以下はその一例です。
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log =========Summary of the update==========
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'mobileAppDeliveryFeedback' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'opensByUserAgent' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log The document with identifier 'deliveryValidation' and type 'nms:webApp' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log Document of identifier 'nms:includeView‘ and type 'xtk:srcSchema' updated in the database and found in the file system. You will have to merge the two versions manually.
リソースの競合に関する警告は、見落とさないように注意して、解決してください。
postupgrade_ServerVersionNumber_TimeOfPostupgrade.logファイルには、同期結果が含まれています。 デフォルトでは、次のディレクトリで使用できます。installationDirectory/var/instanceName/postupgrade. エラーと警告はそれぞれエラーと警告の属性で明示されます。
競合を見つける方法
競合は、該当するキャンペーンのpostupgrade.log内、またはサーバークライアントインターフェイス内(管理/設定/パッケージ管理/競合を編集)で見つかります。
The document with identifier ‘stockOverview’ and type ‘nms:webApp’ is in conflict with the new version.
競合が見つかった場合は、以下の条件に該当するかを確認します。
どちらにも該当しない場合は、誤検出です。どちらにも該当する場合は、実際に競合が存在します。
お客様が変更したオブジェクトかどうかの確認
新しいビルドで変更されたオブジェクトかどうかの確認
競合を解決するには、次の手順に従います。
Adobe Campaign エクスプローラーで管理/設定/パッケージ管理/競合を編集に移動します。
リストから解決する競合を選択します。競合を解決するには、次の3つの方法があります。新しいバージョンを受け入れ、現在のバージョンを保持、コードを結合し(解決済みとして宣言)、競合を無視する(非推奨)。
新しいバージョンを承認できるケース
現在のバージョンを維持できるケース
結合を実行するケース
競合を放置した場合
競合は解決することを強くお勧めします。
結合には様々なタイプがあります。
手動で競合を解決する場合の手順は以下のとおりです。
以下は高度な結合を実行する際の手順です。
複雑な結合を実行するには、開発スキルが必要です。
関連トピック