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


This is a quick documenation of Outlook Integration for JIRA
For a full documentation please visit http://plugins.extern.catworkx.de/display/O2J 
=====================================================================================


1. Content of ZIP file:
-----------------------
- setup.exe
- 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 (32bit or 64bit)
- Windows Vista, Windows 7, Windows 8/8.1, Windows 10
- Internet Explorer 10+, Edge
- .Net 4.0+ framework
- Jira 5.0+

3. Installation:
----------------
Please follow these steps to install 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 setup.exe (not the MSI file) as Adminstrator to install the Add-In on the terminal server
	- 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)%.
	- On this stage the add-in will only be 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
          - 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 one 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 plugin via UPM in JIRA. The installed version of the JIRA plugin needs to be equal or greater than the Outlook AddIn.

5) Run Outlook and configure the connection settings (for further details check http://plugins.extern.catworkx.de/display/O2J)



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/plugins/de.catworkx.jira.plugins.outlook2jira)
- IE10+ or Edge should be installed
- make sure you are able to login to Jira using the Internet Explorer 10+ 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 i. e. are: 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


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

http://plugins.extern.catworkx.de/display/O2J/Change+log+and+Roadmap


