Linux Installation Steps

Table of Contents
minLevel 2 style None

Prerequisites

• Ensure you meet system your deployment can meet the system requirements for Zephyr Enterprise 6.1.
  • Zephyr Server System Requirements 
  • Zephyr Data Center System Requirements
  • Zephyr Cloud Deployment 
  • Zephyr Server Sizing & Utilization  
    
    
• Ensure you have the license file (license.lic).Download your Zephyr license and any plugin license files that were provided. 
  
  
• Download and install or upgrade the required software Javadependencies: 
  • Java JDK 8u101 or higherDownloaded from JAVA JDK: Oracle Version 1.8 Download - here /  Installation Instructions - here
  • MySQL: 5.6.33 or higher
    Downloaded from x Series only Download - here /  Upgrade / Installation Instructions - here
  • MySQL Connector/J 5.1.41
    • Downloaded from here
    Elastic Search: Download - here
  • Elasticsearch (5.5.0 Download from only): Download - here /  Installation Instructions - here
  • Zephyr Enterprise 6.1 Linux Software
    • Download from here

• • Linux Installer: Download - here
    
    

Install Software Dependencies

The following sections software will need to be completed to get Zephyr Enterprise up and running:

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

installed:

1. Install Oracle JAVA JDK 1.8: Please review the Oracle website or documentation for your Linux distribution for JAVA installation instructions.  
   
   
2. Install MySQL 5.6:  A database server is required to use Zephyr, and MySQL is the default for single server installations. If you plan to use MS SQL or Oracle, please review our Zephyr Data Center installation instructions.
   
   
3. Configure MySQL:  See the recommended database settings below.
   
   
4. Install Elasticsearch 5.5.0:  It is now a requirement to install Elasticsearch as a separate process. Zephyr Server installations allow you to install this on the same VM as the Zephyr server application. 
   
   
5. Upload Zephyr License: The Zephyr installer requires access to the license file provided. It will need to be first uploaded to the file system of the server
   
   
6. Upload the MySQL Connector: The Zephyr installer requires access to the MySQL connector jar file downloaded. It will need to be first uploaded to the file system of the server.
   
   
7. Install / Configure Zephyr server: The installer will guide you through the application configuration options necessary for a new installation.
   
   
8. Setting ulimit in Linux: Increase ulimit on the server to 65535

Install & Configuring MySQL

1. Install MySQL Server according to the instructions for your Linux distribution: https://dev.mysql.com/downloads/mysql/5.6.html
   
   
2. Configure MySQL with the following settings below and after configuration, restart the MySQL service. You will need to edit the my.cnf file and add the following configuration settings.  Depending on your linux distribution, this may be in the /etc folder. 
   
   

Install Elastic Search

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

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:

[mysqld]
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]

default-storage-engine=INNODB
character-set-server=utf8
collation-server=utf8_unicode_ci

[mysql]
max_allowed_packet = 150M

[mysqldump]
quick
max_allowed_packet = 150M

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

NOTE: You may run into an issue where the "max_connections" setting does not actually reflect in MySQL. This could be due to a file open limit built into the Linux operating system. Please see these instructions for how to setup MySQL and Systems to adjust for the "LimitNOFILE" setting.  https://dev.mysql.com/doc/refman/5.7/en/using-systemd.html

Install & Configure Elasticsearch

Elasticsearch is required to be installed as a separate system service. 

1. Download Elasticsearch 5.5.0: https://www.elastic.co/downloads/past-releases
   
   
2. Install Elasticsearch: https://www.elastic.co/guide/en/elasticsearch/reference/5.5/_installation.html
   
   
3. Navigate to the Elasticsearch installation path: etc/elasticsearch
   
   

4. Edit the elasticsearch.yml file to match the parameters below and then save the file:
   
   

   1. Zephyr Server and Elastic Search in same Server

      Code Block
      language java title Single node Elastic Search
      cluster.name: zephyr node.name: "Node1" node.master: true node.data: true transport.tcp.port: 9300

1. 1. http.

1. 1. port:

1. 1. 9200 script.inline: true script.

1. 1. stored: true

1. 1. indices.query.bool.max_clause_count: 9012

      
      

   2. Zephyr Server and Elastic Search on Different Servers

      Code Block
      language java title Single node Elastic Search
      cluster.name: zephyr node.name: "Node1" node.master: true node.data: true script.inline: true script.stored: true network.bind_host:

1. 1. (IP of the server elasticsearch is installed) network.publish_host:

1. 1. (IP of the server elasticsearch is installed) network.host:

1. 1. (IP of the server elasticsearch is installed) transport.tcp.port: 9300 http.port: 9200

1. 1. discovery.zen.ping.

1. 1. unicast.hosts: ["

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=192.168.45.21:9300, 192.168.45.22:9300

Install Zephyr Enterprise 6.1

Step 1.) Set the permissions.

1. 1. (IP of the server elasticsearch is installed):9300"]

      
      

2. Restart the Elasticsearch system service.
   
   
   

Install Zephyr

1. Ensure the installer file has the proper permissions to be executed:

   Code Block
   language bash
   shell> chmod +x zephyr_

1. (Build Number)_linux_setup.sh

1. 
   

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

Image Removed

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.

Image Removed

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.

Image Removed

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.

Image Removed

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.

Image Removed

1. , and ensure you launch it as sudo or root: 

   Code Block
   language bash
   shell> sudo ./zephyr_(Build Number)_linux_setup.sh

   
   

2. You will be prompted to continue with the installer.

   Code Block
   language bash
   Starting Installer... This will install Zephyr X.X on your computer OK [o, Enter], Cancel [c]

   
   

3. You may be prompted to choose between a new install or upgrade.

   Code Block
   language bash
   Choose type: Install [1, Enter], Upgrade [2]

   
   

4. You will be prompted to confirm your system meets the Zephyr Server Requirements. Please review that your system meets the requirements before proceeding.

   Code Block
   language bash
   Requirements Server OS: RedHat Enterprise CentOS Ubuntu/Debian SUSE/openSUSE CPU: Quad-core CPU Intel Pentium or AMD Opteron (2Ghz or higher) RAM: Minimum 16GB; Preferred 16GB Disk Space: At least 5GB Free Networking: Wired Ethernet Static IP address If Firewall exists, please allow ports 80, 443, 8005, 8009 , 3306 Account: Superuser (root) access to the machine Installer and services need to be installed as "root"

   
   

5. You will be prompted to agree to the Zephyr EULA.

   Code Block
   language bash
   License Agreement D Software End User License Agreement IMPORTANT - PLEASE READ CAREFULLY: This End User License Agreement ("Agreement") constitutes a valid and binding agreement between D Software, INC. (”d software,” ”WE” or ”US”) and you, as either an individual or a single business entity ("you," "your" or "user") for the use of the Zephyr x.x software, ANY files that are delivered to you by d software to modify the Zephyr x.x software product, any online or enclosed documentation, and any updates, fixes and upgrades provided to you (collectively, the ”Software”). You must FIRST READ AND ACCEPT THE TERMS OF THIS LICENSE AGREEMENT by clicking on the ”i agree” checkbox below in order to install and use the Software.

   
   

6. Use the enter key until you see the following then enter '1' to agree to the terms.

   Code Block
   language bash
   I accept the terms of this license agreement [1], I do not accept the terms of this license agreement [2, Enter]

   
   

7. You will then be prompted to enter the path to place the Zephyr home directory.  

   Code Block
   language bash
   Select Destination Location Setup will install Zephyr into the following folder. To continue click Next. If you would like to select a different folder, click Browse [/usr/local/zephyr]

   
   

8. You will then be prompted to choose an installation type.

   Code Block
   language bash
   Choose deployment type: Server deployment [1, Enter], Data Center deployment [2]

   
   

9. You will then be prompted to locate your license file.

   Code Block
   language bash
   License File License Key File: [/home/zephyr/license.lic]

   
   

10. You will then be prompted to choose a port to run Zephyr on. By default, Zephyr runs on port 80.

    Code Block
    language bash
    Customization Server Port : [80]

    
    

11. You will then be prompted to choose a Tomcat Server Shutdown Port.  We recommend you leave it to the default port.

    Code Block
    language bash
    Tomcat Server Shutdown Port: [8005]

    
    

12. You will then be prompted to choose a database system. Use the default MySQL.

    Code Block
    language bash
    Note: If you had just uninstalled. Please wait few miniutes for the port to get free and try again. Configure Database Database Type: MySQL [1, Enter]

    
    

13. You will then be prompted to provide a database username. Note: The database user must be able to create, update, and alter permissions in the database.

    Code Block
    language bash
    Database Character Set: utf8 Username: []

    
    

14. You will then be prompted to provide a database password. 

    Code Block
    language bash
    Password: [] root

    
    

15. You will then be prompted to provide a database connection string. If you installed MySQL on the same server as Zephyr, you can use "jdbc:mysql://localhost:3306/"

    Code Block
    language bash
    Database URL Configuration: Sample URL: jdbc:mysql://localhost:3306/ Database URL: []

    
    

16. You will then be prompted to provide a connection string for Elasticsearch.  By default, Elasticsearch will bind to the IP configured in the elasticsearch.yml file edited earlier in the installation instructions. For example: "192.168.56.101:9300"

    Code Block
    language bash
    Configure Elasticsearch Enter the hostname or IP address and port used by Elasticsearch. For example: localhost:9300. Multiple Elasticsearch nodes should be separated by comma. For example: localhost:9300,localhost:9301 ES Host URL []

    
    

17. Zephyr will now install the required files and setup the MySQL database.

    Code Block
    language bash
    Extracting files .. # ************************************************************

    
    

18. Zephyr installation is now complete and the service should have started. You can choose 'N' when prompted to Launch Zephyr Desktop and connect to Zephyr from your desktop machine.

    Code Block
    language bash
    ZephyrService.sh may or may not start automatically. Please check and start manually if not started. Done! Zephyr x.x has now been installed on your computer. Zephyr Desktop will now be launched automatically. You can access additional help from the Zephyr installation. Click Finish to exit setup. Launch Zephyr Desktop? Yes [y, Enter], No [n]

    
    

    
    

To start Zephyr you can:

cd /usr/local/zephyr/tomcat/bin

sudo ./startup.sh

To stop Zephyr you can:

cd /usr/local/zephyr/tomcat/bin

sudo ./shutdown.sh

Setting ulimit in Linux

Increase ulimit on the server to 65535

1. Stop the Zephyr Service.
2. As root user, open the file /etc/security/limits.conf for editing and add a line at the end.

<zephyr_user> soft nofile 65535
<zephyr_user> hard nofile 65535
replacing <zephyr_user> with the user used to install Zephyr

3. Start a new session and then start the Zephyr service.