Server upgrade for MySQL
This section applies specifically to the Zephyr Enterprise Server. The information below is generally used to ensure that system administrators can update their Zephyr Enterprise Server instance for MySQL.
Below are instructions on the steps needed to upgrade a Zephyr Enterprise Server installation of 4.8 to the latest 5.0.
Prerequisites for Zephyr 5.0 Installation
- Database ready with remote access permission
- Upgrader
Zephyr 5.0 Installation
- Take a full back up of the existing Zephyr Enterprise Server instance using the information at Backup & Restore.
- Run the 5.0 Upgrader Utility in check mode to verify the backup is ready to be upgraded. If any errors appear during this process, please reach out to Zephyr Support before proceeding.
- Uninstall Zephyr Enterprise Server 4.8
- IMPORTANT: All configurations and settings will be lost during uninstallation. Create a backup of these settings before uninstalling in case they are needed for review in later steps.
- Install Zephyr Enterprise Server 5.0 (14587)
- See our installation guide if you need help here
- Stop the Zephyr Enterprise Server application server before running the upgrade process on the database
- Run the 5.0 Upgrader Utility in Upgrade mode. Use the same backup you checked in step 2 above.
- Use the formatd below to run the utility and point the utility to where your MySQL server and my.ini/my.cnf file are located
Windows
<Upgrader>.exe -VzMySQLPath='C:\Program Files\MySQL\MySQL Server 5.6\bin\mysql.exe' -VzMySQLCnfFilePath='C:\Program Files\MySQL\MySQL Server 5.6\<your_ini_file>'
Linux
<Upgrader>.sh -VzMySQLPath='/usr/bin/mysql' -VzMySQLCnfFilePath='/etc/mysql/<your_cnf_file>'
- Use the formatd below to run the utility and point the utility to where your MySQL server and my.ini/my.cnf file are located
- Once upgrade is complete, start all application nodes and verify the upgrade completion by logging into the instance and checking data
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