TECH TIP: Cleaning up a Corrupt Installation
If you have been advised by Digital Metaphors technical support that you may have a corrupt installation, or if you are having difficulty installing, compiling or running applications after a ReportBuilder install, then it may be necessary to manually remove all ReportBuilder files from your system. Corrupt installations usually result when you are installing over a previous version of ReportBuilder which was not installed into the default directory, which was recompiled from the source, or when ReportBuilder files were manually moved from the default install location. Cleaning up a corrupt installation, consists of locating all ReportBuilder related files, and deleting them from your system. The first step is to use the uninstall program to remove as much of ReportBuilder as possible.
Step 1: Run the uninstall program
- Exit Delphi, and all other applications. You should have no applications running except the uninstall, otherwise you may lose some of your work.
- Select Start | Settings | Control Panel from your Windows desktop.
- Double-click the Add/Remove programs icon.
- Locate the version of ReportBuilder you wish uninstall and double-click it.
- The first page of the Uninstall Wizard allows you to choose between a Repair or Uninstall. Choose Uninstall and click the Next button.
- Wait for the uninstall process to complete. NOTE: If this process fails, cancel the uninstallation process and continue on to Step 2. Step 4 describes how to manually remove the ReportBuilder entry from the Control Panel Add/Remove dialog.
- Click the Finish button. ReportBuilder will be removed from the system.
- After all the ReportBuilder files are removed, you may be prompted to reboot the system. If this is the case, reboot the system.
Step 2: Delete the ReportBuilder root directory (and all subdirectories)
- Using the Windows Explorer, locate the ReportBuilder root directory. The default directory is:
C:\Program Files\CodeGear\RAD Studio\X.0\RBuilder
C:\Program Files\Embarcadero\RAD Studio\X.0\RBuilder
- Once you have located this directory, inspect it. If you have any custom work in this directory which you would like to keep, move it to another directory.
- Delete the ReportBuilder root directory.
Step 3: Delete all remaining ReportBuilder files
- 1. Using the Windows Explorer, search the entire hard drive for all occurrences of:
- Delete any occurrences which correspond to the version you are removing. All packages are named with the convention <name>NN, where the first number is the ReportBuilder version and the second number is the Delphi version. Thus, a typical package name for Delphi 5 would be rbRCL45.bpl. The same package for Delphi 4 would be: rbRCL44.bpl. Check Installing ReportBuilder for a list of the packages associated with each version.
- Using the Windows Explorer, search your hard drive for all occurrences of:
- These are the prefixes used by individual ReportBuilder units. ‘pp’ is used for ReportBuilder units, ‘da’ is used for DADE units, and ‘ra’ is used for RAP units. Depending on which ReportBuilder you have (Standard, Professional or Enterprise) you may not have all of these unit types.
Step 4: Remove the ReportBuilder entry from the Add/Remove Programs dialog (if needed)
- Open RegEdit by clicking the Windows Start button, typing “regedit”, and hitting enter.
- Navigate to one of the following registry keys depending on the architecture of your machine.Windows (64 bit):HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\ReportBuilder XX for Delphi XXWindows (32 bit): HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\ReportBuilder XX for Delphi XX
- Copy the “Uninstall String” key value for the location of the copied install files.
- Navigate to the folder location in previous step and delete all files then root folder itself. (You may need to show hidden files in the Windows Explorer to do so).
- Delete the entire registry key in #2.
- Restart your machine and check that the ReportBuilder entry has been removed from the Add/Remove Programs dialog.
- Never have Delphi running when installing ReportBuilder.
- All ReportBuilder related files should be stored in the root directory $(DELPHI)\RBuilder.
- All ReportBuilder run-time packages should be stored in the Windows\System directory.
- You should never have ReportBuilder files in Delphi\Lib, Delphi\Bin or Delphi\Projects\Bpl.
- Step 4 is only necessary if Step 1 fails and the ReportBuilder entry cannot be removed.