Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 3 Next »

This section provides step-by-step instructions for installing single node Zephyr Enterprise Server 5.0 on Windows.

For multiple nodes clustered installation of Zephyr Enterprise or to use an external Database other than MySQL, please refer to the Zephyr Enterprise Data Center installation guide.

Before you begin

  • 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 send an email to sales@getzephyr.com
  • Download required software
    • Java: Java JDK 8u101 or higher
    • Zephyr Enterprise Server 5.0 Windows Software

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 Server

Step 1:
By double-clicking on the setup file, the following Welcome screen is seen
 

 
Step 2:
A quick reminder on the Requirements needed to install and run Zephyr successfully
 

 
Step 3:
The mandatory acceptance of our Licensing Agreement before continuing. The installation will not proceed further if the terms of the license agreement are not acceptable
 

 
Step 4:
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
 

 
 
Step 5:

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

Step 6:

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

 
Step 7a:
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 running the Zephyr Server (standard http port)
  • Port 8005 for running the Zephyr Server
  • Port 37638 for running the Zephyr Database

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 7b:
This step allows you to customize the various ports if there is a conflict with an existing application
 

 
Step 8a: 

Select your MySQL Database location.  Your options are to select the embedded MySQL which will install the database on the same server or VM where your Zephyr Enterprise Server is being installed or select an external installation of MySQL. If selecting the embedded MySQL database, no further database set up is required; proceed to Step 9

Step 8b:

If selecting an external MySQL database, you will need to provide a username and password which the Zephyr Enterprise Server 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 external MySQL database by clicking the "Test Connection" button



Step 9:
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 10:
Files are now copied and various services are started
 

 
Step 11:
At the end of that process, the Zephyr Enterprise Server installation is complete and allows for the Zephyr Desktop to be immediately launched
 

 
Note: Depending on the speed of the machine, it may take a few minutes for the login dialog to appear when launching Zephyr for the first time. This is to allow all services to start up correctly. Subsequent launches will be much faster
 

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.
 
A typical path is: C:\Program Files\Java\JDK_1.8.0_<version>

  • No labels