Sep

Zephyr 4.6 Installation on Ubuntu Linux 32-Bit

Zephyr, 7707 Gateway Blvd, Suite 100, Newark, CA 94560, USA

14

Zephyr 4.6 Installation on Ubuntu Linux 32-Bit This section covers the installation of Zephyr binary distributions that are provided for various platforms in the form of binary installation script files. The following are the Requirements for Zephyr to Install and Run on a Ubuntu Linux 32Bit machine: Operating System

CPU RAM Disk Space Networking

Account Software

RedHat Enterprise Linux CentOS Fedora Ubuntu / Debian SUSE / openSUSE Dual-core CPU Intel Pentium or AMD Opteron (2Ghz or higher) Minimum 4GB of RAM, 8GB Preferred At least 5GB Free (250GB-1TB recommended for large enterprise installations) Wired Ethernet Static IP address Available ports: 80, 443, 8005, 8009, 8010, 2099, 3306 If Firewall exists, please allow ports: 80, 443, 2099 Superuser (root) access to the machine Zephyr *MUST* be installed as Superuser (root) NO other Tomcat or MySQL is installed on the machine Oracle JDK 6 update 25 and above or JDK 7. JRE is not supported.

Note: All port numbers mentioned in this document are the defaults, and can be configured to fit your specific environment setup. Port 80/443, 8005, 8009, 8010 are used by tomcat and can be configured in the server.xml file under zephyr\tomcat\conf\ Port 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\ Port 3306 is used by MySQL and configured in the my.cnf. The MySQL software does not have to be that specific maintenance release number (5.6.17), 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. Download Java JDK 7 Update 67 Linux 32Bit from: Following instructions on these pages: https://help.ubuntu.com/community/Java#Command_line_methods http://www.webupd8.org/2012/01/install-oracle-java-jdk-7-in-ubuntu-via.html

Zephyr 4.6 Installation on Ubuntu Linux 32-Bit

2

Or download the raw tar.gz package yourself from Oracle and install it manually: (http://www.oracle.com/technetwork/java/javase/downloads/index.html) jdk-7u67-linux-i586.tar.gz Download MySQL 5.6.17 for Linux 32Bit from: Download and install using the Ubuntu package installation tools: apt-get install mysql-server-5.6 mysql-common mysql-client-5.6 Download Zephyr Software: Zephyr Software: http://download.yourzephyr.com/linux/download.php license.lic == attached to email Install the Java JDK: shell> < Follow instructions on the supplied pages above> shell> make sure to 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 install should already have done this) shell> cd /usr/bin shell> rm -f java shell> ln -s /usr/java/default/bin/java java add JAVA_HOME environment variable to point to where you installed Sun/Oracle Java version 7 Update 67 shell> export JAVA_HOME=/usr/lib/jvm/java-7-oracle also update the PATH variable to point to the bin folder shell> export PATH=$JAVA_HOME/bin:$PATH verify java installation, should show you the correct Sun/Oracle Java version 7 Update 67 shell> java -version Install MySQL in this order and set the mysql root user password: shell> apt-get install mysql-server-5.6 mysql-common mysql-client-5.6 shell> shell> /usr/bin/mysqladmin -u root password '' Note: again this specific major/minor (5.6.X) version of MySQL is required with the root username as specified above. If you have other MySQLs on the machine we recommend removing them or installing this version on top of them and upgrading their schemas to what is specified. Create or modify your my.cnf file in /etc/ folder (or wherever it is) to look similar to this:

Zephyr 4.6 Installation on Ubuntu Linux 32-Bit

3

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 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 __________________________________________________________________________________________________ Install Zephyr: shell> chmod +x zephyr_4_6_XXXX_linux_setup.sh in GUI Linux: shell>./zephyr_4_6_XXXX_linux_setup.sh in Console mode (no X-Windows or DISPLAY defined): shell>./zephyr_4_6_XXXX_linux_setup.sh -c Follow all the prompts, and at the end if successful Zephyr will be started automatically. To Start or Stop Zephyr Tomcat manually: shell> cd /usr/local/zephyr/tomcat To Start: shell> ./bin/catalina.sh start To Stop:

Zephyr 4.6 Installation on Ubuntu Linux 32-Bit

4

shell> ./bin/catalina.sh stop Check logfile to check for successful startup or errors: shell> tail -f /usr/local/zephyr/tomcat/logs/catalina.out If any commands fail then please take a screenshot and send us the startup error file in /tomcat/logs/* to Zephyr Support at https://support.getzephyr.com.

Additional Questions For any questions regarding this document, please contact Zephyr Support.  

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

Zephyr 4.6 Installation on Ubuntu Linux 32-Bit

5