How to Repair the Installation of the On-Premise UserManagement Service

Affected versions

All versions before version 1.8.0.1 are affected by the bug.

Description of the Bug

The former setup of the On-Premise Usermanagement Service was configured with the Installshield default for the user context. This leads to the service being installed in the context of the installing user. When updateing this service with another user, the old installation is not found. That leads to a second installation that overwrites the first one. Also the current configuration will not be read, so that e.g. the database configuration will be set to its default location. In case the original configuration was changed this can lead to an error by using a wrong and empty database.

What is fixed in version 1.8.0.1

In this version the user context of the setup is changed to “All Users”. This way any administative user, who wants to update an existing UserManagement service installation, can do the update. The former installation will be found and updated. Also the configuration gets correctly transferred to the new version.

How to make use of the fix

Because the user context must be “All Users” for the currently installed version to benefit from the fix, it is necessary to once do a clean install with version 1.8.0.1 (or higher). This means the older version cannot simply be updated but must be completely uninstalled and after that newly installed.

Steps to re-install the UserManagment service:

  1. Save the current configuration file of the UserManagement service. (The default location and file is: “C:\Program Files (x86)\STP AG\STP UserManagement Service\STP.Common.Services.exe.config”)
  2. Completely uninstalled the current version.
    1. As it might have been installed or updated by other users. Make sure it is also uninstalled in their user context.
  3. Make sure the installation directory (The default is: “C:\Program Files (x86)\STP AG\STP UserManagement Service”) does no longer exist or is at least empty.
  4. Install the new version.
    1. During the setup enter the configuration values from the saved configuration file. Usermanagement config file
  5. After successful installation start the UserManagement App and verify that it still shows your users and groups.

Related to