Installing Zend Server on DEB (Debian and Ubuntu)

This topic describes the procedures for installing Zend Server on a DEB (Debian and Ubuntu) based operating system.

Requirements for installation:

  • Administration login to the server (root / sudo)
  • Internet access to download resources for installation (e.g., downloads.zend.com, your distro repository for dependencies, nginx.org if you use NginX etc.).
  • At least 1GB of disk space on the mount point which will be used for /usr/local/zend (about 500MB is used for standard installation)
  • The following tools are needed to run the Zend Server installer: gnupg (or gnupg2), tar, gzip, wget. Those tools can be installed on Debian or Ubuntu installations using the following command:

    apt install tar gzip wget gnupg

Note

You need the GNUPG (gnupg, gnupg1 or gnupg2) tool for verifying signatures of Zend packages. You can check if you have GNUPG by running 'gpg --version'. If you do not have GNUPG installed, run 'apt install gnupg' to install the preferred OS package. Once you have GNUPG installed, you can run Zend Server installer.

Installation Procedure:

Instructions on how to complete a procedure

  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. If you would like to see the available parameters for the installation, run install_zs.sh with "help" parameter:

    ./install_zs.sh --help

    To automatically setup Zend Server on Apache (Module), run:

    ./install_zs.sh --automatic

    To automatically setup Zend Server on Apache-FPM, run:

    ./install_zs.sh apache-fpm --automatic

    To automatically setup Zend Server on NginX, run:

    ./install_zs.sh nginx --automatic

    To the above web server options (Apache Module, Apache FPM or NginX), you can add optional packages if needed:

    java: To install Zend PHP Java Bridge packages

    debug: To install debug binaries for troubleshooting issues with the product support team

After the installation is complete, a success message will appear, with a notice that the servers have started up.

Automatic or Manual installation?

Automatic installation using the Repository Installer script is the recommended and simplest method to install Zend Server, as it ensures a correct and healthier installation or upgrade process. The script ensures that the correct repositories are set, verifies system requirements and issues the correct package management commands to set Zend Server up properly.

This section describes how to automatically install Zend Server with Apache or NginX Web server.

Note about installed PHP versions

Zend Server 2021.2 installs 4 versions of PHP, all available with a simple PHP switch, after installation.
By default, PHP 7.4 will be selected and enabled as Zend Server PHP runtime.
If you are upgrading from a former Zend Server installation, with PHP 7.1, 7.2, or 7.3 already installed on Zend Server (check by running "/usr/local/zend/bin/php -v"), the installer will enable and use the PHP version which is already installed. PHP 7.4 is still available in the case of upgrade, to be enabled by a simple switch.

Installation Procedure:

Instructions on how to complete a procedure

  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. If you would like to see the available parameters for the installation, run install_zs.sh with "help" parameter:

    ./install_zs.sh --help

    To automatically setup Zend Server on Apache (Module), run:

    ./install_zs.sh --automatic

    To automatically setup Zend Server on Apache-FPM, run:

    ./install_zs.sh apache-fpm --automatic

    To automatically setup Zend Server on NginX, run:

    ./install_zs.sh nginx --automatic

    To the above web server options (Apache Module, Apache FPM or NginX), you can add optional packages if needed:

    java: To install Zend PHP Java Bridge packages

    debug: To install debug binaries for troubleshooting issues with the product support team

After the installation is complete, a success message will appear, with a notice that the servers have started up.

This section describes how to manually install Zend Server with Apache or NginX Web server.

First, we need to create the repository for Zend Server packages.

This method uses "aptitude" and "apt-get" to handle the installation. Alternatively, you may choose any other tool that supports the DEB packaging format (i.e., Synaptic, Kpackage, etc).

PHP Note:

The Zend Server installation package will replace your distribution's PHP - this may create conflicts between DEB packages. If you cannot install one of Zend Server's components, it is recommended that you remove your distribution's PHP packages and try to install again.

Instructions on how to complete a procedure

To setup the environment:

  1. Define a repository by opening the following file: /etc/apt/sources.list , and adding the line:

deb http://repos.zend.com/zend-server/2021.2/[REPO_PATH] server non-free

For Ubuntu 20.04 use:

deb http://repos.zend.com/zend-server/2021.2/deb_ubuntu20 server non-free

For Ubuntu 18.04 use:

deb http://repos.zend.com/zend-server/2021.2/deb_ssl1.1 server non-free

For Debian 10.x use:

deb http://repos.zend.com/zend-server/2021.2/deb_apache2.4 server non-free

For Debian 9.x use:

deb http://repos.zend.com/zend-server/2021.2/deb_debian9 server non-free

For POWER8, use:

deb http://repos.zend.com/zend-server/2021.2/deb_power8 server non-free

  1. Add Zend's repository public key by running:

# wget http://repos.zend.com/zend.key -O- |apt-key add -

  1. If you are using sudo to run each command the next command requires using sudo following the '|' (pipe) symbol as follows:

# wget http://repos.zend.com/zend.key -O- | sudo apt-key add -

  1. To synchronize with Zend's repository run:

# apt-get update

Or

# aptitude update

 

 

Instructions on how to complete a procedure

To install:

  1. Once the environment is set, run the appropriate "apt-get" or "aptitude" command according to the web server you require:

For Apache: # apt-get install zend-server

For Apache-FPM: # apt-get install zend-server-apache-fpm

For NginX: # apt-get install zend-server-nginx

  1. You can add optional packages (only if needed) to the "apt-get install" or "aptitude install" commands:
    add zend-server-dbg: To install debug binaries for troubleshooting issues with the product support team
    add php-java-bridge-zend-server: To install Zend PHP Java Bridge packages
  2. To clean your packages cache and ensure retrieval of updates from the web, run:

apt-get clean

Or

aptitude clean

Launching (initializing) Zend Server:

To launch and start using Zend Server, open your browser at: https://<Server_IP>:10082/ZendServer (secure), or http://<Server_IP>:10081/ZendServer.

Licensing Zend Server:

After installing Zend Server 2021.2, you will automatically be using a 30-day Enterprise edition trial license. To continue working with Zend Server after this time period, you need to register your "Launched" server instance with a valid license (see Zend Server Editions), or join an existing Zend Server cluster with available licensing units. To get a new license for any edition or cluster, please contact Zend.