Upgrading

In this Topic Hide

Upgrading your RPM Installation to Merge Configuration Files During Upgrade

Upgrading to a Newer Version of Zend Server

Zend Server

Zend Server CE

Upgrading from Zend Server CE to Zend Server

Manual Rollback

Upgrading PHP 5.2 to PHP 5.3

RPM

SLES 11

DEB

Windows and Mac OS X

Migrating to Zend Server from Zend Platform/Zend Core

Downgrading/Rollback to an Older Version

 

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

bulb.gif

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.

Tarball

-

 

See Tarball 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.

 

Tarball

+

A separate backup of the ZendServer/etc/ directory is created.

Manually restore the old configuration file if you want to keep configurations. The configuration file is placed in the same location as the .conf file and is renamed with a timestamp. To use the backup rename to .conf.

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.

Tarball

-

 

 

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

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.
 

The recommended directories to backup are:

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.

Note:

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.

RPM

 

 

Instructions on how to complete a procedure

To update your PHP on RPM:

  1. Remove Zend Server by running: yum remove -y "zend-server*-php-5.*" && yum remove -y "*zend*"

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

  3. Update the repositories by running: yum clean all

  4. 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:

  1. Remove Zend Server by running: zypper -n remove "*zend*"

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

  3. Update the repositories by running: zypper refresh

  4. 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:

  1. Update the repository by running: aptitude update

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

 

 

Instructions on how to complete a procedure

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:

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.

 

 

Related Links

Related Links:

Choosing Which Distribution to Install

Ports and Services

Package Setup and Control Scripts

Log Rotation

Ports and Services

Installed Components

Upgrading a Zend Server Cluster