Zephyr Server Requirements
Important
Zephyr Enterprise must run on an isolated instance where no Jira or any other Tomcat is running.
Zephyr Enterprise should only be installed on its server. If you are running a Jira instance, it should be installed on a different server.
We recommend you have Zephyr Enterprise installed separately from where your Jira/Tomcat is installed.
RabbitMQ and ZE Services should be installed on a separate server, as Java 17 is required.
Zephyr Enterprise Server (for Windows On-Premise installations only)
OS | Windows Server 2016 and 2019 |
CPU | Quad-core CPU Intel Pentium or AMD Opteron (2 GHz or higher) |
RAM | Minimum 8 GB; Preferred 12 GB RAM recommendations can be found here |
Disk Space | At least 5 GB free (250 GB-1 TB recommended for large enterprise installations) |
Networking | Wired Ethernet Static IP address REQUIRED Ports: 80, 443 (if HTTPS) Firewall (if present): Allow ports 80 and 443 (if HTTPS). Must support WebSocket protocol Proxy (if present): Must support WebSocket protocol |
Account | Administrator access to the machine Installer and services need to "Run As Administrator" |
Software | Java: OpenJDK 17.0.13 (recommended) or Oracle JDK 17.0.13.
Note: No other Tomcat or MySQL can be installed on the machine |
Database | MySQL 8.0.35 |
ElasticSearch | v. 8.6.2: Download - here / Installation instructions - here |
RabbitMQ (optional) | Currently, installing RabbitMQ is optional |
ZE-Services (optional) | Currently, installing ZE-Services is optional ZE-Services (Java 17.0.13): |
Zephyr Enterprise Server (for Linux On-Premise installations only)
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 (2 GHz or higher) |
RAM | Minimum 8 GB; Preferred 12 GB |
Disk Space | At least 5 GB free (250 GB-1 TB 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) Firewall (if present): Allow ports 80, 443 (for root user) and 1024, 8443 (for non-root user).Must support WebSocket protocol Proxy (if present): Must support WebSocket protocol |
Account | The installer and services will be installed as the current user. |
Software | Java: OpenJDK 17.0.13 (recommended) or Oracle JDK 17.0.13.
|
Database | MySQL 8.0.35 |
ElasticSearch | v. 8.6.2: Download - here / Installation instructions - here |
RabbitMQ (optional) | Currently, installing RabbitMQ is optional |
ZE-Services (optional) | Currently, installing ZE-Services is optional ZE-Services (Java 17.0.13): |
Zephyr Client
OS | Any Desktop OS |
Browser | Any one of these versions that support WebSockets:
|
Networking | The client machine must have access to port 80 for HTTP connection (or 443 for HTTPS) to the Zephyr Server. |
Other | Screen resolution of 1280x1024 (1280x900 for widescreen) or higher |
ZBots
OS | Windows Server 2016 or 2019 Windows 8 Enterprise or Windows 10 Enterprise Linux (Red Hat, Fedora, Ubuntu, CentOS, SUSE) macOS |
CPU | Dual-core CPU Intel Pentium or AMD Opteron (2 GHz or higher) |
RAM | Minimum 1 GB |
Disk Space | At least 100 MB |
Networking | Wired Ethernet |
Account | Administrator access to the machine Installer and services need to "Run As Administrator" |
Software | OpenJDK 17.0.13 or Oracle JDK 17.0.13 |
Database Requirements
Evaluation Environment | Production Environment |
|---|---|
The Zephyr Enterprise installer provides an option for using embedded MySQL in the database. However, it is recommended that you use embedded MySQL only for evaluation purposes only and not for production instances. | When setting up the production instance, use an external database for better performance and easy maintenance. This ensures proper system performance for your Zephyr Enterprise instance. |
Important
All port numbers mentioned are defaults and can be configured to suit your specific environment. If any firewalls or proxies are present, they must 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 configured in the server.xml file under zephyr\tomcat\conf\
3306 is used by MySQL in Linux and configured in the my. cnf
Elasticsearch uses 9200
Hazelcast uses 5701, 5702, 37000, and 37001
RabbitMQ uses 5672, 15672
ZE-Webhook Service uses 8081
ZE-Consumer Service uses 8082
ZE-AuditService uses 8083
8084 is used by ZE-AuditProcessor
Supported Software versions:
Elasticsearch is required to install the Zephyr Enterprise Server. The supported Elasticsearch version is 8.6.2.
The MySQL software has to be the major/minor (8.0.x) version.
No other MySQL should be present on the server instance.
Oracle JDK must be JDK 17.0.13 or later.
Zephyr Enterprise Server for Windows includes MySQL in the installation package and allows remote MySQL.
Zephyr Enterprise Server for Linux requires a separate installation of MySQL not included in the installation package on top of allowing remote MySQL.
RabbitMQ 3.12.10 is a robust messaging and streaming broker easily deployable across cloud environments and on-premises setups. Installing RabbitMQ is optional for users, and Java 17.0.13 is required for using RabbitMQ.
ZE-Services. Installing ZE-Services is optional for users, and Java 17.0.13 is required 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.