Uninstall or Reinstall an Instance

Uninstall or Reinstall on Windows

By running setup and selecting an instance of the same version as the installer, or by selecting Programs and Features from Windows Control Panel and selecting an instance, you can make changes to or uninstall the instance.

When you run setup as described in Windows Attended Installation and select an instance of the same version as the installer in the Select Instance box, or select an instance in Programs and Features and use the Change or Repair buttons, the Updating Instance instancename dialog box displays.

Click Next to display the Modify, repair or remove the program dialog box, then select the appropriate option on this dialog to change, repair, or uninstall the instance.

• Select Modify to display the Custom Setup dialog box described in Windows Custom Installation. Using this dialog box, you can select the component groups or components you want to add or remove. Components are described in the Components Installed by Setup Type table.

• Select Repair to repair problems with the instance such as missing or corrupt files or registry entries.

• Select Remove to uninstall the instance.

Unattended Removal on Windows

To launch an unattended removal, specify the instance to uninstall and the REMOVE=ALL property, as follows:

<path>\<installer>.exe /instance <instancename> /q[b|n] REMOVE=ALL 

You can also use the REMOVE property to remove specific features, as described in the Custom-Installable Features table. For example, to remove the Apache 2.0 Web Gateway from instance IrisC, use the command:

C:\downloads\IRIS-2018.1.0.508.0-win_x64.exe /instance IrisC /qn REMOVE=cspgateway,cspapache20

Special Consideration

If you do not have access to the original installation package, you can run uninstall in unattended mode by using the Windows® Installer command-line application (msiexec) and information in the Registry, as follows:

msiexec /x {<product_guid>} /qn /l <logfile>

where <product_guid> is the ProductCode property value of the version you installed.

You can obtain the ProductCode property value from the following Registry location:

Processor Type	Registry Location
32–bit	HKEY_LOCAL_MACHINE\SOFTWARE\Intersystems\IRIS\Configurations\<instance>
64–bit	HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Intersystems\IRIS\Configurations\<instance>

where <instance> is the name of the instance you want to uninstall in unattended mode. The ProductCode property value is displayed in a row similar to:

ProductCode     REG_SZ   {80E3F658-2D74-4A81-92AD-FD16CD226154}

You can also use any of the properties in the Command-Line Properties table with msiexec. For information about msiexec, see the Microsoft msiexec (command-line options)Opens in a new tab TechNet article (https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2003/cc759262(v=ws.10)).

Uninstall on UNIX®, Linux, and macOS

To safely uninstall an instance, follow this procedure:

1. Find the name of the instance you wish to delete using the iris list command to list all the instances on your machine:

   iris list
   

   

2. Verify the instance is stopped. If it is not, stop it with the iris stop command:

   iris stop <instname>
   

   

   Where instname is the instance name that you chose during the installation. If it hangs, force it down using iris force:

   iris force <instname>
   

   

3. Remove the instance using the iris delete command:

   iris delete <instname>
   

   

4. Remove the installation directory using the following operating system command:

   rm -r <directory>
   

   
   Important:

   Be aware that this removes files you may wish to keep. For example: the license key (iris.key), the configuration file (iris.cpf), and the user database file (iris.dat).

The uninstall procedure removes all files installed and created during normal processing, including journal and temporary database files.