Retiring a Forest from the Database
- Last Updated: April 15, 2026
- 1 minute read
- MarkLogic Server
- Version 11.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 Databases in the left tree menu. A list of databases appears.
-
Click your target database.
-
In the left-tree menu under the database name, click Forests.
-
On the Configure tab, 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 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.