Z-Ray Notes

  • Z-Ray might be blocked by using the browser content security policy (e.g PHPMyADmin on firefox)

  • Specific configuration is required in order for Z-Ray to collect and display data on HTTPS requests in Windows with IIS and IBMi (needs specific configuration)

  • Load balancer configuration is required for Z-Ray to be displayed :

    • An accessible ZS GUI address must be set

    • The Load Balancer IP address must be included in the Z-Ray allowed IPs list (token)

  • Z-Ray is not to be included or enabled in performance tests context (e.g in AB testing)

  • Z-Ray currently supports the following database drivers: PDO, MySQL/i, OCI8 and DB2


Zend Server 7.0 supports both new installations and upgrades from Zend Server 5.6 and 6.x versions. Upgrading from a version prior to 5.6 is not supported. If you would like to upgrade a Zend Server that's older than 5.6, you should first upgrade to 5.6, and only then upgrade to 7.0.
On Linux, starting with version 6, the recommended way to install a new, or upgrade an existing, Zend Server installation is using the supplied script. 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. While it’s still possible to install Zend Server by manually setting up repositories, we advise always using the installation script.
For detailed installation instructions for all supported operating systems, please refer to the Zend Server Installation Guide​


Limitations and Known Issues

The following issues are known at the time of the 7.0 release:



  • Zend Server cannot communicate with MySQL databases that are configured with old_passwords=1 (ZSRV-8104)

  • Misconfiguring LDAP authentication can result in the user being locked out of their Zend Server console. If this occurs, reset your Zend Server password. For more information, see the Zend Server User Guide
  • Session Clustering does not support value=6 for the php.ini directive session.hash_bits_per_character (the Zend Server UI does not currently warn about this issue).
  • Nginx Deployment: deploying to the root of the default virtual host does not work out-of-the-box and causes configuration problems (ZSRV-10098). Workaround: comment out the location / entry in /etc/nginx/conf.d/default.conf 
             #location / {
             # include /etc/nginx/fastcgi.conf;
             # root /usr/share/nginx/html;
             # index index.php index.html index.htm;
             # }

Upgrade & Installation Related

  • ZS 6.x to 7.0 Windows Cluster Upgrade with PHP change: Deployment Daemon may stop functioning on some of the nodes. Workaround: manually restart the Deployment daemon from GUI (ZSRV-12052)

  • Upgrade of ZS old -> ZS 7.0 with PHP change on Windows: reset configuration may not work. Use export/import configuration instead (ZSRV-12048)
  • Upgrade of ZS old -> ZS 7.0 with PHP change Windows Cluster: Some UI operations may hang on server polling. Workaround: clear the ZSD_TASKS table in the Zend DB (ZSRV-12048)
  • RPM Double Upgrade (e.g. ZS 5.6.0 PHP 5.3 -> ZS 6.0.1 PHP 5.4 -> ZS 7.0 PHP 5.4 ) -  PHP directive values are not kept (ZSRV-12019)
  • ZS 5.6 -> ZS 7.0 Windows Upgrade: some extensions should be built-in but they're enabled instead (ZSRV-11916)
  • ZS 5.6 -> ZS 7.0 Upgrade: PDO_OCI support is dropped. May show errors on the servers page about missing PDO extension (ZSRV-11873)
  • When upgrading PHP major versions, configuration settings (php.ini) are not retained 
  • Upgrading to ZS 7.0 with PHP upgrade, in Windows : license is reverted to the 30 day trial license (ZSRV-10885)
  • When upgrading from Zend Server 5.6, extension status is not retained (which extensions should be loaded and which ones should not be loaded). (ZSRV-9255)
  • Due to changes in the Monitoring rule engine, Monitor Rules & Code Tracing settings are not kept when upgrading from Zend Server 5.6 (ZSRV-9140)
  • Upgrading to ZS 7.0 including PHP upgrade in DEB : upgrade fails as of php-5.x-java-bridge-zend-server unmet dependencies - workaround: remove java-bridge , then upgrade (ZSRV-10436)
  • After upgrade to 7.0, cannot import Exported Configuration from 6.0.1 or earlier -  (ZSRV-10773)
  • IBMi - when upgrading from Zend Server 6 (php 5.3) to zs 7.0 (php 5.5) there is an error about mismatched directive (ZSRV-13137)


  • For more information about upgrade and installation issues, please refer to the online documentation.