Hey Richard - 

I just checked and you’re totally right…We don’t document how to delete devices.  I’ll be sure to raise that to our technical writing team.  In the meantime, I’ve got some steps here that may help you.

I posted this over on our NetBrain Customer Success Center Knowledge Base as well:
https://community.netbraintech.com/articles/knowledgebase/Delete-Devices-from-the-Domain-12-10-2020

You may want to look there for some helpful tips as well.  Let me know how it works out for you!

-Jeff

Delete Devices from the Domain

Multiple options are available to a NetBrain administrator to manually delete devices from their NetBrain domain.  NetBrain provides no automatic mechanism to remove devices as they are decommissioned from your network.  NetBrain highly recommends that device deletion in the NetBrain platform should be completed as part of your standard device decommissioning process.

In This Article

• NetBrain User Account Pre-Requisites
• Delete Devices from the Site Pane
• Delete Devices Using Device Group
• Delete Devices from Domain Management (Fine Tune)
• Delete Devices from Domain Management (Tune Live Access)
• Manually Execute a System Benchmark

NetBrain User Account Pre-Requisites

NetBrain requires that a user account with the following privilege level be available in the NetBrain system to complete the steps defined in this article.

Delete Devices Using the Site Manager

1. Log into the NetBrain End User Interface with an account that has Domain Management privileges.

                 http://<NetBrain IP Address or Hostname>  

2. From the main user interface desktop, in the NetBrain Taskbar, click “Site”.
3. In the Site Manager interface, identify the device(s) to be delete

4. Right-Click on the desired device(s), then click “Remove from Domain” to delete the device(s).

Delete Devices Using a Custom Device Group

1. Log into the NetBrain End User Interface with an account that has Domain Management privileges.

http://<NetBrain IP Address or Hostname>  

2. From the main user interface desktop, navigate to the NetBrain Device Group Manager

Start Menu > Network Resources > Device Group

3. Right-Click “Public” folder, then click “New Device Group”.
4. In the Device Group Properties dialog, complete as follows:

4. Validate that Devices and Interfaces is populated with the correct devices to be deleted, then click “OK”.
5. In the Device Group Manager, confirm that the TO_BE_DELETED device group exists with the devices that are expected in the Device Group.
6. Right-Click on the newly created device group (or a pre-existing one), then click “Delete”
7. In the Confirmation dialog, select Remove all devices in this Device Group from current Domain, then click “Yes”.

Delete Devices from Fine Tune Manager

1. Log into the NetBrain End User Interface with an account that has Domain Management privileges.

http://<NetBrain IP Address or Hostname>  

2. From the main user interface desktop, navigate to the Quick Access Toolbar, click on the Domain Name

3. In the Domain Selection dialog, click “Manage Domain”.
4. In the Domain Management user interface, click “Fine Tune”.
5. NetBrain will allow deletion of devices from the following sub-categories in the “Live Access”
   • Discovered by SNMP Only
   • Missed Devices
   • Unclassified Network Devices

5. Right-Click on the desired devices, then click “Remove from Domain”.
6. In the Confirmation dialog, click “Yes”.

Delete Devices from Tune Live Access

1. Log into the NetBrain End User Interface with an account that has Domain Management privileges.

http://<NetBrain IP Address or Hostname>  

2. From the main user interface desktop, navigate to the Quick Access Toolbar, click on the Domain Name.

3. In the Domain Selection dialog, click “Manage Domain”.
4. In the Domain Management user interface, navigate to the Quick Access Toolbar, then click on Operations > Advanced Tools > Tune Live Access.
5. In the Tune Live Access interface, right-click on the desired devices, then click “Remove from Domain”.

6. In the Confirmation dialog, click “Yes”.

Manually Execute the System Benchmark Task

Following device removal, the NetBrain administrator should consider manually executing the System Benchmark task to ensure that all Device Groups, Data Views, Site Maps, and Context Maps are up-to-date following device deletion.

1. Log into the NetBrain End User Interface with an account that has Domain Management privileges.

http://<NetBrain IP Address or Hostname>  

2. From the main user interface desktop, navigate to the Quick Access Toolbar, click on the Domain Name.

3. In the Domain Selection dialog, click “Manage Domain”.
4. In the Domain Management user interface, click “Schedule Task”.
5. In the Schedule Task tab, click “Schedule Discovery/Benchmark”.
6. Right-Click on the “Basic System Benchmark” task, then click “Run Now”.
7. Close the NetBrain Domain Management interface.

I have no idea why I hadn’t noticed this before .  Now I feel dumb.  Thanks!

Just to bring a little automation into the game:

You can use the Delete Devices API to delete devices directly from a domain.
(https://github.com/NetBrainAPI/NetBrain-REST-API-V8.01/blob/master/REST%20APIs%20Documentation/Devices%20Management/Delete%20Devices%20API.md)

For me, this would a bit dangerous though, I prefer to implement a step for a manual check in between.
Create a list of dismantled/removed devices (hostnames) from your asset management or CMDB. Create a dedicated Device Group as described above and use the Add Devices To Group API (https://github.com/NetBrainAPI/NetBrain-REST-API-V8.01/blob/master/REST%20APIs%20Documentation/Device%20Group%20Management/Add%20Devices%20to%20Group.md) to fill the group. Check the contents of the group before right-clicking to Remove from Domain. Or map the devices and do some reachability tests before removing.