Zend Server CE Installation Guide

Zend Server Community Edition (CE)
Installation Guide - Draft

This is a Beta Draft of the Installation Guide for Zend Server CE, Version 4.0 Beta.
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.
1999-2009 Zend Technologies Ltd. All rights reserved.
Zend Server CE Installation Guide, issued February 2009.

DN: ZCE-IG-120209-4.0-005-BETA
Table of Contents
Zend Server Installation Guide ........................................................................................................ 1
Installation Guide ......................................................................................................................... 2
Installing for the first time: ........................................................................................................ 2
Installation Directories .............................................................................................................. 2
Choosing Which Distribution to Install ......................................................................................... 3
Supported Operating Systems ................................................................................................. 3
Tarball Installation ........................................................................................................................ 4
Installing Zend Server CE ........................................................................................................ 4
Uninstalling Zend Server CE .................................................................................................... 5
DEB Installation............................................................................................................................ 6
Additional Packages ................................................................................................................. 6
Upgrading Zend Server CE ...................................................................................................... 7
Uninstalling Zend Server CE .................................................................................................... 7
RPM Installation ........................................................................................................................... 9
Additional Packages ............................................................................................................... 10
Upgrading Zend Server CE .................................................................................................... 11
Uninstalling Zend Server CE .................................................................................................. 11
Package Setup and Control Scripts ........................................................................................... 13
Starting Services on MS Windows ......................................................................................... 13
Controlling Zend Server CE components from the command line ......................................... 13
Command Line Actions .......................................................................................................... 14
Using PECL................................................................................................................................ 15
Installing Zend Server CE Additional Extensions ................................................................... 15
Uninstalling Zend Server CE Additional Extensions .............................................................. 15
Mac OSX Installation ................................................................................................................. 16
Installing Zend Server CE ...................................................................................................... 16
Windows Installation .................................................................................................................. 18
Installing Zend Server CE ...................................................................................................... 18
Installing with the Native Windows Installer........................................................................ 18
Installing Additional Components ....................................................................................... 20
Unattended Installation ....................................................................................................... 20
Silent Installation ................................................................................................................. 21
Installed Components............................................................................................................. 22
iii
Zend Server Community Edition (CE) Installation Guide - Draft
Java Bridge ......................................................................................................................... 22

Locating Installed Components .......................................................................................... 22
Start Menu Options ................................................................................................................ 22
Uninstalling Zend Server CE .................................................................................................. 22
Upgrading................................................................................................................................... 24
Upgrading to a Newer Version of Zend Server CE ................................................................ 24
Zend Server ........................................................................................................................ 24
Zend Server Community Edition ......................................................................................... 25
Upgrading from Zend Server CE to Zend Server ................................................................... 25
Manual Rollback ................................................................................................................. 26
Upgrading Zend Server CE from Zend Platform/Zend Core .................................................. 26
Installed Components ................................................................................................................ 27
Installation Directories ............................................................................................................ 27
Ports and Services ..................................................................................................................... 32
Linux/Mac ............................................................................................................................... 32
Windows ................................................................................................................................. 32
Changing the Apache Port ..................................................................................................... 33
Parallel Installations ................................................................................................................... 34
iv
Zend Server Installation Guide
This is a Beta Draft of the Installation Guide for Zend Server CE, Version 4.0 Beta.
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.
1999-2009 Zend Technologies Ltd. All rights reserved.
Zend Server CE Installation Guide, issued February 2009.

DN: ZCE-IG-120209-4.0-005-BETA
1
Installation Guide
The following instructions describe how to obtain and install Zend Server CE.
A summary of the procedure follows and later sections provide the details.
If you plan to upgrade an existing version of Zend Server CE to a newer version rather than install
Zend Server CE for the first time, see Section "Upgrading Zend Server CE", for information about
upgrade procedures and about issues that you should consider before upgrading.
Installing for the first time:

To determine if Zend Server CE is supported on your platform of choice see the list in Choosing
Which Distribution to Install.
Please note that not all platforms are equally suitable for running Zend Server CE.
Installation Directories
Not all users decide to install their software in the same location. To reflect this requirement, 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\Zend Server

Windows 64 bit C:\Program Files(X86)\Zend\Zend Server
DEB/RPM: /usr/local/zend
Tarball: User defined (the default is /usr/local/zend)
Mac: /Applications/ZendServer
2
Choosing Which Distribution to Install

Zend Server CE is available, in several distribution formats. You can choose from the pre-
packaged distribution called Tarball or install using a Package Manager (RPM and DEB). When
in doubt, use the Tarball distribution.
The distributions for all product versions are:
1. DEB and RPM - Those wanting to use the DEB and RPM should define the Zend Server
CE repository (see the DEB and RPM sections for how to define the repository).
2. Windows - Download the package from zend.com.
Zend Server CE Includes the following additional installation options:
1. Tarball - Download the package from zend.com

2. DMG - For Mac OSX Download the package from zend.com.
Choose the most suitable type of installation according you your operating system by selecting it
from the table below.
If your Operating System does not appear in the list below, click here to be directed to the Tarball
Installation. If you are unable to complete the installation, please refer to our Knowledge Base to
see if these were already handled. Only if there is no article on the subject contact Support for
further assistance.
Supported Operating Systems

Package Name Operating System Installation Type
Linux RHEL 5 RPM
CentOS 5 RPM
SUSE 10 Tarball
Debian and Ubuntu DEB
Fedora 7/8/9/10 RPM

Mac Mac OSX 10.4/10.5 DMG
Windows x86 - 32 Windows XP Professional EXE
Windows Server 2003 EXE
Windows Vista* EXE
Windows x86 - 64 Windows Vista* EXE
windows Server 2003 EXE
Windows XP Professional EXE

.
*All flavours except Home Basic
3
Tarball Installation
The Tarball installation is a generic Linux Tarball installation that includes Zend Server CE,
Apache 2.2, and The latest available version of PHP - PHP 5.2.x. This method is suitable for all
machines, specifically older versions and homegrown Linux based Operating Systems that are
not specified in the list of supported Operating Systems.
Requirement: GLIBC >= 2.3.
Note:
This package includes the Java Bridge component. This component requires Suns SUNs JRE
1.4 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 or http://java.com/en/download/linux_manual.jsp.
).
Installing Zend Server CE

This procedure describes how to install Zend Server CE using the general Tarball installation.
To install Zend Server CE:

The installation package: Zend Server CE 4.0.0 Beta for Linux 32 bit can be
downloaded from
http://downloads.zend.com/zendserver/ce/4.0.0-beta1/ZendServer-4.0.0Beta1MS13RC4-
linux-glibc23-i386.tar.gz
The package's MD5 Sum is: 5c324806bbd2d84568f94d111c76d8b7
The installation package: Zend Server CE 4.0.0 Beta for Linux 64 bit can be
downloaded from
http://downloads.zend.com/zendserver/ce/4.0.0-beta1/ZendServer-4.0.0Beta1MS13RC4-
linux-glibc23-x86_64.tar.gz
The package's MD5 Sum is: 56eb1b5897d921fe5322d948a9d016fa
1. Extract by running the command:
tar -xzvf <package name>
2. CD into the extracted directory and run the installer with the command:
./<Package_Name>/install.sh
3. Specify the prefix (/usr/local/by default) and a new directory called zend will be
created under it (making the path using the default location: /usr/local/zend).
After installing, a completion notification will appear referring informing you about the installation
and what to do next. The Administration (Web) interface is accessed from:
https://localhost:10082/ZendServer. Upon initial login you will be prompted to define your
4
password.
Uninstalling Zend Server CE

The following instructions describe how to uninstall the Tarball package:
To completely uninstall:
# <install_path>/bin/zendctl.sh stop
Ensure all daemons are stopped by running:
# <install_path>/bin/zendctl.sh status
# rm -rf <install_path>
5
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:
To make sure you have root privileges in Ubuntu run the following command, and type your
password: $ sudo -s.

To install Zend Server CE, the first thing you have to do is to setup the repository for downloading
the Zend Server CE package.
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/deb/ce ce non-free
2.Add Zend's repository public key by running:
# wget http://repos.zend.com/deb/zend.key -O- |apt-key add -
3.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 setup, run the command:
# aptitude install zend-ce
2.This package locates and downloads all packages from the web. The actual installation
will require your confirmation.
After installing, a completion notification will appear referring you to the Readme file. This file
contains information about the installation and what to do next.
The Administration (Web) interface is accessed from: https://localhost:10082/ZendServer. Upon
initial login you will be prompted to define your password.
Additional Packages
There are additional packages that can be added after installing Zend Server CE, using: aptitude
install:
6
php5-extra-extensions-zend-ce Additional PHP extensions
php-source-zend-ce Full PHP sources, patched by Zend
php-dev-zend-ce - Zend's development package includes PHP headers, libraries and

PECL. PECL enables you to retrieve and auto-compile PHP extensions.
For more information about PECL see, Using_PECL.
java-bridge-zend-ce - Java bridge package (Requires Suns SUNs JRE 1.4 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 or in
http://wiki.debian.org/Java ).
php-loader-zend-ce - The Zend Guard Loader for running PHP, encoded with Zend
Guard.
phpmyadmin-zend-ce - A phpMyadmin meta package that installs phpMyAdmin and

attaches it to the Administration Interface via a link from the Dashboard.
zend-framework-dojo-ce - Zend Framework's bundled Dojo.
zend-framework-extras-ce - Zend Framework's extra components.
The following extensions require the IBM DB2 runtime client (RTCL):
php-ibmdb2-zend-ce - PHP extension that enables access to the IBM DB2 Universal
Database, IBM Cloudscape and Apache Derby databases using the DB2.
php-pdo-ibm-zend-ce - PHP pdo_ibm extension.
Upgrading Zend Server CE

The following instructions describe how to upgrade Zend Server CE using 'aptitude'.
To perform these actions you must have root privileges.
To upgrade, run:
# aptitude update
# aptitude upgrade
Users can manually initiate the upgrade process. The upgrade process locates any components
of the product version that are newer and downloads them. There are third party tools that can be
used to notify when updates are available.

The following instructions describe how to delete or uninstall using 'aptutude'.
7
To delete Zend Server CE from the system with no traces left run:
# aptitude purge '~nzend.*-ce'
To uninstall Zend Server CE (leaving the configuration files in place) run:

# aptitude remove '~nzend.*-ce'
8
RPM Installation
This method uses "yum" to handle all installations, upgrades and additional packages.
Alternatively, you may choose any other tool that supports the RPM packaging format (i.e.
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.
PHP Note:
The Zend Server installation package will replace your distribution's PHP - this may create
conflicts between RPM packages. If you cannot install one of Zend Server's components, it is
recommended to remove your distribution's PHP packages and try to install again.
SELinux Note:
SELinux users need to change their system settings to permissive mode before starting the Zend
Server CE installation procedure, by executing the following command:
# setenforce permissive

To install Zend Server CE, the first thing you have to do is to setup the repository for downloading
the Zend Server CE package.
To setup the environment:

Set up your Zend Server CE repository by creating:
/etc/yum.repos.d/zend.repo and adding the following content:
[Zend]
name=Zend CE $releasever - $basearch - Released Updates
baseurl=http://repos.zend.com/rpm/ce/$basearch/
enabled=1
gpgcheck=0
[Zendce-noarch]
name=Zend CE - noarch
baseurl=http://repos.zend.com/rpm/ce/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:
9
1.Run the command:

# yum install zend-ce
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 referring you to the Readme file. This file
contains information about the installation and what to do next. The Administration (Web)
interface is accessed from: https://localhost:10082/ZendServer. tar -xzvf <package name>
Additional Packages
There are additional packages that can be added after installing Zend Server CE, using, yum
install:
php5-extra-extensions-zend-ce Additional PHP extensions
php-source-zend-ce Full PHP sources, patched by Zend
php-dev-zend-ce - Zend's development package includes PHP headers, libraries and

PECL. PECL enables you to retrieve and auto-compile PHP extensions.
For more information about PECL see, Using_PECL.
java-bridge-zend-ce - Java bridge package (Requires Suns SUNs JRE 1.4 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 or
http://java.com/en/download/linux_manual.jsp).
After installing the Java Bridge, enable the component by running
/usr/local/zend/bin/setup_jb.sh.
loader-zend-ce - The Zend Guard Loader for running PHP, encoded with Zend Guard.
phpmyadmin-zend-ce - A phpMyadmin meta package that installs phpMyAdmin and

attaches it to the Administration Interface via a link from the Dashboard.
zend-framework-dojo-ce - Zend Framework's bundled Dojo.
zend-framework-extras-ce - Zend Framework's extra components.
The following extensions require the IBM DB2 runtime client (RTCL):
php-ibmdb2-zend-ce - PHP extension that enables access to the IBM DB2 Universal
Database, IBM Cloudscape and Apache Derby databases using the DB2.
php-pdo-ibm-zend-ce - PHP pdo_ibm extension.
CentOS and RHEL4 and 5 Note:
10
The phpmyadmin-zend-ce 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
Upgrading Zend Server CE

The following instructions describe how to upgrade Zend Server CE using 'yum'.
RPM Upgrade Note:

After upgrading from the Community Edition to Zend Server, you will need to manually start your
server by running the command: <install_path>/bin/zendctl.sh start.
To upgrade, run:
To upgrade all Zend related packages run:
# 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 case it is php-mycrypt) run.
# yum update php-mcrypt-zend-pe
Users can manually initiate the upgrade process. The upgrade process locates any components
of the product version that are newer and downloads them. There are third party tools that can be
used to notify when updates are available.

The following instructions describe how to uninstall Zend Server CE:
To uninstall run:
zendctl.sh stop
# yum remove `rpm -qa "*zend*" |xargs`
This will stop the Zend Server CE daemons and remove the program including any additional
packages that were installed.
When un-installing, the configuration files are not removed. They will remain in the same location
with an additional suffix: .rpmsave so that they can be reused in a newer installation. For
example: a file called example.ini, after running the un-install will be renamed to
11
example.ini.rpmsave.
12
Package Setup and Control Scripts

Package setup and control scripts, refer to the management of the different components Zend
Server CE includes. 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 depend on the chosen installation method and product version.
The following instructions describe how to do the following:
How to Start/Stop services on MS Windows
How to control Zend Server CE components from the command line
Starting Services on MS Windows

All Zend Server CE component services are managed by the MS Windows Service Manager.
To Start/Stop (run) or restart any of the services go to, Start | Control Panel | Administrative
Tools | Services.
The components that have services and they are installed will appear with a Zend Prefix.
Additional components can be added by running the installer in modify mode:
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 CE
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 will add (and can also remove) any additional packages that were selected.
Controlling Zend Server CE components from the command line

The setup and control scripts control the optional components that come with Zend Server CE for
the DEB, Tarball and RPM packages.
To control the Administration Interface's dedicated server run:

# <install_path>/bin/lighttpd.sh stop|start|restart:
To set the Administration Interface's password run:
# <install_path>/bin/gui_passwd.sh
13
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
Command Line Actions

The following lists the possible actions that can be done to the Zend Server CE components from
the command line:
Usage: <install_path>bin/zendctl.sh<action>
Zend Server CE
start - Start all Zend Server CE daemons

stop - Stop all Zend Server CE daemons
restart - Restart all Zend Server CE daemons
version - Print Zend Server CE version
status - Get Zend Server CE status
Apache
start-apache - Start Apache only

stop-apache - Stop Apache only
restart-apache - Restart Apache only
LightHttpd
start-lighttpd - Start lighttpd only

stop-lighttpd - Stop lighttpd only
restart-lighttpd - Restart lighttpd only
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
14
Using PECL
This is relevant only for Linux and Mac OS X
PECL is the online repository for PHP Extensions, that includes a directory of known extensions
including many additional extensions that are not bundles with the default PHP distribution or with
Zend Server CE.
Zend Server CE 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 might be
required to compile PHP extensions using pecl.
Make sure you have a C compiler (such as gcc) before using pecl.
Installing Zend Server CE Additional Extensions

The following commands will install additional extensions using pecl
To get a list of available extensions, run:

# <install_path>/bin/pecl list-all
To install an extension, run:
# <install_path>/bin/pecl install $extension_name
Note:
Make sure to verify that all required dependencies for compiling an extension are met. For
example, to compile the newt extension you have to ensure that the ncurses library is
available on the same machine.
Uninstalling Zend Server CE Additional Extensions

The following commands will uninstall additional extensions using pecl
To remove an extension, run:

# <install_path>/bin/pecl uninstall $extension_name
To get a list of commands, run without arguments:
# <install_path>/bin/pecl
15
Mac OSX Installation

This section describes the process for installing Zend Server CE on Mac OSX using the .dmg
Package installer.
Note
If you are upgrading Zend Server CE from an existing installation you must first perform the
procedure described in Upgrading.
To run Zend Server CE on MAC, you need the following:
Mac OSX 10.4 (Tiger) or 10.5 (Leopard) both on Intel
An account with administrator privileges
A minimum of 200 megabytes of available disk space is required to unpack and install
Zend Server CE.
A version for MAC is available in a Binary distribution that contains a setup program .dmg file that
installs everything you need so that you can start immediately.

The following procedure describes how to install Zend Server CE on Mac OSX.

The Zend Server CE 4.0.0 beta installation package for Mac OSX can be downloaded
from:
http://downloads.zend.com/zendserver/ce/4.0.0-beta1/ZendServer-
4.0.0Beta1MS13RC3.dmg
The package's MD5 Sum is: e23cbf07e03235dba116a3423269bff3
1. After downloading the package, locate the downloaded file and double-click it to
reveal the package file ZendServer.pkg . Double-click on it to start the installation
process.
2. Follow the instructions presented by the installer. You should carefully read the
Important Information presented during installation process.
3. If needed, click the Change Install Location button to define a different location
for installing Zend Server CE.
4. Zend Server CE will be installed to /Applications/ZendServer. Once the installation
is complete use the Finder to open this directory. From there you will be able to:
a. Open the Administration interface by launching AdminInterface.app.
b. Start the Zend Controller applet by running ZendController.app
16
c. Open the doc folder to view the README which contains additional
information on the product's content, capabilities and usage.
When opening the Administration Interface for the first time, you will be prompted with request to
set your Zend Server CE password.
This password will be needed for logging-in to the Administration Interface every time you use
Zend Server CE. You should set the same password in the Zend Controller configuration when
launching it for the first time.
You can access your Apache's document root at /Applications/ZendServer/htdocs. Apache is

configured to run on port 10088 by default (accessible at http://localhost:10088/).
17
Windows Installation
This section describes the three available processes for installing Zend Server CE on Windows a
native Windows installer an unattended Installation or Silent Installation.
Note
If you are upgrading Zend Server CE from an existing installation older than Zend Server CE
Version 4.0 Beta you must first perform the procedure described in Upgrading.
To run Zend Server CE on Windows, you need the following:
Generally, you should install Zend Server CE 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.)
There may also be other requirements, depending on how you plan to use Zend Server
CE.
Zend Server CE for Windows is available in a Binary distribution that contains a setup program
.exe file that installs everything you need so that you can start immediately.
If you are encountering problems with Internet Explorer 7 running on Windows 2008 Server see
the following troubleshoot item, Windows: Internet Explorer Blocking Zend Server
IIS Note:
Zend Server CE 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 troubleshoot article.
Installing with the Native Windows Installer
The following procedure describes how to install Zend Server CE on Windows using a binary
distribution.
Note:
18
Users of previous versions of Zend Server CE need to shut down and remove their existing Zend
Server CE installations manually before installing Zend Server CE. See Section Upgrading, for
more information on upgrading from a previous version.

The installation package: Zend Server CE 4.0.0 Beta for Windows x86 can be
downloaded from:
http://downloads.zend.com/zendserver/ce/4.0.0-beta1/ZendServer-4.0.0RC50-
Windows_x86.exe
The package's MD5 Sum: 9748c64d9dc189b95c8c9fe534863c94.
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 components are, Zend Optimizer+,
Zend Loader, Zend Debugger, Zend Cache, Zend Framework 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 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 and MySQL.
3. If you choose the Typical or Complete installation types, click the NEXT button,
to advance to the Administration Interface Password screen and from there to
the confirmation dialog.
4. If you choose the Custom installation type, click the NEXT button, to advance to
the Destination Location dialog.
5. Select a Web server on which to install the PHP and the Installation Location and
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.
19
A single click on a feature in the list will show the items description. 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 optionally 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 CE 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 CE Installation Wizard without installing Zend Server CE,
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 will be asked to specify a different port
number. The selected Web server will be configured to the port specified after
completing the installation.
A browser will open after the installation to display the Administration Interface's login screen.
Use the password you specified in the installation process to login. If specified in the installation,
a shortcut will be added to your desktop, of not Bookmarking this page at this point will help you
to easily locate the link.
Installing Additional Components
While running the installer in custom mode, you can choose not to install certain components. If
at any time you want to add them, save the installation file and re-run in Modify mode or, if you
did not keep the installer file, go to the Control Panel, click Add/Remove programs and select
"change" to run the installer.
Unattended Installation
The following procedure describes how to use an Unattended installation to deploy Zend Server
CE on several machines.

1. Download Zend Server CE.
2. Open the command line from Start | Run
3. Run the command
20
<Package_Name>.exe /r for example ZendServer-4.0.0RC50-

Windows_x86.exe /r
The installer will begin to run in record mode which displays all the run-time dialog
boxes, and stores the data in a file called Setup.iss and stored in the system's
Windows folder.
To specify an alternative response file name and location, use the /f1 argument.
4. Using the /f1 argument allows you to specify where the response file is (or where
it should be created) and what its name is, as in Setup.exe /s
/f1"C:\Temp\Setup.iss". The /f1 switch is available both when creating a
response file (with the /r option) and when using a response file (with the /s
option).
5. Take the generated response file and either store it on a location in the network
which will be available for all machines or copy the file to each of the machines
you want to install Zend Server CE.
6. Go to the new machine and run from the command line Setup.exe /s
/f1"C:\Temp\Setup.iss". This will run the installer in
silent mode, by default based on the responses contained in the response file
called Setup.iss by default. To specify an alternative file name or location of the
response file, use the /f1 argument (see point number 4, above).
Silent Installation
The following procedure describes how to install Zend Server CE in Silent Mode. Silent Mode is
when you install Zend Server CE using all the default settings.
Prerequisites: IIS (any version), IIS is listening to port 80, free disk space (at least 180 MB) and
preferably without a pre-installed PHP.

1. Download Zend Server CE.
2. Open the command line from Start | Run
3. Run the command
<Package_Name>.exe /s /z"di" for example ZendServer-4.0.0RC50-
Windows_x86.exe /s /z"di"
The installer will begin to run in the background and install Zend Server CE using default settings.
If you want to view a progress bar run the same command without the/s argument for example
ZendServer-4.0.0RC50-Windows_x86.exe /z"di".
21
Installed Components
Java Bridge
The Java Bridge is set to run by default and it requires that you have SUNs JRE 1.4 or later
installed on your computer. Therefore, if you do not already have JRE installed please install it
before using the Java Bridge. The installer is set to detect your JVM, if you do not have one the
installer will prompt you to direct it to its location. Clicking NO will continue the installation without
the Java components. More information about JREs and the latest updates are found in the SUN
Website: http://java.sun.com.
Locating Installed Components
Zend Server CE installs to the directory: C:\Program Files\Zend\Zend Server.

If you choose to install Apache from the Zend Server CE installation an additional folder will be
added to the installation path containing your installed Apache:
C:\Program Files\Zend\Zend Server
C:\Program Files\Zend\Apache2.2
If you choose to install phpMyAdmin from the Zend Server CE installation an additional folder will
be added to the installation path containing your installed Apache:
C:\Program Files\Zend\Zend Server
C:\Program Files\Zend\phpMyAdmin
Start Menu Options

The Installation Wizard creates a new entry in the Windows START menu under a Zend Server
CE menu heading.
The following entries are created within the new START menu section:
Change Password - deletes your current password. Clicking this option automatically
deletes your password and opens a new password definition page.
Help and Reference - Opens the online help in a browser
Uninstall - Initiates the Wizard based uninstall process
Zend Server CE - Opens the Zend Server CE Administration Interface
Zend Control Panel - Opens the Zend Controller

The following instructions describe how to uninstall Zend Server CE:
22
To uninstall:
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 CE
package in the list.
3. Click "Remove".
The installer will start to run in uninstall mode.
4. Follow the instructions and click "Finish" to complete the unistallation process.
This will stop the Zend Server CE services and remove the program including any additional
packages that were installed.
23
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.
Locate a product from the list below to see how to upgrade:

Upgrading to a newer version of Zend Server CE
Upgrading from Zend Server CE to Zend Server
Upgrading to Zend Server CE from Zend Platform/Zend Core
Upgrading your RPM Installation to Merge Configuration Files During Upgrade:
If you want to control what Yum will do with configuration changes when installing or
updating packages, use yum-merge-conf.
To install run: # yum install yum-merge-conf.
To use the plugin pass --merge-conf to Yum in addition to regular flags you use.
Upgrading to a Newer Version of Zend Server CE

The following instructions pertain to the process of installing a newer version of the same product
i.e. a newer version of Zend Server CE or a newer version of Zend Server CE Community Edition
( for example, 4.00 to 4.01)
Zend Server
Installation ZendServer Configuration Comments

Type Information
RPM + A separate backup of the You must first add the new
etc file is created. repository to your zend.repo.
Use yum-merge-conf to manage
configurations (see above).
DEB + Handles all configuration You must first add the new
upgrades repository to your sources.list.
Tarball -
Mac OS X -
Windows - For future releases
24
Zend Server Community Edition
Installation Community Configuration Comments

Type Edition Information
RPM + A separate backup You must first add the new repository to
of the etc file is your zend.repo.
created. Use yum-merge-conf to manage
configurations (see above).
DEB + Handles all You must first add the new repository to
configuration your sources.list.
upgrades
Tarball + A separate backup Manually restore the old configuration file if
of the etc file is you want to keep configurations. The
created. 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 + A separate backup Manually restore the old configuration file if
of the etc file is you want to keep configurations. The
created. 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.
Windows - For future releases
Upgrading from Zend Server CE to Zend Server

Installation Availability Configuration Information Comments
Type
RPM + A separate backup of the etc file is Use yum-merge-conf to
created. manage configurations
(see above).
DEB + Handles all configuration upgrades
Tarball -
Mac OS X -
Windows + Configuration information is imported
from: ZendServer/etc/
25
ZendServer/GUI/application/data/
Apache2/conf/
RPM Upgrade Note:

After upgrading from the Community Edition to Zend Server, you will need to manually start your
server by running the command: <install_path>/bin/zendctl.sh start.
Manual Rollback
Once you have upgraded your Community Edition to Zend Server CE, you will have a 60 day trial
period in which you can evaluate the product. If after this time you want to revert to the
Community Edition, there is no need to do anything. The full version of Zend Server CE will
continue to provide the basic Community Edition features and functionality. This also means that
when you do decide to purchase Zend Server CE all you need to do is add a license to activate
the complete functionality.
Alternatively, you can remove Zend Server CE and reinstall the Community Edition. To preserve
you configurations, backup your configuration files before removing Zend Server CE and return
them after re-installing the Community Edition.
The recommended directories to backup are:
In Linux:
ZendServer\etc\
ZendServer\GUI\application\data\
Apache2\conf\
In Windows:
ZendServer/etc/
ZendServer/GUI/application/data/
Apache2/conf/
Upgrading Zend Server CE from Zend Platform/Zend Core

Zend Server CE users can install it in parallel to other Zend products and they will be fully
functional working side-by-side.
26
Installed Components
The following text provides a description of each of the Zend Server CE 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 requirement, 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\Zend Server

Windows 64 bit C:\Program Files(X86)\Zend\Zend Server
DEB/RPM: /usr/local/zend
Tarball: User defined (the default is /usr/local/zend)
Mac: /Applications/ZendServer
Component Loade Descriptio Installation Path Comments

d n
PHP + The Zend Windows: <install_path>\bin
certified RPM, DEB:
version of <install_path>/lib/php/libphp5.so
PHP 5.2.x Tarball and Mac:
that <install_path>/apache2/modules/libphp5.so
includes The extensions for all are under:
commonly <install_path>/lib/php_extensions
used and
Zend
extensions.
Zend + Zends Windows: <install_path>\lib\optimizerplus

Optimizer+ extension RPM, DEB, Tarball and Mac:
for using <install_path>/lib/optimizerplus
opcode
caching
and
optimizatio
27
ns for PHP.
Zend Guard + The Zend Windows: <install_path>\lib\loader

Loader Guard RPM, DEB, Tarball and Mac:
Loader for <install_path>/lib/loader
running
PHP,
encoded
with Zend
Guard.
Zend + Zends Windows: <install_path>\lib\debugger

Debugger extension RPM, DEB, Tarball and Mac:
for server <install_path>/lib/debugger
side
debugging,
profiling
and code
coverage.
Zend + A Zend Windows: <install_path>\lib\datacache

Cache extension RPM, DEB, Tarball and Mac:
for PHP <install_path>/lib/datacache
data
caching
and partial
PHP output
caching.
Java Server - The Java Windows: <install_path>\bin

PHP RPM, DEB, Tarball and Mac:
extension, PHP Extensions -
Java <install_path>/lib/jbridge/php.5.2.x/zendbrid
daemon ge.so
and setup Java Daemon -
files. <install_path>/lib/jbridge/jawamw.jar
28
Java + Enables Windows: <install_path>\lib\jbridge

Note:
Bridge integration RPM, DEB, Tarball and Mac:
Requires
of Java <install_path>/lib/jbridge
SUNs JRE
libraries
1.4 or later or
and
IBM's Java
classes
1.4.2 or later.
within PHP
64 bit JRE is
application
not
s.
supported.
More
information
see:
SUN
Microsystems
s website.
Zend + Installs Windows: This installs

Framework Zend's <install_path>\share\ZendFramework libraries
open- RPM, DEB, Tarball and Mac: containing
source <install_path>/share/ZendFramework the Zend
framework framework
for components.
developing
Web
Application
s and Web
Services in
PHP.
Oracle + This Windows: <install_path>\bin Required for

Instant installs RPM, DEB, Tarball and Mac: The Oracle
Client Oracle OCI extension resides with the other database
(Oracle extensions, the libraries it depends upon access from
Instant are in <install_path>/lib/ PHP.
Client
29
Libraries)
lightweight
drivers for
accessing
Oracle
Databases.
phpMyAdm - A popular Windows: <install_path>\phpMyAdmin Downloaded

in open- Tarball and Mac: not bundled live from the
source DEB and RPM: the distribution's default internet.
manageme location. Only relevant
nt tool for for MySql
handling Database
MySql users.
Database
over a Web
interface.
IBM DB2 - This Windows: user defined location in a Downloaded

RTCL installs the separate installer live from the
IBM DB2 RPM, DEB, Tarball and Mac: The internet.
run Time extension resides with the others, the Required for
Client RTCL is an external IBM IBM DB2
libraries for package for separate download that places access from
managing it's files under /opt/ibm. PHP.
Database
access.
MySQL - Installs a Windows: <install_path>\MySQL Downloaded

complete RPM, DEB, Tarball and Mac: Not Bundled live from the
MySql internet.
database MySQL server's user name and password in usually
on the Web Linux: Default - "root" "root" for
Server. Mac OS X: Defined in the installation administrator
Process s).
Windows: Default - "root" and no password For more
30
information
see: Working
with
phpMyAdmin
to Manage
MySQL
Apache -/+ Windows: <install_path>\Apache2 Installed only

2.2.x Web Tarball and Mac: <install_path>/apache2 if the option
Server DEB and RPM: the distribution's Apache is selected.
package. The
alternative is
to configure
to an existing
installation of
IIS and then
Apache will
not be
installed.
31
Ports and Services

This section lists the services that run after installing Zend Server CE and the ports these
services listen to.
Linux/Mac
After the installation, the following ports will be used by Zend Server CE's components:
Apache: The Tarball installation is sets Apache to listen to port 10088. DEB/RPM is user
defined or it is set to the default port 80 if Apache was not installed.
To change this setting you must configure modify it in your Apache configuration file (see
below).
Lighttpd: The Administration Interface's dedicated server listens to ports 10081 10082 by
default.
10081 is regular HTTP, 10082 is HTTPS [SSL]. The Administration Interface is
accessible via both.
Note: if you change this port remember to update the URL in the Zend Controller.
Java Bridge: The Java Bridge daemon listens on port 10001.

To change this setting go to the Administration Interface and configure the Extension
called "Zend Java Bridge".
Windows
After the installation the following ports will be used by Zend Server CE's components:
IIS server: The service name is "World Wide Web Publishing Service (w3svc)" and it
listens on port 80.
To stop this service from the command line run;
net [stop|start|restart] w3svc
or from Windows go to My Computer | Manage | Services.
Apache server: The service name is "Apache2.2-Zend" and it listens on port 80 by

default.
To stop this service from the command line run:
httpd k [stop|start|restart] n Apache2.2-Zend
or from Windows go to My Computer | Manage | Services.
Note: if you change this port remember to update the URL in the Zend Controller.
Java Server: The service name is "ZendJavaBridge" and it listens on port 10001.
To stop this service from Windows go to My Computer | Manage | Services.
32
Changing the Apache Port

If you have changed your port configuration you need to also update your zwas.ini file with the
change.
Installing Zend Server CE assumes that the Zend Server CE Administration Interface is listening
to 10081,10082. If your environment is configured differently, when trying to access the
Administration Interface you will receive a "Zend Server Exception Caught" error message.
Note:
The Tarball package's Web Server (Apache) listens to port 10088.
Note:
DEB and RPM installations do not need to listen to port 10088 because the Apache's distribution
is used.
In order to fix this the port settings need to be changed.

To set the Administration Interface's settings to listen to a different Web Server Port:
After changing your Apache's port setting to another port:

1. Change the Administration Interface's port setting as follows:
Go to <install_path>/gui/application/data.
2. Open the file zwas.ini and in the section called "User Server" set the URL to the
new port number.
3. Restart Apache
For your information, the different installation options set different Apache configuration file
locations as follows:
DEB Apache conf file: /etc/apache2/apache2.conf
RPM Apache conf file: /etc/httpd/conf/httpd.conf
Tarball Apache conf file: <install_path>/zend/apache2/conf/httpd.conf
MAC Apache conf file: /Applications/ZendServer/apache2/conf/httpd.conf
33
Parallel Installations
Parallel installations refer to installing and running two instances of Zend Server CE on the same
machine. A typical requirement for this type of installation is an environment that services two
different sites on the same machine and requires different configurations.
The package combinations that can be installed in parallel are as follows:

1. Tarball + Tarball
2. RPM + Tarball
3. DEB + Tarball
Any other combination should not be used in parallel.
How to install two instances of Zend Server CE on my machine:
1. For the first installation use only a Tarball package and install to a non default
location anything other than /usr/local/).
2. Change the Lighttpd and Java Bridge port settings to different available ports i.e
any other free ports you have. To view a list of ports that are currently in use run:
netstat -plnt
The lighttpd ports are found in <install_path>/gui/lighttpd/etc/lighttpd.conf.
Change the original SSL connection: SERVER["socket"] == ":10082"
Change the original none secure connection:server.port= 10081
The Java Bridge ports are found in <install_path>/etc/watchdog-jb.ini.
Change the port settings: Dzend.javamw.port=10001
Restart the Zenith Daemon by running <install_path>/bin/zendctl.sh restart.
The second installation should follow the regular installation process. If you are
going to use a combination of RPM + Tarball or DEB + Tarball make sure to install
the RPM or DEB first as they can only be installed in the default location.
You will now be able to access two different instances of Zend Server CE. To view the different
Administration Interfaces call the new port number in your browser.
Notes:
There is no need to change the Web server (apache for linux) as the Tarball's Apache is listening
to port 10088 and the DEB/RPM apache is listening to port 80.
34

Zend Server CE Installation Guide

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Zend Server CE Installation Guide

Încărcat de

Drepturi de autor:

Formate disponibile

Zend Server Community Edition (CE)

Installation Guide - Draft

1999-2009 Zend Technologies Ltd. All rights reserved.

Zend Server CE Installation Guide, issued February 2009.

Java Bridge ......................................................................................................................... 22

1999-2009 Zend Technologies Ltd. All rights reserved.

Zend Server CE Installation Guide, issued February 2009.

Installing for the first time:

Windows: C:\Program Files\Zend\Zend Server

Tarball: User defined (the default is /usr/local/zend)

Choosing Which Distribution to Install

The distributions for all product versions are:

Zend Server CE Includes the following additional installation options:

1. Tarball - Download the package from zend.com

Supported Operating Systems

Linux RHEL 5 RPM

Debian and Ubuntu DEB

Fedora 7/8/9/10 RPM

Windows x86 - 32 Windows XP Professional EXE

Windows Server 2003 EXE

Windows Server 2008 EXE

Windows Vista* EXE

Windows x86 - 64 Windows Vista* EXE

windows Server 2003 EXE

Windows Server 2008 EXE

Windows XP Professional EXE

Installing Zend Server CE

To install Zend Server CE:

Uninstalling Zend Server CE

Installing Zend Server CE

To setup the environment:

php5-extra-extensions-zend-ce Additional PHP extensions

php-source-zend-ce Full PHP sources, patched by Zend

php-dev-zend-ce - Zend's development package includes PHP headers, libraries and

phpmyadmin-zend-ce - A phpMyadmin meta package that installs phpMyAdmin and

zend-framework-dojo-ce - Zend Framework's bundled Dojo.

zend-framework-extras-ce - Zend Framework's extra components.

php-pdo-ibm-zend-ce - PHP pdo_ibm extension.

Upgrading Zend Server CE

To perform these actions you must have root privileges.

Uninstalling Zend Server CE

To perform these actions you must have root privileges.

To uninstall Zend Server CE (leaving the configuration files in place) run:

Installing Zend Server CE

To setup the environment:

1.Run the command:

php5-extra-extensions-zend-ce Additional PHP extensions

php-source-zend-ce Full PHP sources, patched by Zend

php-dev-zend-ce - Zend's development package includes PHP headers, libraries and

phpmyadmin-zend-ce - A phpMyadmin meta package that installs phpMyAdmin and

zend-framework-dojo-ce - Zend Framework's bundled Dojo.

zend-framework-extras-ce - Zend Framework's extra components.

php-pdo-ibm-zend-ce - PHP pdo_ibm extension.

CentOS and RHEL4 and 5 Note:

The phpmyadmin-zend-ce package depends on the availability of phpMyAdmin from your

Upgrading Zend Server CE

RPM Upgrade Note:

To perform these actions you must have root privileges.

Uninstalling Zend Server CE

Package Setup and Control Scripts

How to Start/Stop services on MS Windows

How to control Zend Server CE components from the command line

Starting Services on MS Windows

Additional components can be added by running the installer in modify mode: