RPM Installation (RHEL, CentOS, Fedora and OEL)

In this Topic Hide

Automatically Installing Zend Server

Manually Installing Zend Server

Additional Packages

Post Installation Configuration

Enabling RPM Package Signature Validation

Upgrading Zend Server

Uninstalling Zend Server

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.

 

 

Instructions on how to complete a procedure

  1. Download the package called "Linux x86 Installer (RPM/DEB Setup Script)" from zend.com - http://www.zend.com/en/products/server/downloads

  2. Locate and extract the package:
    ZendServer-X.X.X-RepositioryInstaller-linux.tar.gz

  3. To change to the directory with the installer scripts run:
    cd ZendServer-RepositoryInstaller-linux/

  4. Depending on the PHP version, you want to use, run one of the following commands:

    • For Zend Server with PHP 5.2 Support run:
      install_zs.sh 5.2

    • For Zend Server with PHP 5.3 Support run:
       install_zs.sh 5.3

After installing, a completion notification will appear, with a notice that the servers have started.

To access the Administration Interface (Web) open your browser at: https://localhost:10082/ZendServer (secure) or http://localhost:10081/ZendServer.

Upon initial log in, you will be prompted to define your password.

Manually Installing Zend Server

To install Zend Server, first setup the repository for downloading the Zend Server package.

 

 

Instructions on how to complete a procedure

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:

 

 

Instructions on how to complete a procedure

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:

The following procedure is intended for use with bash. If you are using a different shell, adjust the procedure accordingly.

 

 

Instructions on how to complete a procedure

To add the <install_path>/bin directory to your $PATH environment variable per user profile:

  1. Using a text editor, open .bashrc (located in your home directory).

  2. Add the following lines to the end of the file:

PATH=$PATH:<install_path>/bin

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<install_path>/lib

Replace <install_path> with your Zend Server installation path.

  1. Save the file.

  2. 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.

 

 

Instructions on how to complete a procedure

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.

  1. Save the file.

  2. 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.

 

 

Instructions on how to complete a procedure

To enable RPM package signature validation:

  1. Start the manual installation process as described in (link to manual install)
  2. After creating the file /etc/yum.repos.d/zend.repo, change the value of all of the gpgcheck occurrences to '1'
  3. After each gpgcheck occurrence add the following line:
    gpgkey=http://repos.zend.com/zend.key
  4. Continue the installation process

Before installing the first packages, yum will  prompt you to approve importing the Zend PGP key from the URL above.

After following this procedure, whenever upgrading and installing Zend Packages yum will verify the packages before installing them.

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.

bulb.gifTo perform these actions you must have root privileges.

 

 

Instructions on how to complete a procedure

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:

 

 

Instructions on how to complete a procedure

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.

 

 

Related Links

Related Links:

Upgrading your RPM Installation

Choosing Which Distribution to Install

Package Setup and Control Scripts

Using PECL

http://java.sun.com - External Link

http://wiki.centos.org/AdditionalResources/Repositories/RPMForge - External Link