Retiring a Forest from the Database
- Last Updated: April 14, 2026
- 1 minute read
- MarkLogic Server
- Version 10.0
- Documentation
You can “retire” a forest from a database in order to move all of its documents to the other forests and rebalance them among those forests, as described in How Data is Moved When a Forest is Retired from the Database. If you want to preserve forest documents in a database, you must first retire the forest before detaching it from the database.
To retire a forest from a database, follow these steps:
-
Click the Databases icon on the left-tree menu.
-
Decide which database for which you want to retire a forest.
-
Click the database name, either on the tree menu or the summary page.
-
In the left-tree menu under the database name, select Forests.
-
In the Database Forest Configuration page, check the Retired box for the forest you want to retire from the database. If you want to preserve forest documents in a database, leave the forest attached box checked.
-
Click OK. The documents in the retired forest will be evenly redistributed to the other forests in the database.
-
After the rebalancer has emptied the retired forest, if the forest is no longer needed, you can detach the forest from the database, as described in Attaching and/or Detaching Forests to/from a Database.