Chapter 15Uninstalling and reinstalling
This chapter is for the support technician. It explains what uninstalling the program removes and what it keeps, how to reinstall over existing data, and how to move the laboratory to a new computer.
15.1 Uninstalling
The program is uninstalled from the uninstall shortcut in the Clarus group of the Start menu, or from "Installed apps" in Windows' settings, under the name Clarus_prime. This needs an administrator account, unless the program was installed for one account only (see 2.10 Installing without administrator rights).
Before it stops anything, uninstalling takes one last backup on the server. If that backup fails, it warns and does not stop the removal. So the safer way is for the technician to take a backup by hand first (see Chapter 8: Backup and restore).
Then it asks: keep the laboratory's data, or remove everything? Keeping is the default.
| What is affected | If the data is kept | If everything is removed |
|---|---|---|
| The program's folder | Removed | Removed |
| The data folder: the database, the encryption keys, the logs | Kept | Removed |
| The backups and their keys | Kept | Kept |
| The kept copy of the licence, and the trial's start mark | Kept | Kept |
The ClarusPrimePostgres service | Stopped and unregistered | Stopped and unregistered |
| The scheduled tasks, and the sign-in Run value | Removed | Removed |
| The firewall rules for the program, the analysers and support | Removed | Removed |
A member computer tells its server that it has left.
Silent uninstall. From an administrator command line, in the program's folder D:\Clarus\Clarus_prime:
unins000.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
It asks nothing, and always keeps the data.
Before uninstalling, close the program's window and every browser that opened it on the server. Windows does not delete open files, so they would stay in the program's folder.
15.2 Reinstalling over existing data
If the data folder stayed after uninstalling, Setup finds the database in it and uses it as it is, without creating a new one. The laboratory comes back as it was, with its users and its data.
Installing the newer version over an existing installation, without uninstalling, keeps the folder and the data and replaces only the program's files.
15.3 Moving the laboratory to a new computer
- On the old computer, take a backup and check it (see 8.10 Moving the laboratory to a new computer).
- Keep the emergency sheet, which holds the recovery code and the cloud backup code (see 11.5 The administrator's recovery code).
- Move the licence from the licence screen (see 3.4 Moving the licence to another computer).
- Install the program on the new computer (see Chapter 2: Installation).
- Restore the laboratory from the backup: from a file, or from the cloud backup with its code.
- Activate the licence on the new computer.
- Link again what does not travel with the backup: the analysers and printers on the new computer's station, and the member computers to their new server.
15.4 When uninstalling stumbles
| What shows | Likely cause | What to do |
|---|---|---|
The error TaskDialogMsgBox: Invalid Buttons when uninstalling | A fault in the uninstall window of the first 9.91 release | Install the newest version over it, then uninstall. Or use the silent uninstall |
| Files stay in the program's folder after uninstalling | The program's window or a browser held them | Close them, restart the computer, then delete what is left of the program's folder only |
The ClarusPrimePostgres service is still running | The database did not stop in time | Restart the computer, then uninstall again |
| A new installation did not find the old data | The data folder is not where it usually is | Choose that same folder in Setup, or restore from a backup |