Prerequisites
- Ensure you meet system requirements for Zephyr Enterprise 6.1
- Ensure you have the license file (license.lic).
- Download the required 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
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
Additional 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
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
- Run the following command:
- Download using the wget command from the linux shell command prompt
- You can download the rpm file here.
- 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: 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:
#transport|node transport.nodes=192.168.45.21:9300, 192.168.45.22:9300