Installation

The installation of Outlook Integration for Jira has two parts:

The order of the installation parts is not relevant.

There is a special version of the Outlook add-in available for mass deployment (e.g., terminal servers). The installation of this version is described at the end of this document.

The configuration of the Outlook Integration for Jira App is described in the Configuration section of the user documentation.

Install the Jira App on Jira Server

To install the Jira App of Outlook Integration for Jira using the Universal Plugin Manager (UPM), do the following:

  1. Log into the Jira server as administrator.
  2. From the Administration menu, select Manage Apps.
  3. By default, you should see Atlassian Marketplace for Jira dialog in the right frame. If not, select Find new apps in the left frame.
  4. Search the Marketplace for "Outlook Integration". Outlook Integration for Jira from catworkx should appear in the list of results.
  5. To install the app, select Free trial or Buy now and follow the order process.
  6. To verify that the app is installed, select Manage apps in the left frame.
  7. By default the user-installed apps are listed in the right frame. The Outlook Integration for Jira should be listed.
  8. Make sure that all modules have been enabled (e.g. 5 of 5 modules enabled)

Install the Jira App on Jira Cloud

To install the Jira App of Outlook Integration for Jira using the Universal Plugin Manager (UPM), do the following:

  1. Log into the Jira server as administrator.
  2. From the left frame menu, select Jira Settings.
  3. Now select Apps and then Find new apps in the left frame.
  4. Search the Marketplace for "Outlook Integration". Outlook Integration for Jira from catworkx should appear in the list of results.
  5. To install the app, select it in the list of the results and Start trial.
  6. To verify that the app is installed, select Manage apps in the left frame.
  7. By default the user-installed apps are listed in the right frame. The Outlook Integration for Jira should be listed.

Install the Outlook Add-in

To install the Outlook add-in of Outlook Integration for Jira, do the following:

  1. Extract the Outlook.Integration.for.JIRA_v.{version}.zip archive.
    An directory labeled Outlook.Integration.for.JIRA_v.{version} should be created. It contains the following files:
    • Outlook.Integration.for.JIRA.msi
    • README_FIRST.txt
    • setup.exe
  2. Execute the file setup.exe.

    The file setup.exe checks for necessary dependencies (such as .NET framework) and install them if needed. It is recommend to use setup.exe to install the Outlook add-in.

    The file Outlook.Integration.for.JIRA.msi does not check for any dependencies. It is intended for software distribution only. catworkx does not offer support for software distribution.

    A Setup Wizard dialog appears.

  3. Follow the instructions of the installer.
    The plugin will be registered for the current user in the registry (HKEY_CURRENT_USER) to be loaded by Outlook on the next start.

Mass deploy the Outlook Add-in using your own software deployment strategy

In case you want to install Outlook Integration for Jira

  • on terminal servers,
  • on computers with multiple users or
  • according to your own software deployment strategy,

 You might want to install the add-in only once and handle the load behavior of the add-in for each user on your own. To do so, do the following:

  • Uninstall all previous versions of the add-in if you are upgrading. Uninstalling first is the safe path. Usually just installing/upgrading works as well, older files will be overwritten. Just in case of any errors, always uninstall and then reinstall the plugin.
  • Download and extract Outlook.Integration.for.JIRA_Mass.Deploy_v.{version}.zip
  • Before running the MSI make sure the .NET framework has been deployed as well. Check System Requirements for the minimum required version of .NET
  • Run the MSI file as administrator to install the plugin on the computer.
    • You can use the quiet mode (/qn) for installation if needed.
    • The setup will install and register the essentials for all users of the server, except loading the AddIn in Outlook.
    • By default the add-in installs to %ProgramFiles(x86)%.
    • At this stage the add-in is registered on the computer (HKEY_LOCAL_MACHINE), but not loaded into a user's Outlook.
  • There are two options to load the add-in for users:
    1. Use the outlook_jira_current_user.reg file from the setup directory to install the add-in to each end-user separately.
      • Registry values are written to HKCU (current user).
      • Use the Group Policy Registry Preference or the logon script to add the contents of the file to the registry of the add-in's users.
    2.  Use outlook_jira_local_maschine_office32bit_win32bit_and_office64bit_win64bit.reg or outlook_jira_local_maschine_office32bit_win64bit.reg. To add the contents of the file to the registry of the add-in's machine (HKEY_LOCAL_MACHINE).
      • Registry values are written to HKLM (local machine).
      • The add-in needs to be registered only once and will be loaded for all users. 
      • Please make sure to use the proper *.reg-file due to different bitnesses (32bit/64bit) of Outlook and Windows.

Preconfigure settings

If you also want to preconfigure settings for the users, see Preconfigure and share settings