Skip to content

Repair and Uninstall

Reinstall MetaMiner over an existing installation to repair its program files, or remove MetaMiner from a host and from your tenant.

Before you begin

  • Local administrator rights on the host.
  • A backup of server\config\, server\licenses\ and the MetaMiner Database if you might need them again. See Back Up and Restore MMDB.
  • If you use Power BI backup: copies of any backup archives you want to keep. They are stored on the server's archive path.

Repair an installation

There is no separate repair mode. To repair damaged or missing program files, run the full installer of the same build into the existing folder.

  1. Right-click the full installer and choose Run as administrator.
  2. Install into the existing folder, normally C:\Program Files\Infolytik\MetaMiner. The installer replaces jre\, server\lib\, client\lib\ and the other program files, keeps configuration, licenses, logs and MMDB data, and re-registers the services.
  3. Start the server from the MetaMiner Administrator.

TODO: confirm that reinstalling the same build is the supported repair procedure

Confirm with engineering, and state whether any file under server\config\ is ever reset by a reinstall.

Uninstall

  1. Back up anything you want to keep (see above).
  2. Open Windows Settings > Apps (or Control Panel > Programs and Features), select Infolytik MetaMiner and choose Uninstall.
  3. Follow the uninstaller. It stops the MetaMiner service and processes, removes the registration of the embedded database service InfolytikPostgres, removes the program files and removes the metaminer service.
  4. To remove the remaining data, delete the installation folder after the uninstaller finishes.

Image of the MetaMiner uninstaller welcome screen

../images/get-started/uninstaller-welcome.png

The MetaMiner Database data folder is kept

The uninstaller never deletes server\data\mmdb\. This protects your metadata from an accidental uninstall. Delete the folder yourself only when you are sure you no longer need it.

TODO: confirm what remains after uninstall

Confirm whether server\config\, server\licenses\, server\logs\ and the MetaMinerWebApps and MetaMinerFSS service registrations remain after the uninstaller finishes, and list them here.

Remove MetaMiner's access to your tenant

Uninstalling MetaMiner does not change anything in Microsoft. To revoke its access completely:

  1. Delete the client secret of the registered application, or delete the application in Microsoft Entra ID. Access tokens stop working when they expire.
  2. Remove the application's service principal from the security group used by the Fabric tenant settings.
  3. Remove the application from any workspace where it was added, for example for backup or Capacity Metrics.
  4. If an administrator consented to the MetaMiner Client application for delegated sign-in, remove that enterprise application in Microsoft Entra ID.

TODO: re-check the Microsoft Entra admin center paths for deleting an app registration and an enterprise application

Source to check: current Microsoft Learn pages for app registration and enterprise application management.

Verify

  • After a repair: the server starts and clients connect.
  • After an uninstall: Windows Services no longer lists metaminer or InfolytikPostgres.

Troubleshooting

The embedded database service is still listed after uninstall

Stop it in Windows Services, then remove it from an elevated command prompt with sc delete InfolytikPostgres. Use the service name your installation used if you changed it.

Next steps