Adobe Experience Manager Guidesのアップグレード id224MBE0M0XA
現在のバージョンのExperience Manager Guidesをバージョン 5.1.0 Service Pack 4にアップグレードできます。
- バージョン 5.1.0または5.1.xを使用している場合は、バージョン 5.1.0 Service Pack 4に直接アップグレードできます。
- バージョン 4.6.0、4.6.x、5.0.0、または5.0.xを使用している場合は、バージョン 5.1.0にアップグレードする必要があります。
- バージョン 4.6.3、4.6.1、4.6、または4.4を使用している場合は、バージョン 5.0.0にアップグレードする必要があります。
- バージョン 4.3.x、4.2、4.2.1 (ホットフィックス 4.2.1.3)、4.1、または4.1.xを使用している場合は、バージョン 5.0.0にアップグレードする前にバージョン 4.4にアップグレードする必要があります。
- バージョン 4.0を使用している場合は、バージョン 4.3.xにアップグレードする前にバージョン 4.2にアップグレードする必要があります。
- バージョン 3.8.5を使用している場合は、バージョン 4.2にアップグレードする前にバージョン 4.0にアップグレードする必要があります。
- 3.8.5より前のバージョンを使用している場合は、Adobe Experience Manager Guides ヘルプ Experience Manager Guides アーカイブ で入手できる製品固有のインストールガイドの「PDFのアップグレード」セクションを参照してください。
詳しくは、次の手順を参照してください。
バージョン 3.8.5からバージョン 4.0へのアップグレード
Experience Manager Guides バージョン 3.8.5を使用している場合は、Experience Manager Guides バージョン 4.0にアップグレードできます。 アップグレード機能を使用すると、以前のバージョンのExperience Manager Guidesをアンインストールする必要はありません。
プロセスを実行する前に、完了する必要がある特定のタスクがあります。 次のサブセクションでは、前提条件、レポートの生成、移行プロセスについて説明します。 また、Experience Manager Guides バージョン 4.0をインストールした後は、お客様の設定に応じて様々な設定をカスタマイズできます。
前提条件
Experience Manager Guidesのアップグレードプロセスを開始する前に、次のことを確認してください。
- レビュー用に開いているトピックにレビューコメントを読み込みました。
- アクティブなレビューをすべて閉じました。
- すべての翻訳タスクを閉じました。
- Experience Manager Guidesの以前のバージョン \(メジャーリリースまたはパッチリリース\)の上部にインストールされているExperience Manager Guides ホットフィックスをすべてアンインストールします。
バージョン 4.0をインストールする前
バージョン 4.0をインストールする前に、次の手順を実行します。
- この時点でExperience Manager Guidesがバージョン 3.8.5であることを確認します。
- アップグレードスクリプトパッケージをダウンロードします。 それには、XML Documentation Software Distribution Portalで「Adobe solution 4.0 Upgrade Package」を検索し、zip ファイルをダウンロードします。
- パッケージマネージャーを使用して、このパッケージをAEMにアップロードし、このパッケージをインストールします。
- アップグレードパッケージをインストールしたら、以下のスクリプトを同じ順序で実行し、指定された手順に従います。
アップグレードの互換性を確認するAPI
このAPIは、現在のシステムのステータスを評価し、アップグレードが可能かどうかをレポートするように設計されています。 このスクリプトを実行するには、次のエンドポイントをトリガーします。
- ノードがターゲットの場所に存在する場合、関連するエラーが表示されます。 リポジトリ \(delete node /var/dxml\)をクリーンアップし、アップグレードパッケージを再インストールしてから、このエンドポイントを再度トリガーします。
注意:これは、3.x Experience Manager Guidesではターゲットの場所が以前に使用されていないため、一般的なエラーではありません。
- このスクリプトが成功しない場合は、続行せずにカスタマーサクセスチームに報告してください。
システム データ移行API
このAPIは、移行マッピング セクションで説明されているように、システム データを移行するように設計されています。
- アップグレード互換性の確認APIが失敗した場合は、このスクリプトを実行しないでください\(続行しないでください\)。
- アップグレード互換性を確認APIが正常に返されたら、アップグレード スクリプトを実行できます。
- エラーが発生した場合は、最後のチェックポイントに復元し、エラーログとAPI出力をカスタマーサクセスチームと共有します。
移行マッピング:上記のAPIは、ソースの場所にあるすべてのデータをターゲットの場所に移行します。
バージョン 4.0のインストール id23598G006XA
-
アップグレード手順が正常に実行された場合にのみ、バージョン 4.0をインストールします。
-
Adobe Software Distribution Portalから4.0 バージョンのパッケージをダウンロードします。
- UUID バージョンのソフトウェアを使用している場合は、「4.0 UUID Release for XML Documentation solution for AEM 6.5」を検索します。
- 非UUID バージョンのソフトウェアを使用している場合は、「4.0 Non-UUID Release for XML Documentation solution for AEM 6.5」を検索します。
CRX Package Managerを使用して、パッケージを既存のAEM サーバーインスタンスにアップロードし、インストールします。
note note NOTE すべてのシステムコンポーネントが起動するのを待ちます。 -
パッケージのインストール後、ブラウザーキャッシュをクリアします。
-
DispatcherがAEM オーサーインスタンスで設定されている場合は、次の手順を実行します。
- Dispatcher ルールで次の処理が行われることを確認します。
- URL パターン /home/users/*/preferencesはホワイトリストに登録されています。
- URL パターン /libs/cq/security/userinfo.jsonはキャッシュされません。
-
Dispatcher キャッシュ \(キャッシュされた
clientlibs個の\)をクリアします。
バージョン 4.2へのアップグレード
バージョン 4.2へのアップグレードは、現在のバージョンのExperience Manager Guidesによって異なります。
バージョン 4.0、4.1または4.1.xを使用している場合は、バージョン 4.2に直接アップグレードできます。
前提条件
Experience Manager Guides 4.2のアップグレードプロセスを開始する前に、次のことを確認してください。
- Experience Manager Guides バージョン 4.0、4.1または4.1.xにアップグレードしました。
- すべての翻訳タスクを閉じました。
- クラスのログレベルを INFO
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptに変更し、これらのログを新しいログファイル (例:logs/translation_upgrade.log.)に追加しました
バージョン 4.2のインストール id2245IK0E0EV
-
Adobe Software Distribution Portalから4.2 バージョンパッケージをダウンロードします。
-
バージョン 4.2 パッケージをインストールします。
-
パッケージのインストールが完了したら、次のメッセージ\(s\)がログに記録されるのを待ちます。
Completed the post deployment setup script上記のメッセージは、インストールのすべての手順が完了したことを示します。
次のエラー接頭辞のいずれかが発生した場合は、カスタマーサクセスチームに報告してください。
- デプロイメント後のセットアップ スクリプトでエラーが発生しました
- 翻訳マップの書き出し中に例外が発生しました
- プロパティのv1からv2への翻訳マップをポートできません
-
バージョン 4.2 \(必要に応じて\)でリリースされたOxygen コネクタプラグインをアップグレードします。
-
パッケージのインストール後、ブラウザーキャッシュをクリアします。
-
次の節で詳しく説明しているように、カスタマイズのアップグレードを続行します。
バージョン 4.2のインストール後 id2326F02004K
Experience Manager Guidesをインストールした後、新しくインストールしたバージョンに適用できる様々な設定を設定に統合できます。
-
DAM アセットの更新ワークフロー\(後処理変更\):
-
URLを開く:
code language-http 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/original- 'excludeList'には
"event-user-data:changedByWorkflowProcess"を指定する必要があります。
- 'excludeList'には
-
アップグレードが完了したら、新しいアプリケーションコードと一致するように、カスタマイズ/オーバーレイのいずれかが検証および更新されていることを確認します。 いくつかの例を以下に示します。
- /libs/fmditor/libsbからオーバーレイされたコンポーネントは、新しい製品コードと比較し、/appsの下のオーバーレイファイルで更新する必要があります。
- 製品から使用されるclientlib カテゴリは、変更について確認する必要があります。 上書きされた設定\(以下の例\)は、最新の機能を取得するために、最新の設定と比較する必要があります。
- elementmapping.xml
- ui_config.json\(フォルダープロファイルで設定されている可能性があります\)
- 修正済み
com.adobe.fmdita.config.ConfigManager - 任意のカスタムコードが古いパス \(移行マッピング セクション\)を使用しているかどうかを確認します。カスタマイズも期待どおりに機能するように、新しいパスに更新する必要があります。
-
現在のリリースで導入された新しい設定について説明します\( リリースノート \)を参照し、影響を受ける機能があるかどうかを確認してから、適切なアクションを実行します。 例えば、バージョン 4.0で導入された「改善されたファイルとバージョンの処理」を使用する場合があります。この場合、設定を有効にする必要があります。
既存のコンテンツをインデックス化して、新しい検索と置換を使用する手順:
既存のコンテンツのインデックスを作成するには、次の手順を実行し、マップレベルで新しい検索と置換のテキストを使用します。
-
サーバー\(正しい認証\)に対して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\)
- ジョブが完了すると、上記のGET リクエストは成功して応答し、マップが失敗した場合に言及します。 正常にインデックス化されたマップは、サーバーログから確認できます。
アップグレードジョブが失敗し、エラーログに次のエラーが表示される場合:
「クエリは、100000個を超えるノードを読み取るかトラバースしました。 他のタスクへの影響を避けるために、処理は停止されました。」
これは、アップグレードで使用されるクエリに対してインデックスが正しく設定されていないために発生する可能性があります。 次の回避策を試すことができます。
-
damAssetLucene oak インデックスで、ブール値プロパティ
indexNodeNameをtrueとしてノードに追加します。/oak:index/damAssetLucene/indexRules/dam:Asset -
ノードの下に名前の抜粋を含む新しいノードを追加します。
/oak:index/damAssetLucene/indexRules/dam:Asset/properties
ノードで次のプロパティを設定します。code language-none name - rep:excerpt propertyIndex - {Boolean}true notNullCheckEnabled - {Boolean}truedamAssetLuceneの構造は次のようになります。code language-none <damAssetLucene compatVersion="{Long}2" async="async, nrt" jcr:primaryType="oak:QueryIndexDefinition" evaluatePathRestrictions="{Boolean}true" type="lucene"> <indexRules jcr:primaryType="nt:unstructured"> <dam:Asset indexNodeName="{Boolean}true" jcr:primaryType="nt:unstructured"> <properties jcr:primaryType="nt:unstructured"> <excerpt name="rep:excerpt" propertyIndex="{Boolean}true" jcr:primaryType="nt:unstructured" notNullCheckEnabled="{Boolean}true"/> </properties> </dam:Asset> </indexRules> </damAssetLucene>(他の既存のノードやプロパティと一緒に)
-
damAssetLuceneインデックスのインデックスを再作成します(インデックス再作成フラグをtrueに設定します)
もう一度falseになるまで待ちます(これは、インデックス再作成が完了したことを示します)。 インデックスのサイズによっては数時間かかる場合があります。 -
前の手順を実行して、インデックス作成スクリプトを再度実行します。
バージョン 4.2.1へのアップグレード
バージョン 4.2.1へのアップグレードは、現在のバージョンのExperience Manager Guidesによって異なります。 バージョン 4.1または4.1.x、または4.2を使用している場合は、バージョン 4.2.1に直接アップグレードできます。
前提条件
Experience Manager Guides 4.2.1のアップグレードプロセスを開始する前に、次のことを確認してください。
- Experience Manager Guides バージョン 4.1、4.1.xまたは4.2にアップグレードしました。
- すべての翻訳タスクを閉じました。
- クラスのログレベルを INFO
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptに変更し、これらのログを新しいログファイル (例:logs/translation_upgrade.log.)に追加しました
バージョン 4.2.1のインストール
-
Adobe Software Distribution Portalから4.2.1 バージョンのパッケージをダウンロードします。
-
バージョン 4.2.1 パッケージをインストールします。
-
トリガーを押して、翻訳マップのアップグレードジョブを開始します。 詳しくは、 サーブレットを介したスクリプトのトリガーを有効にするを参照してください。
-
パッケージのインストールが完了したら、次のメッセージ\(s\)がログに記録されるのを待ちます。
Completed the post deployment setup script上記のメッセージは、インストールのすべての手順が完了したことを示します。
次のエラー接頭辞のいずれかが発生した場合は、カスタマーサクセスチームに報告してください。
- デプロイメント後のセットアップ スクリプトでエラーが発生しました
- 翻訳マップの書き出し中に例外が発生しました
- プロパティのv1からv2への翻訳マップをポートできません
-
バージョン 4.2 \(必要に応じて\)でリリースされたOxygen コネクタプラグインをアップグレードします。
-
パッケージのインストール後、ブラウザーキャッシュをクリアします。
-
次の節で詳しく説明しているように、カスタマイズのアップグレードを続行します。
サーブレットを使用したスクリプトのトリガーを有効にする(4.2.1の場合)
投稿:
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
応答:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
上記の応答JSONでは、キーlockNodePathは、送信されたジョブを指すリポジトリで作成されたノードへのパスを保持します。 ジョブが完了すると自動的に削除されます。それまでは、このノードを参照してジョブの現在のステータスを確認できます。
サンプルログ:
次に、スクリプトをトリガーした後にログファイルに表示されるログの例を示します。
04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2
次の手順に進む前に、com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2とcom.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2を探します。
バージョン 4.2.1のインストール後
Experience Manager Guidesをインストールした後、新しくインストールしたバージョンに適用できる様々な設定を設定に統合できます。
-
DAM アセットの更新ワークフロー\(後処理変更\):
-
URLを開く:
code language-http 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/fmditor/libsbからオーバーレイされたコンポーネントは、新しい製品コードと比較し、/appsの下のオーバーレイファイルで更新する必要があります。
- 製品から使用されるclientlib カテゴリは、変更について確認する必要があります。 上書きされた設定\(以下の例\)は、最新の機能を取得するために、最新の設定と比較する必要があります。
- elementmapping.xml
- ui_config.json\(フォルダープロファイルで設定されている可能性があります\)
- 修正済み
com.adobe.fmdita.config.ConfigManager - 任意のカスタムコードが古いパス \(移行マッピング セクション\)を使用しているかどうかを確認します。カスタマイズも期待どおりに機能するように、新しいパスに更新する必要があります。
-
現在のリリースで導入された新しい設定について説明します\( リリースノート \)を参照し、影響を受ける機能があるかどうかを確認してから、適切なアクションを実行します。 例えば、バージョン 4.0で導入された「改善されたファイルとバージョンの処理」を使用する場合があります。この場合、設定を有効にする必要があります。
既存のコンテンツをインデックス化して、新しい検索と置換を使用する手順:
既存のコンテンツのインデックスを作成するには、次の手順を実行し、マップレベルで新しい検索と置換のテキストを使用します。
-
damAssetLuceneのインデックス作成が完了していることを確認します。 サーバーに存在するデータ量に応じて、最大で数時間かかる場合があります。 インデックス再作成が完了したことを確認するには、でインデックス再作成フィールドがfalseに設定されていることを確認しますhttp://<server:port>/oak:index/damAssetLucene。 また、damAssetLuceneでカスタマイズを追加した場合は、再度適用する必要がある場合があります。 -
サーバー\(正しい認証\)に対してPOST リクエストを実行します –
http://<server:port\>/bin/guides/map-find/indexing。 (オプション:マップの特定のパスを渡してインデックスを作成できます。デフォルトでは、すべてのマップにインデックスが付けられます(例:https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)。 -
ルートフォルダーを渡して、特定のフォルダー(およびそのサブフォルダー)のDITA マップをインデックス化することもできます。 例えば、
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/testのようになります。パス パラメーターとルート パラメーターの両方が渡された場合は、パス パラメーターのみが考慮されます。 -
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\)に送信できます -
ジョブが完了すると、上記のGET リクエストは成功して応答し、マップが失敗した場合に言及します。 正常にインデックス化されたマップは、サーバーログから確認できます。
バージョン 4.3.0へのアップグレード
バージョン 4.3.0へのアップグレードは、現在のバージョンのExperience Manager Guidesによって異なります。 バージョン 4.2または4.2.xを使用している場合は、バージョン 4.3.0に直接アップグレードできます。
前提条件
Experience Manager Guides 4.3.0のアップグレードプロセスを開始する前に、次のことを確認してください。
- Experience Manager Guides バージョン 4.2または4.2.xにアップグレードし、それぞれのインストール手順を完了しました。
- すべての翻訳タスクを閉じました。
バージョン 4.3.0のインストール
- Adobe Software Distribution Portalから4.3.0 バージョンのパッケージをダウンロードします。
- バージョン 4.3.0 パッケージをインストールします。
- パッケージのインストール後、ブラウザーキャッシュをクリアします。
- フォルダープロファイルの「
ui_config.jsonXML Editor Configuration 」タブから ファイルをアップグレードします。
バージョン 4.3.0のインストール後
Experience Manager Guidesをインストールした後、新しくインストールしたバージョンに適用できる様々な設定を設定に統合できます。
既存のコンテンツを後処理して、壊れたリンクレポートを使用する手順
既存のコンテンツを後処理し、新しい壊れたリンクレポートを使用するには、次の手順を実行します。
-
(オプション)システムに100,000個を超えるdita ファイルがある場合は、
queryLimitReadsのorg.apache.jackrabbit.oak.query.QueryEngineSettingsServiceを大きな値(存在するアセット数よりも大きい値、例えば200,000個)に更新してから再デプロイします。table 0-row-3 1-row-3 PID プロパティキー プロパティの値 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads 値:200000
デフォルト値:100000 -
すべてのファイルに対して後処理を実行するには、次のAPIを実行します。
table 0-row-2 1-row-2 2-row-2 終点 /bin/guides/reports/upgrade リクエストタイプ POSTこのスクリプトはPOST リクエストであるため、Postmanなどのエージェントを介して実行する必要があります。 期待される応答 APIはjobIdを返します。 ジョブのステータスを確認するには、ジョブ IDを持つGET リクエストを同じエンドポイントに送信できます。
サンプル URL:http://<server:port>/bin/guides/reports/upgradetable 0-row-2 1-row-2 2-row-2 3-row-2 終点 /bin/guides/reports/upgrade リクエストタイプ GET Param jobId:以前の投稿リクエストから受信したjobIdを渡します。 期待される応答 - ジョブが完了すると、GET リクエストは正常に応答します。
- エラーが発生した場合は、エラーログとAPI出力をカスタマーサクセス チームと共有します。
サンプル URL:http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678 -
手順1で変更した場合は、デフォルト値または以前の既存の値
queryLimitReadsに戻します。
バージョン 4.3.1へのアップグレード
バージョン 4.3.1へのアップグレードは、現在のバージョンのExperience Manager Guidesによって異なります。 バージョン 4.3.0、4.2、または4.2.1を使用している場合は、バージョン 4.3.1に直接アップグレードできます。
前提条件
Experience Manager Guides 4.3.1のアップグレードプロセスを開始する前に、次のことを確認してください。
- Experience Manager Guides バージョン 4.3.0、4.2、または4.2.1にアップグレードし、それぞれのインストール手順を完了しました。
- (オプション)すべての翻訳タスクを閉じました。
- クラスのログレベルを INFO
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptに変更し、これらのログを新しいログファイル (例:logs/translation_upgrade.log)に追加しました。
バージョン 4.3.1のインストール
-
Adobe Software Distribution Portalから4.3.1 バージョンのパッケージをダウンロードします。
-
バージョン 4.3.1 パッケージをインストールします。
-
トリガーを押して、翻訳マップのアップグレードジョブを開始します。 詳しくは、 サーブレットを介したスクリプトのトリガーを有効にするを参照してください。
-
パッケージのインストールが完了したら、次のメッセージ\(s\)がログに記録されるのを待ちます。
Completed the post deployment setup script上記のメッセージは、インストールのすべての手順が完了したことを示します。
次のエラー接頭辞のいずれかが発生した場合は、カスタマーサクセスチームに報告してください。
- デプロイメント後のセットアップ スクリプトでエラーが発生しました
- 翻訳マップの書き出し中に例外が発生しました
- プロパティのv1からv2への翻訳マップをポートできません
-
バージョン 4.2 \(必要に応じて\)でリリースされたOxygen コネクタプラグインをアップグレードします。
-
パッケージのインストール後、ブラウザーキャッシュをクリアします。
-
次の節で詳しく説明しているように、カスタマイズのアップグレードを続行します。
サーブレットを使用したスクリプトのトリガーを有効にする(4.3.1の場合)
投稿:
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
応答:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
上記の応答JSONでは、キーlockNodePathは、送信されたジョブを指すリポジトリで作成されたノードへのパスを保持します。 ジョブが完了すると自動的に削除されます。それまでは、このノードを参照してジョブの現在のステータスを確認できます。
サンプルログ:
次に、スクリプトをトリガーした後にログファイルに表示されるログの例を示します。
04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2
次の手順に進む前に、com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2とcom.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2を探します。
バージョン 4.3.1のインストール後
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/fmditor/libsbからオーバーレイされたコンポーネントは、新しい製品コードと比較し、/appsの下のオーバーレイファイルで更新する必要があります。
- 製品から使用されるclientlib カテゴリは、変更について確認する必要があります。 上書きされた設定\(以下の例\)は、最新の機能を取得するために、最新の設定と比較する必要があります。
- elementmapping.xml
- ui_config.json\(フォルダープロファイルで設定されている可能性があります\)
- 修正済み
com.adobe.fmdita.config.ConfigManager
既存のコンテンツをインデックス化する手順
既存のコンテンツのインデックスを作成するには、次の手順を実行し、マップレベルで新しい検索と置換のテキストを使用します。
-
サーバー\(正しい認証\)に対して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\)に送信できます -
ジョブが完了すると、上記のGET リクエストは成功して応答し、マップが失敗した場合に言及します。 正常にインデックス化されたマップは、サーバーログから確認できます。
既存のコンテンツを後処理して、壊れたリンクレポートを使用する手順
既存のコンテンツを後処理し、新しい壊れたリンクレポートを使用するには、次の手順を実行します。
-
(オプション)システムに100,000個を超えるdita ファイルがある場合は、
queryLimitReadsのorg.apache.jackrabbit.oak.query.QueryEngineSettingsServiceを大きな値(存在するアセット数よりも大きい値、例えば200,000個)に更新してから再デプロイします。table 0-row-3 1-row-3 PID プロパティキー プロパティの値 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads 値:200000
デフォルト値:100000 -
すべてのファイルに対して後処理を実行するには、次のAPIを実行します。
table 0-row-2 1-row-2 2-row-2 終点 /bin/guides/reports/upgrade リクエストタイプ POSTこのスクリプトはPOST リクエストであるため、Postmanなどのエージェントを介して実行する必要があります。 期待される応答 APIはjobIdを返します。 ジョブのステータスを確認するには、ジョブ IDを持つGET リクエストを同じエンドポイントに送信できます。
サンプル URL:http://<server:port>/bin/guides/reports/upgradetable 0-row-2 1-row-2 2-row-2 3-row-2 終点 /bin/guides/reports/upgrade リクエストタイプ GET Param jobId:以前の投稿リクエストから受信したjobIdを渡します。 期待される応答 - ジョブが完了すると、GET リクエストは正常に応答します。
- エラーが発生した場合は、エラーログとAPI出力をカスタマーサクセス チームと共有します。
サンプル URL:http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678 -
手順1で変更した場合は、デフォルト値または以前の既存の値
queryLimitReadsに戻します。
バージョン 4.3.1.5にアップグレード
バージョン 4.3.1.5へのアップグレードは、現在のバージョンのExperience Manager Guidesによって異なります。 バージョン 4.3.1を使用している場合は、バージョン 4.3.1.5に直接アップグレードできます。
バージョン 4.3.1.5をインストール
-
4.3.1.5Adobe Software Distribution Portalから バージョンのパッケージをダウンロードします。
-
バージョン 4.3.1.5 パッケージをインストールします。
-
インストールプロセスが正常に完了するのを待ちます。
-
次の節で詳しく説明しているように、カスタマイズのアップグレードを続行します。
バージョン 4.3.1.5のインストール後
<server>:<port>/system/console/bundlesにアクセスします。- org.apache.velocityを検索します。
- 検索したバンドルをアンインストールします。
- 必要なvelocity バンドルをインストールします。
-
アップグレードが完了したら、新しいアプリケーションコードと一致するように、カスタマイズ/オーバーレイのいずれかが検証および更新されていることを確認します。 いくつかの例を以下に示します。
/libs/fmditaまたは/libsからオーバーレイされたコンポーネントは、新しい製品コードと比較し、/appsの下のオーバーレイファイルで更新する必要があります。- 製品から使用されるclientlib カテゴリは、変更について確認する必要があります。 上書きされた設定\(以下の例\)は、最新の機能を取得するために、最新の設定と比較する必要があります。
elementmapping.xmlui\_config.json\(フォルダープロファイルで設定されている可能性があります\)- 修正済み
com.adobe.fmdita.config.ConfigManager
バージョン 4.4.0へのアップグレード
バージョン 4.4.0へのアップグレードは、現在のバージョンのExperience Manager Guidesによって異なります。 バージョン 4.3.1、4.3.0、4.2、または4.2.1 (ホットフィックス 4.2.1.3)を使用している場合は、バージョン 4.4.0に直接アップグレードできます
前提条件
Experience Manager Guides 4.4.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.4.0のインストール
-
Adobe Software Distribution Portalから4.4.0 バージョンパッケージをダウンロードします。
-
バージョン 4.4.0 パッケージをインストールします。
-
トリガーを押して、翻訳マップのアップグレードジョブを開始します。 詳しくは、 サーブレットを介したスクリプトのトリガーを有効にするを参照してください。
-
パッケージのインストールが完了したら、次のメッセージ\(s\)がログに記録されるのを待ちます。
Completed the post deployment setup script上記のメッセージは、インストールのすべての手順が完了したことを示します。
次のエラー接頭辞のいずれかが発生した場合は、カスタマーサクセスチームに報告してください。
- デプロイメント後のセットアップ スクリプトでエラーが発生しました
- 翻訳マップの書き出し中に例外が発生しました
- プロパティのv1からv2への翻訳マップをポートできません
-
バージョン 4.4.0 \(必要に応じて\)でリリースされたOxygen コネクタプラグインをアップグレードします。
-
パッケージのインストール後、ブラウザーキャッシュをクリアします。
-
次の節で詳しく説明しているように、カスタマイズのアップグレードを続行します。
バージョン 4.4.0のインストール後
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/fmditor/libsbからオーバーレイされたコンポーネントは、新しい製品コードと比較し、/appsの下のオーバーレイファイルで更新する必要があります。
- 製品から使用されるclientlib カテゴリは、変更について確認する必要があります。 上書きされた設定\(以下の例\)は、最新の機能を取得するために、最新の設定と比較する必要があります。
- elementmapping.xml
- ui_config.json\(フォルダープロファイルで設定されている可能性があります\)
- 修正済み
com.adobe.fmdita.config.ConfigManager
-
damAssetLuceneでカスタマイズを追加した場合は、再度適用する必要がある場合があります。 これらの変更を行った後、reindexをtrueに設定します。 これにより、カスタマイズを使用して、既存のすべてのノードが再インデックスされます。 完了すると、再インデックスフラグは再びfalseに設定されます。 システム内のアセットの数によっては、この処理に数時間かかる場合があります。
既存のコンテンツをインデックス化する手順
既存のコンテンツのインデックスを作成するには、次の手順を実行し、マップレベルで新しい検索と置換のテキストを使用します。
-
サーバー\(正しい認証\)に対して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\)に送信できます -
ジョブが完了すると、上記のGET リクエストは成功して応答し、マップが失敗した場合に言及します。 正常にインデックス化されたマップは、サーバーログから確認できます。
既存のコンテンツを後処理して、壊れたリンクレポートを使用する手順
既存のコンテンツを後処理し、新しい壊れたリンクレポートを使用するには、次の手順を実行します。
-
(オプション)システムに100,000個を超えるdita ファイルがある場合は、
queryLimitReadsのorg.apache.jackrabbit.oak.query.QueryEngineSettingsServiceを大きな値(存在するアセット数よりも大きい値、例えば200,000個)に更新してから再デプロイします。table 0-row-3 1-row-3 PID プロパティキー プロパティの値 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads 値:200000
デフォルト値:100000 -
すべてのファイルに対して後処理を実行するには、次のAPIを実行します。
table 0-row-2 1-row-2 2-row-2 終点 /bin/guides/reports/upgrade リクエストタイプ POSTこのスクリプトはPOST リクエストであるため、Postmanなどのエージェントを介して実行する必要があります。 期待される応答 APIはjobIdを返します。 ジョブのステータスを確認するには、ジョブ IDを持つGET リクエストを同じエンドポイントに送信できます。
サンプル URL:http://<server:port>/bin/guides/reports/upgradetable 0-row-2 1-row-2 2-row-2 3-row-2 終点 /bin/guides/reports/upgrade リクエストタイプ GET Param jobId:以前の投稿リクエストから受信したjobIdを渡します。 期待される応答 - ジョブが完了すると、GET リクエストは正常に応答します。
- エラーが発生した場合は、エラーログとAPI出力をカスタマーサクセス チームと共有します。
サンプル URL:http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678 -
手順1で変更した場合は、デフォルト値または以前の既存の値
queryLimitReadsに戻します。
サーブレットを使用したスクリプトのトリガーを有効にする
投稿:
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
応答:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
上記の応答JSONでは、キーlockNodePathは、送信されたジョブを指すリポジトリで作成されたノードへのパスを保持します。 ジョブが完了すると自動的に削除されます。それまでは、このノードを参照してジョブの現在のステータスを確認できます。
次の手順に進む前に、com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2とcom.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2を探します。
GET: http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
'fmdita rewriter'競合を処理する手順
Experience Manager Guidesには、クロスマップの場合に生成されるリンク(2つの異なるマップのトピック間のリンク)を処理するためのカスタム sling rewriter モジュールがあります。
コードベースに別のカスタムスリングリライターがある場合は、'order'値が50より大きい値を使用します。これは、Experience Manager Guides sling リライターが'order' 50を使用するからです。 これを上書きするには、50を超える値が必要です。 詳細については、出力の書き換えパイプライン を参照してください。
このアップグレードでは、'order'の値が1000から50に変更されるので、既存のカスタムリライターがある場合は'fmdita-rewriter'と結合する必要があります。
親トピック: ダウンロードしてインストール
バージョン 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 バージョンのパッケージをダウンロードします。
-
バージョン 4.6.0 パッケージをインストールします。
-
トリガーを押して、翻訳マップのアップグレードジョブを開始します。 詳しくは、 サーブレットを介したスクリプトのトリガーを有効にするを参照してください。
-
パッケージのインストールが完了したら、次のメッセージ\(s\)がログに記録されるのを待ちます。
Completed the post deployment setup script上記のメッセージは、インストールのすべての手順が完了したことを示します。
次のエラー接頭辞のいずれかが発生した場合は、カスタマーサクセスチームに報告してください。
- デプロイメント後のセットアップ スクリプトでエラーが発生しました
- 翻訳マップの書き出し中に例外が発生しました
- プロパティのv1からv2への翻訳マップをポートできません
-
バージョン 4.6.0 \(必要に応じて\)でリリースされたOxygen コネクタプラグインをアップグレードします。
-
パッケージのインストール後、ブラウザーキャッシュをクリアします。
バージョン 4.6.0のインストール後
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/fmditor/libsbからオーバーレイされたコンポーネントは、新しい製品コードと比較し、/appsの下のオーバーレイファイルで更新する必要があります。
- 製品から使用されるclientlib カテゴリは、変更について確認する必要があります。 上書きされた設定\(以下の例\)は、最新の機能を取得するために、最新の設定と比較する必要があります。
- elementmapping.xml
- ui_config.json\(フォルダープロファイルで設定されている可能性があります\)
- 修正済み
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'と結合する必要があります。
バージョン 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 バージョンパッケージをダウンロードします。
-
バージョン 5.0.0 パッケージをインストールします。
-
トリガーを押して、翻訳マップのアップグレードジョブを開始します。 詳しくは、 サーブレットを介したスクリプトのトリガーを有効にするを参照してください。
-
パッケージのインストールが完了したら、次のメッセージ\(s\)がログに記録されるのを待ちます。
Completed the post deployment setup script上記のメッセージは、インストールのすべての手順が完了したことを示します。
次のエラー接頭辞のいずれかが発生した場合は、カスタマーサクセスチームに報告してください。
- デプロイメント後のセットアップ スクリプトでエラーが発生しました
- 翻訳マップの書き出し中に例外が発生しました
- プロパティのv1からv2への翻訳マップをポートできません
-
バージョン 5.0.0 \(必要に応じて\)でリリースされたOxygen コネクタプラグインをアップグレードします。
-
パッケージのインストール後、ブラウザーキャッシュをクリアします。
バージョン 5.0.0のインストール後
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/fmditor/libsbからオーバーレイされたコンポーネントは、新しい製品コードと比較し、/appsの下のオーバーレイファイルで更新する必要があります。
- 製品から使用されるclientlib カテゴリは、変更について確認する必要があります。 上書きされた設定\(以下の例\)は、最新の機能を取得するために、最新の設定と比較する必要があります。
- elementmapping.xml
- ui_config.json\(フォルダープロファイルで設定されている可能性があります\)
- 修正済み
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のインデックスを再作成する手順
インデックス定義は、ガイド付きdamAssetLuceneで更新されます。 バージョン 5.0.0にアップグレードした後にdamAssetLuceneのインデックスを再作成する方法については、この記事を参照してください。
バージョン 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.1.0 パッケージをインストールします。
-
トリガーを押して、翻訳マップのアップグレードジョブを開始します。 詳しくは、 サーブレットを介したスクリプトのトリガーを有効にするを参照してください。
-
パッケージのインストールが完了したら、次のメッセージ\(s\)がログに記録されるのを待ちます。
Completed the post deployment setup script上記のメッセージは、インストールのすべての手順が完了したことを示します。
次のエラー接頭辞のいずれかが発生した場合は、カスタマーサクセスチームに報告してください。
- デプロイメント後のセットアップ スクリプトでエラーが発生しました
- 翻訳マップの書き出し中に例外が発生しました
- プロパティのv1からv2への翻訳マップをポートできません
-
バージョン 5.1.0 \(必要に応じて\)でリリースされたOxygen コネクタプラグインをアップグレードします。
-
パッケージのインストール後、ブラウザーキャッシュをクリアします。
バージョン 5.1.0のインストール後
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/fmditor/libsbからオーバーレイされたコンポーネントは、新しい製品コードと比較し、/appsの下のオーバーレイファイルで更新する必要があります。
- 製品から使用されるclientlib カテゴリは、変更について確認する必要があります。 上書きされた設定\(以下の例\)は、最新の機能を取得するために、最新の設定と比較する必要があります。
- elementmapping.xml
- ui_config.json\(フォルダープロファイルで設定されている可能性があります\)
- 修正済み
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のインデックスを再作成する手順
インデックス定義は、ガイド付きdamAssetLuceneで更新されます。 バージョン 5.1.0にアップグレードした後にdamAssetLuceneのインデックスを再作成する方法については、この記事を参照してください。
親トピック: ダウンロードしてインストール