Zend Server Installation Guide
Zend Server Installation Guide
Installation Guide
By Zend Technologies
www.zend.com
Abstract
This is the Install Guide for Zend Server Version 5.1. The information in this document is subject to change without notice and does not represent a commitment on the part of Zend Technologies Ltd. No part of this manual may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose other than the purchasers personal use, without the written permission of Zend Technologies Ltd. All trademarks mentioned in this document, belong to their respective owners.
Table of Contents
Zend Server .................................................................................................................................................. 5 Installing for the First Time ........................................................................................................................ 5 Installation Directories ............................................................................................................................... 5 Choosing Which Distribution to Install .......................................................................................................... 7 Supported Operating Systems .................................................................................................................. 7 DEB Installation ............................................................................................................................................. 8 Automatically Installing Zend Server ......................................................................................................... 8 Manually Installing Zend Server ................................................................................................................ 9 Additional Packages (landscape/DELETE ) ............................................................................................ 10 Post Installation Configuration ................................................................................................................. 11 Upgrading Zend Server ........................................................................................................................... 12 Uninstalling Zend Server ......................................................................................................................... 13 RPM Installation (RHEL, CentOS, Fedora and OEL) ................................................................................. 14 Automatically Installing Zend Server ....................................................................................................... 14 Manually Installing Zend Server .............................................................................................................. 15 Additional Packages (landscape/DELETE ) ............................................................................................ 16 Post Installation Configuration ................................................................................................................. 18 Enabling RPM Package Signature Validation ......................................................................................... 19 Upgrading Zend Server ........................................................................................................................... 20 Uninstalling Zend Server ......................................................................................................................... 21 RPM (SLES and OpenSUSE) Installation................................................................................................... 22 Automatically Installing Zend Server ....................................................................................................... 22 Manually Installing Zend Server .............................................................................................................. 23 To set up repositories in SLES 11 and OpenSUSE ............................................................................ 23 To set up repositories in SLES 10 ....................................................................................................... 24 To install Zend Server using zypper .................................................................................................... 24 Basic Usage ............................................................................................................................................ 25 Additional Packages (landscape/DELETE ) ............................................................................................ 25 Upgrading Zend Server ........................................................................................................................... 26 Uninstalling Zend Server ......................................................................................................................... 27 Windows Installation ................................................................................................................................... 28 Installing Zend Server .............................................................................................................................. 29 Installing with the Native Windows Installer ......................................................................................... 29 Installing Additional Components ........................................................................................................ 30 Installed Components .............................................................................................................................. 31
iii
Java Bridge .......................................................................................................................................... 31 Locating Installed Components ........................................................................................................... 31 Start Menu Options .................................................................................................................................. 31 Uninstalling Zend Server ......................................................................................................................... 32 PHP Extension List ..................................................................................................................................... 33 Zend Server Extension List - PHP 5.2 ..................................................................................................... 34 Common Extensions ............................................................................................................................ 34 Extra / Additional Extensions ............................................................................................................... 38 Standalone Extensions ........................................................................................................................ 40 Zend Server PHP 5.3 Extensions ............................................................................................................ 41 Common Extensions ............................................................................................................................ 41 Extra / Additional Extensions ............................................................................................................... 45 Standalone Extensions ........................................................................................................................ 46 Using PECL ................................................................................................................................................. 47 Installing Zend Server Additional Extensions .......................................................................................... 47 Uninstalling Zend Server Additional Extensions...................................................................................... 48 Registration ................................................................................................................................................. 49 Registration Wizard ................................................................................................................................. 49 License FAQ ............................................................................................................................................ 50 How do I just take a look at the product?............................................................................................. 50 How do I get a License? ...................................................................................................................... 51 I already have a License - what do I do? ............................................................................................. 51 License Expiration................................................................................................................................ 51 Post Installation ........................................................................................................................................... 52 Package Setup and Control Scripts ........................................................................................................ 52 Windows: Package Setup and Control Scripts ........................................................................................ 53 Starting Services on MS Windows ....................................................................................................... 53 Controlling Zend Server from Startup .................................................................................................. 53 Linux Mac: Package Setup and Control Scripts ...................................................................................... 55 Controlling Zend Server Components from the Command Line ......................................................... 55 Command Line Actions ........................................................................................................................ 56 Controlling Zend Server from Startup .................................................................................................. 57 Log Rotation ............................................................................................................................................ 58 Configuring Log Rotation for Zend Server Logs .................................................................................. 58 To Disable Log Rotation ...................................................................................................................... 59 Ports and Services .................................................................................................................................. 60 Web Server Ports ................................................................................................................................. 60
iv
Table of Contents
Firewall Settings ................................................................................................................................... 61 Installed Components .............................................................................................................................. 64 Installation Directories.......................................................................................................................... 64 Upgrading ................................................................................................................................................ 71 Upgrading your RPM Installation to Merge Configuration Files During Upgrade ................................ 71 Upgrading to a Newer Version of Zend Server .................................................................................... 71 Upgrading from Zend Server CE to Zend Server ................................................................................ 73 Migrating to Zend Server from Zend Platform/Zend Core ................................................................... 74 Downgrading/Rollback to an Older Version ......................................................................................... 74 Index ............................................................................................................................................................ 75
Zend Server
The following instructions describe how to obtain and install Zend Server. A summary of the procedure follows and later sections provide the details. If you plan to upgrade an existing version of Zend Server to a newer version rather than install Zend Server for the first time, see the section on "Upgrading Zend Server " for information about upgrade procedures and about issues that you should consider before upgrading.
Installation Directories
Not all users decide to install their software in the same location. To reflect this actuality, all paths in this document have been replaced with the following prefix: <install_path>. This represents the location of the installed files. If you used the default settings, the location should be as follows: Windows: C:\Program Files\Zend\ZendServer Windows 64 bit C:\Program Files (x86)\Zend\ZendServer DEB/RPM: /usr/local/zend Tarball: /usr/local/zend Mac: /usr/local/zend For Zend Server installation directories, see the Zend Server for IBM i Installation Guide.
Package Name
Operating System RHEL CentOS Debian Fedora Oracle Enterprise Linux Ubuntu
Linux
DEB
EXE EXE EXE EXE EXE EXE
Windows x86 - 32
Windows x86 - 64
DEB Installation
This method uses "aptitude" to handle the installations, upgrades and additional packages. Alternatively, you may choose any other tool that supports the DEB packaging format (i.e., Synaptic, Kpackage, etc). This method downloads files from the Internet and therefore requires that you have an active Internet connection, access to your distribution's repositories and root privileges for the server. Note: This procedure requires root privileges. To acquire root privileges in Ubuntu, run the following command and type your password: $ sudo -s.
1. Download the package called "Linux x86 Installer (RPM/DEB Setup Script)" from zend.com - http://www.zend.com/en/products/server/downloads 2. Locate and extract the package: ZendServer-X.X.X-RepositioryInstaller-linux.tar.gz 3. To change to the directory with the installer scripts run: cd ZendServer-RepositoryInstaller-linux/ 4. Depending on the PHP version, you want to use, run one of the following commands: For Zend Server with PHP 5.2 Support run: install_zs.sh 5.2 For Zend Server with PHP 5.3 Support run: install_zs.sh 5.3 After installing, a completion notification will appear, with a notice that the servers have started. To access the Administration Interface (Web) open your browser at: https://localhost:10082/ZendServer (secure) or http://localhost:10081/ZendServer. Upon initial log in, you will be prompted to define your password.
To setup the environment: 1.Define a repository by opening the following file: /etc/apt/sources.list and adding the line: deb http://repos.zend.com/zend-server/deb server non-free 3. Add Zend's repository public key by running: # wget http://repos.zend.com/zend.key -O- |apt-key add If you are using sudo to run each command the next command requires using sudo following the '|' (pipe) symbol as follows: # wget http://repos.zend.com/zend.key -O- | sudo apt-key add 4.To synchronize with Zend's repository run: # aptitude update Now you can use "aptitude" to handle the installations, upgrades and additional packages.
To install: 1.Once the repository is set up, run the appropriate command according to the product version and PHP support you require: To install Zend Server with PHP 5.2 run: # aptitude install zend-server-php-5.2 To install Zend Server with PHP 5.3 run: # aptitude install zend-server-php-5.3 2.Each package locates and downloads all relevant packages from the web. The actual installation will require your conformation. After installing, a completion notification will appear, with a notice that the servers have started. To access the Administration Interface (Web) open your browser at: https://localhost:10082/ZendServer (secure) or http://localhost:10081/ZendServer. Upon initial log in, you will be prompted to define your password.
Description
extensionszend-server
Java bridge package (Requires Sun JRE 1.5, 1.6 or later installed on your computer. Therefore, if you do not already have JRE installed please install it before using the Java Bridge. More information about JREs and the latest updates are found in the SUN Website: http://java.sun.com/javase/downloads/index.jsp (jre-6u21-linux-x64.bin) The Zend Guard Loader for running PHP, encoded with Zend Guard. php-5.2-loader- php-5.3-loaderzend-server zend-server phpmyadminzend-server php-5.2-javabridge-zendserver php-5.3-javabridge-zendserver
A phpMyadmin meta package that installs phpMyAdmin and attaches it phpmyadminto the Administration Interface via a link from the Dashboard. Zend Framework's bundled Dojo. zend-server zend-server-
frameworkextras
zend-server
The following extensions require the IBM DB2 runtime client (RTCL): PHP extension that enables access to the IBM DB2 Universal Database, IBM Cloudscape and Apache Derby databases. php-5.2ibmdb2-zendserver php-5.3ibmdb2-zendserver
10
Description
ibm-zendserver
You can download and install IBM's Runtime Client libraries from ftp://ftp.software.ibm.com/software/data/db2/express/
The following procedure is intended for use with bash. If you are using a different shell, adjust the procedure accordingly.
To add the <install_path>/bin directory to your $PATH environment variable per user profile: 1. Using a text editor, open .bashrc (located in your home directory). 2. Add the following lines to the end of the file: PATH=$PATH:<install_path>/bin LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<install_path>/lib Replace <install_path> with your Zend Server installation path. 3. Save the file. 4. In order for this to take effect, close and reopen your shell or run the following command: source ~/.bashrc You can now run the PHP binary provided by Zend Server without typing its full path.
11
To add the <install_path>/bin directory to your $PATH environment variable for all users: 1. Log in as root or use sudo to execute the following commands. 2. Using a text editor, open /etc/profile. 3. Add the following lines to the end of the file: PATH=$PATH:<install_path>/bin LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<install_path>/lib Replace <install_path> with your Zend Server installation path. 4. Save the file. 5. In order for this to take effect, close and reopen your shell or run the following command: source /etc/profile You can now run the PHP binary provided by Zend Server without typing its full path.
To upgrade all packages installed run: # aptitude update # aptitude upgrade To upgrade only Zend packages, run: # aptitude install `dpkg --get-selections|grep zend| awk -F " " '{print $1}' |xargs` To upgrade Zend Server with PHP 5.2 run: # aptitude install php-mcrypt-zend-server-php-5.2 To upgrade Zend Server with PHP 5.3 run: # aptitude install php-mcrypt-zend-server-php-5.3 The upgrade process locates newer packages and downloads them.
12
To uninstall Zend Server (leaving the configuration files in place) run: # aptitude remove '~nzend.* ' To delete Zend Server from the system with no traces left run: # aptitude purge '~nzend.* '
13
14
[Zend_noarch] name=Zend Server - noarch baseurl=http://repos.zend.com/zend-server/rpm/noarch enabled=1 gpgcheck=0 Now you can use 'yum' to handle installations or any other tool that supports the RPM packaging format. To install:
1.Once the environment is setup, run the appropriate command according to the product version and PHP support you require: To install Zend Server with PHP 5.2 run: # yum install zend-server-php-5.2 To install Zend Server with PHP 5.3 run: # yum install zend-server-php-5.3 2. To clean your packages cache and ensure retrieval of updates from the web, run: yum clean all After installing, a completion notification will appear, with a notice that the servers have started. To access the Administration Interface (Web) open your browser at: https://localhost:10082/ZendServer (secure) or http://localhost:10081/ZendServer. Upon initial log in, you will be prompted to define your password.
15
framework-dojo framework-dojo Zend Framework's extra components. zend-serverframeworkextras Full PHP sources, patched by Zend php-5.2source-zendserver Zend Server Control Panel control-panelzend-server zend-serverframeworkextras php-5.3source-zendserver control-panelzend-server
The following extensions require the IBM DB2 runtime client (RTCL): PHP extension that enables access to the IBM DB2 Universal Database, php-5.2IBM Cloudscape and Apache Derby databases. ibmdb2-zendphp-5.3ibmdb2-zend-
16
Description
php-5.2-pdoibm-zendserver
Informix client
php-5.2-pdo-
informix-zend- informix-zendserver You can download and install IBM's Runtime Client libraries from ftp://ftp.software.ibm.com/software/data/db2/express/ CentOS and RHEL4 and 5 Note: The phpmyadmin-zend-pe package depends on the availability of phpMyAdmin from your distribution's repositories. The default CentOS repositories for example do not offer phpMyAdmin and therefore require that you manually add the rpmforge repositories to your yum repositories list. For information on how to do this for CentOS see: http://wiki.centos.org/AdditionalResources/Repositories/RPMForge server
17
The following procedure is intended for use with bash. If you are using a different shell, adjust the procedure accordingly.
To add the <install_path>/bin directory to your $PATH environment variable per user profile: 1. Using a text editor, open .bashrc (located in your home directory). 2. Add the following lines to the end of the file: PATH=$PATH:<install_path>/bin LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<install_path>/lib Replace <install_path> with your Zend Server installation path. 3. Save the file. 4. In order for this to take effect, close and reopen your shell or run the following command: source ~/.bashrc You can now run the PHP binary provided by Zend Server without typing its full path.
18
To add the <install_path>/bin directory to your $PATH environment variable for all users: 1. Log in as root or use sudo to execute the following commands. 2. Using a text editor, open /etc/profile. 3. Add the following lines to the end of the file: PATH=$PATH:<install_path>/bin LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<install_path>/lib Replace <install_path> with your Zend Server installation path. 4. Save the file. 5. In order for this to take effect, close and reopen your shell or run the following command: source /etc/profile You can now run the PHP binary provided by Zend Server without typing its full path.
To enable RPM package signature validation: 1. Start the manual installation process as described in (link to manual install) 2. After creating the file /etc/yum.repos.d/zend.repo, change the value of all of the gpgcheck occurrences to '1' 3. After each gpgcheck occurrence add the following line: gpgkey=http://repos.zend.com/zend.key 4. Continue the installation process Before installing the first packages, yum will prompt you to approve importing the Zend PGP key from the URL above. After following this procedure, whenever upgrading and installing Zend Packages yum will verify the packages before installing them.
19
To upgrade, run: To upgrade all Zend related packages run the following command according to the package you have installed: # yum update \*zend\* To update any and all files in your system that are managed by 'yum' (not just Zend products) run: # yum update To update a specific component (in this example it is php-mycrypt) run the following command according to the package you have installed: To upgrade Zend Server with PHP 5.2 run: # yum update php-mcrypt-zend-server-php-5.2 To upgrade Zend Server with PHP 5.3 run: # yum update php-mcrypt-zend-server-php-5.3 To upgrade Zend Server Community Edition with PHP 5.2 run: # yum update php-mcrypt-zend-server-ce-php-5.2 To upgrade Zend Server Community Edition with PHP 5.3 run: # yum update php-mcrypt-zend-server-ce-php-5.3 The upgrade process locates any components of the product version that are newer and downloads them.
20
21
1. Download the package called "Linux x86 Installer (RPM/DEB Setup Script)" from zend.com - http://www.zend.com/en/products/server/downloads 2. Locate and extract the package: ZendServer-X.X.X-RepositioryInstaller-linux.tar.gz 3. To change to the directory with the installer scripts run: cd <Install_Path>/ZendServer-RepositoryInstaller-linux/ 4. Depending on the PHP version, you want to use, run one of the following commands: For Zend Server with PHP 5.2 Support run: install.sh 5.2 For Zend Server with PHP 5.3 Support run: instal.sh 5.3 After installing, a completion notification will appear, with a notice that the servers have started. To access the Administration Interface open your browser at: https://localhost:10082/ZendServer (secure) or http://localhost:10081/ZendServer. Upon initial log in, you will be prompted to define your password.
22
To set up the repositories: 1. Run the following command: On 32 bit systems run: zypper addrepo http://repos.zend.com/zendserver/sles/zend_suse_32bit.repo On 64 bit systems run: zypper addrepo http://repos.zend.com/zendserver/sles/zend_suse_64bit.repo 2. Run the following command: zypper refresh 3. Accept importing the Zend Key to your trusted keys list Your repository is now ready for Zend Server to be installed.
23
To set up the repositories: 1. Run the following command: zypper service-add http://repos.zend.com/zendserver/sles/ZendServer-noarch ZendServer-noarch 2. Answer the questions prompted as follows: - Accept importing the Zend Key to your trusted keys list - Accept importing the Zend Key into your key ring 3. Run the following command to add the Zend Server repositories to your system: On 32 bit systems run: zypper service-add http://repos.zend.com/zendserver/sles/ZendServer-i586 ZendServer-i586 On 64 bit systems run: zypper service-add http://repos.zend.com/zendserver/sles/ZendServer-x86_64 ZendServer-x86_64 Your repository is now ready for Zend Server to be installed.
24
Basic Usage
The Zend Server Administration Interface is accessed from https://localhost:10082/ZendServer after the installation. You should refer to the on-line help available through the product or to the Package Setup And Control Scripts guide for additional usage information.
A phpMyadmin meta package that installs phpMyAdmin and attaches it to the Administration Interface via a link from the Dashboard.
frameworkextras
25
Description
The following extensions require the IBM DB2 runtime client (RTCL): PHP extension that enables access to the IBM DB2 Universal Database, IBM Cloudscape and Apache Derby databases. php-5.2ibmdb2-zendserver php-5.2-pdoPHP pdo_ibm extension. ibm-zendserver You can download and install IBM's Runtime Client libraries from ftp://ftp.software.ibm.com/software/data/db2/express/ php-5.3ibmdb2-zendserver php-5.3-pdoibm-zendserver
To upgrade on SLES 11 and OpenSUSE run: To upgrade all Zend related packages run the following command according to the package you have installed: # zypper update '*zend*' To upgrade on SLES 10 and OpenSUSE run: To update any and all files in your system that are managed by 'zypper' (not just Zend products) run: # zypper update -t package '*zend*' To update a specific component (in this example it is php-mycrypt) run the following command according to the package you have installed: The upgrade process locates any components of the product version that are newer and downloads them.
26
To uninstall Zend Server on SLES 11 and OpenSUSE run: zypper remove *zend*
To uninstall Zend Server on SLES 10 run: rpm -qa --qf "%{name}\n" | grep zend | xargs zypper remove
When uninstalling, configuration files are not removed. They remain in the same location and are renamed with an additional suffix (.rpmsave) so that they can be reused in a newer installation. For example: a file called example.ini is renamed to example.ini.rpmsave after running the un-install.
27
Windows Installation
This section describes the three available processes for installing Zend Server on Windows: Either via a native Windows installer, an unattended Installation or a Silent Installation. Note If you are upgrading Zend Server from an existing installation older than Zend Server Version 5.1, you must first perform the procedure described in Upgrading. To run Zend Server on Windows, you need the following: Generally, you should install Zend Server on Windows using an account that has administrator rights. Otherwise, you may encounter problems with certain operations such as editing the PATH environment variable or accessing the Service Control Manager. Enough space on the hard drive to unpack and install (generally a minimum of 200 megabytes is recommended.) Zend Server for Windows is available in a binary distribution that contains a setup program .exe file. The .exe file installs everything you need to start using Zend Server immediately.
If you are encountering problems with Internet Explorer 7 running on Windows 2008 Server, see the following troubleshooting topic: Windows: Internet Explorer Blocking Zend Server IIS Note: Zend Server running with IIS does not provide URL rewrite capabilities. If you require such capabilities (for example, when using Zend Framework based applications that use the default MVC components) refer to the following troubleshooting article.
28
To install Zend Server: 1. After completing the download, double-click on the .exe file to start the installation process. 2. There are three installation types available: Typical, Full, and Custom. The Typical installation type installs the most common options and is recommended for most users. The installed components are Zend Optimizer+, Zend Loader, Zend Debugger, Zend Cache, Zend Framework, Monitor and Page Cache and Oracle OCI Driver. The Full installation type installs all components included in the installation package. The components are Zend Optimizer+, Zend Loader, Zend Debugger, Zend Cache, Java Server, Zend Framework, Oracle OCI Driver, phpMyAdmin, IBM DB2 RTCL, Monitor, Page Cache and MySQL. The full installation package requires an Internet connection while running the installation, to download online components. The Custom installation type gives you complete control over which packages you wish to install and the installation path that is used. The components are Zend Optimizer+, Zend Loader, Zend Debugger, Zend Cache, Java Server, Zend Framework, Oracle OCI Driver, phpMyAdmin, IBM DB2 RTCL, Monitor, Page Cache and MySQL. Important Note: If you are installing Zend Server in order to create a cluster with Zend Server Cluster Manager, make sure you use an identical installation path for all the servers, otherwise Zend Server Cluster Manager will refuse to add the server to the cluster (based on the configurations of the first server added to the cluster from inside Zend Server Cluster Manager). 3. Click the NEXT button to advance to the Confirmation dialog. 4. If you choose the Custom installation type, click the NEXT button to advance to the
29
Destination Location dialog. 5. Select a Web server on which to install the PHP and the Installation Location. Click the NEXT button to advance to the Select Features dialog. 6. Select the features to install by double-clicking the check box next to each feature. A single click on a feature in the list displays a description for the feature. Click the NEXT button to advance to the Administration Interface Password screen and from there, to the Confirmation dialog. 7. The Confirmation Dialog Once you choose an installation type and choose your installation components, you advance to the confirmation dialog. Your installation type and installation path are displayed for you to review. 8. To install Zend Server (if you are satisfied with your settings), click the INSTALL button. To change your settings, click the BACK button. 9. To exit the Zend Server Installation Wizard without installing Zend Server, click the CANCEL button. 10. The Custom Installation The custom installation installs select components and provides an option to choose the Web server on which to install PHP. After confirming the installation, if the port number is already in use, you are asked to specify a different port number. The selected Web server is configured to the port specified after completing the installation. A browser opens after the installation, to display the Administration Interface's login screen. Use the password you specified in the installation process to log in. If it was selected during the installation, a shortcut is added to your desktop, otherwise, bookmarking the page at this point will help you to easily locate the link.
30
Installed Components
Java Bridge
The Java Bridge is set to run by default and it requires that you have SUN Microsystems JRE 1.4 (or later) installed on your computer. Therefore, if you do not already have JRE installed, install it before using the Java Bridge. The Installer is set to detect your JVM: if you do not have one, the Installer prompts you to identify its location. Clicking NO continues the installation without the Java components. More information about JREs and the latest updates can be found on the Sun Microsystems website: http://java.sun.com.
31
32
33
Extension
Linux (DEB/RPM)
Enabled
Windows
Description
Arbitrary precision mathematics functions based on the bcmatch (Binary Calculator) library The bzip2 functions are used to transparently read and write bzip2 (.bz2) compressed files and streams The calendar extension provides functions that simplify conversion between different calendar formats Component Object Model - An interface to Microsoft's COM / .NET environment Character Classifications - Checks whether a character or string falls into a certain character class according to the current locale Enables you to connect to and communicate with different types of servers using various protocols - for example HTTP and FTP Enables various date and time related functions that can handle retrieving the time, date formatting and more Enables operating on an XML document using the Document Object Model (DOM) API Enables access to image EXIF (Exchangeable Image File Format) meta data Provides a set of functions for validating and filtering data coming from insecure sources, such as user inputs Provides low-level client access to FTP (File Transfer Protocol) servers Enables creation, manipulation and streaming of images and graphics in various formats Provides a set of functions that allow internationalization of PHP applications through the GNU gettext API Enables direct or incremental processing of arbitrary length messages using a variety of hashing algorithms Enables conversion between different character sets using the iconv library Provides mail and news access through the IMAP, POP3 and NNTP
bcmath
Enabled
bz2
Enabled
Enabled
calendar
Enabled
Enabled
com_dotnet
Not Shipped
Built-in
ctype
Enabled
Built-in
curl
Enabled
Enabled
date
Built-in
Built-in
dom
Built-in
Built-in
exif
Enabled
Enabled
filter ftp gd
gettext
Enabled
Enabled
hash
Built-in
Built-in
iconv imap
Built-in Enabled
Built-in Enabled
34
Extension
Linux (DEB/RPM)
Windows
protocols
Description
intl
Enabled
Enabled
Provides Unicode and global localization support to PHP applications using the ICU library Implements the JavaScript Object Notation (JSON) data-interchange format Provides access to LDAP (Lightweight Directory Access Protocol) based directory servers; Based on the OpenLDAP library Provides basic API and infrastructure for other XML processing extensions Enables manipulation of strings encoded in multi-byte character encoding schemes Provides support for multiple encryption algorithms using the mcrypt library Provides support for multiple hashing algorithms using the mhash
json
Enabled
Built-in
ldap
Enabled
Enabled
libxml
Built-in
Built-in
mbstring
Enabled
Enabled
mcrypt
Enabled
Enabled
mhash
Enabled
Enabled
library. Can be used to create checksums, message digests, message authentication codes, and more
mime_magic
Enabled
Enabled
Eanbles automatic MIME-type detection based on various patterns in files Provides legacy access to MySQL database servers. For new applications it is recommended to use the 'mysqli' extension MySQL Improved - Provides access to MySQL database servers. Enables the functionality provided by MySQL 4.1 and above Oracle Call Interface - Provides access to Oracle database servers, supporting many of the advanced features provided by Oracle servers This module utilizes the OpenSSL library for generation and verification of signatures and for encrypting and decrypting data and streams Provides a set of functions for string matching and manipulation based on Perl Compatible Regular Expressions syntax Base PDO (PHP Data Objects) Driver - Defines a lightweight, consistent interface for accessing databases in PHP PDO (PHP Data Objects) driver that enable access from PHP to MySQL database servers PDO (PHP Data Objects) driver that enable access from PHP to Oracle database servers using the OCI library PDO (PHP Data Objects) driver that enable access from PHP to
mysql
Enabled
Enabled
mysqli
Enabled
Enabled
oci8
Enabled
Enabled
openssl
Built-in
Built-in
pcre
Built-in
Built-in
pdo
Built-in
Built-in
pdo_mysql
Enabled
Enabled
pdo_oci pdo_pgsql
Enabled Enabled
Enabled Enabled
35
Extension
Linux (DEB/RPM)
Windows
Description
PostgreSQL database servers
pdo_sqlite pgsql
Built-in Enabled
PDO (PHP Data Objects) driver that enable access from PHP to SQLite database files Provides access to PostgreSQL database servers Contains an interface to functions defined in the IEEE 1003.1 (POSIX.1) standards document which are not accessible through other means Adds the ability to reverse-engineer classes, interfaces, functions and methods as well as extensions Enables data persistence between consecutive requests of the same user session The SimpleXML extension provides a very simple and easily usable
posix
Enabled
reflection
Built-in
Built-in
session
Built-in
Built-in
simplexml
Built-in
Built-in
toolset to convert XML to an object that can be processed with normal property selectors and array iterators
soap
Enabled
Enabled
The SOAP extension can be used to implement SOAP Servers and Clients The socket extension implements a set of low-level socket
sockets
Enabled
Enabled
communication functions, providing the possibility to act as a socket server as well as a client
spl
Built-in
Built-in
SPL is a collection of interfaces and classes that can be used to solve standard problems Enables usage of the SQLite Embeddable SQL Database Engine. Can
sqlite
Enabled
Enabled
be used for SQL database access without running a separate RDBMS process
standard
Built-in
Built-in
Standard PHP functions Tidy HTML Clean and Repair - enables you to not only clean and
tidy
Enabled
Enabled
otherwise manipulate HTML documents, but also traverse the document tree The tokenizer functions provide an interface to the PHP tokenizer
tokenizer
Enabled
Enabled
embedded in the Zend Engine. Using these functions you may write your own PHP source analyzing or modification tools without having to deal with the language specification at the lexical level
win32service xml
Enabled Built-in
Allows management of Windows Services using PHP API Enables the creation of event-based XML document parsers using the SAX XML interface
36
Extension
Linux (DEB/RPM)
Windows
Description
The XMLReader extension is an XML Pull parser. The reader acts as a
xmlreader
Enabled
Enabled
cursor going forward on the document stream and stopping at each node on the way.
xmlwriter
Enabled
Enabled
Provides a non-cached, forward-only writer for generating streams or files containing XML data in an efficient manner The XSL extension implements the XSL standard, performing XSLT transformations using the libxslt library ZIP Archives - Enables you to transparently read ZIP compressed archives and the files inside them Enables you to transparently read and write gzip (.gz) compressed
xsl
Enabled
Enabled
zip
Enabled
Enabled
zlib
Built-in
Built-in
files, through versions of most of the filesystem functions which work with gzip-compressed files
37
Extension
Linux (DEB/RPM)
Windows
Description
Allows retrieval of information regarding many different file types. This information includes file type and encoding, as well as more specific information such as dimensions, quality or length These functions allow you to work with arbitrary-length integers using the GNU MP library Enables image creation and manipulation using the ImageMagick API Provides access to memcached - a highly efficient memory based caching daemon Provides a set of functions that can be used to create SWF ("Flash") format animations; Based on the open-source Ming library Provides access to MS SQL Server database; Based on the opensource FreeTDS library Provides access to several database servers through the Unified ODBC interface Process Control Functions - Process Control support in PHP implements the Unix style of process creation, program execution, signal handling and process termination PDO (PHP Data Objects) driver that enable access from PHP to MSSQL and other databases accessible through the FreeDTS interface PDO (PHP Data Objects) driver that enable access from PHP to
fileinfo
Enabled
Not Shipped
ming
Enabled
Disabled
mssql
Enabled
Disabled
odbc
Enabled
Disabled
pcntl
Enabled
Not Shipped
pdo_dblib
Enabled
Not Shipped
pdo_odbc
Enabled
Disabled
different databases through ODBC drivers or through the IBM DB2 Call Level Interface (DB2 CLI) library Shared Memory - Shmop is an easy-to-use set of functions that
shmop
Enabled
Disabled
allows PHP to read, write, create and delete Unix shared memory segments Enables System V messages support - The messaging functions may
sysvmsg
Enabled
Not Shipped
be used to send and receive messages to/from other processes. They provide a simple and effective means of exchanging data between processes, without the need for setting up an alternative using Unix domain sockets
sysvsem
Enabled
Not
38
Extension
Linux (DEB/RPM)
Windows
Shipped
Description
provide exclusive access to resources on the current machine, or to limit the number of processes that may simultaneously use a resource
sysvshm
Enabled
Enables System V shared memory support - Shared memory may be used to provide access to global variables Provides a mechanism for keeping track and showing progress when uploading files WDDX (Web Distributed Data Exchange) - These functions are intended for work with the WDDX data exchange format Provides a set of functions that can be used to write XML-RPC servers and clients
uploadprogress
Enabled
wddx
Enabled
Disabled
xmlrpc
Enabled
Disabled
39
Standalone Extensions
Standalone extensions are provided by Zend but are not included in any of the meta-packages / categories above.
Extension
Linux (DEB/RPM)
Windows
Description
Provides functions that enable you to access the IBM DB2 Universal
ibm_db2
Enabled
Disabled
Database, IBM Cloudscape, and Apache Derby databases using the DB2 Call Level Interface
pdo_ibm
Enabled
Disabled
PDO (PHP Data Objects) driver that enable access from PHP to IBM databases PDO (PHP Data Objects) driver that enable access from PHP to Informix database servers Provides access to Microsoft SQL Server 2005 database servers. Developed by Microsoft
pdo_informix
Enabled
Disabled
sqlsrv
Not Shipped
Disabled
40
Extension
Linux (DEB/RPM)
Enabled
Windows
Description
Arbitrary precision mathematics functions based on the bcmatch (Binary Calculator) library The bzip2 functions are used to transparently read and write bzip2 (.bz2) compressed files and streams The calendar extension provides functions that simplify conversion between different calendar formats PHP CGI/FastCGI Server API Component Object Model - An interface to Microsoft's COM / .NET environment Core PHP functionality Character Classifications - Checks whether a character or string falls into a certain character class according to the current locale Enables you to connect to and communicate with different types of servers using various protocols - for example HTTP and FTP Enables various date and time related functions that can handle retrieving the time, date formatting and more Enables operating on an XML document using the Document Object Model (DOM) API Provides a set of string pattern matching functions using POSIX extended regular expressions. Enables access to image EXIF (Exchangeable Image File Format) meta data Allows retrieval of information regarding many different file types. This
bcmath
Enabled
bz2
Enabled
Enabled
curl
Enabled
Enabled
date
Built-in
Built-in
dom
Built-in
Built-in
ereg
Built-in
Built-in
exif
Enabled
Enabled
fileinfo
Enabled
Enabled
information includes file type and encoding, as well as more specific information such as dimensions, quality or length
filter ftp gd
Provides a set of functions for validating and filtering data coming from insecure sources, such as user inputs Provides low-level client access to FTP (File Transfer Protocol) servers Enables creation, manipulation and streaming of images and graphics in various formats
41
Extension
Linux (DEB/RPM)
Enabled
Windows
Description
Provides a set of functions that allow internationalization of PHP applications through the GNU gettext API Enables direct or incremental processing of arbitrary length messages using a variety of hashing algorithms Enables conversion between different character sets using the iconv library Provides mail and news access through the IMAP, POP3 and NNTP protocols Provides Unicode and global localization support to PHP applications using the ICU library Implements the JavaScript Object Notation (JSON) data-interchange format Provides access to LDAP (Lightweight Directory Access Protocol) based directory servers; Based on the OpenLDAP library Provides basic API and infrastructure for other XML processing extensions Enables manipulation of strings encoded in multi-byte character encoding schemes Provides support for multiple encryption algorithms using the mcrypt library Provides legacy access to MySQL database servers. For new applications it is recommended to use the 'mysqli' extension MySQL Improved - Provides access to MySQL database servers. Enables the functionality provided by MySQL 4.1 and above Oracle Call Interface - Provides access to Oracle database servers, supporting many of the advanced features provided by Oracle servers This module utilizes the OpenSSL library for generation and verification of signatures and for encrypting and decrypting data and streams Provides a set of functions for string matching and manipulation based on Perl Compatible Regular Expressions syntax Base PDO (PHP Data Objects) Driver - Defines a lightweight, consistent interface for accessing databases in PHP PDO (PHP Data Objects) driver that enable access from PHP to MySQL database servers PDO (PHP Data Objects) driver that enable access from PHP to Oracle
gettext
Enabled
hash
Built-in
Built-in
iconv
Built-in
Built-in
imap
Enabled
Enabled
intl
Enabled
Enabled
json
Enabled
Enabled
ldap
Enabled
Enabled
libxml
Built-in
Built-in
mbstring
Enabled
Enabled
mcrypt
Enabled
Enabled
mysql
Enabled
Enabled
mysqli
Enabled
Enabled
oci8
Enabled
Enabled
openssl
Built-in
Built-in
pcre
Built-in
Built-in
pdo
Built-in
Built-in
pdo_mysql pdo_oci
Enabled Enabled
Enabled Enabled
42
Extension
Linux (DEB/RPM)
Windows
Description
database servers using the OCI library
pdo_pgsql
Enabled
Enabled
PDO (PHP Data Objects) driver that enable access from PHP to PostgreSQL database servers PDO (PHP Data Objects) driver that enable access from PHP to SQLite database files Provides access to PostgreSQL database servers Allows running of complete PHP applications out of .phar package files Contains an interface to functions defined in the IEEE 1003.1 (POSIX.1) standards document which are not accessible through other means Adds the ability to reverse-engineer classes, interfaces, functions and methods as well as extensions Enables data persistence between consecutive requests of the same user session The SimpleXML extension provides a very simple and easily usable
posix
Enabled
reflection
Built-in
Built-in
session
Built-in
Built-in
simplexml
Built-in
Built-in
toolset to convert XML to an object that can be processed with normal property selectors and array iterators
soap
Enabled
Enabled
The SOAP extension can be used to implement SOAP Servers and Clients The socket extension implements a set of low-level socket
sockets
Enabled
Enabled
communication functions, providing the possibility to act as a socket server as well as a client
spl
Built-in
Built-in
SPL is a collection of interfaces and classes that can be used to solve standard problems Enables usage of the SQLite Embeddable SQL Database Engine. Can be
sqlite
Enabled
Enabled
used for SQL database access without running a separate RDBMS process
standard
Built-in
Built-in
Standard PHP functions Tidy HTML Clean and Repair - enables you to not only clean and
tidy
Enabled
Enabled
otherwise manipulate HTML documents, but also traverse the document tree The tokenizer functions provide an interface to the PHP tokenizer
tokenizer
Enabled
Enabled
embedded in the Zend Engine. Using these functions you may write your own PHP source analyzing or modification tools without having to deal with the language specification at the lexical level
xml
Built-in
Built-in
43
Extension
Linux (DEB/RPM)
Windows
SAX XML interface
Description
The XMLReader extension is an XML Pull parser. The reader acts as a xmlreader Enabled Enabled cursor going forward on the document stream and stopping at each node on the way. xmlwriter Enabled Enabled Provides a non-cached, forward-only writer for generating streams or files containing XML data in an efficient manner The XSL extension implements the XSL standard, performing XSLT transformations using the libxslt library ZIP Archives - Enables you to transparently read ZIP compressed archives and the files inside them Enables you to transparently read and write gzip (.gz) compressed zlib Built-in Built-in files, through versions of most of the filesystem functions which work with gzip-compressed files
xsl
Enabled
Enabled
zip
Enabled
Enabled
44
Extension
Linux (DEB/RPM)
Enabled Enabled Enabled
Windows
Description
These functions allow you to work with arbitrary-length integers using the GNU MP library Enables image creation and manipulation using the ImageMagick API Provides access to memcached - a highly efficient memory based caching daemon Provides access to MS SQL Server database; Based on the open-source FreeTDS library Provides access to several database servers through the Unified ODBC interface Process Control Functions - Process Control support in PHP implements the Unix style of process creation, program execution, signal handling and process termination PDO (PHP Data Objects) driver that enable access from PHP to MSSQL and other databases accessible through the FreeDTS interface PDO (PHP Data Objects) driver that enable access from PHP to different
mssql
Enabled
Disabled
odbc
Enabled
Disabled
pcntl
Enabled
pdo_dblib
Enabled
pdo_odbc
Enabled
Disabled
databases through ODBC drivers or through the IBM DB2 Call Level Interface (DB2 CLI) library
shmop
Enabled
Disabled
Shared Memory - Shmop is an easy-to-use set of functions that allows PHP to read, write, create and delete Unix shared memory segments Enables System V messages support - The messaging functions may
sysvmsg
Enabled
Not Shipped
be used to send and receive messages to/from other processes. They provide a simple and effective means of exchanging data between processes, without the need for setting up an alternative using Unix domain sockets
sysvsem
Enabled
Enables System V semaphore support - Semaphores may be used to provide exclusive access to resources on the current machine, or to limit the number of processes that may simultaneously use a resource Enables System V shared memory support - Shared memory may be used to provide access to global variables WDDX (Web Distributed Data Exchange) - These functions are intended for work with the WDDX data exchange format Provides a set of functions that can be used to write XML-RPC servers and clients
sysvshm
Enabled
wddx
Enabled
xmlrpc
Enabled
Disabled
45
Standalone Extensions
Standalone extensions are provided by Zend but are not included in any of the meta-packages / categories above.
Extension
Linux (DEB/RPM)
Windows
Description
Provides functions that enable you to access the IBM DB2 Universal
ibm_db2
Enabled
Disabled
Database, IBM Cloudscape, and Apache Derby databases using the DB2 Call Level Interface
pdo_ibm
Enabled
Disabled
PDO (PHP Data Objects) driver that enable access from PHP to IBM databases PDO (PHP Data Objects) driver that enable access from PHP to Informix database servers Provides access to Microsoft SQL Server 2005 database servers. Developed by Microsoft
pdo_informix
Enabled
Disabled
sqlsrv
Not Shipped
Disabled
46
Using PECL
This is relevant only for Linux and Mac OS X [Not applicable for IBM i] PECL is the online repository for PHP extensions. PECL includes a directory of known extensions, including many additional extensions that are not bundled with the default PHP distribution or with Zend Server.
Zend Server includes a command line tool, pecl, that automates the download, compilation and installation of additional extensions from PECL. Note: The default Zend Server installation does not include the complete set of build tools that may be required to compile PHP extensions using pecl. Make sure you have a C compiler (such as gcc) before using pecl.
47
48
Registration
Registration Wizard
The first time Zend Server runs, the registration wizard is displayed. 1. The first step is the license agreement. To continue and install Zend Server, you must accept the license agreement. 2. The second step is the password page. Your password is used to log in to the Administration Interface, either from the main login page accessed from your browser or from the Zend Controller. If you are using the Zend Controller locally or remotely (i.e., Zend Server and Zend Controller are located on separate machines), make sure that the Zend Controller settings match your Zend Server settings. Click here for instructions on how to change your Zend Controller settings according to your operating system. Passwords must be between 4 - 20 characters long. This step is also displayed when your license expires or when you reset your password. After you define your password the first time, you can always change your password from the Administration Interface. For more information, see Password Management. To further secure Zend Server, please refer to Securing the Administration Interface
3. You are not required to enter a license to use Zend Server. However, you must have a valid license to use the complete edition of Zend Server. 1. To enter without a license mark the "Enter without License" check box. 2. If you have your license details, enter them in the Order Number and License Key Fields. This information is stored in your zend.com account or under the account used for the purchase.
49
Note: When attaching a server to Zend Server Cluster Manager, the Zend Server GUI will be disabled. This is to allow Zend Server Cluster Manager the ability to have sole control over settings and configuration in order to prevent inconsistency that could result in loss of information.
License FAQ
How do I just take a look at the product?
If you enter Zend Server without a license, you can run Zend Server in Community Edition Mode. In this mode, Zend Server 's Community Edition features ( PHP 5.x, Zend Data Cache, Zend Debugger, Zend Guard Loader, Zend Java Bridge and Zend Optimizer+) are available and the features that require a license are visible and disabled.
To enter the Community Edition mode, do not enter an Order Number and License Key. Click "Enter Without a License" to start using Zend Server in Community Edition mode. As soon as you enter a valid license, all licensed features are automatically activated for the license period.
50
If you have just installed Zend Server: To enter a license, enter your Order Number and License Key as stated in your confirmation email and click .
If you have already been running Zend Server in Community Edition Mode or with an evaluation license: In the Administration Interface go to Administration | Password and License. Enter your new license details into the "Update License" area. Click to apply the changes.
License Expiration
Before a license expires, a notification is displayed at the bottom of the Administration Interface, telling you how long you have left until your license expires and where to go to renew your license. Once a license expires, Zend Server reverts to Community Edition mode until a new license is entered. During this time, all licensed features are unavailable. However, their settings are kept and are restored, along with the functionality, when a new license is entered.
51
Post Installation
Package Setup and Control Scripts
Package setup and control scripts, refer to the management of the different components included in Zend Server . A list of the components that are installed and running on your system can be found in the Administration Interface in Server Setup | Components. Which components are installed depends on the chosen installation method, license type and product version. For information on Windows click here For information on Linux and Mac OS X click here
52
To add components: 1. Use the Windows Control Panel Start | Control Panel | Add or Remove Programs. 2. In the Add or Remove Programs dialog, locate and click on the Zend Server package in the list. 3. Click Change. The installer will start to run in modify mode. 4. Click Modify and select the components you want to add in the Custom Setup dialog. This adds (and can also remove) any additional packages that are selected.
The Zend Server services are controlled via the MS Windows service manager and are as follows: Monitor - Automatically started Job Queue - Automatically started Code Tracing - Installed but not started by default Session Clustering - Installed but not started by default Java Bridge - Not installed by default MySQL(Optional) Automatically starts according to standard MySQL settings.
53
Zend Server Installation Guide Additional Information Apache Web Server - The service name is Apache2.2-Zend, and it automatically starts after reboot. To change the setting to run or not run at boot time use the MS Windows service manager. The command to start/stop the service from the command line is to first go to the directory <install_dir>\Zend\Apache2\bin and run httpd.exe -k [start|stop] -n Apache2.2-Zend. -or IIS(5,6,7) depends on user settings. The command line to start/stop service (all versions): net [start|stop] w3svc. More info about changing IIS configurations can be found in http://www.iis.net/.
54
To control the Administration Interface's dedicated server, run: # <install_path>/bin/lighttpdctl.sh stop|start|restart: To set the Administration Interface's password, run: # <install_path>/bin/gui_passwd.sh To setup the Java Bridge, run: #<install_path>/bin/setup_jb.sh To control (start/stop) the Java Bridge daemon, run: # <install_path>/bin/java_bridge.sh stop|start|restart
55
Java Bridge setup-jb - Setup Java bridge Running zendctl.sh will show a list of uses and only after running setup_jb.sh will the following additional options be available: start-jb - Start Java bridge only stop-jb - Stop Java bridge only restart-jb - Restart Java bridge only Zend Monitor: start-monitor - Start Monitor node only stop-monitor - Stop Monitor node only restart-monitor - Restart Monitor node only
56
Zend Job Queue: start-jobqueue - start jobqueue only stop-jobqueue - stop jobqueue only restart-jobqueue - restart jobqueue only
The Zend Server daemons are controlled via: /usr/local/zend/bin/zendctl.sh which is symlinked to /etc/init.d/zend-server Zend Server postinstall scripts call: Debian and Ubuntu: update-rc.d zend-server defaults CentOS, Fedora and OEL): /sbin/chkconfig --add zend-server MAC (the procedure is different): /Library/StartupItems/ZendServer_init/
57
Log Rotation
This Item is only relevant for Linux. In production environments, it is important to periodically compress/archive or truncate log file contents. Controlling your log file size prevents unnecessary disk consumption due to bloated log files. The following instructions describe how to override the native Zend Server log rotation mechanism and use logrotate. Note: logrotate is not part of the Zend Server product. To add this component you can use yum and aptitude, according to your distribution's repository. For example, to locate the package in yum, run # yum search logrotate. You can do the same with aptitude too. If your distribution does not include this package in its repositories, you can download the source from here: https://fedorahosted.org/logrotate/.
58
3. Save the file. You have now created a configuration file for all the files located in /usr/local/zend/var/log/ that will be picked-up by logrotate. According to the above mentioned configuration, logrotate checks the file size of each log, every time it is executed (through a daily cron job on most systems). If the file size exceeds 5Mb, the log file is archived by moving the content to a new file and truncating the log file. The new file's name is the same name with an additional number added to the file name. According to the example, logrotate created up to ten backup files. After exceeding ten files, the oldest file is deleted and replaced with new content. The code example describes the following settings: size 5M = file size to rotate missingok = if the file is not found, do not generate an error. rotate 10 = keep up to ten backup files. compress = compress archive log files, using gzip. delaycompress = do not compress the newest file created. copytruncate = rotation method. In this case, copy the content to a new file and truncate the active log.
To disable log rotation, set the log_rotation_size directive to 0. The default log rotation directive value is 10mb.
59
60
Firewall Settings
The following document describes the minimal set of ports that must be opened in your firewall in order for the different Zend Server and Zend Server Cluster Manager components to function. If you are not using one of the Zend Server or Zend Server Cluster Manager components listed below, you are not required to open any of its related ports. Note Most ports can be configured. Each components relevant documentation includes configuration details. Zend Server Administration Interface (Web GUI) Function Port / Protocol TCP/10081 (HTTP) from client Web GUI Access browser to Zend Server and from Zend Server Cluster Manager to Zend Server TCP/10082 (HTTPS) from client Web GUI Access browser to Zend Server and from Zend Server Cluster Manager to Zend Server Local Web Server Control for Zend Server GUI Comments Should be open for administrative access, and between Zend Server Cluster Manager and cluster members. May be blocked if HTTPS (10082) is always used. Linux only. Should be open for administrative access, and between Zend Server Cluster Manager and cluster members. May be blocked if HTTPS is never used.
If closed, no updates will be listed in the Updates periodical check for the GUI TCP/80 (HTTP) from Zend Server to updates.zend.com Administration tab. This does not affect the Linux package managers ability to fetch updates. Update Notification Email Subscription TCP/80 (HTTP) from Zend Server to now.eloqua.com Optional, one time only. Not required for normal operation.
61
Zend Server Installation Guide Monitoring and Code Tracing Function Event Reporting Zend Server Cluster Manager Port / Protocol TCP/3306 (MySQL) from cluster members to DB Server TCP/3306 (MySQL) from Zend Server Cluster Manager to DB Server TCP/25 (SMTP) from Zend Server to configured mail server Comments DB Server may be on the machine running Zend Server Cluster Manager, or may be on a dedicated machine, depending on your configuration. Only required when running in Cluster. DB Server may be on the machine running Zend Server Cluster Manager, or may be on a dedicated machine, depending on your configuration. Only required when running in Cluster. Optional, depends on configuration. Only used if email action is enabled.
Debugging and Profiling Function Port / Protocol TCP/10137 (Proprietary Debugging / Profiling in open LAN Debugger Protocol) from Zend Server (the debugging server) to Zend Studio (client machine) TCP/80 (HTTP, persistent Tunneling connection) from Zend Studio to Zend Server. HTTP/S on application port (usually TCP/80) from Event Debugging and Profiling Zend Server or Zend Server Cluster Manager to application server or alternate debugging server Studio Settings AutoDetection Comments Zend Studio must be able to accept incoming connections from server. Will work when server and client are in the same LAN. If machines are separated by NAT routers or Firewalls, usage of tunneling or SSH port forwarding is required. Linux / Mac only. Required to bypass NAT routers or Firewalls between Zend Studio and Zend Server. Connection starts as HTTP but is kept alive after HTTP request ends, and will be used to tunnel debugging traffic. The Zend Server/Zend Server Cluster Manager GUI will attempt to reproduce the original triggering HTTP request when debugging an event. For this reason, in order to debug or profile an event, the GUI must be able to send HTTP/S requests to the same host name / port on which the application runs, or to an alternate debugging server if one is configured. No interaction with the server is required - sent using TCP/20080 (HTTP) on localhost on the clients machine AJAX to http://localhost:20080 by the users browser, in order to check Zend Studio configuration before debugging events. Not used if Studio Settings autodetection is turned off.
62
Zend Server Installation Guide Zend Java Bridge Function Java Bridge Job Queue Function Port / Protocol TCP/10085 (Proprietary JQ Job Queuing protocol) from Zend Server to Job Queue Daemon (on local or remote machine) Job Execution TCP/80 (HTTP) or any other port, depending on Job URL, from Job Queue Daemon to executing server Comments On Linux, Zend Server is configured by default to use UNIX Domain Sockets instead of TCP. Opening port is only required in cluster or when queuing to a remote machine. Application Dependant: target host and port depend on Job URL, which may change per job. Port / Protocol TCP/10001 (Proprietary JB Protocol) on localhost from Zend Server to local JVM Comments
Session Clustering Function Session Data Exchange PHP to Session Clustering Daemon Session Data Exchange Cluster Members Port / Protocol TCP/10060 on localhost on each Zend Server instance Windows Only. TCP/10062 between Zend Server instances Comments In Linux, UNIX Domain Sockets are used by default. May be initiated between any pair of Session Clustering Daemons. Kept open until connection times out. Initiated during graceful shutdown / startup between the terminated server and replacement servers. UDP Broadcast or Unicast (depending on UDP/10070 between Zend Server instances configuration) between all cluster members.
Graceful Shutdown
63
Installed Components
The following text provides a description of each of the Zend Server components that are installed in your environment Along with the installation location of each component.
Installation Directories
Not all users decide to install their software in the same location. To reflect this actuality, all paths in this document have been replaced with the following prefix: <install_path>. This represents the location of the installed files. If you used the default settings, the location should be as follows: Windows: C:\Program Files\Zend\ZendServer Windows 64 bit C:\Program Files (x86)\Zend\ZendServer DEB/RPM: /usr/local/zend Tarball: /usr/local/zend Mac: /usr/local/zend For Zend Server installation directories, see the Zend Server for IBM i Installation Guide. Loaded + Description The Zend certified version of PHP 5.2.x or 5.3.x that includes commonly used and Zend extensions. Installation Path Windows: <install_path>\bin RPM, DEB: <install_path>/lib/php/libphp5.so The extensions for all are under: <install_path>/lib/php_extensions Comments
Component PHP
Zend Optimizer+
Zends extension for using opcode caching and optimizations for PHP.
Zend Guard
The Zend
Windows: <install_path>\lib\loader
64
Component Loader
Loaded
Description Guard Loader for running PHP, encoded with Zend Guard.
Comments
Zend Debugger
Zends extension for server side debugging, profiling and code coverage.
Zend Cache
A Zend extension for PHP data caching and partial PHP output caching.
Java Bridge
Windows: <install_path>\lib\jbridge RPM, DEB: <install_path>/lib/jbridge Note: Requires SUNs JRE Java Server The Java PHP extension, Java daemon and setup files (not loaded by default). Windows: <install_path>\bin RPM, DEB: PHP Extensions PHP 5.2: <install_path>/lib/jbridge/php.5.2.x/zendbridg 1.4 or later or IBM's Java 1.4.2 or later. 64 bit JRE is not supported. For more
65
Component
Loaded
Description
Installation Path e.so PHP 5.3 <install_path>/lib/jbridge/php.5.3.x/zendbridg e.so Java Daemon <install_path>/lib/jbridge/jawamw.jar
Monitor
Collects information for monitoring and improving the quality of your PHP application.
Job Queue
Windows: PHP 5.2: <install_path>\lib\jobqueue\php5.2.x\JobQueueExt.dll PHP 5.3: <install_path>\lib\jobqueue\php5.3.x\JobQueueExt.dll Job Queue Daemon: <install_path>\\bin\jqd.exe RPM, DEB: Job Queue Extension: PHP 5.2:<install_path>/lib/jobqueue/php5.2.x/jobqueue.so PHP 5.3:<install_path>/lib/jobqueue/php5.3.x/jobqueue.so Job Queue Daemon: <install_path>/bin/jqd Job Queue Daemon Wrapper Script: <install_path>/bin/jqd.sh
Session
Session
Windows:
This
66
Component Clustering
Loaded
Installation Path PHP 5.2: <install_path>\lib\sc\php5.2.x\ZendSessionClustering.dll PHP 5.3: <install_path>\lib\sc\php5.3.x\ZendSessionClustering.dll SC Daemon: <install_path>\bin\ZendSessionManager.exe RPM, DEB: SC Extension: PHP 5.2: <install_path>/lib/sc/php5.2.x/modcluster.so PHP 5.3:<install_path>/lib/sc/php5.3.x/modcluster.so SC Queue Daemon: <install_path>/bin/scd SC Daemon Wrapper Script: <install_path>/bin/scd.sh
Comments component in not installed on ZSCM. Session Clustering is run on the servers in a cluster.
Code Tracing
Windows: PHP 5.2:<install_path>\lib\codetracing\php5.2.x\ZendCodeTracing.dll PHP 5.3:<install_path>\lib\codetracing\php5.3.x\ZendCodeTracing.dll RPM, DEB: PHP 5.2:<install_path>/lib/codetracing/php5.2.x/CodeTracing.so PHP 5.3:<install_path>/lib/codetracing/php5.3.x/CodeTracing.so
Page Cache
ZDS
67
Component
Loaded
Installation Path
Comments
Zend Framework
Installs Zend's opensource framework for developing Web Applications and Web Services in PHP.
This installs Oracle OCI (Oracle Instant Client Libraries) lightweight drivers for accessing Oracle Databases.
Windows: <install_path>\bin RPM, DEB: The extension resides with the other extensions, the libraries it depends upon are in <install_path>/lib/ Note: "Zend Server provides the Oracle Instant Client 'Basic Lite' package, which only includes English error messages, and support for ASCII, Unicode and Western European character sets. If you need support for other languages and character sets, please install one of the other Oracle Instant Client packages available from Oracle, such as here: http://www.oracle.com/technology/software/te ch/oci/instantclient/index.html. You should be
68
Component
Loaded
Description
Installation Path able to install any recent version of the full Oracle Instant Client libraries as a drop-in replacement for the Lite version provided by Zend, without having to reinstall Zend Server." In Linux, make sure that you place the full version's shared libraries before the Lite version in 'LD_LIBRARY_PATH'.
Comments
phpMyAdmin
A popular open-source management tool for handling MySql Database over a Web interface.
This installs the IBM DB2 run Time Client libraries for managing Database access.
Windows: user defined location in a separate installer RPM, DEB: IBM DB2 RTCL is not shipped with Zend Server and can be downloaded from ftp://ftp.software.ibm.com/software/data/db2/e xpress/
Downloaded during installation. Required for IBM DB2 access from PHP.
MySQL
MySQL server's user name and password Linux: Default - "root" Windows: Default - "root" and no password
69
Component
Loaded
Description
Installation Path
Comments For more information see: Working with phpMyAdmin to Manage MySQL
-/+
Installed only if the option is selected. The alternative is to configure to an existing installation of IIS and then Apache will not be installed.
70
Upgrading
The information in this section refers to the different upgrade options available to users, according to the product currently installed and available installation type.
71
Zend Server Installation Guide Zend Server CE Installation Type RPM DEB Community Edition + + Handles all configuration upgrades Tarball + A separate backup of the ZendServer/etc/ directory is created. Manually restore the old configuration file if you want to keep configurations. The configuration file is placed in the same location as the .conf file and is renamed with a timestamp. To use the backup rename to .conf. Mac OS X + When upgrading, the following information will be preserved. apache2/htdocs apache2/conf apache2/conf.d Except for apache2/conf.d/zendserver_gui.conf etc/php.ini etc/conf.d/*.ini All directories under share/pear/ (but not .php files) gui/application/data/zend-server-user.ini gui/application/data/logfiles.xml MySQL data directory MySQL my.cnf file Windows + Upgrades include existing configurations. SLES and OpenSUSE + Upgrades all Zend related packages. The installer automatically identifies if it is a new installation or an upgrade. Configuration Information Comments
72
73
After transferring any configuration from Zend Platform/Zend Core to Zend Server it is highly recommended to thoroughly test your applications before permanently applying these changes.
74
Index
A Additional Packages RPM ................................................................ 9 yum install ....................................................... 9 Administration Interface ................................... 17 setting passwords ......................................... 47 Administration Interface Settings changing ports .............................................. 55 controlling the dedicated server ................... 47 Apache 2.2.x Web server installation path & description ....................... 59 C Changes to the File System ............................. 23 Changes to the Registry................................... 23 Changing the Apache Port ............................... 55 CLI PHP ............................................................. 3 Command Line ................................................. 47 using PHP ....................................................... 3 Command Line Actions .................................... 47 Apache server .............................................. 47 Java Bridge ................................................... 47 LightHttpd ..................................................... 47 Zend Monitor ................................................ 47 Zend Server .................................................. 47 Community Edition features ............................. 44 Community Edition mode ................................. 44 Components descriptions .................................................. 59 installation paths ........................................... 59 Configuration files backing up for reinstallation .......................... 66 Linux ............................................................. 66 Windows ....................................................... 66 Configuring Log Rotation ................................. 53 control scripts ................................................... 47 D DEB Installation ................................................. 3 DEB installation, upgrading ............................. 66 DEB uninstall ..................................................... 3 default file locations ......................................... 23 default program file locations ........................... 23 delete ................................................................. 3 distribution formats............................................. 2 distributions ........................................................ 2 downgrading .................................................... 66 Downgrading/Rollback to an Older Version ..... 66 downloading additional extensions .................. 42 downloading additional PHP extensions ......... 42 F features ............................................................ 44 G getting a Zend Server license .......................... 44 I IBM DB2 RTCL ................................................ 59 installation path & description ...................... 59 installation directories ........................................ 1 installation distributions ...................................... 2 installation distributions, DEB ............................ 2 installation distributions, DMG ........................... 2 installation distributions, RPM ............................ 2 installation distributions, Tarball ......................... 2 installation distributions, Windows ..................... 2 installation, downgrading ................................. 66 Installation, first time .......................................... 1 installation, rollback.......................................... 66 Installed Components ................................ 23, 59 installed directories .......................................... 59 Installing Additional Components .................... 23 Controlling Zend Server Components from the Command Line ............................................. 47
Zend Server Installation Guide M Mac OS X installation upgrading ..................................................... 66 Mac OS X, using PECL ................................... 42 Manual Rollback .............................................. 66 Monitor installation path & description ...................... 59 MS Windows Service Manager ........................ 47 MySQL installation path & description ...................... 59 O Oracle Instant Client nstallation path & description ....................... 59 Order number................................................... 44 P Package setup ................................................. 47 Package Setup and Control Scripts ................. 47 Page Cache installation path & description ...................... 59 password length ............................................... 44 passwords ........................................................ 44 passwords, administration ............................... 44 passwords, requirements ................................. 44 passwords, setting ........................................... 44 pecl tool ............................................................ 42 PECL, definition ............................................... 42 PHP installation path & description ...................... 59 PHP CLI ......................................................... 3, 9 PHP extensions, downloading ......................... 42 PHP extensions, installing ............................... 42 PHP extensions, uninstalling ........................... 42 phpMyAdmin installation path & description ...................... 59 Ports and Services ........................................... 55 Ports settings, changing .................................. 55 Ports, Apache .................................................. 55
Installing with the Native Windows Installer ..... 23 Installing Zend Server .................................. 9, 23 Installing Zend Server Additional Extensions... 42 J Java Bridge installation path & description ....................... 59 set up ............................................................ 47 Java Bridge daemon controlling ..................................................... 47 Java Server installation path & description ....................... 59 L licences, renewing ............................................ 44 license .............................................................. 44 License Expiration ............................................ 44 License key ...................................................... 44 license renewal ................................................ 44 Licenses ........................................................... 44 licenses, obtaining ............................................ 44 licenses, updating ............................................ 44 Linux, using PECL ............................................ 42 Locating Installed Components ........................ 23 log ..................................................................... 44 Log Rotation ..................................................... 53 Log Rotation, configuring ................................. 53 Log Rotation, disabling..................................... 53 Log Rotation, Linux .......................................... 53 Log Rotation, Mac OS X .................................. 53 login .................................................................. 44 login page ......................................................... 44 login, Zend Controller ....................................... 44 logrotate ........................................................... 53 logrotate settings .............................................. 53 logs, archiving .................................................. 53 logs, compressing ............................................ 53 logs, file size ..................................................... 53 logs, truncating ................................................. 53
76
Index
Ports, Java Bridge ............................................ 55 Ports, Lighttpd .................................................. 55 R registering Zend Server .................................... 44 Registration ...................................................... 44 rollback ............................................................. 66 RPM installation upgrading ...................................................... 66 RPM Installation ................................................. 9 RPM packaging format....................................... 9 RPM Upgrade .................................................... 9 S SELinux ............................................................ 17 Setting a Password .......................................... 44 Silent Installation .............................................. 23 SLES Installation .............................................. 17 Start Menu Options .......................................... 23 Starting Services on MS Windows ................... 47 Supported Operating Systems ........................... 2 T Tarball installation upgrading ...................................................... 66 To Disable Log Rotation................................... 53 tools, PEAR ........................................................ 3 tools, PECL ........................................................ 3 tools, yum ........................................................... 9 U Unattended Installation .................................... 23 Uninstalling Zend Server ....................3, 9, 17, 23 YaST ............................................................. 17 Uninstalling Zend Server Additional Extensions ...................................................................... 42 upgrade .............................................................. 3 upgrade options ............................................... 66 upgrade procedures ........................................... 1 upgrading Community Edition to Professional Edition .. 66 Z Y
Zend Platform/Core to Zend Server ............. 66 Zend Server .................................................. 66 Upgrading ........................................................ 66 Upgrading to a Newer Version of Zend Server 66 Upgrading Zend Server ............................. 1, 3, 9 Upgrading Zend Server from Zend Platform/Zend Core ...................................... 66 Upgrading Zend Server, yum............................. 9 Using PECL ..................................................... 42 Using PECL, Linux ........................................... 42 Using PECL, Mac OS X ................................... 42 W Windows Installation ........................................ 23 components .................................................. 23 Java Bridge .................................................. 23 requirements ................................................ 23 system changes ........................................... 23 upgrading ..................................................... 66
ZDS installation path & description ...................... 59 Zend Cache installation path & description ...................... 59 Zend Debugger installation path & description ...................... 59 Zend Download Server (ZDS) installation path & description ...................... 59 Zend Framework installation path & description ...................... 59 Zend Guard Loader installation path & description ...................... 59 Zend Optimizer+ installation path & description ...................... 59
77
Zend Server additional DEB installation packages ............. 3 Additional Packages ....................................... 9 DEB installation .............................................. 3 installation ....................................................... 3 native Windows installer ............................... 23 optional packages for YaST installation ....... 17 RPM Installation ............................................. 9 Silent Installation .......................................... 23 upgrading from Community to Professional Edition ....................................................... 66 upgrading to newer versions ........................ 66 Windows Installation ..................................... 23 Windows unattended Installation .................. 23 YaST installation ........................................... 17 Zend Server Community Edition ................17, 66 installation on SLES ..................................... 17 upgrading ...................................................... 66
Zend Server Installation changes to registry ....................................... 23 changes to system ....................................... 23 default settings ............................................. 23 Zend Server Logs ............................................ 53 Zend Server Logs, configuring log rotation ...... 53 Zend Server registration .................................. 44 Zend Server, additional extensions ................. 42 Zend Server, installing additional extensions .. 42 Zend Server, licenses ...................................... 44 Zend Server, Linux/Mac component port definitions ..................................................... 55 Zend Server, port definitions ............................ 55 Zend Server, registering .................................. 44 Zend Server, uninstalling additional extensions ...................................................................... 42 Zend Server, Windows component port definitions ..................................................... 55
78