.. _purge_delete_hierarchy:

Delete a Hierarchy
------------------


.. _19.1.2|VOSS-520:


.. caution::

   Unintentionally deleting a hierarchy can have serious effects on the
   system. Proceed with caution.

A utility is available under a hierarchy management menu
to delete a hierarchy (Provider, Reseller, Customer, Site, IntermediateNode)
and all data under it.

If the utility is used at a higher level
hierarchy, then select the lower level hierarchy to delete from the drop-down
list.

Check box options are available to:

* remove data on selected UC Apps configured on the hierarchy
* remove the hierarchy data from the VOSS Automate system database completely

.. note::

   * If a site is deleted, an additional cleanup workflow step also removes site related
     data above the site level.

     The table below indicates the DN and E164 Inventory state after a site is deleted.

     +------+----------+-------------+-----------+-----------+-------------+-------------+
     |      |          | E164        | DN        | E164      | E164        | E164        |
     | DN   | E164     | Association | Inventory | Inventory | Association | Assocations |
     |      |          |             |           |           | Flag        |             |
     +======+==========+=============+===========+===========+=============+=============+
     | Site | Site     | Site        | Removed   | Removed   | N/A         | Removed     |
     +------+----------+-------------+-----------+-----------+-------------+-------------+
     | Site | Customer | Site        | Removed   | Remain    | set to      | Removed     |
     |      |          |             |           |           | false       |             |
     +------+----------+-------------+-----------+-----------+-------------+-------------+
     |      |          |             |           | Remain at |             |             |
     | Site | Customer | Site        | Removed   | customer  | set to      | Removed     |
     |      | & Site   |             |           | Removed   | false       |             |
     |      |          |             |           | at site   |             |             |
     +------+----------+-------------+-----------+-----------+-------------+-------------+

   * If no check boxes are selected, the transaction is successful and no data is deleted.

Since there is a risk in using this utility, a confirmation
of the action is required by selecting the **Confirmation**
drop down box. Click **Save** to carry out the transaction.