Skip to main content

Administrating MarkLogic Server

Retiring a Forest from the Database

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:

  1. Click Databases in the left tree menu. A list of databases appears.

  2. Click your target database.

  3. In the left-tree menu under the database name, click Forests.

  4. 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.

  5. Click OK. The documents in the retired forest will be evenly redistributed to the other forests in the database.

  6. 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.