Set Up Zephyr Data Center
About
Zephyr Data Center is a solution you use to organize testing by using cluster machines. You deploy Zephyr on multiple nodes, set up an external database and create a shared folder – all this is done to provide high availability and performance at scale for the users working with Zephyr. If a node fails for some reason, the requests are redirected to the other nodes:
Â
The deployment components include the following:Â
Load Balancer - balances the load across the cluster nodes.
Elasticsearch – a search engine deployed on the server node as a micro service or as a separate process in the virtual private network. Â
Shared database – a shared database used by the nodes. Zephyr supports MySQL, MS SQL Server, and Oracle Database.Â
Shared directory – a shared folder where attachments are stored. In a cluster environment, this folder must be shared with write permissions. Network-attached storage (NAS) and similar devices are supported.
It is recommended to have this clustered deployment behind a firewall.
Requirements
The same Java version must be installed on all the nodes.
The same time zone must be set on all the nodes and the current time must be synchronized (use the Network Time Protocol daemon (ntpd) or a similar service).
Installation procedure
To install Zephyr Enterprise on cluster nodes, you need to perform the following:
1. Install a database
You can install one of the following database management systems on any computer where Zephyr is not installed:
MySQL (make sure the ITCC and Dversion databases are not installed)
You must have a connector JAR file for your MySQL, Microsoft SQL Server or Oracle database.
2. Install Elasticsearch
Install Elasticsearch 5.5.0 (a search engine) on any computer where Zephyr is not installed.
3. Set up a shared directory
4. Install Zephyr Enterprise on your nodes
When installing Zephyr on your nodes, keep in mind the following:
You can install Zephyr on any drive other than drive C.
Before installing Zephyr, you need to make sure the ITCC and Dversion databases are not installed on the node.
Use the same Zephyr version and build on all the nodes.
Zephyr installed on all the nodes must have the same license.
Installation steps:
Install Zephyr Enterprise on nodes. The installation steps on the first node differ from the steps you perform on the other nodes.
1. To install Zephyr Enterprise on the first node:
2. After you install Zephyr, stop the node.
3. Install Zephyr Enterprise on another node. The way you do this depends on your operating system:
4. Once the installation is complete, stop the node.
You can use any number of nodes. If you want to add more nodes, repeat steps 3-4.
5. After you install Zephyr Enterprise on all the nodes, you need to modify the following files:
6. On all the nodes, open the folder zephyr/tomcat/webapps/flex/WEB-INF/template, copy the file cluster.properties.tmpl, paste it to the folder zephyr/tomcat/webapps/flex/WEB-INF/classes and change the file name to cluster.properties.
7. Make the following changes in the cluster.properties file:
Remove the following lines:
#unique identifier for the cluster node
cluster.aws.enable=false
HAZELCAST_PASSWORD=huser
HAZELCAST_USERNAME=hpass
Update the following information:
cluster.key=node1 (this should be a unique name of the node)
cluster.node.1.key=node1
cluster.node.1.url=172.17.18.141 (the IP address of node 1)
cluster.node.count=4
cluster.node.2.key=node2
cluster.node.2.url= 172.17.18.157(the IP address of node 2)
cluster.node.3.key=node3
cluster.node.3.url=172.17.18.223 (the IP address of node 3)
cluster.node.4.key=node4
cluster.node.4.url=172.17.18.201 (the IP address of node 4)
The cluster.key
name must be unique in each file.
8. Start the first node where you installed Zephyr. Zephyr will start on it. After Zephyr is launched, the HAZELCAST_USERNAME and HAZELCAST_PASSWORD values will be generated in the zephyr/tomcat/webapps/flex/WEB-INF/classes/cluster.properties file.
9. Copy the HAZELCAST_USERNAME and HAZELCAST_PASSWORD values and paste them to the zephyr/tomcat/webapps/flex/WEB-INF/classes/cluster.properties file on the other nodes.
Now you can use your nodes.
See Also
Â
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