Update for Passwork 4→5 (Windows Server)

this manual describes how to upgrade passwork from version 4 to version 5 for windows server passwork version 5 runs on php 8 0, so in addition to updating the source code you will also need to install a new version of php 💡 we recommend that you make a backup of your system before you start the upgrade table of contents 1\ installing php 8 0 💡 php 8 0 specifically needs to be installed php 8 1 is not yet supported download php 8 0 from the official site — https //windows php net/downloads/releases/php 8 0 26 nts win32 vs16 x64 zip https //windows php net/downloads/releases/php 8 0 26 nts win32 vs16 x64 zip check archive properties remove the "locked" property if the archive received it when downloading unzip archive move the folder with the unpacked archive (in this example, the path — c \program files\php8 ) install vc++ visual c++ redistributable packages for visual studio /call https //download visualstudio microsoft com/download/pr/b929b7fe 5c89 4553 9abe 6324631dcc3a/296f96cd102250636bcd23ab6e6cf70935337b1bbb3507fe8521d8d9cfaa932f/vc redist x64 exe https //download visualstudio microsoft com/download/pr/b929b7fe 5c89 4553 9abe 6324631dcc3a/296f96cd102250636bcd23ab6e6cf70935337b1bbb3507fe8521d8d9cfaa932f/vc redist x64 exe 6\ retart the system 2\ adding extensions phalcon and mongodb for php 8 0 download archives with extension files https //github com/phalcon/cphalcon/releases/download/v5 1 4/phalcon php8 0 nts windows2019 vs16 x64 zip https //windows php net/downloads/pecl/releases/mongodb/1 13 0/php mongodb 1 13 0 8 0 nts vs16 x64 zip check archive properties remove the "locked" property if the archive received it when downloading place the extension files in the directory — c \program files\php8\ext 3\ selection of php 8 0 as the primary version of php for the passwork site 1 download and install php manager for iis ⬇️ https //github com/phpmanager/phpmanager/releases/download/v2 7/phpmanagerforiis x64 msi 2 open "iis manager" and go to "php manager" 3 register php version by specifying the path to php cgi exe — "register new php version" 4 configure the path for the logs file "configure error reporting" 5\ add the previously unpacked extensions with "add an extension", and enable the necessary and disable the unnecessary ones with "enable or disable an extension" the resulting list of extensions 4\ edit php ini copy php ini from version php 7, which was installed earlier and change the following lines change to error log=c \windows\temp\php80x64 errors log change to extension dir=c \program files\php8\ext comment out extension=php gd2 dll → ;extension=php gd2 dll comment out extension=php xmlrpc dll → ;extension=php xmlrpc dll comment out extension=php wincache dll → ;extension=php wincache dll add extension=php psr dll 5\ download passwork 5 download passwork 5 from your customer portal ( https //portal passwork pro https //portal passwork pro ) rename folder c \inetpub\wwwroot\ → c \inetpub\wwwroot old\ recreate a new folder c \inetpub\wwwroot\ extract the archive and copy the contents to a directory c \inetpub\wwwroot\\ 6\ set correct permissions 1 open iis manager, then right click on website and click “edit permissions” 2 press “edit”, then “add” and search for “iusr” object select “iusr” and grant “write” permissions then click “ok” twice 7\ copy config ini copy this file c \inetpub\wwwroot old\app\config\config ini → c \inetpub\wwwroot\app\config\config ini 8\ check configuration if you are using https, check if the following setting has been made after updating the php version, enable the session cookie secure parameter in c \program files\php8\php ini session cookie secure = on 9\ import url rewrite rules double click on “url rewrite” icon click “import rules” and select htaccess file from website root directory, then click “open” and “import” buttons click “apply” button once imported 10\ configure background tasks background tasks are jobs that run on the scheduler in the background for example, ldap synchronization, loading favicons, and other tasks that require a lot of time, constant execution, or resource allocation background tasks docid\ pj1ekrpvv2ndjc8hbpacp 11\ possible issues and solutions 1 sometimes, after changing the php version in iis, the settings for index php disappear check if there is an entry for index php in “default document”, if this entry is missing, add it 2 we also recommend that you check the php log with the path to which you previously specified in php ini if you see the session save path \[c \windows\temp] is not writable error, assign write permissions for this folder to iusr or network service users 3 make sure that the php psr dll, php mongodb dll, php phalcon dll extensions were available in "php manager" → "php extensions"