1.40 Deployment on Terminal Server

Owned by Tobias Viehweger
Last updated: Oct 23, 2019 by Simone Schmidt
2 min read

new version

We have a new version of Outlook Email for Jira!
This is the documentation for the old add-in. If you are looking for info about the new one, please click click here.

Getting Started

If your users are running on a virtualized environment (Citrix, Terminal Server, etc), you should use a specific version of our add-in to install. 

To get the correct installation file, please visit the admin area of our add-in in Jira (Jira → Add-ons → Outlook App → General Overview). In the rightmost box, you'll find an advanced section, which will provide you with a download link.

You will need to specify the following options first:

  • Your Office installation bitness (please note that this can differ from the Windows bitness)
  • Where settings should be stored (Roamed Application Data or Local Application Data)

The installer you download here, works a bit different than the default one. Here are the basic differences:

  • Installs to %ProgramFiles% instead of %LocalAppData%
  • Does not have an automatic updater
  • Will be active for all users on the Terminal Server instance by default

Installation

After you install the application on your terminal server, there will be a registry key that needs to be set for each user (e.g. via GPO), which we cannot do via the installer.

You can find a description here: Fix: Clicking on the Jira Tab opens an empty folder

Configuration

By default, the Outlook add-in will be active for all users on the Terminal Server instance. In most cases, this will not be the preferred deployment, as only a subset of users will be Jira users. To change this, please do the following:

  1. Export & remove the following registry folder. This will deactivate the add-in for all users.
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Outlook\Addins\yasoonBase

  2. To re-enable the add-in for certain users, import the values from the exported file for each user, but into the HKEY_CURRENT_USER hive, e.g.:

    yasoon.reg
    Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\yasoonBase]
"Description"="yasoonBase"
"FriendlyName"="Jira"
"LoadBehavior"=dword:00000003
"Manifest"="file:///C:\\Program Files (x86)\\yasoon\\yasoonBase.vsto|vstolocal"
  3. Now only specified users will be able to use the Jira add-in from Outlook