Steps to perform before the upgrade
Back up the servers and the database.
Save the content of the following APIs for post-upgrade verification:
https://instance.yourzephyr.com/flex/assets/html/version.html and https://instance.yourzephyr.com/flex/version
License details: the license key, the start, and end dates.
Attachments: indexing statistics, indexing status.
Current JVM size.
Copy somewhere the following files
{Zephyr directory}\zephyr\tomcat\conf\server.xml
{Zephyr directory}\zephyr\tomcat\conf\web.xml
{Zephyr directory}\zephyr\tomcat\webapps\flex\WEB-INF\classes\jdbc.properties
{Zephyr directory}\zephyr\tomcat\conf\<SSL certificate>
Copy somewhere the
zephyrdata folder located in the common share storage. If it is not there, back up the {Zephyr directory}\zephyrdata folder on each Zephyr node cluster.
If you are not in the Latest supported version of Elasticsearch(7.9.2) make sure you install it.
Do the echo $ZEPHYR_HOME if it does not return set the ZEPHYR_HOME
| Code Block |
|---|
export ZEPHYR_HOME='Path of the Zephyr Dir' |
The upgrade procedure
Stop the Zephyr service on all Zephyr cluster nodes.
| Code Block |
|---|
cd <ZephyrDir>/tomcat/bin
sudo ./shutdown.sh
|
Upgrade Zephyr on the first node using the installer
| Code Block |
|---|
sudo ./zephyr_(Build Number)_linux_setup.sh
Starting Installer ...
This will install Zephyr x.x on your computer.
OK [o, Enter], Cancel [c] |
You may be prompted to choose between a new installation and upgrading. Choose Upgrade.
| Code Block |
|---|
Choose type:
Install [1, Enter], Upgrade [2]
Upgrade is in progress. Time taken to upgrade depends on the size of your data. Please wait.
Note: If you are running the upgrader in command prompt/linux shell, please don't enter or press any key until next message appears, otherwise upgrade may fail |
| Info |
|---|
Wait till you get the next prompt |
| Code Block |
|---|
Select Destination Location
Setup will install Zephyr into the following folder.
To continue click Next. If you would like to select a different folder, click Browse
<location of zephyr>
At least 5120 MB of free disk space is required.
Available disk space: 256042 MB
Configure Elasticsearch
Enter the hostname or IP address and HTTP port used by Elasticsearch. For example: http://localhost:9200.
Multiple Elasticsearch nodes should be separated by comma. For example: http://localhost:9200,http://localhost:9201
ES Host URL
[http://localhost:9200]
Extracting files ...
After the installation is complete, you will see the following:
ZephyrService.sh may or may not start automatically. Please check and start manually if not started.
Done!
Zephyr x.x has now been installed on your computer.
Zephyr Desktop will now be launched automatically.
You can access additional help from the Zephyr installation.
Click Finish to exit setup.
Launch Zephyr Desktop?
Yes [y, Enter], No [n]
|
Choose No for now.
After you install Zephyr, make sure it is up and running
When Zephyr starts, you will see the following line in the log file zephyrlocation/tomcat/logs/thedinc.log:
| Code Block |
|---|
*****************
Zephyr Started
**************** |
Stop the Zephyr service.
| Code Block |
|---|
cd <ZephyrDir>/tomcat/bin
sudo ./shutdown.sh |
Copy SSL certificate files with those you copied earlier if you have the zephyr set as a SSL:
{Zephyr directory}\zephyr\tomcat\conf\<SSL certificate>
| Info |
|---|
Navigate to another Zephyr cluster node and repeat the steps above |
After you Upgrade Zephyr Enterprise on all the nodes, you need to modify the following files on each node:
<Zephyr Directory>/tomcat/webapps/flex/WEB-INF/classes/hazelcast.properties
In the file, find the following line:
| Code Block |
|---|
zephyr.hz.cluster.enabled=false
zephyr.hz.cluster.name=zephyr-hazelcast-cluster
zephyr.hz.interfaces.enabled=false
zephyr.hz.interface=127.0.0.1
zephyr.hz.tcp-ip.enabled=false
zephyr.hz.members=127.0.0.1:5701 |
make the following changes
| Info |
|---|
|
| Code Block |
|---|
zephyr.hz.cluster.enabled=true
zephyr.hz.cluster.name=zephyr-hazelcast-cluster_smartbear
zephyr.hz.interfaces.enabled=true
zephyr.hz.interface= 192.168.*.*
zephyr.hz.tcp-ip.enabled=true
zephyr.hz.members=192.168.0.1:5701,192.168.0.2:5701 |
Start Zephyr on the ALL node by using the following commands:
| Code Block |
|---|
cd <zephyrDir>/tomcat/bin
sudo ./startup.sh |
When Zephyr starts, you will see the following line in the log file zephyrlocation/tomcat/logs/thedinc.log:
| Code Block |
|---|
*****************
Zephyr Started
**************** |
Steps to perform after the upgrade
Check if Zephyr and Elasticsearch are up and running.
Check the logs for any errors and make sure that all the patches have been applied successfully.
Verify Catalina files, hazel-cast, Elasticsearch configs, and jdbc.properties.
Check the status of re-indexing:
https://instance.yourzephyr.com/flex/assets/html/version.html