Installation Guide Ubuntu Linux 64 Bit

ENTERPRISE EDITION Software Version: 4.7 Installation Guide – Ubuntu Linux 64‐Bit  Document Release Date: September 2016 Z e p h y r,    7 7 0 7 ...
Author: Willa Dorsey
9 downloads 0 Views 210KB Size
ENTERPRISE EDITION Software Version: 4.7

Installation Guide – Ubuntu Linux 64‐Bit 

Document Release Date: September 2016

Z e p h y r,    7 7 0 7    G a t e w a y    B l v d,    S u i t e    1 0 0,     N e w a r k,    C A    9 4 5 6 0,    U S A 

Zephyr Enterprise Edition 4.7 Installation on Ubuntu Linux 64‐Bit  This guide provides step‐by‐step instructions for installing Zephyr Enterprise Edition 4.7 on Ubuntu Linux. Zephyr Enterprise Edition binary distributions are provided for various platforms in the form of binary installation script files.

System Requirements  Operating System

Ubuntu Linux 64‐Bit / Debian

CPU RAM Disk Space

Quad‐core CPU Intel Pentium or AMD Opteron (2Ghz or higher) Minimum 8GB of RAM, 12GB Preferred At least 5GB Free (250GB‐1TB recommended for large enterprise installations) Wired Ethernet Static IP address Required ports: 80, 443, 8005, 8009, 2099, 3306* If Firewall exists, please allow ports: 80, 443, 2099 Java: Oracle JDK 8 Database: MySQL Note: NO other Tomcat or MySQL is installed on the machine. JRE is not supported Superuser (root) access to the machine Zephyr *MUST* be installed as Superuser (root)

Networking

Software

Account

Note: All port numbers mentioned in this document are the defaults, and can be configured to fit your specific environment setup.

*Ports Explained:    

80/443, 8005 and 8009 are used by tomcat and can be configured in the server.xml file under zephyr\tomcat\conf\ 443 or 2099 are used within Zephyr by flex for the RTMP protocol, and can be configured in the services‐config.xml file under zephyr\tomcat\webapps\flex\WEB‐INF\flex\ 3306 is used by MySQL and configured in the my.cnf.  

Software Version 





The MySQL software does not have to be that specific maintenance release number (5.6.28), but has to be the major/minor (5.6.X) version specified and configured to our specs since we have a number of services relying on the port and username/password combinations. Conflicts with other installed MySQL versions on the same machine are highly likely. Similarly Oracle JDK software does not have to be specific version mentioned below. Oracle JDK 8 is supported. JRE is not supported.

Zephyr 4.7 Installation on Ubuntu Linux 64‐bit 

Download Software    Java  Use Ubuntu’s default package manager (apt‐get) to install Oracle Java JDK 8 using the commands listed in the Java install section. OR Download the Java JDK 8 Update 71 Linux 64Bit raw tar.gz package ‐ jdk‐ 8u71‐linux‐x64.tar.gz from Oracle and install it manually. It can be downloaded from http://www.oracle.com/technetwork/java/javase/downloads/jdk8‐ downloads‐2133151.html

MySQL  Download and install MySQL 5.6.x Community Server for Ubuntu Linux 64‐bit. Use the Ubuntu package installation tools commands listed in the MySQL install section.

Zephyr Software   

Download Zephyr Software from http://download.yourzephyr.com/linux/download.php Download the license file “license.lic” that was provided to you by Zephyr Sales.

                              Zephyr 4.7 Installation on Ubuntu Linux 64‐bit 

  Install Software  Java  Below steps outlines using Ubuntu’s default package manager to install Java JDK



a. Install Java JDK sudo apt‐get install python‐software‐properties sudo add‐apt‐repository ppa:webupd8team/java sudo apt‐get update sudo apt‐get install oracle‐java8‐installer b. Set JAVA_HOME  Find the path of Java installation sudo update‐alternatives ‐‐config java  Copy the path from preferred installation and edit the file ‘/etc/environment’ sudo vi /etc/environment





Add the following line (replacing YOUR_PATH by the just copied path) and save: JAVA_HOME="YOUR_PATH"





Reload this file: sudo source /etc/environment





c. Verify java installation and JAVA_HOME location: shell> java ‐version echo $JAVA_HOME

MySQL  a. Install MySQL using the Ubuntu package installation tools sudo apt‐get install mysql‐server‐5.6 mysql‐common mysql‐client‐5.6

Zephyr 4.7 Installation on Ubuntu Linux 64‐bit 

b. Set the MySQL root user password when prompted during installation. c. Verify MySQL installation



shell> mysql –uroot –p

Note: 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. d. Create or modify my.cnf file as shown below. Typically 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 e. 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: shell> /etc/init.d/mysql stop shell> /etc/init.d/mysql start

    Zephyr 4.7 Installation on Ubuntu Linux 64‐bit 

Zephyr Software 

Install Zephyr Enterprise Edition by following below steps. a. Set permission shell> chmod +x zephyr_4_7_XXXX_linux_setup.sh b. To install using GUI Linux: shell>./zephyr_4_7_XXXX_linux_setup.sh c. To install using console mode (no X‐Windows or DISPLAY defined): shell>./zephyr_4_7_XXXX_linux_setup.sh ‐c Follow all the prompts. If successful, Zephyr will start automatically at the end of installation.

  Launch Zephyr Software manually  By default Zephyr in installed in /opt/zephyr directory. To Start or Stop Zephyr manually: shell> cd /opt/zephyr To Start: shell> ./bin/ZephyrService.sh start To Stop: shell> ./bin/ ZephyrService.sh stop

Log files  Check log files for successful startup or errors: shell> tail ‐f /opt/zephyr/tomcat/logs/catalina.out

  Additional Questions  For any questions or assistance during installation, please contact Zephyr Support. Send to Support, log files located in /tomcat/logs/* and screenshots of error message.  

Web: https://support.getzephyr.com Phone: +1‐510‐400‐8656

Zephyr 4.7 Installation on Ubuntu Linux 64‐bit