1. Overview
2. Windows uninstallation
   1. Requirements
   2. Event log retention
   3. Uninstallation overview
   4. Uninstallation steps
3. Linux uninstallation
   1. Requirements
   2. Uninstallation overview
   3. Uninstallation steps

Overview

DnsStream can be uninstalled using the uninstall script supplied with each platform-specific package - this is copied to the installation directory by the install script.

On Windows, the uninstaller stops the Windows service, stops the ETW trace session, removes the service registration, and deletes the installation files and data directories.

On Linux, the uninstaller stops and disables the systemd service, removes the service definition, deletes the installation directory, and removes the runtime socket directory.

Windows uninstallation

Requirements

• PowerShell running as Administrator
• The uninstall.ps1 script - located in the DnsStream installation directory

You do not need to:

• Stop or restart the Windows DNS Server service
• Reboot the server
• Modify DNS Server configuration

Event log retention

The DnsStream install.ps1 script creates the Telemity DnsStream Windows Event Log source during installation, however, the uninstall.ps1 script does not remove it during uninstallation. This is intentional - removing the event log source would also remove all historical DnsStream log entries, including metrics history and any warning or error events that may be needed for post-uninstall review.

Use the following command to remove the event log source and all DnsStream entries from the Windows Event Log manually after uninstall:

Remove-EventLog -LogName "Telemity DnsStream"

Uninstallation overview

The uninstaller modifies the system as follows:

The uninstaller checks whether the Telemity DnsStream service exists and, if it is running, it issues a stop command before proceeding.

DnsStream registers a named real-time ETW consumer session called Telemity DnsStream when it starts. Stopping the Windows service does not release the ETW session registration - the uninstaller explicitly stops it using logman to ensure the session is fully cleaned up.

Uninstallation steps

Open PowerShell as Administrator and run the uninstall.ps1 file found under the %ProgramFiles%\Telemity\DnsStream\ directory:

# Check signed files have a status of "Valid":
(Get-AuthenticodeSignature $Env:ProgramFiles\Telemity\DnsStream\uninstall.ps1).Status

# Check signed files have a subject of "CN=Telemity Ltd, O=Telemity Ltd, L=Redhill, S=Surrey, C=GB":
(Get-AuthenticodeSignature $Env:ProgramFiles\Telemity\DnsStream\uninstall.ps1).SignerCertificate.Subject

& $Env:ProgramFiles\Telemity\DnsStream\uninstall.ps1 -Confirm

Optionally delete the Telemity DnsStream Windows Event Log (as noted under Event log retention):

Remove-EventLog -LogName "Telemity DnsStream"

Linux uninstallation

Requirements

• Root shell
• The uninstall.sh script located under /opt/telemity/dnsstream/bin/

You do not need to:

• Stop or restart the DNS server
• Reboot the server
• Remove dnstap configuration from the DNS server - This can be done before or after DnsStream is uninstalled at any time

Uninstallation overview

The Linux uninstaller modifies the system as follows:

The uninstaller performs the following actions:

1. Stops telemity-dnsstream.service if it exists.
2. Disables telemity-dnsstream.service.
3. Removes /etc/systemd/system/telemity-dnsstream.service.
4. Reloads the systemd configuration.
5. Deletes /opt/telemity/dnsstream.
6. Deletes /run/telemity/dnsstream.
7. Removes /opt/telemity and /run/telemity if they are empty.

Uninstallation steps

Open bash as root and run the uninstall.sh file found under the /opt/telemity/dnsstream/bin directory:

/opt/telemity/dnsstream/bin/uninstall.sh --confirm

Following this the dnsstream user and group created ahead of or during installation can be removed if they are no longer required.