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

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.

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

+

 

 

DEB

+

Handles all configuration upgrades.

 

Tarball

-

 

 

Mac OS X

-

 

 

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.

 

Zend Server CE

Installation Type

Community Edition

Configuration Information

Comments

RPM

+

 

 

DEB

+

Handles all configuration upgrades

 

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.

 

Upgrading from Zend Server CE to Zend Server

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:

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