Modifying a UEC Installation via the Graphical Interface

Owned by
Former user (Deleted)
Nov 02, 2015
4 min read

Modifying a Universal Enterprise Controller Installation via the Windows Installer Graphical Interface

After Universal Enterprise Controller is installed, Windows Installer can be run as many times as needed to modify the installation.

These installation modifications are:

  • Adding or Removing Universal Enterprise Controller Components
  • Repairing a Corrupted Universal Enterprise Controller Installation
  • Removing a Universal Enterprise Controller Installation

Adding or Removing Universal Enterprise Controller Components

To add or remove components from a Universal Enterprise Controller installation, perform the following steps:

Step 1

On the Windows Control Panel, select Programs and Features. The Programs and Features dialog displays.
 

 

Windows Server 2003

If you are using Windows Server 2003, select Add or Remove Programs on the Windows Control Panel.

Step 2

From the list of installed programs, select Universal Enterprise Controller and click Change to start Windows Installer. The Welcome dialog displays.
 

Step 4

Click the Next> button. The Program Maintenance dialog displays.
 

 

Installing over a Remote Desktop Session

If Universal Enterprise Controller was installed via a Remote Desktop connection, the environment settings used during that session may no longer be available. Starting with Windows Server 2003, Remote Desktop provides distinct session environments for each logged-in user.

The distribution file's default extraction location is based on the TEMP environment variable. The location referenced by this variable can change between Remote Desktop sessions, and any files extracted there may not be accessible after the session is closed. Consequently, any attempts to modify the installation may fail because the Windows Installer can't locate the installation's source files (a dialog similar to the one shown below may be displayed).
 

 
To resolve this issue, re-extract the distribution files to a location that is independent of a Remote Desktop environment and specify that location in the dialog above. Keep in mind, however, that the extracted files must come from the same distribution package used to do the initial install. If matching distribution files can't be found, Universal Enterprise Controller must be uninstalled and then reinstalled with the desired modifications.

Step 5

Click the Modify radio button, and then the Next> button, to display the Custom Setup dialog.
 

 
Currently installed components are identified by a drive icon.
Uninstalled components are identified by an X icon.
 

Step 6

To remove a currently installed component:

  1. Click the drive icon next to that component.
  2. Select the X icon from the drop-down list to mark the component for removal.

Step 7

To add an uninstalled component:

  1. Click the X icon next to that component.
  2. Select the drive icon from the drop-down list to mark the component for installation.

Step 8

Click the Next> button to display the Ready to Modify the Program dialog.
 

Step 9

Click the Install button to modify the installation.
 
When the modifications are complete, the following actions will be taken:

  • Components marked with a drive icon will:
    • Remain installed if they already are installed.
    • Be installed if they are not already installed.
  • Components marked with an X will:
    • Remain uninstalled if they are not currently installed
    • Be removed if they currently are installed.

Repairing a Corrupted Universal Enterprise Controller Installation

Windows Installer has the ability to recover accidentally deleted application files, configuration files, or registry entries required by Universal Enterprise Controller. This repair feature will re-install the missing items, making a complete re-install unnecessary.

During a repair, any options stored in the Universal Enterprise Controller configuration file is preserved. If the UEC configuration file was deleted, the installation will create a new configuration file with default values.

To repair an installation, perform the following steps:

Step 1

On the Windows Control Panel, select Programs and Features. The Programs and Features dialog displays.
 

 

pre-Vista versions of Windows

If you are using an earlier version of Windows than Windows Vista, select Add or Remove Programs on the Windows Control Panel.

Step 2

From the list of installed programs, select Universal Enterprise Controller and click Change to start Windows Installer. The Welcome dialog displays.
 

Step 3

Click the Next> button. The Program Maintenance dialog displays.
 

Step 4

Click the Repair radio button, and then the Next> button, to display the Ready to Repair the Program dialog.
 

Step 5

Click the Install button to repair the installation.

Removing a Universal Enterprise Controller Installation

To uninstall a Universal Enterprise Controller installation, perform the following steps:

Step 1

On the Windows Control Panel, select Programs and Features. The Programs and Features dialog displays.
 

 

pre-Vista versions of Windows

If you are using an earlier version of Windows than Windows Vista, select Add or Remove Programs on the Windows Control Panel.

Step 2

From the list of installed programs, select Universal Enterprise Controller and click the Change button to start Windows Installer. The Welcome dialog displays.
 

Step 3

Click the Next> button. The Program Maintenance dialog displays.
 

Step 4

Click the Remove radio button, and then the Next> button, to display the Remove the Program dialog.
 

Step 5

Click the Remove button to remove the installation.

Un-Installed Files

The un-install process will remove only those files created during the installation. Some files stored under the .\Universal install directory by Universal Enterprise Controller, such as trace files, may be left behind after the uninstall. In this situation, those files and/or directories may simply be deleted.

Before deleting the entire .\Universal directory, make sure that no other Stonebranch, Inc. products are installed there. (See Universal Enterprise Controller for Windows - File Inventory Lists for a list of files and directories installed with Universal Enterprise Controller.)

In addition to those files and directories created by the Universal Enterprise Controller installation, there may be some shared files left behind following an uninstall. These components will be removed when the last Stonebranch Inc. product that uses them is uninstalled.