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

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

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

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

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. テスト環境で実行します。
重要

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

関連トピック

このページ