You are currently viewing Zend Server 5.x documentation. Click here to view the latest Zend Server online documentation.

You are here: Zend Server Installation Guide > Upgrading

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 are using Zend Server Cluster Manager see Upgrading a Zend Server Cluster.

Upgrading your RPM Installation to Merge Configuration Files During Upgrade

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 the regular flags that you use.

Upgrading to a Newer Version of Zend Server

The following instructions pertain to the process of installing a newer version of the same product, i.e., a newer version of Zend Server or a newer version of Zend Server CE (Community Edition). For example, upgrading from version 5.03 to 5.04 or from version 5.0 to 5.1.

Zend Server

Installation Type	Zend Server	Configuration Information	Comments
RPM	+		See Upgrading a RPM Installation.
DEB	+	Handles all configuration upgrades.	See Upgrading a DEB Installation.
Mac OS X	-		See Upgrading a Mac OS X Installation.
Windows	+	Upgrades include existing configurations.	The installer automatically identifies if it is a new installation or an upgrade. See Upgrading a Windows Installation.
SLES and OpenSUSE	+	Upgrades all Zend related packages.	See Upgrading a RPM (SLES and OpenSUSE) Installation.

Zend Server CE

Installation Type	Community Edition	Configuration Information	Comments
RPM	+		See Upgrading a RPM Installation.
DEB	+	Handles all configuration upgrades	See Upgrading a DEB Installation.
Mac OS X	+	When upgrading, the following information will be preserved.	apache2/htdocs apache2/conf apache2/conf.d 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 include existing configurations.	The installer automatically identifies if it is a new installation or an upgrade.
SLES and OpenSUSE	+	Upgrades all Zend related packages.	See Upgrading a RPM (SLES and OpenSUSE) Installation.

Upgrading from Zend Server CE to Zend Server

This procedure can be performed using the Zend Repository Installer script (available in Zend Server's Download Page | Linux Tab | "Zend Server (DEB/RPM Installer Script)") by running the command ./install.sh <php version> in the script's directory after download.

Installation Type	Availability	Configuration Information	Comments
RPM	+		You must first add the new repository to your sources.list. Use yum-merge-conf to manage configurations (see above).
DEB	+	Handles all configuration upgrades	You must first add the new repository to your sources.list.
Mac OS X	-
Windows	+	Configuration information is imported from: ZendServer\etc\ ZendServer\GUI\application\data\ Apache2\conf/
SLES and OpenSUSE	+	Upgrades all Zend related packages.

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

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.

The recommended directories to backup are:

In Windows:
- ZendServer\etc\
- ZendServer\GUI\application\data\
- Apache2\conf\
In Linux:
- ZendServer/etc/
- ZendServer/GUI/application/data/
- Apache2/conf/

Upgrading PHP 5.2 to PHP 5.3

This procedure describes how to manually update your Zend Server PHP 5.2 to PHP 5.3.

Notes:

This procedure can also be performed using the Zend Repository Installer script (available in Zend Server's Download Page | Linux Tab | "Zend Server (DEB/RPM Installer Script)") by running the command ./upgrade_zs_php.sh <php version> in the script's directory after download.

Currently, upgrades to PHP 5.4 (Technology Preview) are not supported.

RPM

Instructions on how to complete a procedure

To update your PHP on RPM:

Remove Zend Server by running: yum remove -y "zend-server*-php-5.*" && yum remove -y "*zend*"
Restore the configuration files by running from the shell: for conffile in `find /usr/local/zend/ -name "*.rpmsave"`;do echo "Restoring $conffile" ;mv $conffile `echo $conffile|sed "s@.rpmsave@@"`;done
Update the repositories by running: yum clean all
Install the PHP 5.3 version of all packages you installed for 5.2, for example: yum install zend-server-php-5.3 php-5.3-extra-extensions-zend-server

SLES 11

Instructions on how to complete a procedure

To update your PHP on SLES:

Remove Zend Server by running: zypper -n remove "*zend*"
Restore the configuration files by: running from the shell: for conffile in `find /usr/local/zend/ -name "*.rpmsave"`;do echo "Restoring $conffile" ;mv $conffile `echo $conffile|sed "s@.rpmsave@@"`;done
Update the repositories by running: zypper refresh
Install the PHP 5.3 version of all packages you installed for 5.2, for example: zypper install zend-server-php-5.3

DEB

Instructions on how to complete a procedure

To update your PHP on DEB:

Update the repository by running: aptitude update
Install the PHP 5.3 version of all packages you installed for 5.2, for example: aptitude install zend-server-php-5.3 php-5.3-extra-extensions-zend-server php-5.3-java-bridge-zend-server php-5.3-loader-zend-server

Windows and Mac OS X


	To update your PHP on Windows or Mac OS X, simply download the PHP 5.3 version of Zend Server from the product's Downloads Page on top of your existing one. There is no need to remove the prior version in order to update.

Migrating to Zend Server from Zend Platform/Zend Core

Currently there is no automated process for upgrading from Zend Platform/Zend Core to Zend Server. However, it is possible to install Zend Server on a separate machine and manually transfer part of the Zend Platform/Zend Core configurations to the machine running Zend Server. This may help save some time configuring your Zend Server environment.

The following configuration files can be manually copied and used to replace Zend Server configuration files:

Apache configuration files
php.ini

After transferring any configuration from Zend Platform/Zend Core to Zend Server it is highly recommended to thoroughly test your applications before permanently applying these changes.

Downgrading/Rollback to an Older Version

Rollback is the process of reverting to an older version of Zend Server.

Currently there is no automated process for this. Therefore, users who want to rollback should first uninstall their current version and only then install an older version of Zend Server.

Note:

This does not refer to Updates. You can rollback to remove recently added updates. For more information on updating go to Update Notifications.