When installing Zephyr on your nodes, keep in mind the following:

  • Install Zephyr on any drive other than drive C: to avoid permission issues, as administrator permissions may be required to work with this drive.

  • Use the same Zephyr version and build on all the nodes.

  • Zephyr installed on all the nodes must have the same license.

Prerequisites (apply to each node)

Make sure you have specified the correct paths for PATH and JAVA_HOME.

Zephyr installation steps

1. Install Zephyr Enterprise on the first node (the installation steps on the first node differ from the steps you perform on the other nodes):

If you use an external database other than MySQL, please refer to Zephyr Data Center Requirements and Connecting to an External Database.

1. Double-click the installation file and select Install in the Welcome screen:

2. View the requirements, if needed, then click Next:

3. Read the license agreement and accept its terms:

4. Specify the location where you want to install Zephyr. Make sure the disk has enough free space:

5. Choose Data Center deployment, as you are installing Zephyr on a cluster node:

6. Add the license file you received from Zephyr Sales:

7. Select the Standard installation type to use predefined ports, or Custom to use some other ports:

8. In the subsequent window, select the type of the external database you set up earlier, specify the username and password you use to connect to it, the database URL, and the database driver file:

9. Click Test Connection to check that Zephyr can connect to the database:

10. In the next window, specify the host name or the IP address and port used by Elasticsearch. If you have several Elasticsearch nodes, separate their addresses with commas:

11. In the subsequent window, configure shortcuts and click Next:

12. Wait for the installer to finish the product installation:

13. After you install Zephyr, make sure it is up and running, and then stop the node.

2. Install Zephyr Enterprise on another node:

The command is case-sensitive.

3. Once the installation is complete, stop the node.

You can use any number of nodes. If you want to add more nodes, repeat steps 2-3, at that, keep in mind that:

Write down the IP address of each node – you will need them at the next step. 

4. After you install Zephyr Enterprise on all the nodes, you need to modify the following file on each node:
<Zephyr Directory>/tomcat/webapps/flex/WEB-INF/classes/hazelcast.properties

In this file, find the following lines and change the values as shown below:

zephyr.hz.cluster.enabled=false - set it to true.
zephyr.hz.cluster.name=zephyr-hazelcast-cluster - specify a unique name for each cluster, for example, zephyr-hazelcast-cluster_smartbear.
zephyr.hz.interfaces.enabled=false - set to true.
zephyr.hz.interface=127.0.0.1 - This is the IP of the IP interface. Replace it with an IP address that has asterisks instead of the last two components. For example: zephyr.hz.interface= 192.168.*.*
zephyr.hz.tcp-ip.enabled=false - set it to true.
zephyr.hz.members=127.0.0.1 - specify the IP addresses and port number of each node separated by a comma. For example: zephyr.hz.members=192.168.0.1:5701,192.168.0.2:5701

5. Start Zephyr on the first node. When Zephyr starts, you will see the following line in the log file zephyrlocation/tomcat/logs/thedinc.log:

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

6. Start the other nodes.

7. Stop all the nodes.

Now you can set up a shared folder. To learn how to do that, click Next Step below.

< Prev Step Next Step >

See Also

Set Up Zephyr Data Center
Support and Troubleshooting