.. _purge-delete-hierarchy:

Delete a hierarchy
------------------


.. _19.1.2|VOSS-520:
.. _25.3|EKB-25958:


.. tip:: 

   :ref:`use-action-search-to-navigate-automate`


This procedure deletes a hierarchy (for example, a reseller, customer, intermediate node, or site).

.. caution::

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

1. Go to **Hierarchy Management**. 
2. Choose an option for the hierarchy you wish to delete, for example, **Delete Reseller**, **Delete Customer**, 
   **Delete Intermediate Node**, or **Delete Site**. 

   .. image:: /src/images/hierarchy-management-delete-hierarchy.png 

3. If you're deleting a site, choose the customer where the site exists. 

   .. image:: /src/images/hierarchy-management-delete-site.png 

4. Choose options for relevant data to delete for the selected hierarchy. Options are the same for 
   all hierarchy types. You can remove data on selected UC apps configured on the hierarchy and 
   completely remove all hierarchy data from the Automate system database: 

   * Delete data from CUCM 
   * Delete data from CUC 
   * Delete data from UCCX 
   * Delete data from Webex 
   * Delete data from VOSS Assurance Arbitrator 
   * Remove all data from VOSS Automate  

   .. note:: 

      * If you don't select any data delete options, the hierarchy is deleted but its data is retained.
      * The option to delete data from Webex does not delete Webex locations since these can only 
        be deleted via Webex Control Hub and not via the API.  
      * If deleting a customer, remove any entities associated with the customer, such as LDAP, 
        SSO providers, Devices, and NDLs.

5. At **Confirmation**, since a risk exists when using the hierarchy delete tool, you will need to 
   select the acknowledgement for the delete/purge from the drop-down.

6. Click the toolbar **Save** icon to execute the transaction. 

   .. note::

      If deleting a site, an additional cleanup workflow step also removes site-related data 
      above the site level.

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

      +------+----------+-------------+-----------+-----------+-------------+-------------+
      |      |          | E164        | DN        | E164      | E164        | E164        |
      | DN   | E164     | Association | Inventory | Inventory | Association | Association |
      |      |          |             |           |           | 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   |             |             |
      +------+----------+-------------+-----------+-----------+-------------+-------------+