/
Zephyr Trial Installation for Windows

Zephyr Trial Installation for Windows

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-enterprise-trial/zephyr-trial-installation-for-window.html

This page will guide you through the steps to install and set up Zephyr Enterprise on Windows.

If you're ready to set up a production instance or have special installation requirements, refer to our production installation page.

This trial installation procedure uses the Embedded Database. Note that this installation is meant for trial instances only. It allows you to use Zephyr Enterprise from a trial perspective. We support only external databases for production. You cannot migrate or upgrade your embedded MySQL database for production purposes. The purpose of the embedded MySQL database is to test data meant for trial versions.

Prerequisites


For an installation on Windows, please ensure you meet our minimum requirements:

1. Ensure the minimum system requirements:

OS

Windows Server 2016 and 2019

CPU

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

RAM

Minimum 8GB; Preferred 12GB

Disk Space

At least 5GB

Networking

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 be "Run As Administrator"

2. Ensure you have the Zephyr licenses available. Zephyr has moved to using 1 license file that includes all the features available for the Zephyr product (this includes both Zephyr and Vortex).

Installation Overview

The installation will consist of the following steps:

  1. Java JDK installation and configuring the related environment variables.

  2. Elasticsearch installation and configuration.

  3. Microsoft Visual C++ Redistributable Package installation. 

  4. Zephyr installation.

The sections below will take you through each step separately.

Java Installation

Zephyr Enterprise can run either on OpenJDK 17.0.10 (recommended) or Oracle JDK 17.0.10. Follow the instructions below to install your preferred JDK.

OpenJDK Installation

  1. Go to https://jdk.java.net/java-se-ri/17.

  2. Unzip the archive to some folder, for example, to C:\Program Files\OpenJDK or C:\OpenJDK.

Oracle JDK Installation

1. Download JDK 17.0.10 for Windows x64 from the Oracle website: https://www.oracle.com/java/technologies/downloads/?er=221886#java17

You must download exactly this file: Windows x64 jdk-17-windows-x64.exe (210.18MB)

You must accept the Oracle terms of use and to do this, you must either create an Oracle account or login with an existing Oracle account to be able to download the file.

2. Once downloaded, run the installer and follow the default steps.

Configuring Environment Variables

After you install OpenJDK or Oracle JDK, you must configure the environment variables that specify the paths to the JDK folder:

1. In the Windows Search Bar, type in "Edit the system environment variables" which is nested in the Control Panel.

2. The System Properties window will open and in this window, click on "Environment Variables…".

3. In the top window click on the Path and click on "Edit…".

4. A new window will open for the Edit environment variable. Click on "New…" and then click on "Browse.." to locate your Java bin folder. After this is done, click "OK".

The typical folder location is:
for OpenJDK: C:\<SomeFolder>\jdk-17\bin
for Oracle JDK: C:\Program Files\Java\JDK_17.0.<version>\bin

 

 

5. In the upper section, click on "New..." and fill out the Variable name and value.

For the "Variable name" type in JAVA_HOME

For the "Variable value," click on "Browse Directory", locate the Java folder, and press "OK."

The typical folder location is:
for OpenJDK: C:\<SomeFolder>\jdk-17\bin
for Oracle JDK: C:\Program Files\Java\JDK_17.0.<version>\bin>

6. Click OK to close the Environment Variables window and then click OK to close the System Properties window.

Checkpoint: Verify Java is Properly Installed

Before proceeding, follow the steps below to ensure that the correct version of Java is installed along with the Paths:

In the Windows Search Bar, type in cmd to open the Windows Command Prompt.
Type java -version
This will display the default version of Java being used.
Ensure it says Java version 17.x or similar.

Elasticsearch Installation

Zephyr Enterprise requires Elasticsearch to be installed and configured properly. The supported Elasticsearch version is 8.6.2.

You do not need to download extra plugins as they are not crucial.

3. Once successfully installed, configure Elasticsearch:

1. Open the "This PC" folder, click on the View tab and ensure that the Hidden Items checkbox is checked.

2. Navigate to your Elasticsearch.yml file.

The file can typically be found here "C:\ProgramData\Elastic\Elasticsearch\config"

3. Right-click the Elasticsearch.yml file and select Properties.

This will display the Elasticsearch properties window.

4. Navigate to the Security tab and click Edit…

5. For your user, ensure that you check the box Allow for Full Control and then click Apply and OK.

This changes the security permission for the Elasticsearch.yml file to allow the user to make changes to the file.

  1. Open the Elasticsearch.yml file in a text editor. Delete the existing content in the file. Afterwards, copy and paste the below configurations in the file and then save the Elasticsearch.yml file.

For more details, refer the instructions in