Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info

Starting Release October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation has moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise Documentation documentation page. Please  Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-installation---upgrade-guides/zephyr-system-requirements/zephyr-data-center-requirements.html

...

Warning

Zephyr must run in an isolated instance where no Jira is running or any other Tomcat.

  • Zephyr should only be installed on its own server. If you are running a Jira instance, it should be installed on a different server.
  • We recommend that you install Zephyr on a separate instance from where you install Jira or Tomcat.
  • RabbitMQ and ZE Services should be installed on a separate server as we require Java 17 (optional).

...

OS

Windows Server 2016 and 2019

CPU

Quad-core CPU Intel Pentium or AMD Opteron (2GHz or higher)

RAM

Minimum 8GB; Preferred 12GB
RAM recommendations can be found here 

Disk Space

At least 5GB Free (250GB-1TB recommended for large enterprise installations)

Networking

Wired Ethernet
Static IP address
REQUIRED Ports: 80, 443 (if HTTPS), 8005, 9300, 5701, 5702, 37000, 37001
Firewall (if present): Allow ports 80, and 443 (if HTTPS). Must support WebSocket protocol
Proxy (if present): Must support WebSocket protocol
Nodes should have at least 1Gbps Ethernet connectivity (10Gbps recommended)

Account

Administrator access to the machine 
Installer and services need to "Run As Administrator"

Software

Java: Oracle JDK 17 and Open JDK 17.0.10
Note: NO other Tomcat can be installed on the machine. ††

ElasticSearchv. 8.6.2: Download - here / Installation instructions - here
RabbitMQ (​optional​)

Currently, installing RabbitMQ is optional

  • RabbitMQ 3.12.10 (Java 17 is required) / Download - here / Installation instructions - here
ZE-Services (optional)

Currently, installing ZE-Services is optional

ZE-Services (Java 17.0.10 required):

  • ZE-Webhook: Download - here / Installation instructions - here

  • ZE-Consumer Deployment: Download - here / Installation instructions - here

  • ZE-AuditService Deployment: Download - here / Installation instructions - here

  • ZE-AuditProcessor Deployment: Download - here / Installation instructions - here

...

OS

Red Hat Enterprise 64-bit (the latest supported version is RHEL 8)

CentOS 64-bit

Ubuntu/Debian 64-bit 

SUSE/openSUSE 64-bit

CPU

Quad-core CPU Intel Pentium or AMD Opteron (2GHz or higher)

RAM

Minimum 8GB; Preferred 12GB

Disk Space

At least 5GB Free (250GB-1TB recommended for large enterprise installations)

Networking

Wired Ethernet
Static IP address
REQUIRED Ports: 80, 443 (for root user) and 1024, 8443 (for non-root user), 8005, 9300, 5701, 5702, 37000, 37001
Firewall (if present): Allow ports 80, 443 (for the root user), and 1024,8443 (for non-root user). Must support WebSocket protocol
Proxy (if present): Must support WebSocket protocol
Nodes should have at least 1Gbps Ethernet connectivity (10Gbps recommended) 

Account

Installer and services will be installed as the current user

Software

Java: Oracle JDK 17.0.10 and Open JDK 17.0.10
Note: No other Tomcat can be installed on the machine. ††

ElasticSearchv. 8.6.2: Download - here / Installation instructions - here
RabbitMQ
(optional)

Currently, installing RabbitMQ is optional

  • RabbitMQ 3.12.10 (Java 17.0.10 is required) Download - here / Installation instructions - here
ZE-Services
(optional)

Currently, installing ZE-Services is optional

ZE-Services (Java 17.0.10 is required):

  • ZE-Webhook: Download - here / Installation instructions - here
  • ZE-Consumer Deployment: Download - here / Installation instructions - here
  • ZE-AuditService Deployment: Download - here / Installation instructions - here
  • ZE-AuditProcessor Deployment: Download - here / Installation instructions - here

...

OS

Windows Server 2016 or 2019
Linux (Red Hat, Fedora, Ubuntu, CentOS, SUSE) 
macOS

CPU

Dual-core CPU Intel Pentium or AMD Opteron (2GHz or higher)

RAM

Minimum 1GB

Disk Space

At least 100MB Free

Networking

Wired Ethernet

Account

Administrator access to the machine 
Installer and services need to "Run As Administrator"

Software

Java: Oracle JDK 17.0.10 and Open JDK 17.0.10


Info
titleAdditional Notes

All port numbers mentioned are by default and can be configured to fit your specific environment setup. If any firewalls or proxies are present, it is required that they support the WebSocket protocol.

...

  • 80, 443 (for the root user) 1024, 8443 (for the non-root user), 8005, and 8009 are used by Tomcat and can be configured in the server.xml file under zephyr\tomcat\conf\
  • 9200 is used by Elasticsearch
  • 5701, 5702, 37000, 37001 are used by Hazelcast
  • Database system - 3306 (unless changed) for MySQL and 1433 (unless changed) for Microsoft SQL Server
  • Elasticsearch - 9200 on all nodes of the cluster including the one where Elasticsearch is installed
  • Zephyr Instances - 5701,5702 (inbound ports) and 37000,37001 (outbound ports)
  • Load Balancer - 80 (unless changed) for load balancer access
  • 5672, 15672 are used by RabbitMQ
  • 8081 is used by ZE-Webhook Service
  • 8082 is used by ZE-Consumer Service
  • 8083 is used by ZE-AuditService
  • 8084 is used by ZE-AuditProcessor

...

  • Elasticsearch is strictly required for installing Zephyr Data Center. The supported version is 8.6.2.
  • Oracle JDK 17.0.10 is required.
  • No other database should be present on the server node.
  • RabbitMQ 3.12.10 is a message broker software that receives messages from producers and forwards them to consumers, serving as middleware to alleviate loads and streamline delivery times on web application servers. Currently, installing RabbitMQ is optional for the users. Java 17 is required to use RabbitMQ.

  • ZE-Services. Currently, installing ZE-Services is optional for the usersJava 17.0.10 is required to use 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.

Additional deployment requirements:

...