Versions Compared

Key

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

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 /wiki/spaces/ZEE50/pages/77824238Zephyr Enterprise Data Center installation guide.

Before you begin

  • Review all /wiki/spaces/ZEE50/pages/77856795system 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:

...

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

...

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

 
Step 2:
A quick reminder on the /wiki/spaces/ZEE50/pages/77856795 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 /wiki/spaces/ZEE50/pages/77824238 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:

...

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 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 /wiki/spaces/ZEE50/pages/77857381 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
 

...

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>