誤ったバージョンのパージパラメーターにより、AEM内のページのすべてのバージョンが消去される
Adobe Experience Manager(AEM)でバージョンのパージを設定する場合、3 つのパラメーターがやり取りします。
maxAgeDays– 保持するバージョンの最長有効期間(日数)。-1 は年齢制限がないことを示します。minNumberVersions– 常に保持するページの最小バージョンmaxNumberVersions– 保持するページの最大バージョン数
誤って設定されたパラメーターを使用すると、ページのすべての履歴バージョンが消去され、現在のバージョンのみが残る場合があります。 この記事では、意図しないパージを防ぐのに役立つ、様々なユースケースでの正しい設定の概要を説明します。
説明 description
環境
Adobe Experience Manager(AEM)
問題
バージョンパージの OSGi パラメーターの設定を誤ると、すべてのページバージョンが削除される可能性があります。
サンプルシナリオ :
年齢に関係なく 10 個のバージョンを保持し、パラメーターを次のように設定します。
maxAgeDays= -1minNumberVersions= 0maxNumberVersions= 10
ただし、この設定を使用すると、すべてのバージョンがパージされます。
原因
- 有効期限(
maxAgeDays)が–1 に設定されている場合、バージョンの年齢に基づいたパージは実行されません。 その場合、保持するバージョンはminNumberVersionsパラメーターとmaxNumberVersionsパラメーターで決まります。 minNumberVersionsを 0 (または 1 未満)に設定すると、すべてのバージョンをパージできます。maxNumberVersionsパラメーターは、年齢制限が設定されていないので、無関係になります。- すべてのバージョンを明示的にパージする場合を除き、年齢に関係なく、常に
minNumberVersionsを 1 より大きい値に設定することをお勧めします。
注意: 現在のバージョンは常に保持されます。
解決策 resolution
年齢に関係なく 10 個のバージョンを保持するには、次の設定を使用します。
maxAgeDays= -1minNumberVersions= 10maxNumberVersions= 0
この場合、リテンションは maxNumberVersions によって制御されるので、minNumberVersions は無視されます。
バージョンのパージパラメーターを更新する手順については、AEM ユーザーガイドの version manager を参照してください。
ユースケース
ページのすべてのバージョンのパージを回避するために、これらのパラメーターを設定する前に確認するユースケースを次に示します。
maxAgeDays
minNumberVersions
maxNumberVersions
結果
-1
0
10
1 日より前のバージョンが 10 個ある場合でも、この設定ではすべてのバージョンがパージされます。 これは、-
年齢制限が設定されていない場合、
minNumberVersions が 0 (または 1 未満)に設定され、すべてのバージョンをパージする必要があることを示しているからです。年齢制限が設定されていない場合、
maxNumberVersions パラメーターは無関係になります)。10
0
10
すべてのバージョンが 10 日を超え、
10 日未満のバージョンが 5 つ、10 日以上のバージョンが 10 つ、
minNumberVersions パラメーターが指定されていない場合、10 日の制限内にバージョンがないので、すべてのバージョンがパージされます。10 日未満のバージョンが 5 つ、10 日以上のバージョンが 10 つ、
minNumberVersions=0 の場合、5 つのバージョンが保持されます。10
0
0
すべてのバージョンが 10 より古い場合、保持するバージョンの最小数がないので、すべてのバージョンがパージされます。 この場合も
10 日未満のバージョンが 5 つあっても、すべてのバージョンがパージされます。
maxNumberVersions はありません。10 日未満のバージョンが 5 つあっても、すべてのバージョンがパージされます。
-1
-1
10
この設定では、保持するバージョンの最小数が存在しないので、すべてのバージョンがパージされます。
maxNumberVersions パラメーターは、年齢制限が設定されていない場合、無関係になります。10
-1
10
すべてのバージョンが 10 日を超えている場合、保持するバージョンの最小数がないので、すべてのバージョンがパージされます。
10 日未満のバージョンが 5 つ、10 日以上のバージョンが 10 つ、
maxNumberVersions パラメーターは、10 日以下のバージョンがない場合、関係なくなります。10 日未満のバージョンが 5 つ、10 日以上のバージョンが 10 つ、
minNumberVersions=0 の場合、10 日未満のバージョンの 5 つのみが保持されます。10
-1
0
すべてのバージョンが 10 日を超えている場合、保持するバージョンの最小数がないので、すべてのバージョンがパージされます。 この場合、
10 日未満のバージョンが 5 つ、10 日以上の古いバージョンが 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 のバージョンが保持されます。 ここでは、最小パラメーターと最大パラメーターの両方が重要です。3d58f420-19b5-47a0-a122-5c9dab55ec7f