This is a special version of the setup for terminal servers.


This is a quick documenation of Teamworkx Outlook Integration for Jira
For a full documentation please visit https://documentation.catworkx.com/cwxjiratool/latest
=====================================================================================


1. Content of ZIP file:
-----------------------

- Teamworkx.Outlook.Integration.for.Jira.Mass.Deploy.msi
- outlook_jira_current_user.reg
- outlook_jira_local_maschine_office32bit_win32bit_and_office64bit_win64bit.reg
- outlook_jira_local_maschine_office32bit_win64bit.reg
- README_FIRST_MASS_DEPLOY.TXT
- UPDATE_INFO.txt


2. Prerequisites:
-----------------
- Outlook 2007, 2010, 2013, 2016, 2019 (32bit or 64bit)
- Windows Vista, Windows 7, Windows 8/8.1, Windows 10
- Internet Explorer 11+, Edge
- .NET framework 4.5.2+
- Jira 5.0.1+

3. Installation:
----------------
Please follow these steps to install Teamworkx Outlook Integration for Jira on terminal servers.

1) 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.)

2) Run the MSI file as Adminstrator to install the Add-In on the computer
	- Make sure the minimum version of .NET is deployed as well
        - 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 %ProgramFile(x86)%.
	- At this stage the add-in is registered on the server, but not loaded into a user's Outlook

3) Now there are 2 options to load the plugin for users

     3.1) Use the "outlook_jira_current_user.reg" file from the setup folder to register 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.
     
     3.2) Use outlook_jira_local_maschine_office32bit_win32bit_and_office64bit_win64bit.reg or outlook_jira_local_maschine_office32bit_win64bit.reg
          - Registry values are written to HKLM (local machine).
          - Only need to be registered once and the plugin 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.

 
4) Install the related Jira app via UPM in Jira. The installed version of the Jira app needs to be equal or greater than the Outlook AddIn.

5) Run Outlook and configure the connection settings (for further details check https://documentation.catworkx.com/cwxjiratool/latest)



4. Some hints in case something is not working as expected (esp. when using the embedded browser of the add-on):
----------------------------------------------------------------------------------------------------------------
- make sure the Jira admin installed the related plugin in Jira (https://marketplace.atlassian.com/1210861)
- IE11+ or Edge should be installed
- make sure you are able to login to Jira using the Internet Explorer 11+ due to SSL-certs etc.
  -- you only need to do this once, because Outlook internally uses the IE to render mails
- the configure dialog will ask for a Jira URL
  -- valid URL like: https://jira.company.com,  http://company.com:8080/jira 
  -- be aware of company proxies, firewalls, and so on
  -- using an IP address or fully qualified domain name (FQDN) in some cases work instead of using an URLs like http://jira.intranet:8080

- if nothing works and the Add-in does not load anymore:
  -- try to uninstall the addin using the installer or windows uninstall routine
  -- search for "71EA6BBB-E9AA-434B-BE3D-8D9C9D007626" and "o2jexpress.AddinModule" in the registry and remove the keys
  -- install the Add-in again


5. Change log
-------------

https://documentation.catworkx.com/cwxjiratool/latest/change-log


