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 here
- MySQL:
  - 5.6.33 or higher
    - Downloaded from here
  - MySQL Connector/J 5.1.41
    - Downloaded from here
- Zephyr Enterprise 5.0 Linux Software

Installing Java

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 Sun/Oracle Java version 8 Update 101 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

Installing MySQL

1. Install MySQL RPMs in the order shown below:

shell> rpm -ivh MySQL-client-5.6.33-1.linux_glibc2.5.x86_64.rpm
shell> rpm -ivh MySQL-shared-5.6.33-1.linux_glibc2.5.x86_64.rpm
shell> rpm -ivh MySQL-devel-5.6.33-1.linux_glibc2.5.x86_64.rpm
shell> rpm -ivh MySQL-server-5.6.33-1.linux_glibc2.5.x86_64.rpm

2. Set the MySQL root user password. “server” rpm installation typically displays the following message.

A RANDOM PASSWORD HAS BEEN SET FOR THE MySQL root USER! You will find that password in '/root/.mysql_secret'.

Change that password on your first connect

Start the MySQL server

shell> /etc/init.d/mysql start

Get the auto-generated password

shell> cat /root/.mysql_secret

3. Connect to MySQL using the auto-generated password from the .mysql_secret file and change the root password:

shell> mysql -uroot -p
mysql> SET PASSWORD FOR 'root'@'localhost' = PASSWORD('<ANYTHING YOU WANT>');
mysql> SET PASSWORD FOR 'root'@'127.0.0.1' = PASSWORD('<ANYTHING YOU WANT>');
mysql> flush privileges;
mysql> quit

Additional Notes

This specific major/minor (5.6.X) version of MySQL is required with the root username as specified above. If you have other MySQL installations on the machine we recommend removing them or installing this version on top of them and upgrading their schemas to what is specified.

4. Create or modify my.cnf file as shown below. Typically my.cnf file is in /etc/ folder

shell> vi /etc/my.cnf

[mysqld]
datadir=/var/lib/mysql
socket=/var/lib/mysql/mysql.sock
user=mysql
max_allowed_packet = 150M
max_connections = 600
default-storage-engine=INNODB
character-set-server=utf8
collation-server=utf8_unicode_ci
sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES

[mysqld_safe]
log-error=/var/log/mysqld.log
pid-file=/var/run/mysqld/mysqld.pid
default-storage-engine=INNODB
character-set-server=utf8
collation-server=utf8_unicode_ci

[mysql]
max_allowed_packet = 150M

[mysqldump]
quick
max_allowed_packet = 150M

Installation on CentOS

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 CentOS Linux environment.

This section provides step-by-step instructions for installing single node Zephyr Enterprise Server on CentOS 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

Installing Java

Installing MySQL