Skip to main content
When installing SuperOffice in a Citrix or Terminal Server environment, review this information to prevent issues after deployment. Before you continue, clarify the following: Will WebTools be deployed to all users in the Citrix or Terminal Server environment?
  • If WebTools will be deployed to all users, no additional configuration is required.
  • If WebTools will be deployed to selected users only, follow the guidance below.
We’re not using the Shadow key system in the registry anymore.
When deploying MailLink in a Terminal Server/Citrix environment, we use a registry mechanism called Registry propagation built into Microsoft Office.
Registry propagation does not work for Office 2013 in SuperOffice versions below 7.5.
The requirement to get the ribbon components, a user needs to have the AddIns registered in the HKEY_CURRENT_USER hive of the registry. Since we don’t know who will log in (and new users can be added later on), there is no way for us to write anything to these areas in the registry when we install SuperOffice. The way we’ve solved this is to register the necessary keys under the HKEY_LOCAL_MACHINE hive in the registry (64-bit machine). These keys contain the values that will be copied to the HKEY_CURRENT_USER keys for a user when he/she starts Microsoft Office programs. These keys will be written AFTER any login scripts have been run, so it is impossible to remove them using such a script. The problem with the above solution is that for every user that logs in and starts any of the Microsoft Office programs, these registry keys will be copied to their local HKEY_CURRENT_USER registry hive and they will get a question asking them if they want to install SuperOffice Ribbons/MailLink. The correct way to support a scenario where some users/groups should NOT get the MailLink in Outlook is to remove the following registry keys: 32-bit environment:
64-bit environment:
These keys are for Office 2016, for other Office versions change the path accordingly.

​
Registry scripts to import

Use the following Registry script to deploy MailLink to those users/groups that should receive these components. Remember to substitute the paths with correct filenames for your installation! The following file is to get MailLink deployed on SuperOffice 8.0 and newer:

​
Web Extensions deployment

​
Installation on Citrix-server

  1. Install SuperOffice.Web.Tools.exe in ‘Install mode’
  2. To avoid all users to run Web Extensions remove ‘SuperOffice CRM.Web Extensions’ (TrayApp) from C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup
  3. Make sure users who should run Web Extensions get the Web Extensions shortcut in: C:\Users\"username"\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

​
Upgrade of Web Extensions on Citrix-server

After the upgrade of WebTools on the server remember to remove Web Extensions startup from C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup again. How to change default MailLink language is described in this article. Another way is described in this FAQ.

Related topics

Deployment of SuperOffice Ribbons in a Citrix or Terminal Server environmentWebTools deployment in a restricted environmentInstall on a Citrix or Terminal serverInstall WebToolsSystem requirements for WebToolsClient requirements for SuperOffice Web and Win