Versions Compared

Old Version 1

changes.mady.by.user Daniel

Saved on

compared with

New Version Current

changes.mady.by.user Kevin Pham

Saved on

Key

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

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Anchor
Top
Top

Column

This section applies specifically to the Zephyr Enterprise Server product. The information below is generally used to ensure that system administrators can install their new Zephyr Enterprise Server product instance on a CentOS Linux environment. 


This section provides step-by-step instructions for installing single node Zephyr Enterprise Server

...

on CentOS Linux.

For multiple nodes clustered installation of Zephyr Enterprise or to use an external Database other than MySQL, please refer to the 

...

Zephyr Enterprise Data Center installation guide.

...

Before you begin

...


After installing the Zephyr Enterprise Server product, you can upgrade the product if need be. Please use the link provided below if you need to upgrade Zephyr Enterprise Server:

Prerequisites

...

  • Review all system requirements thoroughly
  • Ensure you have the license file (license.lic) as this will be required during the installation process.  If you do not have this license file, please contact your Zephyr Sales Account Manager or send an email to sales@getzephyr.com
  • Download 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
    • Zephyr Enterprise 5.0 Linux Software:Download from here

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 (note: a clean rpm install should already have done this)

Code Block
themeEmacs
shell> cd /usr/bin 
shell> rm -f java
shell> ln -s /usr/java/default/bin/java java


Step 3: Add . Add 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 . Update the PATH variable to point to the bin folder

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

...

 
5 (Optional). Verify java installation version - Sun/Oracle Java JDK 8
 Code Block
themeEmacs
shell> java –version
Installing MySQL
...
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
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 will find that password in '/root/.mysql_secret'.
...
 Code Block
themeEmacs
shell> cat /root/.mysql_secret

3. Connect to MySQL using the auto-generated password from the .mysql_secret file and change the root password:
 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

false
 Info
icon
titleNoteAdditional Notes
This specific major/minor (5.6.X) 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.

4. Create or modify my.cnf file as shown below. Typically 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

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 or Stop MySQL server:
 Code Block
themeEmacs
shell> /etc/init.d/mysql stop
...
 Code Block
themeEmacs
shell> /etc/init.d/mysql start
Installing Zephyr Enterprise 
...
Software
...
The installation of Zephyr Enterprise software can be completed either via a GUI or via Command Line.
GUI Install
 Anchor
gui
gui
Step 1:. Set permissions
 Code Block
themeEmacs
shell> chmod +x zephyr_5_0_14587_linux_setup.sh

Step 2: To install 2. Install using the GUI use the command below
...

Once the setup file has been launched, the following Welcome screen will display automatically

 
Step 3: . A quick reminder will pop up on the /wiki/spaces/ZEE50/pages/77856795requirements needed to install and run Zephyr successfully .

   Step 4: You will be prompted with the full EULA which will require acceptance of the terms stated before continuing
4. Review the mandatory acceptance of our Licensing Agreement before continuing.
  • The installation will not proceed further if the terms of the license agreement are not accepted

 
Step 5: After . After accepting the EULA, you will be prompted to enter the Zephyr Enterprise home directory.
  • You will be notified of the required and available disk space.

 
 
Step 6: . Select the Server deployment optiontype.
  
   
Step 7: This step will prompt you to enter the directory location of your license file provided by Zephyr Sales. 7. Add the license file.
  • You can browse your system directory if you do not know the direct path.
  • You would have received the license file from Zephyr Sales.
Step  
8: . This step allows the customization of the ports used by Zephyr.
  • The default suggested ports are already provided, however you can customize the port usage by entering in your own custom port number
...
  • .
 
   
Step 9: . This step allows you to customize the MySQL parameters needed by Zephyr. The character set is UFT8 by default and cannot be changed. You will need to enter the URL for your MySQL database and the directory location of the JDBC driver. Use the 'Test Connection' button and verify a success before continuing.

A successful connection test will return this dialog box.

Step 10: . Files are now copied and various services are started
 
 
Step 11: . At the end of that process, the Zephyr server installation is complete and allows for the Zephyr Enterprise login page to be immediately launched.

  
Note: 

 Info
titleAdditional Notes
Depending on the speed of the machine, it may take a few minutes for the login dialog to appear when launching Zephyr for the first time. This is to allow all services to start up correctly. Subsequent launches will be much faster.
...

 Anchor
cli
cli
...
Command-line Install
...
1. Launch the setup file with the '-c' command line option as shown below.
 
Step 2: . A quick reminder on the Requirements needed to install and run Zephyr successfully on Linux is made available during pre-install.
 

Step 3: . You will be prompted with the full EULA which will require acceptance of the terms stated before continuing.
 

Step  
4: . After accepting the EULA, you will be prompted to enter the Zephyr Enterprise home directory. You will be notified of the required and available disk space.

 
 Step 
5: . This step allows the selection of the type of deployment of Zephyr Enterprise; select '1' for Zephyr Enterprise Server deployment

Step 6: . This step will prompt you to enter the directory location of your license file provided by Zephyr Sales 

 Step 

7: . This step allows the customization of the ports used by Zephyr.
  • The default suggested ports are in brackets, however you can customize the port usage by entering in your own custom port number for each step.
 Step 

8: . The next step allows for the selection of Database. For Zephyr Enterprise Server installation, MySQL is the only option available. If you prefer to use another database, please contact your Zephyr Account Manager for information on how to upgrade to the Zephyr Enterprise Data Center.
 Step 

9: . This step allows you to customize the MySQL parameters. You will need to enter the URL for your MySQL database and the directory location of the JDBC driver.
 Step 

10: . Files are now copied and various services are started. At the end of that process, the installation is complete.
 
You have now successfully installed Zephyr Enterprise Server!
Launch Zephyr Software 
...
Manually
...
By default Zephyr in installed in /opt/zephyr directory. To Start or Stop Zephyr manually:
...
 Code Block
themeEmacs
shell> tail -f /opt/zephyr/tomcat/logs/catalina.out
...

Back to Top ^