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:

  • Installing Java
  • Installing MySQL
  • Installing Elastic Search
  • Installing Zephyr Enterprise 6.1

    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.

    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'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 may launch Zephyr Desktop by entering "Y".