TFS4JIRA Self-Hosted | Upgrade procedure

Below steps should be followed to assure a non-problem upgrade to the latest version of TFS4JIRA Self-Hosted.

1. Before continuing with the below steps, please make sure your environment complies with TFS4JIRA latest version requirements and prerequisites. A detailed documentation page concerning the latest released version can be found in this section: https://confluence.spartez-software.com/display/TFS4JIRA/Installation

2. In order to be 100% safe from configuration data loss, please backup the database file with the current configuration.

   1. the configuration file is by default present in this folder: C:\inetpub\wwwroot\tfs-jira-synchronizer\App_Data (please look in other/custom location if you performed custom TFS4JIRA installation)

   2. 

      database file name: config.sdf

   3. please copy this file to a safe location, for example, your desktop

3. Uninstall currently installed TFS4JIRA using standard Windows procedure - Uninstall a program in the Programs section of the Control Panel.

   1. TFS4JIRA uninstaller will not remove previous logs and configuration database

4. Please download and install the latest version of TFS4JIRA. Detailed instruction: https://confluence.spartez-software.com/display/TFS4JIRA/Installing+TFS4JIRA+Synchronizer

5. Once installed please run the TFS4JIRA configuration page.

   1. the first run always takes longer to load the page

   2. since uninstallation did not erase the configuration file, when you login, all profiles should be present and setup in your TFS4JIRA

   3. If for any reason proper expected configuration is not visible, because due to some reason configuration database has been replaced with a blank version, please simply use the backup created in point 2 and copy it to your current config.sdf location (by default C:\inetpub\wwwroot\tfs-jira-synchronizer\App_Data)

https://confluence.spartez-software.com/pages/viewpage.action?pageId=8781930