Understanding the Inventory Removal Service

The Inventory Removal service is a manual service that runs on the Inventory server. You can remove the unwanted, redundant, or obsolete inventoried servers from the Inventory database using the Inventory Removal service. The Inventory Removal service removes the inventoried servers from the Inventory database through using the SERVERREMOVALLIST.TXT file. To understand the Inventory Removal Service synchronization, see Using the Inventory Removal Service for Synchronization .

The SERVERREMOVALLIST.TXT file contains a list of inventoried servers that have to be removed from the Inventory database.

IMPORTANT:   You cannot run the Inventory Removal service on the Intermediate Server if the Intermediate Server does not have inventoried servers or database attached to it.

To remove the inventoried servers from the Inventory database:

1. Using a text editor, create a file with the name SERVERREMOVALLIST.TXT with the following contents:

   ;                     Enter comments, if any

   DN or name of the inventoried server (as stored in the Inventory database) to be removed from the Inventory database

   DN or name of the inventoried server (as stored in the Inventory database) to be removed from the Inventory database

   ...

   ...

   DN or name of the inventoried server (as stored in the Inventory database) to be removed from the Inventory database

   To generate the list of inventoried servers that must be removed you can either perform a query on a selected criteria or manually enter the names of the inventoried servers. For more information on Query, see Forming the Query and Setting the Filter Conditions .

2. Copy the SERVERREMOVALLIST.TXT file to the Inventory_server_installation_path\INV\SERVER\WMINV\PROPERTIES directory on NetWare Inventory server and to the C:\ directory on Windows NT/2000 Inventory server.

   NOTE:  The SERVERREMOVAL.PROPERTIES file contains the property FilePath, which is the path to the SERVERREMOVALLIST.TXT file.The default path is SYS:/INV/SERVER/WMINV/PROPERTIES. If you copy the SERVERREMOVALLIST.TXT to a path other than the default path, you must update the FilePath value in the SERVERREMOVAL.PROPERTIES file with the new path. Ensure that the path separator is "/" and not "\".

3. At the server console prompt, enter StartSer RemoveInventory to start the Inventory Removal service.

The processing done by Inventory Removal service is as follows:

1. The Inventory Removal service reads each line of the SERVERREMOVALLIST.TXT file and creates a DELETE STR file for each inventoried server that is listed in the SERVERREMOVALLIST.TXT file.

   The DELETE STR file is saved in the SCANDIR directory.

2. The Selector validates the DELETE STR file and copies it into the DBDIR and ENTMERGEDIR directories.

3. The Storer reads the DELETE STR file from DBDIR and deletes the inventoried server from the attached Inventory database.

4. If the inventory deployment rolls up scan data, the DELETE STR is also rolled up to the next level Inventory server.

   The inventoried server is deleted from the Inventory database at all Inventory servers deployed at the enterprise level.

Using the Inventory Removal Service for Synchronization

The Inventory Removal Service automatically removes inventoried servers from the Inventory database when the corresponding server objects are removed from eDirectory.

Sometimes it is possible that the inventoried servers in eDirectory and in the Inventory database are not synchronized because of one or both of the following reasons:

• If you kill the Inventory Service Manager, remove some server objects in the eDirectory, and restart the Inventory Service Manager.
• If you restart a previous version of the Inventory database containing servers that have already been deleted from eDirectory.

If this happened, you can use the Inventory Removal Service to remove unwanted inventoried servers from the Inventory database so the database is once again synchronized with eDirectory.

If you know the fully qualified DN names of the inventoried servers, you can specify the DN names of these servers in the SERVERREMOVALLIST.TXT file.

To find the server objects that were removed from eDirectory:

1. Export the list of server objects attached to the given Inventory server using an eDirectory tool like NDSREPAIR. The eDirectory tools can be downloaded from the Cool Solutions Web site.
2. To export all the server objects into a .CSV file, use the Data Export Wizard.

   NOTE:  While exporting all the inventoried servers to a .CSV files, it is necessary to select the attributes.

   The exported .CSV file will contain the DNS name and the selected attributes of the inventoried servers. However, you must remove attribute values and the double-quote characters from the .CSV file.

3. Compare the eDirectory exported file and the .CSV file using the file comparison utility to identify the inventoried servers that do not match the .CSV file.

   NOTE:  The eDirectory output file and the .CSV file should be in the same format for the comparison to succeed.

4. After identifying the inventoried servers that are not synchronized, place the DN names of these servers in the SERVERREMOVALLIST.TXT file for the Inventory Removal Service to pick them up.