バージョン 4.6.0以降のAdobe Experience Manager Guidesのアップグレード
この記事では、Experience Manager Guides バージョン 4.6.0以降をアップグレードする手順について説明します。
現在のバージョンのExperience Manager Guidesをバージョン 5.1.0 Service Pack 3にアップグレードできます。
- バージョン 5.1.0または5.1.xを使用している場合は、バージョン 5.1.0 Service Pack 3に直接アップグレードできます。
- バージョン 4.6.0、4.6.x、5.0.0、または5.0.xを使用している場合は、バージョン 5.1.0にアップグレードする必要があります。
- 4.6.0より前のバージョンを使用している場合は、アップグレード手順の詳細については、 バージョン 4.4.0以前のAdobe Experience Manager Guidesのアップグレード を参照してください。
詳しくは、次の手順を参照してください。
バージョン 5.1.0へのアップグレード
前提条件
Experience Manager Guides 5.1.0のアップグレードプロセスを開始する前に、次のことを確認してください。
- Experience Manager Guides バージョン 4.6.3、4.6.4、5.0.0、または5.0.0 Service Pack 1にアップグレードしました。
- (オプション)すべての翻訳タスクを閉じました。
- クラスのログレベルを INFO
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptに変更し、これらのログを新しいログファイル (例:logs/translation_upgrade.log)に追加しました。
バージョン 5.1.0のインストール
Adobe Software Distribution Portalから5.1.0 バージョンのパッケージをダウンロードし、 インストールおよびインストール後のアップグレードワークフローの手順に従って、アップグレードプロセスを完了します。
バージョン 5.0.0へのアップグレード
前提条件
Experience Manager Guides 5.0.0のアップグレードプロセスを開始する前に、次のことを確認してください。
- Experience Manager Guides バージョン 4.6.3、4.6.1、4.6.0、または4.4にアップグレードしました。
- (オプション)すべての翻訳タスクを閉じました。
- クラスのログレベルを INFO
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptに変更し、これらのログを新しいログファイル (例:logs/translation_upgrade.log)に追加しました。
バージョン 5.0.0のインストール
Adobe Software Distribution Portalから5.0.0 バージョンのパッケージをダウンロードし、 インストールおよびインストール後のアップグレードワークフローの指示に従って、アップグレードプロセスを完了します。
バージョン 4.6.0へのアップグレード
バージョン 4.6.0へのアップグレードは、現在のバージョンのExperience Manager Guidesによって異なります。 バージョン 4.4.0、4.3.1、4.3.0、4.2、または4.2.1 (ホットフィックス 4.2.1.3)を使用している場合は、バージョン 4.6.0に直接アップグレードできます。
前提条件
Experience Manager Guides 4.6.0のアップグレードプロセスを開始する前に、次のことを確認してください。
- Experience Manager Guides バージョン 4.3.1、4.3.0、または4.2.1 (ホットフィックス 4.2.1.3)にアップグレードしました。
- (オプション)すべての翻訳タスクを閉じました。
- クラスのログレベルを INFO
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptに変更し、これらのログを新しいログファイル (例:logs/translation_upgrade.log)に追加しました。
バージョン 4.6.0のインストール
Adobe Software Distribution Portalから4.6.0 バージョンのパッケージをダウンロードし、 インストールおよびインストール後のアップグレードワークフローの手順に従って、アップグレードプロセスを完了します。
インストールとインストール後のアップグレードワークフロー
バージョンパッケージのインストール
バージョンパッケージをインストールするには、次の手順を実行します。
-
アップグレードするバージョンパッケージをインストールします。
-
トリガーを押して、翻訳マップのアップグレードジョブを開始します。 詳しくは、 サーブレットを介したスクリプトのトリガーを有効にするを参照してください。
-
パッケージのインストールが完了したら、ログに次のメッセージが表示されるまで待ちます。
Completed the post deployment setup script上記のメッセージは、インストールのすべての手順が完了したことを示します。
次のエラーのいずれかが発生した場合は、カスタマーサクセスチームに報告してください。
- デプロイメント後のセットアップ スクリプトでエラーが発生しました
- 翻訳マップの書き出し中に例外が発生しました
- プロパティのv1からv2への翻訳マップをポートできません
-
(オプション)アップグレードするバージョンでリリースされたOxygen コネクタプラグインをアップグレードします。
-
パッケージのインストール後、ブラウザーキャッシュをクリアします。
インストール後のプロセス
Experience Manager Guidesをインストールした後、新しくインストールしたバージョンに適用できる様々な設定を設定に統合できます。
DAM アセットの更新ワークフロー\(後処理変更\):
-
URLを開く:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html -
DAM アセットの更新ワークフローを選択します。
-
「編集」を選択します。
-
DXML Post Process Initiator コンポーネントが存在する場合は、カスタマイズが同期されていることを確認します。
-
DXML Post Process Initiator コンポーネントが存在しない場合は、次の手順を実行してコンポーネントを挿入します。
-
「コンポーネントを挿入 \(処理の最終ステップとしてExperience Manager Guides後処理を担当\)を選択します。
-
以下の詳細を含む プロセス手順 を設定します。
共通タブ:
-
タイトル: DXML後処理イニシエータ
-
説明:変更または作成されたアセットのDXML後処理のSling ジョブをトリガーするDXML後処理イニシエータステップ
プロセスタブ
- 「プロセス」ドロップダウンから「DXML Post Process Initiator」を選択します
- ハンドラーの詳細を選択
- 完了を選択
-
-
-
変更を完了した後、右上の 同期 を選択します。 成功の通知が届きます。
note note NOTE 更新して、カスタマイズされた変更とExperience Manager Guides後処理ステップが最終的なワークフローモデルに存在することを確認します。 -
DAM アセットの更新ワークフローが検証されたら、対応するランチャー設定を確認します。 AEMのワークフローインターフェイスでランチャーを開きます。
code language-http http://localhost:4502/libs/cq/workflow/content/console.htmlDAM アセットの更新ワークフローに対応する次の2つのランチャー\(アクティブにする必要がある場合\)を検索して変更します。
-
条件の DAM アセット更新ワークフローの「 Node Created
"jcr:content/jcr:mimeType!=video"」のランチャー – 「Globbing」の値は次のようにする必要があります。code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original- 'excludeList'には
"event-user-data:changedByWorkflowProcess"を指定する必要があります。 - 条件「」の DAM アセットの更新ワークフロー – の「 Node Modified
jcr:content/jcr:mimeType!=video」のランチャー。Globbing値は次のとおりです。
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/originalexcludeListには"event-user-data:changedByWorkflowProcess"が必要です。
- 'excludeList'には
-
アップグレードが完了したら、新しいアプリケーションコードと一致するように、カスタマイズ/オーバーレイのいずれかが検証および更新されていることを確認します。 いくつかの例を以下に示します。
/libs/fmditaor/libsshouldからオーバーレイされたコンポーネントは、新しい製品コードと比較され、更新は/アプリの下のオーバーレイファイルで行う必要があります。- 製品から使用されている
clientlibカテゴリは、変更を確認する必要があります。 最新の機能を取得するには、上書きされた設定\(examples below\)を最新の設定と比較する必要があります。 - elementmapping.xml
ui\_config.json\(may have been set in folder profiles\)- 修正済み
com.adobe.fmdita.config.ConfigManager
-
damAssetLuceneでカスタマイズを追加した場合は、再度適用する必要がある場合があります。 これらの変更を行った後、reindexをtrueに設定します。 これにより、カスタマイズを使用して、既存のすべてのノードが再インデックスされます。 完了すると、再インデックスフラグは再びfalseに設定されます。 システム内のアセットの数によっては、この処理に数時間かかる場合があります。
Experience Manager Guides インデックスを再インデックス化する手順
-
crx/deを開き、インデックスパス/oak:index/guidesAssetPropertiesに移動します -
再インデックスプロパティを
true(falseデフォルト)に設定し、すべて保存をクリックします。 -
再インデックスが完了すると、再インデックス プロパティが
falseに設定され、再インデックス数が1増加します。note note NOTE データ量によっては数分かかる場合があります。 4. 他の追加または変更されたインデックスに対しても、同じ手順を実行します:`guidesBulkActivation`、`guidesPeerLinkIndex`、および`guidesKonnectTemplateIndex`。
既存のコンテンツをインデックス化する手順
既存のコンテンツのインデックスを作成するには、次の手順を実行します。
-
サーバー\(正しい認証\)に対してPOST リクエストを実行します –
http://<server:port\>/bin/guides/map-find/indexing。 (オプション:マップの特定のパスを渡してインデックスを作成できます。デフォルトでは、すべてのマップにインデックスが付けられます||例:https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>) -
APIは
jobIdを返します。 ジョブのステータスを確認するには、ジョブ IDを持つGET リクエストを同じエンドポイントhttp://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}\(例:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678)に送信できます -
ジョブが完了すると、上記のGET リクエストは成功して応答し、マップが失敗した場合に言及します。 正常にインデックス化されたマップは、サーバーログから確認できます。
'fmdita rewriter'競合を処理する手順
Experience Manager Guidesには、クロスマップの場合に生成されるリンク(2つの異なるマップのトピック間のリンク)を処理するためのカスタム sling rewriter モジュールがあります。
コードベースに別のカスタムスリングリライターがある場合は、'order'値が50より大きい値を使用します。これは、Experience Manager Guides sling リライターが'order' 50を使用するからです。 これを上書きするには、50を超える値が必要です。 詳細については、出力の書き換えパイプライン を参照してください。
このアップグレードでは、'order'の値が1000から50に変更されるので、既存のカスタムリライターがある場合は'fmdita-rewriter'と結合する必要があります。
damAssetLuceneのインデックスを再作成する手順
AEM Guidesを使用してdamAssetLuceneのインデックス定義を更新します。 必要なバージョンにアップグレードした後、damAssetLuceneのインデックス再作成については、この記事を参照してください。
reindex=trueのプロパティ(reindex-async=trueと/oak:index/damAssetLucene)の両方が保存操作で同時に更新されていることを確認してください。