For multiple nodes clustered installation of Zephyr or to use an external Database other than MySQL, please refer to the Zephyr Data Center Requirements and the Connecting to an External Database.

• When installing Zephyr, users can choose to select Data Center Deployment for multiple nodes when going through the installation process and choosing the Deployment Type.

After installing the Zephyr Server product, you can upgrade the product if need be. Please use the link provided below if you need to upgrade Zephyr Server:

• Zephyr Upgrade

Prerequisites

---

• Review all system requirements thoroughly.

• Ensure you have the license file (license.lic) as this will be required during the installation process. If you do not have this license file, please contact your Zephyr Account Manager or contact Zephyr Sales at sales@getzephyr.com.

• Download the required software:

  • Java - one of the following:

    • OpenJDK 8 (recommended): Download here / Unzip to any folder

    • Oracle Java JDK 8 (update u101 or later): Download - here / Installation instructions - here

  • MySQL 5.6.x or 5.7.x Series: Download - here /  Upgrade / Installation instructions - here

  • Elasticsearch v. 7.9.2: Download - here /  Installation instructions - here

  • Zephyr Server for Windows: Download - here

Update the PATH and JAVA_HOME environment variables

---

Zephyr needs a couple of environment variable set once you have the JDK installed. You can set the variables this way to allow it to persist through reboot.

Setting up PATH in Windows (steps might vary with Windows version):

1. Click Start > Control Panel > System

2. Click Advanced > Environment Variables

3. Scroll through the fields until you find PATH

4. Add the location of the bin folder of the install for PATH in System variables (do not delete the existing value, just add to the beginning of it).

A typical path is:

• for OpenJDK: C:\SomeFolder\java-se-8u41-ri\bin

• for Oracle JDK: C:\Program Files\Java\JDK_1.8.0_<version>\bin

Setting up JAVA_HOME in Windows (steps might vary with Windows version):

1. Click Start > Control Panel > System

2. Click Advanced > Environment Variables

3. Scroll through the fields until you find JAVA_HOME, if it's not present Add it to the System variables.

4. Add the location of the JDK root folder to the value of JAVA_HOME in System variables. 

A typical path is:

• for OpenJDK: C:\SomeFolder\java-se-8u41-ri

• for Oracle JDK: C:\Program Files\Java\JDK_1.8.0_<version>

Important: make sure you have specified the correct path!

Install Zephyr Server

---

1. Double-click the setup file. The following Welcome screen appears.

 
2. A quick reminder will pop up on the requirements needed to install and run Zephyr.

3. Review the mandatory acceptance of our Licensing Agreement before continuing.

• The installation will not proceed further if the terms of the license agreement are not accepted

4. Select the destination location of where the Zephyr server needs to be installed.

• Make sure the specified disk drive has enough free space.

 
 
5. Select the deployment type.  

• To install Zephyr Server, select Server deployment and continue to Step 6.  

• To install Zephyr Data Center, select Data Center deployment and see the Set Up Zephyr Data Center section.

 

6. Add the license file.

• You would have received the license file from Zephyr Sales.

 
7a. Select one of the 2 types of Setup - Standard or Custom.

• In the Standard installation, there are predefined ports used for running Zephyr. These ports are:

  • Port 80 for running the Zephyr Server (standard HTTP port)

  • Port 8005 for running the Zephyr Server

  • Port 37638 for running the Zephyr Database

• Choose the Custom installation setup type if you have other applications using one or many of these ports.

  • You choose to pick alternate ports for Zephyr (see 7b)

• Else, proceed to Step 8.

 
 
7b. Simply enter a different port from the default port that was provided.