If the usual procedure to register a license in Zend Server fails, the instructions below present a method of applying the license manually.


Before You Begin

Depending on whether Zend Server is used as a standalone server, or in a cluster, a different database is used.

As a standalone server, Zend Server uses a set of local SQLite databases (located in /usr/local/zend/var/db on Linux/OS X and in <ZS_INSTALL_DIR>\ZendServer\data\db on Windows). The queries in the below procedure need to be executed on zsd.db. On Linux, the 'sqlite3' command line tool can be used. On Windows, an SQLite editing tool such as SQLite Browser is required.

When in a cluster, the queries need to be executed on the backend MySQL database.


Linux and OS X


1. Stop Zend Server using the command '/usr/local/zend/bin/zendctl.sh stop'  (in case of cluster, do this on all nodes).

2. Open the following file in a text editor:

Zend Server 2019: /usr/local/zend/etc/ZendGlobalDirectives.ini 

Zend Server 2018 or earlier: /usr/local/zend/etc/conf.d/ZendGlobalDirectives.ini 


3. Update the following lines:

zend.user_name=your Order Number
zend.serial_number=your License Key


4. Execute the following queries on the database:

Zend Server 2019:


UPDATE ZSD_ZEND_COMMON_DIRECTIVES SET DISK_VALUE='OrderNumber' WHERE NAME='zend.user_name';
UPDATE ZSD_ZEND_COMMON_DIRECTIVES SET DISK_VALUE='LicenseKey' WHERE NAME='zend.serial_number';

Zend Server 2018 or earlier:


UPDATE ZSD_DIRECTIVES SET DISK_VALUE='OrderNumber' WHERE NAME='zend.user_name';
UPDATE ZSD_DIRECTIVES SET DISK_VALUE='LicenseKey' WHERE NAME='zend.serial_number';


Note: in the above commands, replace 'OrderNumber' and 'LicenseKey' with the actual license details.


5. Start Zend Server using '/usr/local/zend/bin/zendctl.sh start'  (in case of cluster, do this on all nodes).


Windows


1. Stop Zend Server using Start | All Programs | Zend Server | Support Tool | Select "Stop" | Click "Next" | Click "Yes" (in case of cluster, do this on all nodes).

2. Update the license on the file system:

Zend Server 2019:

Open <ZS_INSTALL_DIR>\ZendServer\etc\ZendGlobalDirectives.ini in a file editor and update the following lines:

zend.user_name=your Order Number
zend.serial_number=your License Key

Zend Server 2018 or earlier:

Open <ZS_INSTALL_DIR>ZendServer\etc\php.ini in a file editor and update the following lines:

zend.user_name=your Order Number
zend.serial_number=your License Key


3. Execute the following queries on the database:

Zend Server 2019:


UPDATE ZSD_ZEND_COMMON_DIRECTIVES SET DISK_VALUE='OrderNumber' WHERE NAME='zend.user_name';
UPDATE ZSD_ZEND_COMMON_DIRECTIVES SET DISK_VALUE='LicenseKey' WHERE NAME='zend.serial_number';

Zend Server 2018 or earlier:


UPDATE ZSD_DIRECTIVES SET DISK_VALUE='OrderNumber' WHERE NAME='zend.user_name';
UPDATE ZSD_DIRECTIVES SET DISK_VALUE='LicenseKey' WHERE NAME='zend.serial_number';


Note: in the above commands, replace 'OrderNumber' and 'LicenseKey' with the actual license details.


4. Start Zend Server using Start | All Programs | Zend Server | Support Tool | Select "Start" | Click "Next" | Click "Yes" (in case of cluster, do this on all nodes).


  • No labels