ドキュメントAEM GuidesAEM Guides ドキュメント

2024.06.0 リリースのアップグレード手順

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • ユーザー

この記事では、Adobe Experience Manager Guidesas a Cloud Serviceの 2024.06.0 リリースのアップグレード手順と互換性マトリックスについて説明します。

新機能と機能強化について詳しくは、 2024.06.0リリースの新機能を参照してください。

このリリースで修正された問題の一覧については、2024.06.0リリースで修正された問題を参照してください。

互換性マトリックス

この節では、Experience Manager Guidesas a Cloud Serviceの 2024.06.0 リリースでサポートされているソフトウェアアプリケーションの互換表を示します。

FrameMakerとFrameMaker Publishing Server

Experience Manager Guides as a Cloud リリース
FMPS
FrameMaker
2024.06.0
互換性がありません
2022 以上

酸素コネクタ

Experience Manager Guides as a Cloud リリース
酸素コネクタウィンドウ
酸素コネクタMac
酸素ウィンドウで編集
Oxygen Macで編集
2024.06.0
3.5-uuid 1
3.5-uuid 1
2.3
2.3

ナレッジベーステンプレートバージョン

コンポーネントパッケージ名
コンポーネントのバージョン
テンプレートのバージョン
Cloud Service用Experience Manager Guides コンポーネントコンテンツパッケージ
dxml-components.all-1.2.2
aem-site-template-dxml.all-1.0.16

2024.06.0 リリースへのアップグレード

Experience Manager Guidesは、現在の（最新の）Experience Managerのas a Cloud Serviceリリースをアップグレードすると、自動的にアップグレードされます。

NOTE
現在（最新）のリリースの使用を開始したら、上書きされた設定を最新の設定と比較して、最新の機能を取得します。
  • ui_config.json （フォルダープロファイルで設定されている可能性）

既存のリリースでExperience Manager Guidesのas a Cloud Serviceをまだ行っていない場合は、次の手順を実行します。

サーブレットを使用したスクリプトのトリガーを有効にする手順

（2023 年 6 月のExperience Manager Guidesas a Cloud Serviceリリースより前のリリースを使用している場合のみ）

インストールが完了したら、トリガーを押して翻訳ジョブを開始できます。

POST:

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 は、送信されたジョブを指す、リポジトリで作成されたノードへのパスを保持します。 ジョブが完了すると自動的に削除されるので、このノードでジョブのステータスを確認できます。

このジョブが完了するのを待ってから、次の手順に進みます。

NOTE
ノードがまだ存在するかどうか、およびジョブのステータスを確認する必要があります。
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json

壊れたリンクレポートを使用するために、既存のコンテンツを後処理する手順

（2023 年 6 月のExperience Manager Guidesas a Cloud Serviceリリースより前のリリースを使用している場合のみ）

既存のコンテンツを後処理し、新しい壊れたリンクのレポートを使用するには、次の手順を実行します。

  1. （オプション）システムに 100,000 個を超える DITA ファイルがある場合は、org.apache.jackrabbit.oak.query.QueryEngineSettingsService 下の queryLimitReads および queryLimitInMemory を大きい値（存在するアセットの数を超える値は、たとえば 200,000）に変更してから再デプロイします。

    • Adobe Experience Manager Guidesのインストールと設定のas a Cloud Serviceの 設定の上書き の節で説明している手順に従って、設定ファイルを作成します。

    • 設定ファイルで、queryLimitReads と queryLimitInMemory オプションを設定するために、次の（プロパティ）の詳細を指定します。

      table 0-row-3 1-row-3 2-row-3
      PID プロパティキー プロパティの値
      org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads 値：200000 デフォルト値：100000
      org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory 値：200000 デフォルト値：100000

  2. （正しいPOSTを使用して）サーバへの認証リクエストを実行します。http://<server>//bin/guides/reports/upgrade

  3. API は jobId を返します。 ジョブのステータスを確認するには、ジョブ ID を含むGETリクエストを同じエンドポイント（http://<server>/bin/guides/reports/upgrade?jobId= {jobId}）に送信します。
    （例：http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678）

  4. ジョブが完了すると、前回のGETリクエストが正常に応答します。 何らかの理由でジョブが失敗した場合は、サーバーログに失敗が記録されています。

  5. 手順 1 で変更した場合は、デフォルトまたは以前の既存の値 queryLimitReads に戻します。

「レポート」タブで新しい「検索と置換」および「トピック」リストを使用するために、既存のコンテンツにインデックスを作成する手順は次のとおりです。

（2023 年 6 月のExperience Manager Guidesas a Cloud Serviceリリースより前のリリースを使用している場合のみ）

既存のコンテンツのインデックスを作成する次の手順を実行し、「レポート」タブの新しい検索と置換のテキストをマップレベルとトピックリストで使用します。

  1. （正しいPOSTを使用して）サーバへの認証リクエストを実行します。http://<server:port>/bin/guides/map-find/indexing （オプション：マップの特定のパスをインデックスを作成するためにマップの特定のパスを渡すことができます。デフォルトでは、すべてのマップにインデックスが作成されます||例：https://<Server:port>/bin/guides/map-find/indexing?paths=<path of the MAP in repository>）。

  2. ルートフォルダーを渡して、特定のフォルダー（およびそのサブフォルダー）の DITA マップのインデックスを作成することもできます。 例えば、http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test のようになります。paths パラメーターと root パラメーターの両方が渡される場合、paths パラメーターのみが考慮されることに注意してください。

  3. API は jobId を返します。 ジョブのステータスを確認するには、同じエンドポイント http://<server:port>/bin/guides/map-find/indexing?jobId={jobId} （例：http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678）にジョブ ID を含むGETリクエストを送信します

  4. ジョブが完了すると、前回のGETリクエストが成功を示して応答し、マップが失敗したかどうかを示します。 正常にインデックス化されたマップは、サーバ ログから確認できます。

'fmdita rewriter' の競合を処理する手順

Experience Manager Guidesには、クロスマップ（2 つの異なるマップのトピック間のリンク）の場合に生成されるリンクを処理する custom sling rewriter モジュールがあります。

コードベースに別のカスタム sling rewriter がある場合は、Experience Manager Guides sling rewriter が 50 を使用するように、50 より大きい 'order' 値を使用し 'order' す。 これを上書きするには、50 より大きい値が必要です。 詳しくは、 出力の書き換えパイプラインを参照してください。

このアップグレード中に、'order' の値が 1000 から 50 に変更されるので、既存のカスタムリライターがある場合は fmdita-rewriter と結合する必要があります。

コンテンツフラグメントの B-Tree 移行を実行する手順

コンテンツフラグメントの参照が表示されない場合は、トリガーを押して移行ジョブを開始できます。

POST:

http://localhost:4503/bin/guides/script/start?jobType=cf-reference-store-btree-migration

応答：

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886",
"status": "SCHEDULED"
}

前の応答では、キー lockNodePathJSON は、リポジトリで作成されたノードへのパスを保持します。これは、送信されたジョブを指します。 ジョブが完了すると、自動的に削除されます。 ジョブのステータスについては、このノードを参照してください。

このジョブが完了するのを待ってから、次の手順に進みます。

NOTE
ノードがまだ存在するかどうか、およびジョブのステータスを確認する必要があります。

GET:

http://<aem_domain>/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886.json
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178