Data Center Installation on Windows

Owned by Daniel (Deactivated)
Last updated: Jan 23, 2018 by Kevin Pham (Deactivated)

This section applies specifically to the Zephyr Enterprise Data Center product. The information below is generally used to ensure that system administrators can install their new Zephyr Enterprise Data Center product instance on a Windows environment using the GUI or Command Line. 


This section provides step-by-step instructions for installing the Zephyr Enterprise Data Center on Windows. This is just one part of a larger setup for Zephyr Enterprise Data Center to be setup and work properly. Please be sure to have read the sections below before proceeding to the steps.

Prerequisites

  • Review all system requirements thoroughly
  • Have a database installed, running, and configured to connect with Zephyr Enterprise Data Center
    • If this is not done, please proceed here to begin database setup
  • Ensure you have the correct Data Center 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 send an email to sales@getzephyr.com
  • Ensure timezone setting for all nodes are uniform
  • Download and install required software
    • Java JDK 8u101 or higher
      • Download from here
  • Download Zephyr Enterprise Data Center

Installing Java

Follow Oracle's install instructions linked here. Once installation is complete, set the environment variables and continue to installing Zephyr Enterprise section below

Installing Zephyr Enterprise Data Center

Step 1:
For the first node installation (NODE 1), run the installer as normal.

For all subsequent nodes, run the installer from the command line using the option to skip database modification, ie:

zephyr_5.0_XXXXX_64bit_setup.exe -VzSkipStartupData=true -VzSkipZephyrServerStart=true -VzSkipDropData=true


Step 2:
After running the installer, you will be greeted with the installer Welcome screen
 


 
Step 3:
A quick reminder on the requirements needed to install and run Zephyr successfully
 

 
Step 4:
EULA screen is next. The installation will not proceed further if the terms of the license agreement are not acceptable
 

 
Step 5:
The destination location of where the Zephyr server needs to be installed. You should make sure that you have enough disk space on that drive for the installation
 

 
 
Step 6:
Select the deployment option.  For installation of Zephyr Enterprise Data Center, select "Data Center deployment" and continue to Step 6.  For installation of Zephyr Enterprise Data Center, reference the Installation of Zephyr Enterprise Server section


 

Step 7:
This steps allows the addition of a license file that you would have received from Zephyr Sales
 


 
Step 8a:
2 types of Setup are possible - Standard or Custom. In the Standard installation, all the predefined ports are used for running Zephyr. These are:

  • Port 80 for client access to server
  • Port 8005 for internal server use

If you already have other applications using one or many of these ports, chose the Custom installation setup type and you will have the opportunity to pick alternate ports for Zephyr (see Step 7b)
 
Else proceed to Step 8:
 

 
 
Step 8b:
This step allows you to customize the various ports if there is a conflict with an existing application
 

 
Step 9:
You will need to provide the database type, username, and password which Zephyr Enterprise Data Center will use to read/write data to the database and the Database URL along with the database driver file location. Once this information is entered, test the connection to the database by clicking the "Test Connection" button. The 'Next' button will not become active until a successful test is made.


 


  • Don't use "localhost" even if MySQL and Zephyr Enterprise Data Center are on the same machine. Instead, provide the IP address of the machine where MySQL is installed
  • Provide the port number that MySQL is configured to
  • Reference a JDBC file stored locally


Step 10:
This step allows the customization of the Program Group name ("Zephyr" is the default) as well as the options for creating Windows Desktop and Quick Launch shortcuts
 

 
Step 11:
Files are now being extracted from the installer and configurations made
 

 
Step 12:
At the end of that process, the Zephyr Enterprise Data Center installation is complete and the Zephyr service will automatically start. You have the final option of opening the Zephyr Enterprise login page upon finishing the installation
 

Zephyr Enterprise Data Center is now installed for a single node. Continue installing Zephyr Enterprise Data Center for every node you wish to use in the cluster by following the steps again for each node.

Update the PATH and JAVA_HOME variables in Windows

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: 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. 


Back to Top ^