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:
| Code Block | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
shell> export JAVA_HOME=/usr/java/default |
Step 4.) Update the PATH variable to point to the bin folder.
| Code Block | ||
|---|---|---|
| ||
shell> export PATH=/usr/java/default/bin:$PATH |
Step 5.) Optional: Verify the java installation version - Sun/Oracle Java JDK 8
| Code Block | ||
|---|---|---|
| ||
shell> java –version |
Installing MySQL
Step 1.) Install MySQL RPMs in the order shown below:
| Code Block | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
shell> /etc/init.d/mysql start |
Step 2.2.) Get the auto-generated password.
| Code Block | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
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:
| Code Block | ||||
|---|---|---|---|---|
| ||||
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 | ||||
|---|---|---|---|---|
| ||||
#transport|node
transport.nodes=192.168.45.21:9300, 192.168.45.22:9300 |