System Requirements

Zephyr Enterprise Server (for Linux On-Premise Installations only)

Zephyr Client

ZBots

Ports Explained:

• 80, 443(if HTTPS), 8005 and 8009 are used by tomcat and can be configured in the server.xml file under zephyr\tomcat\conf\
• 3306 is used by MySQL in Linux and configured in the my.cnf
• 9300 is used by Elastic search
• 5701, 5702, 37000, 37001 are used by Hazelcast

Software Version Explained:

• The MySQL software has to be the major/minor (5.6.X) version
• No other MySQL should be present on the server instance
• Oracle JDK must be JDK 8u101 or higher. JRE is not supported
• Zephyr Enterprise Server for Windows includes MySQL in the installation package on top of allowing remote MySQL
• Zephyr Enterprise Server for Linux requires a separate installation of MySQL not included in the installation package on top of allowing remote MySQL

Installing Java

Step 1.) Execute the Java JDK installation with the command:

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

Step 2.) Set the /usr/bin/java (also: javac javaws javadoc jar jcontrol) symbolic links to point to where the rpm installed the JDK.

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

Step 3.) Add the 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

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

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

 
Step 5.) Optional: Verify the java installation version - Sun/Oracle Java JDK 8

shell> java –version

Installing MySQL

Step 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

Step 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 can find the password in "/root/.mysql_secret".
  • When you first connect to the server, change the password.

Step 2.1) Start the MySQL server.

shell> /etc/init.d/mysql start

Step 2.2.) Get the auto-generated password.

shell> cat /root/.mysql_secret

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

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

Step 4.) Create or modify the my.cnf file as shown below.

• Typically the 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

Step 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 and Stop the MySQL server.

shell> /etc/init.d/mysql start
shell> /etc/init.d/mysql stop

Install Elastic Search

Step 1.) Download the .rpm file using either methods below:

• Download using the linux shell command prompt
  • Run the following command:
    • sudo rpm -ivh elasticsearch-5.5.0.rpm
• Download using the wget command from the linux shell command prompt
  • You can download the rpm file here.
    
    

Step 2.) Navigate to the installation path (Eetc/elasticsearch) >> elasticsearch.yml file

Step 3.) Edit the elasticsearch.yml file

• Change and update the following parameters:

cluster.name: zephyr
node.name: "Node1"
node.master: true
node.data: true

script.disable_dynamic: false
script.inline: true
script.indexed: true

index.number_of_shards: 2
index.number_of_replicas: 1

network.bind_host: (host IP)
network.publish_host: (host IP)
network.host: (host IP)
transport.tcp.port: 9300
http.port: 9200

discovery.zen.ping.timeout: 3s
discovery.zen.ping.unicast.hosts: ["192.168.45.21"]

Step 4.) Save the file.

Step 5.) Start the service by utilizing the following command:

• sudo systemctl start elasticsearch.service

Configure Elastic Search

Step 1.) In JDBC, change the transport nodes in the properties to the following:

#transport|node
transport.nodes=(host IP):9300

Install Zephyr Enterprise 6.1

Step 1.) Set the permissions.

• The name of the setup file below may be different and may correspond more to your Zephyr Enterprise 6.1.

shell> chmod +x zephyr_(Build Number)_linux_setup.sh

Step 2.) Launch the setup file with the '-c' command line option as shown below.

Step 3.) You'll be prompted with a quick reminder on the Requirements needed to install and run Zephyr successfully on Linux.

Step 4.) You'll be prompted with the full EULA.

• You must accept the terms presented before proceeding with the installation.
• Simply enter "1" to accept and "2" to decline.

Step 5.) You'll then be prompted to enter where to place the Zephyr Enterprise home directory.

• You'll also be notified of the required and available disk space as per the system requirements.

Step 6.) You'll then be prompted to enter the directory location of the license file that has been provided.

Step 7.) This step allows you to customize any of the ports utilized by Zephyr Enterprise.

• The suggested ports are within the brackets.
• You are able to change the port usage by entering your own custom port numbers for each step.

Step 8.) You'll then be prompted to select your Database.

• For Zephyr Enterprise Server installation, MySQL is the default database option.
• If you are interested in using another database, please contact your Zephyr Account Manager for further information.

Step 9.) This step allows you to customize the MySQL parameters.

• Enter the URL for your MySQL Database.
• Enter the directory location of the JDBC driver.

Step 10.) Once configured and customized, the files should now be copied and there will be various services that may start. Wait until the services are complete.

• Once the additional services are complete, the installation process for Zephyr Enterprise 6.1 is complete.

Step 11.) You'll then be prompted to launch Zephyr Enterprise and you may launch Zephyr Desktop by entering "Y".