/
Installation on Ubuntu

Installation on Ubuntu

Jan 22, 2018

This section applies specifically to the Zephyr Enterprise Server product. The information below is generally used to ensure that system administrators can install their new Zephyr Enterprise Server product instance on a Ubuntu Linux environment. 


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

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.


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

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 Sales Account Manager or send an email to sales@getzephyr.com

  • Download required software

    • Java: 

      • Java JDK 8u101 or higher

        • Downloaded from:

          • Ubuntu's default package manager

          • Oracle's download page here

    • MySQL:

      • 5.6.33 or higher

        • Downloaded from Ubuntu's package manager

      • MySQL Connector/J 5.1.41

        • Downloaded from here

    • Zephyr Enterprise 5.0 Linux Software

Installing Java

Using Ubuntu's Package Manager

1. Use Ubuntu's built-in package manager to download and install the Java JKD package by following the commands detailed below:

sudo apt-get install python-software-properties sudo add-apt-repository ppa:webupd8team/java sudo apt-get update sudo apt-get install oracle-java8-installer



2. Set the JAVA_HOME environment variables to point to the location where Java JDK version 8 was installed

Find the path using:

sudo update-alternatives --config java


Copy the path from preferred installation and edit the file ‘/etc/environment’:

sudo vi /etc/environment


Add the following line (replacing YOUR_PATH by the just copied path) and save:

JAVA_HOME="YOUR_PATH"


Reload this file:

sudo source /etc/environment


Verify java installation and JAVA_HOME location:

shell> java -version echo $JAVA_HOME



Using Oracle's download page and installing manually

1.  Execute the Java JDK installation with the command:

shell> rpm –ivh  jdk-8u101-linux-x64.rpm



2. Set the /usr/bin/java (also: javac javaws javadoc jar jcontrol) symbolic links to point to where the rpm installed the JDK (note: a clean rpm install should already have done this)

shell> cd /usr/bin shell> rm -f java shell> ln -s /usr/java/default/bin/java java



3. Add JAVA_HOME environment variable to point to the location where Java JDK version 8 was installed

shell> export JAVA_HOME=/usr/java/default



4. Update the PATH variable to point to the bin folder

shell> export PATH=/usr/java/default/bin:$PATH


5 (Optional). Verify java installation version - Sun/Oracle Java JDK 8

shell> java –version