Remove a server from the Admin console through config files (EMS 7.x only)

This procedure applies to EMS 7.x only. Do not follow it on EMS 8.0 or later.

EMS 8.0 moved test results and product configuration into the SQL database and removed the built-in file-based database. On 8.0 and later the files described below either do not exist or no longer drive what the console shows, so editing them will not remove a server — and stopping the application pool to do it achieves nothing.

On EMS 8.0 or later: remove the server through the ENow Admin Console. If the console will not let you remove it, contact ENow Support rather than editing anything on disk.

We recommend involving ENow Support in these steps. Deleting the wrong server entries will interrupt monitoring on servers you intended to keep.

Purpose

This article covers removing servers from the Admin Console on EMS 7.x by editing configuration files directly. It is useful when:

• You are unable to remove a client server (Exchange, Domain Controller, and so on) from the ENow Admin Console through the GUI, or
• You have multiple servers to remove at once.

Procedure (EMS 7.x)

The ENow Client is removed manually by first uninstalling it from the server, then editing three configuration files on the ENow web server.

1. On the client server you want to remove, open Add or Remove Programs in Control Panel.
2. Uninstall the ENow Client from that server. This completes the work on the client server.
   If the uninstall fails, see Unable to uninstall ENow client through Windows Control Panel.
3. On the ENow web server, open IIS Manager and stop the MailscapeAppPool.
4. In Windows Explorer, open the ENow Database\Properties folder. The default location is:
   C:\Program Files (x86)\ENow\MailscapeWeb\MailscapeData\Database\Properties
5. Delete all folders whose names match the clients being removed.
   
6. In the Database folder, open Authenticate.txt in a text editor. The default location is:
   C:\Program Files (x86)\ENow\MailscapeWeb\MailscapeData\Database\Authenticate.txt
7. Delete any lines listing the server names being removed, then save and close the file.
   
8. In the Database folder, open Authorized.txt in a text editor.
9. Delete any lines listing the server names being removed, then save and close the file.
   
10. In the Database folder, open Catalog.xml in a text editor.
11. Locate and delete any <s> entries containing the server names being removed.
    Example: to remove the server "Riverside Exchange 2016", delete the entire line including its opening <s> and closing </s> tags, as highlighted in the screenshot.
    
12. Save and close the file.
13. In IIS Manager, start the MailscapeAppPool.

Once these steps are complete, the affected servers should no longer be listed on the OneLook Dashboard.

Applies to

EMS 7.12 through 7.x. Confirmed by ENow Software in EMS 7.13 CU1 (7.13.1.232).

Not applicable to EMS 8.0 or later, where results and configuration are stored in SQL rather than in the built-in file database.