Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
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.
iii
Zend Server Community Edition (CE) Installation Guide - Draft
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.
1
Zend Server Community Edition (CE) Installation Guide - Draft
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.
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
Mac: /Applications/ZendServer
2
Zend Server Installation Guide
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.
CentOS 5 RPM
SUSE 10 Tarball
3
Zend Server Community Edition (CE) Installation Guide - Draft
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.
).
4
Zend Server Installation Guide
password.
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
Zend Server Community Edition (CE) Installation Guide - Draft
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:
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
Zend Server Installation Guide
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.
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.
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.
7
Zend Server Community Edition (CE) Installation Guide - Draft
To delete Zend Server CE from the system with no traces left run:
# aptitude purge '~nzend.*-ce'
8
Zend Server 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 (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
9
Zend Server Community Edition (CE) Installation Guide - Draft
Additional Packages
There are additional packages that can be added after installing Zend Server CE, using, yum
install:
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.
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.
10
Zend Server Installation Guide
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.
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
Zend Server Community Edition (CE) Installation Guide - Draft
example.ini.rpmsave.
12
Zend Server Installation Guide
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.
13
Zend Server Community Edition (CE) Installation Guide - Draft
Zend Server CE
Apache
LightHttpd
Java Bridge:
14
Zend Server Installation Guide
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.
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.
15
Zend Server Community Edition (CE) Installation Guide - Draft
Note
If you are upgrading Zend Server CE from an existing installation you must first perform the
procedure described in Upgrading.
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.
16
Zend Server Installation Guide
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.
17
Zend Server Community Edition (CE) Installation Guide - Draft
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.
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.
The following procedure describes how to install Zend Server CE on Windows using a binary
distribution.
Note:
18
Zend Server Installation Guide
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.
19
Zend Server Community Edition (CE) Installation Guide - Draft
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.
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.
20
Zend Server Installation Guide
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.
21
Zend Server Community Edition (CE) Installation Guide - Draft
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.
Change Password - deletes your current password. Clicking this option automatically
deletes your password and opens a new password definition page.
22
Zend Server Installation Guide
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
Zend Server Community Edition (CE) Installation Guide - Draft
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.
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.
Zend Server
Tarball -
Mac OS X -
Windows - For future releases
24
Zend Server Installation Guide
25
Zend Server Community Edition (CE) Installation Guide - Draft
ZendServer/GUI/application/data/
Apache2/conf/
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.
In Linux:
ZendServer\etc\
ZendServer\GUI\application\data\
Apache2\conf\
In Windows:
ZendServer/etc/
ZendServer/GUI/application/data/
Apache2/conf/
26
Zend Server Installation Guide
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:
DEB/RPM: /usr/local/zend
Mac: /Applications/ZendServer
27
Zend Server Community Edition (CE) Installation Guide - Draft
ns for PHP.
28
Zend Server Installation Guide
29
Zend Server Community Edition (CE) Installation Guide - Draft
Libraries)
lightweight
drivers for
accessing
Oracle
Databases.
30
Zend Server Installation Guide
information
see: Working
with
phpMyAdmin
to Manage
MySQL
31
Zend Server Community Edition (CE) Installation Guide - Draft
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.
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.
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
Zend Server Installation Guide
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.
33
Zend Server Community Edition (CE) Installation Guide - Draft
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.
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