ビルドアップグレードの実行

このセクションでは、アップグレードプロセスの詳細なチュートリアルと、競合を識別して解決する手順を説明します。

ビルドのアップグレードは慎重におこなう必要があります。必ず事前にアップグレードが及ぼす影響を検討し、作業は高度なスキルを備えた人が実行するようにしてください。アップグレードを正常に完了するために、後述の手順を実行する人はエキスパートユーザーに限定してください。また、アップグレードを開始する前に Adobe カスタマーサポートに連絡することを強くお勧めします。

アップグレードの前提条件は以下のとおりです。

• Campaign のアーキテクチャに関する理解
• システムおよびサーバーサイドの知識
• 管理者としての権限とアクセス許可

詳しくは、次の節を参照してください。Adobe Campaignを更新中、新しいバージョンに移行中です。

ホストされているインスタンスおよびハイブリッドインスタンスの場合、アドビのテクニカルオペレーションチームにビルドのアップグレードをリクエストする必要があります。詳しくは、このページの下にあるよくある質問の節を参照してください。ビルドアップグレードFAQも参照してください。

アップグレードの準備

ビルドアップグレードを開始する前に、以下の説明に従って完全な準備を行う必要があります。
システムのアップグレード準備が整ったら、ビルドのアップグレードには​少なくとも 2時間かかります。

ビルドのアップグレードをおこなうには、以下のリソースが必要です。

• Adobeアーキテクト — データベース構造(標準搭載のスキーマ、追加されたその他のスキーマ、キャンペーン設計、および特定の順序で開始およびテストする必要のある重要なパス機能)を理解します。
• プロジェクトマネージャー — ビルドのアップグレードに多数の異なるインスタンス（実稼働、ステージング、テスト）や、他のサードパーティのサーバーおよびアプリケーション(データベース、SFTPサイト、メッセージングサービスプロバイダー)が含まれる場合、ベストプラクティスと見なされます。
• Adobe Campaign 管理者：管理者はセキュリティ、フォルダーの配置、レポート、インポートおよびエクスポートの要件をはじめとするサーバーの設定を把握しています。管理者がいない状況でビルドのアップグレードを実行しないでください。
• Adobe Campaignオペレーター（マーケティングユーザー） — アップグレードを成功させるには、ユーザーが日次タスクを正常に実行できるかどうかに依存します。このため、必ず、アップグレードしたサーバーのテストに日別演算子を少なくとも1つ含めてください。

計画

ビルドのアップグレードを計画する際に重要なポイントを紹介します。

1. アップグレードには、少なくとも 2 時間確保しておく。
2. アドビおよびお客様側担当者の連絡先詳細を配布しておく。
3. ホストインスタンスの場合：Adobeとお客様のスタッフは、アップグレードの時間と実行者を調整します。
4. オンプレミスのインスタンスの場合：お客様側担当者がすべてのプロセスを管理します。カスタマイズされたワークフローや配信ロジックのテスト時にサポートが必要な場合は、コンサルティングサービスを依頼してください。
5. アップグレード先のAdobe Campaignのバージョンを確認し、確認します。Adobe Campaign Classicのリリースノートを参照してください。
6. アップグレードの実行可能ファイルがあることを確認します。

主要人物

ビルドのアップグレードプロセスには、次の担当者が関与する必要があります。

• Adobeアーキテクト：ホストアーキテクチャまたはハイブリッドアーキテクチャの場合、アーキテクトはAdobe CampaignのClientCareと連携する必要があります。

• プロジェクトマネージャー：

  • オンプレミスインストールの場合：お客様の社内プロジェクトリーダーは、アップグレードをリードし、ライフサイクルテストを管理します。

  • ホストインストールの場合：ホスティングチームは、Adobe CampaignのClientCareチームおよびお客様と提携して、すべてのインスタンスのアップグレードの日程を調整します。

• Adobe Campaign 管理者：:

  • オンプレミスインストールの場合：管理者がアップグレードを実行します。

  • ホストインストールの場合：ホスティングチームがアップグレードを実行します。

• Adobe Campaign演算子\マーケティングユーザー：演算子は、開発、テストおよび実稼働のインスタンスに対してテストを実行します。

ビルドのアップグレードの準備

ビルドアップグレードを開始する前に、オンプレミスのお客様は次の準備を行う必要があります。

1. アップグレード前にすべての開発作業がエクスポート（パッケージとしてエクスポート）可能であることを確認する。

2. 移行元の環境と移行先の環境のすべてのインスタンスについてデータベースの完全バックアップを作成する。

3. サーバー構成ファイルの最新バージョンを取得します。

4. 最新のビルドをダウンロードします。詳細情報。

また、ビルドのアップグレードを開始する前に、役に立つすべてのコマンドラインを知っておく必要があります。

• nlserver pdump：実行中のプロセスのリストを表示します
• nlserver pdump -who：アクティブなクライアントセッションのリストを表示します
• nlserver monitor -missing：不足しているプロパティのリストを表示します
• nlserver開始process@instanceName:プロセスの開始
• nlserver stop process@instanceName:プロセスの停止
• nlserver restart process@instanceName:プロセスを再開する
• nlserver shutdown:すべてのキャンペーンプロセスを停止します。
• nlserver watchdog -svc：ウォッチドッグを開始します（UNIX のみ）

アップグレードの実行

以下の手順は、オンプレミス​のお客様のみが実行します。 ホスト版のお客様については、ホスティングチームがこの作業を実行します。Adobe Campaignを新しいビルドに更新するには、詳細な手順を以下に説明します。

環境の重複

ここでは、Adobe Campaign の環境を複製する方法を説明します。これにより、移行元の環境が移行先の環境に復元され、同一の作業環境が 2 つになります。

これをおこなうには、以下の手順に従います。

1. 移行元となる環境に含まれているすべてのインスタンス上にあるデータベースのコピーを作成します。

2. 作成したコピーを、移行先となる環境のすべてのインスタンス上に復元します。

3. 起動する前に、ターゲット環境で​nms:freezeInstance.js​の焼灼スクリプトを実行します。 これにより、外部との対話をすべてのプロセスが停止します。ログ、トラッキング、配信、キャンペーンワークフローなど

   nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run
   

4. 次に示すように、注意を確認します。

   • 唯一の配信部分が​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 のすべてのインスタンスをシャットダウンする必要があります。

1. 以下のサービスをシャットダウンします。

   • Webサービス(IIS):iisreset /stop
   • Adobe Campaignサービス：nlserver6 net stop nlserver6
   メモ

   IIS で使用されている nlsrvmod.dll ファイルを新しいバージョンで置き換えることができるように、リダイレクションサーバー（webmdl）が停止したことを確認してください。

2. 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
   

3. Windowsタスクマネージャーで、すべてのプロセスが停止したことを確認します。

Adobe Campaignサーバーアプリケーションのアップグレード

1. Setup.exe​ファイルを実行します。 このファイルをダウンロードする必要がある場合は、ダウンロードセンターにアクセスしてください。

2. インストールモードを選択します。アップデート​または​修復。

3. 「次へ」をクリックします。

4. 「完了」をクリックすると、インストールプログラムによって新しいファイルがコピーされます。

5. 処理が完了したら「完了」をクリックします。

リソースの同期

1. コマンドラインを開きます。

2. nlserver config -postupgrade -allinstances を実行して以下の作業をおこないます。

   • リソースの同期
   • スキーマの更新
   • データベースの更新
   メモ

   この操作は、nlserverwebアプリケーションサーバー上でのみ実行する必要があります。

   1つのデータベースのみを同期するには、次のコマンドを実行します。

   nlserver config -postupgrade -instance: <instance_name>
   

3. 同期でエラーまたは警告が生成されたかどうかを確認します。

サービスの再起動

以下のサービスを再起動する必要があります。

• Webサービス(IIS):issreset /開始
• Adobe Campaignサービス：net開始nlserver6

クライアントコンソールの更新

クライアントコンソールは、サーバーインスタンスと同じビルド上にある必要があります。

Adobe Campaign アプリケーションサーバーがインストールされているマシン（nlserverweb）で、以下のファイルをダウンロードしてインストールします。

Setup-client-7.xxxx.exe in [path of the application]\datakit\nl\en\jsp

次回クライアントコンソールに接続したときに、ウィンドウが開いて新しい更新が利用可能なことを知らせるメッセージが表示され、その更新をダウンロードしてインストールするよう促されます。

特定の追加タスク

一部の設定では、新しいビルドに更新するために特定の追加タスクが必要です。

トランザクションメッセージ

キャンペーンインスタンスでトランザクションメッセージング(Message Center)が有効になっている場合、次の追加手順を実行してアップグレードする必要があります。

1. Message Center の本番サーバーを、選択したバージョンに更新します。

2. ポストアップグレードスクリプトを実行します。

3. テストを実行して E メールが Message Center の本番用インスタンスを通じて正常に受信されることを確認します。

4. クライアントをアップグレードし、キャッシュをクリアします。

5. パッケージをエクスポートします。

   • クライアントパッケージエクスポートツールを使用したパッケージのエクスポート
   • スキーマパッケージの読み込み
   • クライアントの切断と再接続
   • データベースの更新
   • 切断して再接続
   • 管理パッケージのインポート
   • コンテンツパッケージの読み込み
   • コンテンツ管理パッケージの読み込み
   • 切断して再接続
   • ワークフローのサニティチェックを簡単に実行する

6. Message Center テンプレートをパブリッシュして、サーバーと Message Center インスタンス間のインターフェイスが機能していることを確認します。

7. テストを実行して、Message Center実稼働インスタンスを通じて電子メールが正常に受信されたことを確認します。

8. 本番環境でワークフローのテストを実行して、配信が受信されることを確認します。

ミッドソーシング

ミッドソーシング環境のコンテキストで、次の追加手順を実行してアップグレードする必要があります。

1. Adobeカスタマーケアに連絡して、ミッドソーシングサーバーのアップグレードを調整してください。

2. テストリンクを実行して、バージョンが更新されたことを検証します。 例：

   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.

競合が見つかった場合は、以下の条件に該当するかを確認します。

• お客様が変更またはカスタマイズしたオブジェクトか
• 本番環境で変更したオブジェクトか

どちらにも該当しない場合は、誤検出です。どちらにも該当する場合は、実際に競合が存在します。

お客様が変更したオブジェクトかどうかの確認

1. 競合しているオブジェクトを特定します。
2. お客様にオブジェクトを変更したかどうかを問い合わせます。
3. オブジェクトに異常がないかを確認します。
4. オブジェクトのコードに最終変更日が設定されているかを確認します。
5. 競合の XML コードに「_conflict」属性がないかを調べます。カスタマイズされた形跡がないかを確認します。

新しいビルドで変更されたオブジェクトかどうかの確認

1. 「常習犯」の仕業かもしれません。組み込みのWebアプリケーションまたはレポート(例：'deliveryValidation'、'deliveryOverview'、'budget')。
2. 変更ログを見て更新がないかを調べます。
3. Adobe Campaignの専門家に聞いて。
4. コードに対して「差分表示」を実行します。

競合の解決

競合を解決するには、次の手順に従います。

1. Adobe Campaign エクスプローラーで​管理／設定／パッケージ管理／競合を編集​に移動します。

2. リストから解決する競合を選択します。競合を解決するには、次の3つの方法があります。新しいバージョン​を受け入れ、現在のバージョンを保持、コードを結合し（解決済みとして宣言）、競合を無視する（非推奨）。

新しいバージョンを承認できるケース

• 標準機能が必要な場合
• カスタマイズしていない場合（カスタマイズした内容はすべて削除されます）

現在のバージョンを維持できるケース

• カスタマイズしている場合
• 結合を実行したくない場合
• アップグレードが原因で競合しているオブジェクトを修正する必要がない場合

結合を実行するケース

• 結合できるのはフォーム、レポート、Web アプリケーションのみです。
• 小規模な結合であればコードの知識がなくても実行できる場合があります。
• 複雑な結合は適切なスキルと能力を持った人が実行する必要があります。
• マージの実行を参照してください。

競合を放置した場合

• 競合した状態が続きます。
• オブジェクトはアップグレードされません。
• バージョンの互換性が失われたり、バグ修正を適用しても改善されなかったりといった長期的な影響が生じます。

マージを実行

結合には様々なタイプがあります。

1. 簡単な結合：カスタム要素と新規要素は小さく、無関係で、コーディングは必要ありません。
2. 変更なし：新しいバージョンを承認します。最終更新日のみ変更され、コメント、タブ、スペース、新規行のみ反映されます（例：意図しない保存）。
3. 軽微な変更：1 行のみ変更されます（例：xpathToLoad）。
4. 高度な結合：コーディングが必要な場合です。開発に関するスキルが必要です。複雑な結合を参照してください。

結合方法

1. 3つのバージョンをすべて入手する：元のバージョン、新しいバージョン、およびカスタムバージョン。
2. 元のバージョンと新しいバージョンの間で「相違」を実行します。
3. 変更を抽出します。
4. 変更がない場合、現在のバージョンを維持して競合を解決します。

コードの場所

1. 組み込みコードは、データキットフォルダー内のXMLファイルに保存されます。 競合しているオブジェクトに対応する XML ファイルを探します。例：installationDirectory\datakit\nms\fra\form\recipient.xml
2. 元のバージョンを取得します。を設定します。
3. 新しいバージョンを取得します。ダウンロードセンターまたはお客様のインストール済みファイルを使用します。
4. カスタムバージョンの取得：Campaign クライアント内からオブジェクトのソースコードを取得します。

差分表示の実行方法

1. テキストエディターまたは結合エディター（Notepad ++、AraxisMerge、WinMerge など）をインストールします。
2. エディターで元のファイルと新しいファイルを開きます。
3. 差分表示（2 つのファイルの比較）を実行します。
4. 差分を特定します。

結合方法

1. カスタムバージョンから着手します。
2. 変更を適用します。
3. 解決したと宣言して競合を解決します。
4. 回帰しないかどうかを確認します。

手動で競合を解決する場合の手順は以下のとおりです。

1. ウィンドウの下のセクションで、conflict_string​を探して、競合のあるエンティティを探します。 新しいバージョンでインストールされたエンティティは新しい引数を持ちます。古いバージョンと一致するエンティティはカスタム引数を持ちます。
2. 維持しないバージョンを削除します。保持するエンティティの​conflict_argument​文字列を削除します。
3. 解決した競合に移動します。アクション​アイコンをクリックし、「解決済みとして宣言」を選択します。
4. 変更を保存します。これにより競合が解決します。

高度な結合

1. 変更の効果を理解する：変更をリバースエンジニアリングし、変更ログを調べ、Adobe Campaignの専門家にフォローアップします。
2. 変更の処理を決定します。
3. カスタマイズの機能を理解します。変更をリバースエンジニアリングする

以下は高度な結合を実行する際の手順です。

1. 変更セットからコードのビットをコピー
2. カスタマイズしたバージョンに貼り付けます。
3. カスタマイズの非回帰性のテスト
4. 変更の機能のテスト
5. ユーザー受け入れテストの実行
6. テスト環境で実行します。

関連トピック

• ビルドアップグレードに関する FAQ
• Campaign Classic リリースノート
• Campaign Classic のヘルプとサポートのオプション
• Gold Standard プログラム