Zend Server CE Installation Guide V40 N
Zend Server CE Installation Guide V40 N
0
Installation Guide
By Zend Technologies
www.zend.com
This is the Installation Guide for Zend Server Community Edition, Version 4.0.
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
purchaser’s personal use, without the written permission of Zend Technologies Ltd.
All trademarks mentioned in this document, belong to their respective owners.
iii
Zend Server Community Edition (CE) Installation Guide
iv
Zend Server Community Edition
The following instructions describe how to obtain and install Zend Server Community Edition. A
summary of the procedure follows and later sections provide the details.
If you plan to upgrade an existing version of Zend Server Community Edition to a newer version
rather than install Zend Server Community Edition for the first time, see the section on
"Upgrading Zend Server Community Edition " 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 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:
DEB/RPM: /usr/local/zend
Tarball: /usr/local/zend
Mac: /usr/local/zend
5
Zend Server Community Edition (CE) Installation Guide
1. DEB and RPM - Those wanting to use the DEB and RPM should define the Zend Server
Community Edition repository (see the DEB and RPM sections for how to define the
repository).
2. Windows - Download the package from zend.com.
Zend Server Community Edition Includes the following additional installation options:
6
Zend Server Installation Guide
CentOS 5 RPM
SUSE 10 Tarball
7
Zend Server Community Edition (CE) Installation Guide
Tarball Installation
The Tarball installation is a generic Linux Tarball installation that includes Zend Server
Community Edition , Apache 2.2, and The latest available version of PHP - PHP 5.2 or PHP 5.3.
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 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. More information about JREs and the latest updates can
be found on the Sun Microsystem website: http://java.sun.com or
http://java.com/en/download/linux_manual.jsp).
8
Zend Server Installation Guide
9
Zend Server Community Edition (CE) Installation Guide
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>
10
Zend Server Installation Guide
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.
11
Zend Server Community Edition (CE) Installation Guide
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 Community Edition with PHP 5.2 run:
# aptitude install zend-server-ce-php-5.2
To install Zend Server Community Edition with PHP 5.3 run:
# aptitude install zend-server-ce-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.
1. Download the package called "Linux x86 Installer (RPM/DEB Setup Script)" from
zend.com - http://www.zend.com/products/server/downloads-all
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 Community Edition with PHP 5.2 Support run:
install_zs.sh 5.2 ce
• For Zend Server Community Edition with PHP 5.3 Support run:
install_zs.sh 5.3 ce
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.
12
Additional Packages
There are additional packages that can be added after installing Zend Server Community Edition, using 'aptitude install':
Description PHP 5.2 PHP 5.3
Java bridge package (Requires Suns SUN’s 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 JRE’s and the latest java-bridge-zend-server java-bridge-zend-server
updates are found in the SUN Website: http://java.sun.com or in
http://wiki.debian.org/Java).
The Zend Guard Loader for running PHP, encoded with Zend Guard. php-5.2-loader-zend-server Not Supplied
Zend's development package includes PHP headers, libraries and PECL. PECL
enables you to retrieve and auto-compile PHP extensions. Installed by default Installed by default
For more information about PECL see, Using_PECL.
The following extensions require the IBM DB2 runtime client (RTCL):
PHP extension that enables access to the IBM DB2 Universal Database, IBM
php-5.2-ibmdb2-zend-server php-5.3-ibmdb2-zend-server
Cloudscape and Apache Derby databases.
You can download and install IBM's Runtime Client libraries from ftp://ftp.software.ibm.com/software/data/db2/express/
13
Post Installation Configuration
If you intend to use PHP and other tools provided by Zend Server (pear and pecl) from the
command line, it is recommended that you add the <install_path>/bin directory to your $PATH
environment variable.
This can be done in two ways:
• Per user profile
• For all users
The following instructions are 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 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.
14
Zend Server Installation Guide
To upgrade, run:
# aptitude update
# aptitude upgrade
The upgrade process locates any components of the product version that are newer and
downloads them.
15
Zend Server Community Edition (CE) Installation Guide
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 (e.g.
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 that you remove your distribution's PHP packages and try to install again.
SELinux Note:
SELinux users must change their system settings to permissive mode before starting the Zend
Server Community Edition installation procedure, by executing the following command:
# setenforce permissive
16
Zend Server Installation Guide
1.Once the environment is setup, run the appropriate command according to the product
version and PHP support you require:
To install Zend Server Community Edition with PHP 5.2 run:
# yum install zend-server-ce-php-5.2
To install Zend Server Community Edition with PHP 5.3 run:
# yum install zend-server-ce-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.
17
Zend Server Community Edition (CE) Installation Guide
1. Download the package called "Linux x86 Installer (RPM/DEB Setup Script)" from
zend.com - http://www.zend.com/products/server/downloads-all
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 Community Edition with PHP 5.2 Support run:
install_zs.sh 5.2 ce
• For Zend Server Community Edition with PHP 5.3 Support run:
install_zs.sh 5.3 ce
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.
18
Additional Packages
There are additional packages that can be added after installing Zend Server Community Edition, using, 'yum install':
Description PHP 5.2 PHP 5.3
Java bridge package (Requires Suns SUN’s JRE 1.4 or later installed on php-5.2-java-bridge-zend-server php-5.3-java-bridge-zend-server
your computer. Therefore, if you do not already have JRE installed please
install it before using the Java Bridge. More information about JRE’s and
the latest updates are found in the SUN Website: http://java.sun.com or in
http://wiki.debian.org/Java).
The Zend Guard Loader for running PHP, encoded with Zend Guard. php-5.2-loader-zend-server Not Supplied
A phpMyadmin meta package that installs phpMyAdmin and attaches it to phpmyadmin-zend-server-php-5.2 phpmyadmin-zend-server-php-5.3
the Administration Interface via a link from the Dashboard.
Zend's development package includes PHP headers, libraries and PECL. Installed by default Installed by default
PECL enables you to retrieve and auto-compile PHP extensions.
For more information about PECL see, Using_PECL.
The following extensions require the IBM DB2 runtime client (RTCL):
PHP extension that enables access to the IBM DB2 Universal Database, php-5.2-ibmdb2-zend-server php-5.3-ibmdb2-zend-server
IBM Cloudscape and Apache Derby databases.
You can download and install IBM's Runtime Client libraries from ftp://ftp.software.ibm.com/software/data/db2/express/
19
Zend Server Community Edition (CE) Installation Guide
20
Post Installation Configuration
If you intend to use PHP and other tools provided by Zend Server (pear and pecl) from the
command line, it is recommended that you add the <install_path>/bin directory to your $PATH
environment variable.
This can be done in two ways:
• Per user profile
• For all users
The following instructions are 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 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.
21
Zend Server Community Edition (CE) Installation Guide
To upgrade, run:
To upgrade all Zend related packages run the following command according to the
package you have installed:
To upgrade Zend Server Community Edition with PHP 5.2 run:
# yum update zend-server-ce-php-5.2
To upgrade Zend Server Community Edition with PHP 5.3 run:
# yum update zend-server-ce-php-5.3
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 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.
22
Zend Server Installation Guide
To uninstall run:
zendctl.sh stop
And then run th following command according to the packlage you have installed:
To uninstall Zend Server Community Edition with PHP 5.2 run:
# yum -y remove zend-server-ce-php-5.2 && yum -y remove `rpm -
qa|grep zend|xargs`
To uninstall Zend Server Community Edition with PHP 5.3 run:
# yum -y remove zend-server-ce-php-5.3 && yum -y remove `rpm -
qa|grep zend|xargs`
This will stop the Zend Server Community Edition daemons and remove the program, including
any additional packages that were installed.
When uninstalling, the configuration files are not removed. They 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 is renamed to example.ini.rpmsave, after you run the uninstall.
23
Zend Server Community Edition (CE) Installation Guide
Mac OS X Installation
This section describes the process for installing Zend Server Community Edition on Mac OS X
from a .dmg disk image. The disk image contains a .pkg installer for Zend Server Community
Edition (including MySQL and phpMyAdmin) and the Zend Controller App. which you may
optionally install after installing Zend Server Community Edition .
Note
If you are upgrading Zend Server Community Edition from an existing installation you must first
perform the procedure described in ”Upgrading”.
Requirements:
A minimum of 200 megabytes of available disk space is required to unpack and install
Zend Server Community Edition.
The Oracle extensions (oci8, pdo_oci) and Oracle Instant Client library can only be
installed on Mac OS X version 10.5 and above.
24
Zend Server Installation Guide
25
Zend Server Community Edition (CE) Installation Guide
26
Zend Server Installation Guide
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.
27
Zend Server Community Edition (CE) Installation Guide
28
Zend Server Installation Guide
Windows Installation
This section describes the three available processes for installing Zend Server Community
Edition on Windows: Either via a native Windows installer, an unattended Installation or a Silent
Installation.
Note
If you are upgrading Zend Server Community Edition from an existing installation older than Zend
Server Community Edition Version 4.0 , you must first perform the procedure described in
“Upgrading”.
To run Zend Server Community Edition on Windows, you need the following:
Generally, you should install Zend Server Community Edition 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 Community Edition 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 Community Edition 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.
29
Zend Server Community Edition (CE) Installation Guide
Note:
Users of previous versions of Zend Server Community Edition need to shut down and remove
their existing Zend Server Community Edition installations manually before installing Zend Server
Community Edition . See Section “Upgrading”, for more information on upgrading from a previous
version.
30
Zend Server Installation Guide
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 Community Edition (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 Community Edition Installation Wizard without installing
Zend Server Community Edition, 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.
31
Zend Server Community Edition (CE) Installation Guide
Unattended Installation
The following procedure describes how to use an Unattended installation to deploy Zend Server
Community Edition on several machines.
32
Zend Server Installation Guide
Silent Installation
The following procedure describes how to install Zend Server Community Edition in Silent Mode.
Silent Mode is when you install Zend Server Community Edition 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.
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.
33
Zend Server Community Edition (CE) Installation Guide
Change Password - deletes your current password. Clicking this option automatically
deletes your password and opens a new password definition page.
Zend Server Community Edition - Opens the Zend Server Community Edition
Administration Interface
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 the Zend Server
Community Edition package in the list.
3. Click "Remove".
The Installer runs in uninstall mode.
4. Follow the instructions and click "Finish" to complete the uninstallation process.
This will stop the Zend Server Community Edition services and remove the program, including
any additional packages that were installed.
34
Zend Server Installation Guide
35
Zend Server Community Edition (CE) Installation Guide
36
Zend Server Installation Guide
37
Zend Server Community Edition (CE) Installation Guide
38
Zend Server Installation Guide
39
Zend Server Community Edition (CE) Installation Guide
40
Zend Server Installation Guide
41
Zend Server Community Edition (CE) Installation Guide
Standalone Extensions
Standalone extensions are provided by Zend but are not included in any of the meta-packages /
categories above.
42
Zend Server Installation Guide
Not Not
cgi-fcgi Not Shipped Built-in PHP CGI/FastCGI Server API
Shipped Shipped
43
Zend Server Community Edition (CE) Installation Guide
44
Zend Server Installation Guide
45
Zend Server Community Edition (CE) Installation Guide
46
Zend Server Installation Guide
47
Zend Server Community Edition (CE) Installation Guide
48
Zend Server Installation Guide
49
Zend Server Community Edition (CE) Installation Guide
Standalone Extensions
Standalone extensions are provided by Zend but are not included in any of the meta-packages /
categories above.
50
Zend Server Installation Guide
Parallel Installations
Parallel installations refer to installing and running two instances of Zend Server Community
Edition 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.
1. For the first installation, use only a Tarball package and install to a non-default
location (i.e., 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 non-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
3. Restart the Zend Server Community Edition Daemon by running
<install_path>/bin/zendctl.sh restart.
4. 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 because those packages can only be installed in the
default location.
You are now able to access two different instances of Zend Server Community Edition. 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 listens to
port 10088 and the DEB/RPM Apache listens to port 80.
51
Zend Server Community Edition (CE) Installation Guide
Using PECL
This is relevant only for Linux and Mac OS X
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 Community Edition.
Zend Server Community Edition 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.
Note:
Make sure to verify that all required dependencies for compiling an extension are met.
For example, to compile the newt extension, you must ensure that the ncurses library is
available on the same machine.
52
Zend Server Installation Guide
53
Zend Server Community Edition (CE) Installation Guide
Registration
The first time Zend Server runs, the Password and License page is displayed.
This page 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.
From the Password and License page, you can set your Administration Interface password and
enter your license details.
Setting a Password
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 Community Edition 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.
54
Zend Server Installation Guide
Licenses
You are not required to enter a license to use Zend Server Community Edition. However, you
must have a valid license to use the complete edition of Zend Server Community Edition.
To enter the Community Edition mode, do not enter an Order Number and License Key.
55
Zend Server Community Edition (CE) Installation Guide
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 Community Edition 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.
56
Zend Server Installation Guide
Post Installation
Package Setup and Control Scripts
Package setup and control scripts, refers to the management of the different components
included in Zend Server Community Edition. 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.
The following sections describe how to do the following:
How to control Zend Server Community Edition components from the command line
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
Community Edition 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.
57
Zend Server Community Edition (CE) Installation Guide
Apache
LightHttpd
58
Zend Server Installation Guide
Java Bridge
Zend Monitor:
59
Zend Server Community Edition (CE) Installation Guide
Log Rotation
This Item is only relevant for Linux and Mac OS X .
Note:
logrotate is not part of the Zend Server Community Edition 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/.
60
Zend Server Installation Guide
copytruncate = rotation method. In this case, copy the content to a new file and truncate
the active log.
61
Zend Server Community Edition (CE) Installation Guide
62
Zend Server Installation Guide
Linux /Mac OS X
After the installation, the following TCP ports will be used by Zend Server Community Edition 's
components:
Apache: The Linux generic Tarball and Mac installation set Apache to listen to port
10088. When installing Zend Server using DEB/RPM repositories the distribution's
Apache is used; by default in such cases Apache will listen to port 80 - although this
setting might change according to your predefined settings.
To change this setting, edit your Apache configuration file.
Java Bridge: The Java Bridge daemon, when enabled, listens on port 10001.
Windows
After the installation the following TCP ports will be used by Zend Server Community Edition 's
components:
IIS: When Zend Server is installed on IIS the ports to which IIS listens to are defined by
your IIS configuration.
Apache: When Zend Server is installed on Apache, it listens on port 80 by default unless
a different port was selected during installation. To change this port edit your Apache
configuration file.
Note: If you change this port, remember to update the URL in the Zend Controller.
Java Bridge: The Java Bridge daemon, when enabled, listens on port 10001.
63
Installed Components
The following text provides a description of each of the Zend Server Community Edition 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:
DEB/RPM: /usr/local/zend
Tarball: /usr/local/zend
Mac: /usr/local/zend
64
Zend Server Installation Guide
65
Zend Server Community Edition (CE) Installation Guide
Oracle + This installs Oracle OCI Windows: <install_path>\bin Required for Oracle
Instant Client (Oracle Instant Client RPM, DEB, Tarball and Mac: The extension resides database access from PHP.
Libraries) lightweight drivers with the other extensions, the libraries it depends
for accessing Oracle upon are in <install_path>/lib/
Databases.
66
Zend Server Installation Guide
IBM DB2 - This installs the IBM DB2 Windows: user defined location in a separate Downloaded during
RTCL run Time Client libraries for installer installation.
managing Database access. RPM, DEB, Tarball and Mac: IBM DB2 RTCL is not Required for IBM DB2
shipped with Zend Server Community Edition and access from PHP.
can be downloaded from
ftp://ftp.software.ibm.com/software/data/db2/express/
67
Zend Server Community Edition (CE) Installation Guide
68
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.
Zend Server
Installation Zend Configuration Comments
Type Server Information
RPM +
DEB + Handles all
configuration upgrades.
Tarball -
Mac OS X -
Windows + Upgrades include The installer automatically identifies
existing configurations. if it is a new installation or an
upgrade.
69
Zend Server Community Edition (CE) Installation Guide
Zend Server CE
Installation Community Configuration Comments
Type Edition Information
RPM +
DEB + Handles all
configuration
upgrades
Tarball + A separate Manually restore the old configuration file
backup of the if you want to keep configurations. The
ZendServer/etc/ configuration file is placed in the same
directory is location as the .conf file and is renamed
created. with a timestamp. To use the backup
rename to .conf.
Mac OS X + When upgrading, apache2/htdocs
the following apache2/conf
information will apache2/conf.d
be preserved. 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 The installer automatically identifies if it is
include existing a new installation or an upgrade.
configurations.
70
Zend Server Installation Guide
71
Zend Server Community Edition (CE) Installation Guide
Manual Rollback
Once you have upgraded your Community Edition to Zend Server, you will need a license to run
the fully functional product . If you do not enter a license, Zend Server will run with the same
functionality as the Community Edition: There is no need to do anything. The full version of Zend
Server will continue to provide the basic Community Edition features and functionality. This also
means that when you do decide to purchase Zend Server, all you need to do is add a license to
activate the complete functionality.
Alternatively, you can remove Zend Server and reinstall the Community Edition. To preserve
your configurations, back up your configuration files before you remove Zend Server and return
them after you reinstall the Community Edition.
In Windows:
• ZendServer\etc\
• ZendServer\GUI\application\data\
• Apache2\conf\
In Linux:
• ZendServer/etc/
• ZendServer/GUI/application/data/
• Apache2/conf/
72
Zend Server Installation Guide
php.ini
After transferring any configuration from Zend Platform/Zend Core to Zend Server Community
Edition it is highly recommended to thoroughly test your applications before permanently applying
these changes.
73