Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Steps to perform before the upgrade

  1. Back up the servers and the database.

  2. Save the content of the following APIs for post-upgrade verification:

  1. 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>

  1. 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.

  1. If you are not in the Latest supported version of Elasticsearch(7.9.2) make sure you install it.

  1. Do the echo $ZEPHYR_HOME if it does not return set the ZEPHYR_HOME

export ZEPHYR_HOME='Path of the Zephyr Dir'


The upgrade procedure

  1. Stop the Zephyr service on all Zephyr cluster nodes.

cd <ZephyrDir>/tomcat/bin
sudo ./shutdown.sh

  1. Upgrade Zephyr on the first node using the installer

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.

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

Wait till you get the next prompt

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.

  1. 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:

*****************
Zephyr Started
****************

  1. Stop the Zephyr service.

cd <ZephyrDir>/tomcat/bin
sudo ./shutdown.sh

  1. 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>

Navigate to another Zephyr cluster node and repeat the steps above

  1. 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:

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

Note:-
zephyr.hz.cluster.name this should be unique
zephyr.hz.interface= Interface of the IP and replace it with an IP address that has an asterisk instead of the last component

zephyr.hz.members=node1IP:5701,node2IP:5701

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

  1. Start Zephyr on the ALL node by using the following commands:

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:

*****************
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

  • No labels