RPM Installation (RHEL, CentOS, Fedora and OEL)
In this Topic ShowHide
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
installation procedure, by executing the following command:
# setenforce permissive
Automatically Installing Zend Server
The following procedure describes how to run a script that will automatically
create your DEB or RPM repositories and install Zend Server.
|
|
|
Download the package called "Linux x86 Installer
(RPM/DEB Setup Script)" from zend.com - http://www.zend.com/en/products/server/downloads Locate and extract the package:
ZendServer-X.X.X-RepositioryInstaller-linux.tar.gz To change to the directory with the installer scripts
run:
cd ZendServer-RepositoryInstaller-linux/ Depending on the PHP version, you want to use, run one
of the following commands:
|
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. |
Manually Installing
Zend Server
To install Zend Server,
first setup the repository for downloading the Zend Server
package.
|
|
|
To setup the environment:
Set up your Zend Server
repository by creating:
/etc/yum.repos.d/zend.repo and adding the following content:
[Zend]
name=Zend Server
baseurl=http://repos.zend.com/zend-server/rpm/$basearch
enabled=1
gpgcheck=0
[Zend_noarch]
name=Zend Server - noarch
baseurl=http://repos.zend.com/zend-server/rpm/noarch
enabled=1
gpgcheck=0 |
Now
you can use 'yum' to handle installations or any other tool that
supports the RPM packaging format. |
To install:
|
|
|
1.Once
the environment is setup, run the appropriate command according
to the product version and PHP support you require:
To install Zend
Server with PHP 5.2
run:
#
yum install zend-server-php-5.2
To install Zend
Server with PHP 5.3
run:
#
yum install zend-server-php-5.3
2. To clean your packages cache and ensure retrieval of updates
from the web, run:
yum clean all |
After
installing, a completion notification will appear, with a notice
that the servers have started.
To access the Administration Interface (Web) open your browser
at: https://localhost:10082/ZendServer (secure) or http://localhost:10081/ZendServer.
Upon initial log in, you will be prompted to define your password. |
Additional Packages
There are additional packages that can be added after installing Zend Server, using, 'yum
install'.
You can remove each package individually with the following command
'yum
remove' and then the package name of the component you want to
remove. To complete the removal process in the Zend Server Administration
interface click "Restart PHP".
Description |
PHP 5.2 |
PHP 5.3 |
Additional PHP extensions |
php-5.2-extra-extensions-zend-server |
php-5.3-extra-extensions-zend-server |
Java bridge package (Requires Sun JRE
1.5, 1.6 or later installed on your computer. Therefore, if you
do not already have JRE installed please install it before using
the Java Bridge. More information about JRE’s and the latest updates
are found in the SUN Website: http://java.sun.com/javase/downloads/index.jsp
(jre-6u21-linux-x64-rpm.bin) |
php-5.2-java-bridge-zend-server |
php-5.3-java-bridge-zend-server |
The Zend Guard Loader for running PHP,
encoded with Zend Guard. |
php-5.2-loader-zend-server |
php-5.3-loader-zend-server |
A phpMyadmin meta package that installs
phpMyAdmin and attaches it to the Administration Interface via
a link from the Dashboard. |
phpmyadmin-zend-server-php-5.2 |
phpmyadmin-zend-server-php-5.3 |
Zend Framework's bundled Dojo. |
zend-server-framework-dojo |
zend-server-framework-dojo |
Zend Framework's extra components. |
zend-server-framework-extras |
zend-server-framework-extras |
Full PHP sources, patched by Zend |
php-5.2-source-zend-server |
php-5.3-source-zend-server |
| Zend
Server Control Panel |
control-panel-zend-server
|
control-panel-zend-server
|
The following
extensions require the IBM DB2 runtime client (RTCL): |
PHP extension that enables access to
the IBM DB2 Universal Database, IBM Cloudscape and Apache Derby
databases. |
php-5.2-ibmdb2-zend-server |
php-5.3-ibmdb2-zend-server |
PHP pdo_ibm extension. |
php-5.2-pdo-ibm-zend-server |
php-5.3-pdo-ibm-zend-server |
Informix client |
php-5.2-pdo-informix-zend-server |
php-5.3-pdo-informix-zend-server |
You can download and install IBM's Runtime Client libraries from ftp://ftp.software.ibm.com/software/data/db2/express/
CentOS and RHEL4 and 5 Note:
The phpmyadmin-zend-pe
package depends on the availability of phpMyAdmin from your distribution's
repositories. The default CentOS repositories for example do not offer
phpMyAdmin and therefore require that you manually add the rpmforge
repositories to your yum repositories
list. For information on how to do this for CentOS see: http://wiki.centos.org/AdditionalResources/Repositories/RPMForge
Post Installation Configuration
If you intend to use PHP and other tools provided by Zend Server (pear and pecl) from
the command line (PHP CLI), 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 procedure is intended for use with bash.
If you are using a different shell, adjust the procedure accordingly.
|
|
|
To add the <install_path>/bin
directory to your $PATH environment variable per user profile:
Using
a text editor, open .bashrc (located in your home directory). 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.
Save the file. In order for this to take effect, close and
reopen your shell or run the following command:
source ~/.bashrc |
You
can now run the PHP binary provided by Zend Server
without typing its full path. |
|
|
|
To add the <install_path>/bin
directory to your $PATH environment variable for all users:
Log
in as root or use sudo to execute the following commands. Using
a text editor, open /etc/profile. 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.
Save the file. 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. |
Enabling RPM Package Signature Validation
Zend Server's RPM packages are signed using PGP. This can be used to
validate package integrity and authenticity during installation. This
is an optional step which is recommended for organizations with strict
security policies.
|
|
|
To enable RPM package signature validation:
- Start the manual installation process as described in (link
to manual install)
- After creating the file /etc/yum.repos.d/zend.repo, change
the value of all of the gpgcheck
occurrences to '1'
- After each gpgcheck
occurrence add the following line:
gpgkey=http://repos.zend.com/zend.key
- Continue the installation process
|
Before
installing the first packages, yum
will prompt you to approve importing the Zend PGP key from
the URL above.
After following this procedure, whenever upgrading and installing
Zend Packages yum will
verify the packages before installing them. |
Upgrading Zend Server
The following procedure describes how to upgrade Zend Server
using 'yum'.
RPM Upgrade Note:
After upgrading, you will need to manually start your
server by running the command: <install_path>/bin/zendctl.sh start.
To perform these actions you must have root privileges.
|
|
|
To upgrade, run:
To upgrade all Zend related packages run the following command
according to the package you have installed:
# yum update \*zend\*
To update any and all files in your system that are managed
by 'yum' (not just Zend products) run:
# yum update
To update a specific component (in this example it is php-mycrypt)
run the following command according to the package you have installed:
To upgrade Zend
Server with PHP 5.2
run:
#
yum update php-mcrypt-zend-server-php-5.2
To upgrade Zend
Server with PHP 5.3
run:
#
yum update php-mcrypt-zend-server-php-5.3
To upgrade Zend Server Community
Edition with PHP 5.2
run:
# yum update php-mcrypt-zend-server-ce-php-5.2
To upgrade Zend Server Community
Edition with PHP 5.3
run:
# yum update php-mcrypt-zend-server-ce-php-5.3 |
The
upgrade process locates any components of the product version
that are newer and downloads them. |
Uninstalling Zend Server
The following procedure describes how to uninstall Zend Server:
|
|
|
To uninstall run:
zendctl.sh stop
And then run the following command according to the package
you have installed:
To uninstall Zend
Server with PHP 5.2
run:
#
yum -y remove zend-server-php-5.2 && yum -y remove `rpm
-qa|grep zend|xargs`
To uninstall Zend
Server with PHP 5.3
run:
#
yum -y remove zend-server-php-5.3 && yum -y remove `rpm
-qa|grep zend|xargs`
|
This
will stop the Zend Server
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. |
