Versions Compared

Key

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

Anchor
Top
Top

Column

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:

...

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

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

...

Code Block
themeEmacs
shell> java –version

Installing MySQL

...

1. Install MySQL RPMs in the order shown below:

Code Block
themeEmacs
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'.

...

Code Block
themeEmacs
shell> cat /root/.mysql_secret


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

Code Block
themeEmacs
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

...

Info
titleAdditional 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

Code Block
themeEmacs
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


5. Restart MySQL.  Based on the standard MySQL installation a MySQL script is added to the init.d directory that you can use to Start or Stop MySQL server:

Code Block
themeEmacs
shell> /etc/init.d/mysql stop

...

6. This step will prompt you to enter the directory location of your license file provided by Zephyr Sales


 


7. This step allows the customization of the ports used by Zephyr.

...