Modifying Database for user mappings
TF4JIRA Synchronizer database
- Open Internet Information Services (IIS) Manager and stop the TFS4JIRA Sync App Pool.
- Backup your current TFS4JIRA Synchronizer. It should be enough to zip/compress the following directory:
- C:\inetpub\wwwroot\tfs-jira-synchronizer
- Download and install CompactView. It's a tool that allows you to view and modify Microsoft SQL Server CE database files (sdf). Download it using the following link:
- Copy the Synchronizer's database file (config.sdf) to your Desktop:
- C:\inetpub\wwwroot\tfs-jira-synchronizer\App_Data\config.sdf
- Open CompactView.
- Select File > Open database.
- Open the config.sdf file you copied to the Desktop.
- If you get the following error message while trying to open the file:
Could not load file or assembly 'System.Data.SqlServerCe, Version=4.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91' or one of its dependencies. The system cannot find the file specified.
It means Microsoft SQL CE 4.0 is not installed, but a 4.0 CE database is being used. Follow this KB article to install Microsoft SQL CE 4.0.
- If you get the following error message while trying to open the file:
- On the top-left corner of the application, the window change the drop-down button from Read-only to Allow editing.
- Find the FieldMappings & "ValueMappings" & "SyncProfiles" tables.
- You will need to find the corresponding field mappings in the FieldMappings table by looking at the right sync profile ID.
- Remember the "Id" in FieldMappings table because you will need it at ValueMappings table later
- Insert the records at ValueMappings table, "Id" is incremental, "JiraValue" is the username attribute in Jira, "TfsValue" is the username attribute in TFS, and "FieldMapping_Id" is the ID you checked above in the "FieldMappings" table. (you may automatize this by script later or do it fully manually at CompactView)
- Change the drop-down button back to Read-only.
- Close CompactView. You don't need to save anything. Changes are made on the fly.
- Replace the original config.sdf file with the one from your Desktop and make sure that the IIS user has access (permissions) to that file:
- C:\inetpub\wwwroot\tfs-jira-synchronizer\App_Data\config.sdf
- Open Internet Information Services (IIS) Manager and start the TFS4JIRA Sync App Pool.