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 the Databases icon on the left-tree menu.

  2. Decide which database for which you want to retire a forest.

  3. Click the database name, either on the tree menu or the summary page.

  4. In the left-tree menu under the database name, select Forests.

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

    forest-retire_v10.gif
  6. Click OK. The documents in the retired forest will be evenly redistributed to the other forests in the database.

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