Set Up Zephyr Data Center Cluster

About

Zephyr Data Center is a Zephyr Enterprise solution with horizontal scalability support for high availability, scalability, and performance. It involves deploying Zephyr Enterprise on multiple nodes, which are stateless engines where all the business logic resides, along with an external database and a shared folder as shown below:

Open

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.

• RabbitMQ 3.12.10 – It is a robust messaging and streaming broker that's easily deployable across cloud environments and on-premises setups. Currently, installing RabbitMQ is optional for the users. Java 17 is required for using RabbitMQ 3.12.10.

• ZE-Services – Currently, installing ZE-Services is optional for the users. Java 17 is mandatory for using ZE-Services.

  • ZE-Webhook Service is the component responsible for accepting the incoming events from Jira and enqueues them to the message broker for further processing.

  • ZE-Consumer Service is the component that picks the enqueued events from the message broker and updates ZE with the incoming data.

  • ZE-AuditService is the component that acts as the incoming endpoint for the Audit Logs generated during the incoming webhook event processing and enqueues them to the message broker.

  • ZE-AuditProcessor is the component responsible for reading the enqueued audit logs from the message broker and inserting them into ZE.

Recommended Configurations

The deployment components may vary depending on the number of concurrent users who will work with Zephyr Data Center. There are three recommended configurations:

Configuration 1: Up to 100 concurrent users

* Depending on the database size.

Configuration 2: 100 - 500 concurrent users

* Depending on the database size.

Configuration 3: 500 - 1500 concurrent users.
Recommended OS: Linux

* Depending on the database size.

Requirements

• Zephyr Data Center Requirements

• JVM Allocation

• 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 steps:

1. Connect to an external database
2. Install & configure Elasticsearch
3. Install Zephyr Enterprise on your nodes
4. Set up a shared directory
5. Configure load balancer
6. Bring up the whole system

See Also

Upgrading Zephyr Enterprise
Support and Troubleshooting