Upgrading Zend Server on RPM (SLES and OpenSUSE)

To upgrade Zend Server 5.6 or 6.x:

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.4 or 5.5), run the following command:

./install_zs.sh <PHP Version>

6. Launch Zend Server - This procedure is required only after upgrading the first server in the cluster:
   1. In your Web browser, enter the following URL:

   http://<server IP>:10081/ZendServer

   The License Agreement dialog of the Launch Zend Server wizard is displayed.

   2. Read and accept the terms in the agreement, and click Next.
      The User Passwords dialog is displayed.
   3. Configure the 'admin' and 'developer' (optional) passwords for accessing the Zend Server UI, and click Next.
      The Summary dialog is displayed..
   4. Click Submit.
      Zend Server is launched.

7. Return the server to the Load Balancer.

To upgrade Zend Server 7.x or PHP version:

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.4 or 5.5), run the following command:

./install_zs.sh <PHP Version>

6. Return the server to the Load Balancer.

Note:

The Zend Server 5.6 databases are stored in a separate directory - 'db-5.6.0'. Zend Server 5.6 .ini files are stored in 'etc-5.6.0'.

To upgrade a Zend Server 5.6 cluster:

1. To avoid conflict between jobs created by upgraded servers and those created by pre-upgrade servers, suspend existing recurring jobs in the cluster:
   1. In the Zend Server 5.6 Cluster Manager UI, go to Rule Management | Recurring Jobs.
   2. Select the recurring jobs, and click Suspend.

   Note:

   Jobs created by the Zend Server 5.6 cluster servers after the first server has completed the upgrade process, may not be migrated to the new Zend Server 7.x schema.

2. Create a new database in the same server holding the Zend Server 5.6 Cluster Manager schema.

   Important!

   Use your existing database server for this purpose as long as it is a compatible MySQL version and accessible from all the servers.

3. Create a schema named 'ZendServer' to be used by Zend Server 7.0 to store data:

CREATE DATABASE IF NOT EXISTS ZendServer;

4. Give the new database full permissions to pre-existing user 'zend' (replace <password> in the following SQL commands with the password specified in your 'monitor_node.ini' file):
   

GRANT CREATE,DROP,ALTER,DELETE,INDEX,INSERT,SELECT,UPDATE,CREATE TEMPORARY TABLES,LOCK TABLES,CREATE VIEW,SHOW VIEW,ALTER ROUTINE,CREATE ROUTINE,EXECUTE ON `ZendServer`.* TO 'zend'@'%' IDENTIFIED BY '<password>';
FLUSH PRIVILEGES;

5. Upgrade each server in the cluster, as follows:
   1. Remove the server from the Load Balancer. This should be done following the recommended procedure depending on your load balancing configuration.
   2. Disable the server from the Zend Server 5.6 Cluster Manager UI to ensure that your sessions are transferred to a different server:
      1. In the Zend Server 5.6 Cluster Manager UI, go to Cluster Setup | Servers.
      2. Go to the server you would like to disable, and click Disable.
         Click OK when a notification asking to confirm your decision is displayed.

      3. The server’s status should indicate that it is disabling. This process may take between a few seconds and a minute, depending on the number and size of sessions and on your network throughput.

   3. 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/
      4. Depending on the PHP version you want to use (5.4 or 5.5), run the following command:

      ./install_zs.sh <PHP Version>
      

   4. Launch Zend Server - This procedure is required only after upgrading the first server in the cluster:
      1. In your Web browser, enter the following URL:

      http://<server IP>:10081/ZendServer

      The License Agreement dialog of the Launch Zend Server wizard is displayed.

      2. Read and accept the terms in the agreement, and click Next.
         The User Passwords dialog is displayed.
      3. Configure the 'admin' and 'developer' (optional) passwords for accessing the Zend Server UI, and click Next.
         The Summary dialog is displayed..
      4. Click Submit.
         Zend Server is launched.
      5. Resume the job rules that were suspended at the beginning of the upgrade process:
         1. In the UI, go to the Applications | Job Rules page.
         2. Select the recurring jobs from the Job Rules list, and click . This procedure is required only once, and is not necessary for servers subsequently upgraded.
   5. Return the server to the Load Balancer.

Note:

The disabling process performs a Graceful Shutdown, which will increase the load on active servers during this process since some of the server's sessions are moved to other servers.

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/
   4. Depending on the PHP version you want to use (5.4 or 5.5), run the following command:

   ./install_zs.sh <PHP Version>
   

3. Return the server to the Load Balancer.

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/
   4. Depending on the PHP version you want to use (5.4), run the following command:

   ./install_zs.sh <PHP Version>
   

3. Return the server to the Load Balancer.

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 according to your OS:

• Windows: C:\Program Files\Zend\ZendServer\etc-x.x.x and C:\Program Files\Zend\ZendServer\data\db-x.x.x

• Windows 64 bit C:\Program Files (x86)\Zend\ZendServer\etc-x.x.x and C:\Program Files (x86)\Zend\ZendServer\data\db-x.x.x

• DEB/RPM: /usr/local/zend/etc-x.x.x and /usr/local/zend/db-x.x.x

• Mac: /usr/local/zend/etc-x.x.x and /usr/local/zend/db-x.x.x

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

If this fails, please contact Zend Support.

To upgrade to Zend Server with the same PHP version, run:

# zypper update '*zend*'

To upgrade to Zend Server with a different PHP version, run:

zypper remove "zend-server*-php-5.*" && zypper remove "deployment-daemon-zend-server" && zypper remove "*zend*"

zypper install zend-server-php-<PHP version>

The upgrade process locates any components of the product version that are newer and downloads them.

To upgrade Zend Server 7.x or switch your PHP (e.g, from 5.3.1 to 5.3.2) on SLES:

1. Set up the Zend Server repository. For instructions, see manually installing Zend Server.
2. Update the repository by running:

zypper refresh

3. Upgrade Zend Server by running:

zypper install zend-server-php-<PHP version>

To upgrade Zend Server 7.x or upgrade your PHP (e.g, from 5.4 to 5.5) on SLES:

1. Remove Zend Server by running:

zypper remove "zend-server*-php-5.*" && zypper remove "deployment-daemon-zend-server" && zypper remove "*zend*"

2. Set up the Zend Server repository. For instructions, see the steps for manually installing Zend Server.

3. Update the repository by running:

zypper refresh

4. Upgrade Zend Server by running:

zypper install zend-server-php-<PHP version>