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.