Resolving Shoretel Call Manager’s Outlook integration UAC issues

greenshot_2011-03-01_14-16-49In my previous post, I detailed the issues we’d been having with Shoretel’s Call Manager client under Vista since v8.1 was released. In this post, I’m going to detail the process used to get around the issue until Shoretel resolve it and release an update.

You’ll need to download and install the Microsoft Application Compatibility Toolkit (v5.6 at the time of writing)

The first thing to do is to create the security database containing the Application Compatibility shim (more about this in my previous post). The shim will force the installer to inherit the parent process’ token. When logged on as a standard user, this means that the Outlook integration installer will run as a standard user.

“The RunAsInvoker compatibility fix enables an application to start by using the token inherited from the parent process. The RunAsInvoker fix overrules both installer detection and manifest processing, and will determine the elevation state for the entire application after it is applied.” – TechNet

  1. Fire up Compatibility Administrator
  2. Either create a new custom database, or rename the default one.
  3. Right-click on the database and select Create New, Application Fix
  4. On the next screen, specify a program and vendor name, and point the wizard to the location of the UninstWrpr.exe file. Hit Next
  5. On the compatibility mode selection screen, select the “RunAsInvoker” mode, then hit Next
  6. Don’t select anything on the Compatibility Fixes screen. Hit Next
  7. The next screen will prompt you to choose which identifying information to use to determine when to apply the shim to the target application. It’s probably safest to leave this at defaults. When I first tested the process, I selected only options that weren’t going to change with a new version of PCM, but this may cause issues down the track depending on how you roll out the security database
  8. The AppCompat database is now almost ready to go. greenshot_2011-03-01_14-35-31
  9. Save the AppCompat database file to somewhere on your network. domainnetlogon or in one of your Group Policy script folders would be a good candidate.
  10. Install the patch locally, and have a look in %windir%AppPatchCustom. You should see a new SDB file in the form of {guid}.sdb. You’ll need that full file name and path for the batch file below.
  11. Set up a new computer logon script with the following contents:
    @echo off
    @echo Shoretel Call Manager Outlook Integration Patch
    if exist %windir%AppPatchCustom{your-patch-guid-here}.sdb goto ALREADYINSTALLED
    sdbinst -q "domainnetlogonShoretelOutlookFix.sdb"
    goto END
    @echo Patch is already installed
  12. Reboot a machine (hopefully a test PC) that has the group policy applied. The computer logon script should run and install the patch. You can verify by checking the %windir%AppPatch folder to see if the SDB file has appeared.

    If you check in the Call Manager install folder, you will also notice that the UAC shield icon has disappeared from the program icon for UninstWrpr.exe


I’ve tested this, and it seems to work well. Of course, as with anything you find on the ‘net, try at your own risk – and never test it in your live environment.

Unfortunately there’s no other easy way to distribute the SDB file. This shouldn’t hopefully be a long-term fix as we’re still hoping that Shoretel will release a proper solution.

Shoretel Call Manager: Outlook Integration issues

shoretel-productsSince we moved from Shoretel 7.5 –> 8.1, we’ve had a niggling issue that’s about to become a show-stopper on a new deployment for our entire Melbourne office.

The client software is easily deployed via Active Directory and Group Policy, but there’s a problem where the Outlook integration installer requires elevation, even though the only changes that are being made are restricted to the user’s profile. This is obviously ridiculous in a corporate environment, as new user setups require the user to be made a local administrator for their first login just to install Shoretel’s Outlook integration.

I lived with this as an inconvenience over the last few years, but the time has now come to plan for a replacement of our Melbourne office’s out-dated Ericsson PABX system. This issue, then, will be a show-stopper as we’re not going to make 80+ users local administrators – even temporarily.

Last week, I sat down to think about the problem and remembered something I’d read about “shimming” applications in Vista & Windows 7. This then led me to wonder if I could create a shim that stops UAC from being triggered by the Shoretel Outlook integration installer – %programfiles%Shoreline CommunicationsShoreWare ClientUninstWrpr.exe

The above process will obviously break any functionality within UninstWrpr.exe that does actually require elevated privileges, but that’s not a concern to me. I went ahead and created a new Security Database using Microsoft’s Application Compatibility Toolkit, and set up the shim as per one of the technet documents. I installed the resulting sdb file on a test machine using the inbuilt sdbinst.exe command, and voila! The Outlook integration installed without a single UAC prompt, and worked properly to boot.

The only part of the process left, is to figure out how to deploy the shim to the client machines. For the sake of brevity, I’ll detail the entire process in a new post shortly.