...
If you are migrating a JIRA server to a new location, and as a result, the URL of the server changes, then you will need to manually repair some data in the database to make Enterprise Tester aware of these changes.
For the purpose of this KB article, we will assume that from and to URL's for JIRA are:
...
- Login to Enterprise Tester as an administrator, and configure the defect tracker link(s) being updated to all be disabled (accessed via the Admin tab).
- Change the URL in each defect tracker to point to the new server and save, this will cause the details to be validated confirming the new server is accessible.
- Stop IIS, from an Administrator command prompt on the ET Enterprise Tester server you can execute the following command: iisreset /stop
- Backup your ET Enterprise Tester database.
Updating Incidents
Incidents within the ET Enterprise Tester database are stored across a number of tables. The table that needs updating when changing the JIRA URL is called "IncidentDetails", and in particular, a column called "TicketKey".
You will need the assistance of your DBA to run these queries against your Enterprise Tester Database.
Database Type |
|
Sql Server | UPDATE IncidentDetails |
Oracle | UPDATE INCIDENTDETAILS |
MySql | UPDATE IncidentDetails |
PostgreSql | UPDATE IncidentDetails |
Updating Requirements
Version 4.4 and below
For requirements synchronized to JIRA, the JIRA information is stored in a table called "ExternalSystemReferences". number of tables. As with incidents above, it is necessary to search and replace the values of the old server name with the new server name but instead using the column "ExternalUrl".
...
You will need the assistance of your DBA to run these queries against your Enterprise Tester Database.
SQL Server
ExternalSystemReferences | UPDATE ExternalSystemReferences SET ExternalUrl= replace(ExternalUrl, 'http://jirasvr/', 'http://mycorp.com/jira/') WHERE ExternalUrl IS NOT NULL |
OracleExternalIconUrl | UPDATE EXTERNALSYSTEMREFERENCESExternalSystemReferences |
ExternalStatusIconUrl MySql | UPDATE ExternalSystemReferences |
ExternalStatusIconLink PostgreSql | UPDATE ExternalSystemReferences |
Additional Steps for Version 4.5. and Above
In version 4.5 and above of Enterprise Tester, additional columns store URLs to other assets associated with JIRA for requirement sync:
...
Oracle
SQL Server
ExternalSystemReferences | ExternalIconUrl | UPDATE ExternalSystemReferencesUPDATE EXTERNALSYSTEMREFERENCES | SET | ExternalIconUrlEXTERNALURL = | replaceREPLACE( | ExternalIconUrlEXTERNALURL , 'http://jirasvr/', 'http://mycorp.com/jira/') | WHERE ExternalIconUrl IS WHERE EXTERNALURL IS NOT NULL |
ExternalStatusIconUrl ExternalIconUrl | UPDATE ExternalSystemReferencesEXTERNALSYSTEMREFERENCES | ||||||
ExternalStatusIconLinkExternalStatusIconUrl
| UPDATE ExternalSystemReferencesEXTERNALSYSTEMREFERENCES |
...
ExternalStatusIconLink |
Oracle
| ExternalIconUrl | UPDATE EXTERNALSYSTEMREFERENCES ExternalStatusIconUrl |
My SQL
ExternalSystemReferences | UPDATE | EXTERNALSYSTEMREFERENCESExternalSystemReferences | SET EXTERNALSTATUSICONURL SET ExternalUrl= | REPLACEreplace( | EXTERNALSTATUSICONURLExternalUrl, 'http://jirasvr/', 'http://mycorp.com/jira/') | WHERE EXTERNALSTATUSICONURL IS WHERE ExternalUrl IS NOT NULL |
ExternalStatusIconLinkExternalIconUrl
| UPDATE EXTERNALSYSTEMREFERENCESExternalSystemReferences | |||||
ExternalStatusIconUrl
|
My SQL
ExternalIconUrl | UPDATE ExternalSystemReferences |
ExternalStatusIconLink
| UPDATE ExternalSystemReferences |
PostgresSQL
ExternalSystemReferences | UPDATE ExternalSystemReferences | SET ExternalStatusIconLinkSET ExternalUrl= replace( | ExternalStatusIconLinkExternalUrl, 'http://jirasvr/', ' | hhttphttp://mycorp.com/jira/') | WHERE ExternalStatusIconLink IS WHERE ExternalUrl IS NOT NULL |
...
ExternalIconUrl | UPDATE ExternalSystemReferences |
ExternalStatusIconUrl
| UPDATE ExternalSystemReferences |
ExternalStatusIconLink
| UPDATE ExternalSystemReferences |
Also from v4.5 and above of Enterprise Tester, the log Log messages stored for synchronization may also contain hyperlinks. These can be replaced as follows:
...
Once you have searched and replaced all the data, execute some SELECT statements across the tables you have updated and confirm the URLs have been replaced correctly.
We suggest running the following statement:
...
- Restart IIS, from an administrator command prompt, run the command iisreset /start
- Login to ET Enterprise Tester (it may take a couple of minutes to start up).
- Re-enable previously disabled defect links.
Try the following tests:
- Create a new test incident in a project and confirm it synchronizes to JIRA in its new location correctly.
- Update an existing test incident within a project and confirm it synchronizes to JIRA and has the correctly URL etc. when clicking on the external link displayed in top right corner of the edit incident window.
- If everything looks OK, go live. However, if you are now having issues, please Please contact the Catch Support Team and include Team if there are any issues. Include details of all the steps performed and scripts you executed and any other relevant information such as ET Enterprise Tester log files.