Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Issue

This knowledge base article addresses two issues we have found with the fastcgi.conf  file in Zend Server 2019.0.5

1) Starting Beginning with Zend Server version 2019.0.0, multiple versions of PHP are available (PHP 7.1.x, PHP 7.2.x and PHP 7.3.x), and the active version can be changed whenever desired either through the User Interface (UI) or a menu option.  The location of the "active" php.ini file is incorrectly defined in the fastcgi.conf file, which prevents Zend Server from finding the correct location of the active version of php.ini when the version of PHP has been changed. 

...

2) The other issue you may encounter is that the value of the ENV var INSTALLATION_UID is left with a value of TIMESTAMP rather than the correct numeric value from the zce.rc file.  This will cause the IPC objects and shared memory files used by Zend Server to be incorrectly created with TIMESTAMP as part of the file name rather than the intended numeric value. 

Environment

Zend Server 2019.0.0 and higher - 2019.0.5, running on all supported versions of the IBM i OS.

Resolution

...

Info
iconfalse
Please note that this procedure does require Zend Server to be restarted and also Requires user QSECOFR to run the Reset of Zend Server at the end. 

...

Please ensure this is done at time when your website / applications can be down for a few minutes while Zend Server restarts.


Info
iconfalse

...

Please make a backup copy of the fastcgi.conf file first so that it can be reverted if neccessary.  Also, please make sure to use an editor such as Notepad++ so that you can ensure that no addition / unseen characters are added to the file by mistake


Modify the fastcgi.conf file at the following location 

Info
iconfalse
/www/zendphp7/conf

There will be on very long line with the configuration values,  locate Locate the variable "SetEnv="PHPRC/usr/local/zendphp7/etc/" and replace it with the following, which includes is the path to the "active" php.ini file.  Be careful not to add any additional spaces before or after the value that you copy in. 

Info
iconfalse
SetEnv="PHPRC=/usr/local/zendphp7/php/active/etc/"

Check to see if the value of the INSTALLATION_UID is 100313092679 or if it is TIMESTAMP

Note
iconfalse

If the value is 100313092679 or a similar numeric value, your installation does not have this issue and you can save the fastcgi.conf file and continue with the instructions

If the value of the INSTALLATION_UID is TIMESTAMP you will need to replace it with the correct value.

On that same very long line with the configuration values, locate the variable SetEnv="INSTALLATION_UID=TIMESTAMP" .  Be careful not to add any additional spaces before or after the value that you copy in. 


Info
iconfalse

Replace just the word TIMESTAMP with the value 100313092679         Be careful not to add any additional spaces when replacing the value, and make sure the " included at the end of the variable

The variable should like the example below.


Info
iconfalse

SetEnv="INSTALLATION_UID=100313092679"


Save the changes to the file


Note

User QSECOFR is Required to run the Reset Zend Server job.  Users with *SECOFR or *ALLOBJ authorities will not work

A Reset of Zend Server is needed to pickup the changes .  and rebuild the shared memory and other IPC objects used by Zend Server.  Log into a 5250 session as QSECOFR. 

Info
iconfalse
GO ZENDPHP7/ZSMAINT   and take option 41. Reset Zend Server environment

This will end Zend Server, rebuild the necessary objects and then restart Zend Server. 

...