Compacting Tar Files
As data is never overwritten in a tar file, the disk usage increases even when only updating existing data. To make up for the growing size of the repository, AEM employs a garbage collection mechanism called Tar Compaction. The mechanism will reclaim disk space by removing obsolete data from the repository.
Revision Clean Up
By default, tar file compaction is automatically run each night between 2 am and 5 am. The automatic compaction can be triggered manually in the Operations Dashboard via a maintenance job called Revision Clean Up.
To start Revision Clean Up you need to:
- Go to the AEM Welcome Screen.
- In the main AEM window, go to Tools - Operations - Dashboard - Maintenance or directly browse tohttp://localhost:4502/libs/granite/operations/content/maintenance.html
- Click on Daily Maintenance Window.
- Hover over the Revision Clean Up window and press the Start button.
The icon will turn orange to indicate that the Revision Clean Up job is running. You can stop it at any time by hovering the mouse over the icon and pressing the Stop button:
Invoking Revision Garbage Collection via the JMX Console
- Open the JMX Console by going to http://localhost:4502/system/console/jmx
- Click the RevisionGarbageCollection MBean.
- In the next window, click startRevisionGC() and then Invoke to start the Revision Garbage Collection job.
NOTE
Due to the mechanics of the garbage collection, the first run will actually add 256 MB of disk space. Subsequent runs will work as expected and start shrinking the repository size.
Offline Compaction via the Oak-run Tool
For faster compaction of the Tar files (e.g. to trim none-production env) and situations where normal garbage collection doesn't work, Adobe provides a manual Tar compaction tool called Oak-run. It can be downloaded here:
http://mvnrepository.com/artifact/org.apache.jackrabbit/oak-run
CAUTION
Different versions of the Oak-run tool need to be used depending on the Oak version you use with your AEM installation. Please check the version requirements list below before using the tool:
For Oak versions 1.0.0 through 1.0.11 or 1.1.0 through 1.1.6, use Oak-run version 1.0.11
For Oak versions newer than the above, use the version of Oak-run that matches the Oak core of your AEM installation.
Open CRX DE Lite to see oak version (http://localhost:4502/crx/de/index.jsp)
For Oak versions 1.0.0 through 1.0.11 or 1.1.0 through 1.1.6, use Oak-run version 1.0.11
For Oak versions newer than the above, use the version of Oak-run that matches the Oak core of your AEM installation.
Open CRX DE Lite to see oak version (http://localhost:4502/crx/de/index.jsp)
The tool is a runnable jar that can be manually run to compact the repository. The procedure is called offline compaction because the repository needs to be shut down in order to properly run the tool.
Normal operation of the tool also requires old checkpoints to be cleared before the compaction takes place.
The procedure to run the tool is:
- Shut down AEM.
- Use the tool to find old checkpoints:
java -jar oak-run.jar checkpoints install-folder/crx-quickstart/repository/segmentstore
|
- Then, delete the unreferenced checkpoints:
java -jar oak-run.jar checkpoints install-folder/crx-quickstart/repository/segmentstore rm-unreferenced
|
- Finally, run the compaction and wait for it to complete:
java -jar oak-run.jar compact install-folder/crx-quickstart/repository/segmentstore
|
Ref: http://mvnrepository.com/artifact/org.apache.jackrabbit/oak-run
Nhận xét
Đăng nhận xét