Table of Contents

Uninstalling a DataMiner Agent

There are two possibilities to uninstall a DataMiner Agent:

Uninstalling a DMA using the Installer

  1. Download the DataMiner installer from DataMiner Dojo.

  2. Make sure you are logged into Windows with the Administrator account. (Do not use a regular user account with administrative rights.)

  3. Double-click Setup.exe.

  4. Click Uninstall.

    Caution

    Once you have clicked Uninstall, there is no way to gracefully stop the uninstallation process.

    The progress of the uninstallation will be displayed. With the Open logs button in the lower right corner, you can see more detailed log information if necessary.

  5. Click Close.

  6. In case the DataMiner Agent used a Cassandra database, follow the procedure related to Cassandra from Uninstalling a DMA using a manual procedure.

  7. In case the DataMiner Agent used an Elasticsearch database, follow the procedure related to Elasticsearch from Uninstalling a DMA using a manual procedure.

  8. In case the DataMiner Cloud Pack was installed on the DataMiner Agent, uninstall it in Windows via Control Panel > Programs > Programs and Features.

    Note

    Multiple programs are installed as part of the DataMiner Cloud Pack: DataMiner APIGateway, DataMiner ArtifactDeployer, DataMiner CloudGateway, etc. Uninstalling DataMiner Cloud Pack in the Programs and Features window will remove the cloud pack including all of its related components.

  9. In case other systems have DxMs that request data from the Agent you are uninstalling (such as Data Aggregator), make sure to disable these requests.

    This will ensure that those DxMs do not keep trying to send requests to the uninstalled Agent.

Uninstalling a DMA using a manual procedure

  1. Go to the folder C:\Skyline DataMiner\Tools.

  2. Run the following scripts as Administrator:

    • DataMiner Stop DataMiner And SLNet.bat

    • ConfigureIIS_Undo.bat

    • ConfigureFirewall_Undo.bat

    • In case the DataMiner Agent used a MySQL database: RemoveDB.bat

    • UnRegister DataMiner.bat

    • UnRegister dll's of DataMiner.bat

    • RemoveEventLog.exe

    Note

    After you run these scripts, check the Details and Services tabs of Windows Task Manager for remaining DataMiner processes or services. Neither tab should contain any entries starting with "SL". If any such processes are still shown in the Task Manager, try re-running the scripts above or stop the processes manually.

  3. From DataMiner 10.1.0/10.1.1 onwards, use SLEndpointTool_console to remove NATS:

    1. Run C:\Skyline DataMiner\Files\SLEndpointTool_Console.exe either directly or from cmd.exe as Administrator.

    2. Select Uninstall.

    3. Select NAS as the endpoint to uninstall.

    Note

    In some DataMiner releases, the file SLendpointTool_Console.exe is not available. In this case, uninstall NATS by running the following command as Administrator:

    sc stop NATS && sc stop NAS && sc delete NATS && sc delete NAS

  4. Delete the folder C:\Skyline DataMiner.

  5. In case a Cassandra database was installed on the server:

    1. Stop the Cassandra service.

    2. Run cmd.exe as Administrator and enter the following command to delete the Cassandra service:

      sc delete cassandra

    3. Delete the folder C:\Program Files\Cassandra.

      If you want, you can do so within the same command window by entering the following command:

      rmdir "C:\Program Files\Cassandra" /s

    4. Delete the folder C:\ProgramData\Cassandra.

      If you want, you can do so within the same command window by entering the following command:

      rmdir "C:\ProgramData\Cassandra" /s
      Note

      The ProgramData folder is not displayed by default, so you may need to select to display hidden items in order to access this folder.

    5. Run regedit as Administrator and delete the registry key “cassandra” in HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0.

  6. In case an Elasticsearch database was installed on the server:

    1. Stop the Elasticsearch service. If the process does not stop properly, end the process.

    2. Run cmd.exe as Administrator and enter the following command to delete the Elasticsearch service:

      sc delete elasticsearch-service-x64

    3. Run regedit as Administrator and delete HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\elasticsearch-service-x64.

    4. Delete the Elasticsearch data folder, e.g. C:\ProgramData\Elasticsearch. If you are unsure where to find the directory, look for path.data in the elasticsearch.yml file.

      Note

      The ProgramData folder is not displayed by default, so you may need to select to display hidden items in order to access this folder.

    5. Delete the folder C:\Program Files\Elasticsearch.

    6. If any Elasticsearch firewall rule exists, delete it.

  7. In case the DataMiner Cloud Pack was installed on the DataMiner Agent, uninstall it in Windows via Control Panel > Programs > Programs and Features.

    Note

    Multiple programs are installed as part of the DataMiner Cloud Pack: DataMiner APIGateway, DataMiner ArtifactDeployer, DataMiner CloudGateway, etc. Uninstalling DataMiner Cloud Pack in the Programs and Features window will remove the cloud pack including all of its related components.

  8. In case other systems have DxMs that request data from the Agent you are uninstalling (such as Data Aggregator), make sure to disable these requests.

    This will ensure that those DxMs do not keep trying to send requests to the uninstalled Agent.

Propose changes