Versions Compared

Key

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


Info

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


Warning

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

  • Zephyr Enterprise 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 you to have Zephyr Enterprise installed on a separate instance from where you have your Jira/Tomcat installed. 
  • RabbitMQ and ZE Services should be installed in a separate server as we require Java 17.

Zephyr Enterprise Server (for Windows On-

...

Premises installations only)

OS

Windows Server

2008 / 2012 /

2016

/ 2019
Windows 7 Enterprise / Windows 8 Enterprise / Windows 10 Enterprise

and 2019

CPU

Quad-core CPU Intel Pentium or AMD Opteron (

2Ghz

2 GHz or higher)

RAM

Minimum

8GB

8 GB; Preferred

12GB

12 GB
RAM recommendations can be found here

 

Disk Space

At least

5GB Free (250GB-1TB

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

needs

need to "Run As Administrator"

Software

  • Java: OpenJDK 17.0.10 (recommended) or Oracle JDK

  • 17.0.10.

  • Oracle JDK must be JDK
8u101 or higher. JRE is not supported

Note:

NO

No other Tomcat or MySQL can be installed on the machine.

JRE is not supported††
  • Please refer to Note on Oracle JDK License Update
  • DatabaseMySQL 5.6 or 5.7 series

    ...

    ††

    Database

    MySQL 8.0.35 

    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 or later 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

    Zephyr Enterprise Server (for Linux On-

    ...

    Premises installations only)

    MySQL 5.6 or 5.7 series

    OS

    RedHat 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 2 GHz or higher)

    RAM

    Minimum 8GB8 GB; Preferred 12GB12 GB

    Disk Space

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

    Networking

    Wired Ethernet
    Static IP address
    REQUIRED Ports: 80, 443 (if HTTPSfor root user) and 1024, 8443 (for non-root user)
    Firewall (if present): Allow ports 80, 443 (if HTTPSfor root user) and 1024, 8443 (for non-root user). Must support WebSocket protocol
    Proxy (if present): Must support WebSocket protocol

    Account

    Superuser (root) access to the machine 
    Installer and services needs to run as "root"will be installed as the current user

    Software

    Java: OpenJDK 17.0.10 (recommended) or Oracle JDK 817.0.10.

    MySQL Connector-  JDBC 5.1.40

    • Note: NO other Tomcat or MySQL can be installed on the machine. JRE is not supported††
    Database
    • 17.0.10.
    Database

    MySQL 8.0.35

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

    Currently, installing RabbitMQ is optional

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

    Currently, installing ZE-Services is optional

    ZE-Services (Java 17.0.10 or later 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

    Zephyr Client

    OS

    Any Desktop OS

    Browser

    Any one of these versions that support Web SocketsWebSockets:

    • Chrome
    • Firefox
    • Safari
    • Internet Explorer 11 is not recommended
    • Edge

    Networking

    Client The client machine must have access to port 80 for HTTP connection (or 443 for HTTPS) to the Zephyr Server

    OtherScreen resolution of 1280x1024 (1280x900 for widescreen) or higher

    ZBots

    OS

    Windows Server 2008 / 2012 / 2016 / or 2019
    Windows 7 Enterprise / Windows 8 Enterprise / , or Windows 10 Enterprise
    Linux (RedHatRed Hat, Fedora, Ubuntu, CentOS, SUSE) 
    MacOS macOS 

    CPU

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

    RAM

    Minimum 1GB1 GB

    Disk Space

    At least 100MB Free100 MB

    Networking

    Wired Ethernet

    Account

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

    Software

    OpenJDK 17.0.10 or Oracle JDK 8. JRE is not supported17.0.10

    Database Requirements

    Evaluation EnvironmentProduction Environment
    The Zephyr Enterprise installer provides an option for using Embedded MySQL for the database. This should only be used for evaluation purposes and not for production instances. We recommend you always use an external database for improved performance and easy maintenance when setting up your production instance/server. This provides you with proper system performance for your Zephyr instance.


    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.

    Ports Explained

    Anchor
    ports
    ports
    Ports explained:

    • 80, 443(if HTTPS), 8005 443 (for root user) and 1024, 8443 (for non-root user) 8005, and 8009 are used by tomcat Tomcat and can be configured in the server.xml file under zephyr\tomcat\conf\
    • 3306 is used by MySQL in Linux and configured in the my.cnf
    • 9300 9200 is used by Elastic searchElasticsearch
    • 5701, 5702, 37000, 37001 are used by Hazelcast
    • 5672, 15672 are used by RabbitMQ

    Software Version Explained:

    • Elasticsearch 5.5.0 is strictly required for installing Zephyr Server.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

    Anchor
    versions
    versions
    Software versions explained:

    • 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 (58.6.X or 5.7.X0.x) version.
      • No other MySQL should be present on the server instance.
    • Oracle JDK must be JDK 8u101 or higher. JRE is not supported17.0.10.
    • Zephyr Enterprise Server for Windows includes MySQL in the installation package on top of allowing 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 that's easily deployable across cloud environments and on-premises setups. Currently, installing RabbitMQ is optional for the users. Java 17.0.10 or later is required to use RabbitMQ.
    • ZE-Services. Currently, installing ZE-Services is optional for the usersJava 17.0.10 or later 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.