Steps to change the JDBC Driver
Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-installation---upgrade-guides/upgrade-zephyr-enterprise/zephyr-on-premise-upgrade-instructions/steps-to-change-the-jdbc-driver.html
This section explains the step-by-step process to update the JDBC driver for a Zephyr installation running on MySQL, MSSQL, or Oracle databases.
Before proceeding, we recommend taking a snapshot or backup of the Zephyr instance.
To update the JDBC driver for a Zephyr installation,
Stop the Zephyr Server Service.
Take a backup of the jdbc.properties file from the location <Zephyr installation directory>\tomcat\webapps\flex\WEB-INF\classes.
Go to <Zephyr installation directory>\tomcat\webapps\flex\WEB-INF\lib folder and take a backup of the lib folder.
Remove the existing jar file (depending on the database used, such as MySQL, MSSQL, or Oracle) under <Zephyr installation directory>\tomcat\webapps\flex\WEB-INF\lib folder.
Download the recommended jar file for the specific database being used:
MySQL:
MySQL 8.x (JDBC Driver: mysql-connector-j-8.0.32.jar)
MSSQL: mssql-jdbc-11.2.3.jre8.jar
After downloading extract, the sqljdbc_11.2.3.0_enu.zip ->then go to \sqljdbc_11.2.3.0_enu\sqljdbc_11.2\enu folder -> and pick only "mssql-jdbc-11.2.3.jre8.jar
Oracle: ojdbc7.jar
Copy the downloaded jar file and paste it into <Zephyr installation directory>\tomcat\webapps\flex\WEB-INF\lib folder.
Go to <Zephyr installation directory>\tomcat\webapps\flex\WEB-INF\classes folder.
Open the jdbc.properties file and locate the jarFileName = parameter.
Change the value of jarFileName to reflect the name of the new jar file.
For example, for MSSQL,
jarFileName = sqljdbc42.jarStart the Zephyr Server service.
Note: If the Zephyr instance is part of a cluster setup, these steps must be done on all nodes.
Starting Release 8.2, Zephyr Enterprise documentation is moving from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise Documentation page. https://support.smartbear.com/zephyr-enterprise/docs/en/welcome-to-zephyr-enterprise.html