誤ったバージョンのパージパラメーターにより、AEM内のページのすべてのバージョンが消去される

Adobe Experience Manager(AEM)でバージョンのパージを設定する場合、3 つのパラメーターがやり取りします。

  • maxAgeDays – 保持するバージョンの最長有効期間(日数)。-1 は年齢制限がないことを示します。
  • minNumberVersions – 常に保持するページの最小バージョン
  • maxNumberVersions – 保持するページの最大バージョン数

誤って設定されたパラメーターを使用すると、ページのすべての履歴バージョンが消去され、現在のバージョンのみが残る場合があります。 この記事では、意図しないパージを防ぐのに役立つ、様々なユースケースでの正しい設定の概要を説明します。

説明 description

環境

Adobe Experience Manager(AEM)

問題

バージョンパージの OSGi パラメーターの設定を誤ると、すべてのページバージョンが削除される可能性があります。

サンプルシナリオ :

年齢に関係なく 10 個のバージョンを保持し、パラメーターを次のように設定します。

maxAgeDays= -1
minNumberVersions= 0
maxNumberVersions= 10

ただし、この設定を使用すると、すべてのバージョンがパージされます。

原因

  • 有効期限(maxAgeDays)が–1 に設定されている場合、バージョンの年齢に基づいたパージは実行されません。 その場合、保持するバージョンは minNumberVersions パラメーターと maxNumberVersions パラメーターで決まります。
  • minNumberVersions を 0 (または 1 未満)に設定すると、すべてのバージョンをパージできます。 maxNumberVersions パラメーターは、年齢制限が設定されていないので、無関係になります。
  • すべてのバージョンを明示的にパージする場合を除き、年齢に関係なく、常に minNumberVersions を 1 より大きい値に設定することをお勧めします。

注意: 現在のバージョンは常に保持されます。

解決策 resolution

年齢に関係なく 10 個のバージョンを保持するには、次の設定を使用します。

maxAgeDays= -1
minNumberVersions= 10
maxNumberVersions= 0

この場合、リテンションは maxNumberVersions によって制御されるので、minNumberVersions は無視されます。

バージョンのパージパラメーターを更新する手順については、AEM ユーザーガイドの version manager を参照してください。

ユースケース

ページのすべてのバージョンのパージを回避するために、これらのパラメーターを設定する前に確認するユースケースを次に示します。

maxAgeDays
minNumberVersions
maxNumberVersions
結果
-1
0
10
1 日より前のバージョンが 10 個ある場合でも、この設定ではすべてのバージョンがパージされます。 これは、-minNumberVersions  が 0 (または 1 未満)に設定され、すべてのバージョンをパージする必要があることを示しているからです。

年齢制限が設定されていない場合、maxNumberVersions パラメーターは無関係になります)。
10
0
10
すべてのバージョンが 10 日を超え、minNumberVersions  パラメーターが指定されていない場合、10 日の制限内にバージョンがないので、すべてのバージョンがパージされます。

10 日未満のバージョンが 5 つ、10 日以上のバージョンが 10 つ、minNumberVersions=0 の場合、5 つのバージョンが保持されます。
10
0
0
すべてのバージョンが 10 より古い場合、保持するバージョンの最小数がないので、すべてのバージョンがパージされます。 この場合も maxNumberVersions はありません。

10 日未満のバージョンが 5 つあっても、すべてのバージョンがパージされます。
-1
-1
10
この設定では、保持するバージョンの最小数が存在しないので、すべてのバージョンがパージされます。 maxNumberVersions パラメーターは、年齢制限が設定されていない場合、無関係になります。
10
-1
10
すべてのバージョンが 10 日を超えている場合、保持するバージョンの最小数がないので、すべてのバージョンがパージされます。

maxNumberVersions パラメーターは、10 日以下のバージョンがない場合、関係なくなります。

10 日未満のバージョンが 5 つ、10 日以上のバージョンが 10 つ、minNumberVersions=0 の場合、10 日未満のバージョンの 5 つのみが保持されます。
10
-1
0
すべてのバージョンが 10 日を超えている場合、保持するバージョンの最小数がないので、すべてのバージョンがパージされます。 この場合、maxNumberVersions パラメーターは無関係です。

10 日未満のバージョンが 5 つ、10 日以上の古いバージョンが 10 つ、minNumberVersions = 0 の場合、5 つのバージョンが保持されます。
10
5
5
minNumberVersions が 5 に設定されているので、5 つのバージョンすべてが 10 日より古い場合は、5 つのバージョンがすべて保持されます。

10 日より古いバージョンが 25 ある場合、最小と最大の両方が 5 に設定されているので、最後の 5 つのバージョンのみが保持されます。
10
5
10
10 日以内にバージョンが 5 つあり、10 日より前のバージョンが 10 つある場合(合計 15 のバージョン)、minNumberVersions  は 5 に設定され、maxNumberVersions は 10 に設定されているので、最新 10 のバージョンが保持されます。 ここでは、最小パラメーターと最大パラメーターの両方が重要です。

関連資料

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f