Versions Compared

Key

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


Prerequisites


  • Ensure you meet system requirements for Zephyr Enterprise 6.1
  • Ensure you have the license file (license.lic).
  • Download the 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
    • Elastic Search
      • 5.5.0
    • Zephyr Enterprise 6.1 Linux Software

Steps to Install the Required Software


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


Expand
titleInstalling Java

Anchor
anchor1
anchor1

Panel

Installing Java


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

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

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

Code Block
themeEmacs
shell> export JAVA_HOME=/usr/java/default


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

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

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

Code Block
themeEmacs
shell> java –version





Expand
titleInstalling MySQL

Anchor
anchor2
anchor2

Panel

Installing MySQL


Step 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

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.

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


Step 2.2.) Get the auto-generated password.

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

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 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.


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

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


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.
Code Block
themeEmacs
shell> /etc/init.d/mysql start
shell> /etc/init.d/mysql stop





Expand
titleInstall Elastic Search

Anchor
anchor3
anchor3

Panel

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:
Code Block
languagejs
themeEmacs
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: 192.168.45.21
network.publish_host: 192.168.45.21
network.host: 192.168.45.21
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:

Code Block
languagejs
themeEmacs
#transport|node
transport.nodes=192.168.45.21:9300, 192.168.45.22:9300





Expand
titleInstalling Zephyr Enterprise 6.1

Anchor
anchor4
anchor4

Panel

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.
Code Block
themeEmacs
shell> chmod +x zephyr_5_0_14587_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 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 uou you may launch Zephyr Desktop by entering "Y".