Upgrading Zend Server on DEB

The procedures on this page describe the upgrade procedures for a single Zend Server and a Zend Server cluster on a DEB operating system.
Please read the following restrictions carefully before proceeding.

Upgrade Restrictions

Upgrading Zend Server can only be performed when upgrading from Zend Server 6.x and older to Zend Server 8.x, or when upgrading between Zend Server 8.x versions.

Direct upgrades from Zend Server 5.6 or older can only be performed using a clean installation of Zend Server 8.x. If a clean installation is not possible, you will need to complete a two-step upgrade procedure. For more information, please contact the Zend Support Center.

For a list of limitations and known upgrade issues, see the Zend Server Release Notes.

Note:

When upgrading from a PHP version lower than PHP 5.5, the Optimizer component will be replaced by the OPcache (Optimizer Plus Cache) component.

Using the Zend Repository Installer

The upgrade procedures use the Linux Zend Repository Installer program which includes a simple shell script that automates the process of upgrading Zend Server through Zend's DEB repository.

The script upgrades your Zend Server and PHP versions, according to your current configurations and target version passed. The script will notify you when an upgrade cannot be performed. This occurs in the following scenarios:

  • When attempting to upgrade from Zend Server 5.x and below
  • When attempting to downgrade a PHP version
  • When attempting to upgrade a Web server (e.g., from Apache to nginx)

Zend Server Versions/PHP Versions Support

This table specifies the PHP versions supported by the latest versions of Zend Server.

Zend Server 6.0 Zend Server 6.1 Zend Server 6.2 Zend Server 6.3 Zend Server 7.0 Zend Server 8.x*
PHP 5.3 PHP 5.3 PHP 5.3 PHP 5.3 - -
PHP 5.4 PHP 5.4 PHP 5.4 PHP 5.4 PHP 5.4 -
      PHP 5.5 PHP 5.5 PHP 5.5
          PHP 5.6

* Current version

This section describes the procedure for upgrading a single Zend Server.

Example Scenarios:

  • Upgrading from Zend Server 7.x to 8.x
  • Upgrading between 8.x versions
  • Upgrading a PHP Version on Zend Server 8.x

Important!

When changing a major PHP version, some PHP and Zend Server configuration settings may be lost. For post-upgrade reference, we recommend making a backup of the 'etc' folder located in the Zend Server installation files (/usr/local/zend/etc-x.x.x).

 

 

Instructions on how to complete a procedure

To upgrade a single Zend Server:

  1. Remove the server from the Load Balancer.
  2. Download the package called "Zend Server (DEB/RPM Installer Script)" from zend.com - http://www.zend.com/en/products/server/downloads

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

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

  5. Depending on the PHP version you want to use (5.5 or 5.6), run the following command:

./install_zs.sh <PHP Version>

  1. Return the server to the Load Balancer.

 

This procedure explains how to upgrade a Zend Server cluster using the Zend Repository Installer program.

Example scenarios:

  • Upgrading a Zend Server cluster to a cluster with the same major PHP version (Example: Zend Server 7.0.0 with PHP 5.5 to Zend Server 8.0.0 with PHP 5.5).

  • Upgrading a Zend Server cluster to a cluster with a different major PHP version (Example: Zend Server 6.3.0 with PHP 5.4 to Zend Server 8.0.0 with PHP 5.5 OR Zend Server 7.0.0 with PHP 5.5 to Zend Server 8.0.0 with PHP 5.6).

Important!

When changing a major PHP version, some PHP and Zend Server configuration settings may be lost. For post-upgrade reference, we recommend making a backup of the 'etc' folder located in the Zend Server installation files (/usr/local/zend/etc-x.x.x).

Important!

This procedure does not require disabling the servers in the cluster before upgrading. Servers which are disabled during the upgrade process may fail to run properly when re-enabled.

 

 

Instructions on how to complete a procedure

To upgrade a Zend Server cluster, perform the following procedure for each server in the cluster:

  1. Remove the server from the Load Balancer. This should be done following the recommended procedure depending on your load balancing configuration.
  2. Upgrade the server:
    1. Download the package called "Zend Server (DEB/RPM Installer 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/
    1. Depending on the PHP version you want to use (5.5 or 5.6), run the following command:

    ./install_zs.sh <PHP Version>

  1. Return the server to the Load Balancer.

 

During the upgrade process, Zend Server backs up the 'etc' folder containing your server and PHP configurations, and the 'db' folder containing your database information. In case something goes wrong during the upgrade process, and you cannot access Zend Server, follow the steps below to restore your older version of Zend Server.

 

 

Instructions on how to complete a procedure

To restore Zend Server:

  1. Back up the 'etc-x.x.x' and 'db-x.x.x' folders located in your Zend Server installation directory:

/usr/local/zend/etc-x.x.x and /usr/local/zend/db-x.x.x

  1. Uninstall the new version of Zend Server.
  2. Re-install the old version of Zend Server.
  3. Copy the 'etc' and 'db' folders into your Zend Server installation files.

If this fails, please contact Zend Support.