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

この節では、アップグレードプロセスに関する詳細な手順と、競合を識別および解決する手順について説明します。

ビルドのアップグレードは慎重におこなう必要があります。必ず事前にアップグレードが及ぼす影響を検討し、作業は高度なスキルを備えた人が実行するようにしてください。アップグレードを正常に完了するために、後述の手順を実行する人はエキスパートユーザーに限定してください。また、アップグレードを開始する前に 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 Client Care と連携する必要があります。

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

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

    • ホストインストールの場合:ホスティングチームは、Adobe Campaign Client Care チームおよびお客様と連携して、すべてのインスタンスについてアップグレードのスケジュールを調整します。

  • Adobe Campaign 管理者::

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

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

  • Adobe Campaign operator\marketing user:オペレーターは、開発用、テスト用および本番用のインスタンスに対してテストを実行します。

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

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

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

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

  3. の最新バージョンを取得する サーバー設定ファイル.

  4. 最新ビルドをダウンロード. 詳細情報

また、 便利なコマンドライン ビルドのアップグレードを開始する前に、以下を実行します。

  • nlserver pdump:実行中のプロセスのリストを表示します
  • nlserver pdump -who:アクティブなクライアントセッションのリストを表示します
  • nlserver monitor -missing:不足しているプロパティのリストを表示します
  • nlserver start 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. 次のように、注意点を確認します。

    • ID がに設定されているのが唯一の配信部分であることを確認します。 0:

      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サービス: 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 Server アプリケーションのアップグレード

  1. を実行します。 Setup.exe ファイル。 このファイルをダウンロードする必要がある場合は、 ダウンロードセンター.

  2. インストールモードを選択します。 更新 または 修復.

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

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

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

リソースの同期

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

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

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

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

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

    nlserver config -postupgrade -instance: <instance_name>
    
  3. 同期でエラーや警告が発生したかどうかを確認します。

サービスの再起動

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

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

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

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

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

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

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

特定の追加タスク

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

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

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

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

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

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

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

  5. パッケージのエクスポート:

    • クライアントパッケージの書き出しツールを使用してパッケージを書き出す
    • スキーマパッケージをインポート
    • クライアントを切断して再接続します
    • データベースを更新
    • 接続を解除して再接続します。
    • 管理パッケージをインポート
    • コンテンツパッケージを読み込む
    • コンテンツ管理パッケージを読み込む
    • 接続を解除して再接続します。
    • ワークフローのクイックサニティチェックの実行
  6. Message Center テンプレートをパブリッシュして、サーバーと Message Center インスタンス間のインターフェイスが機能していることを確認します。

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

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

ミッドソーシング

ミッドソーシング環境の場合、アップグレードするには、次の追加手順を実行する必要があります。

  1. 連絡先 Adobeカスタマーケア をクリックして、ミッドソーシングサーバーのアップグレードを調整します。

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

    http://[InsertServerURL]/r/test
    
メモ

ミッドソーシングサーバーは、マーケティングサーバーと同じバージョン(またはそれ以降)を常に実行する必要があります。

競合の場合

競合の特定

同期結果を確認する必要があります。 ここで紹介する手順はオンプレミス版のお客様のみを対象にしています。ホスト版のお客様については、ホスティングチームがこの作業を実行します。同期結果の表示方法は 2 つあります。

コマンドラインインターフェイスでは、エラーは 3 つの山形記号「>>>」で具体化され、同期は自動的に停止します。 警告は二重山形記号「>>」で具体化され、同期が完了したら解決する必要があります。 ポストアップグレードの最後に概要がコマンドプロンプトで表示されます。以下はその一例です。

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 または Campaign クライアントインターフェイス(管理/設定/パッケージ管理/競合を編集)で見つけることができます。

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. 組み込みコードは、datakit フォルダー内の 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. テスト環境で実行します。
重要

複雑な結合を実行するには、開発スキルが必要です。

関連トピック

このページ