Upgrade manual for Passwork 4→5 (CentOS 7)

9min

This manual describes how to upgrade Passwork from version 4 to version 5 for CentOS 7. 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. Updating PHP to PHP 8.0
💡 PHP 8.0 specifically needs to be installed. 
PHP 8.1 is not yet supported.
Shell
yum-config-manager --disable remi-php73
yum-config-manager --enable remi-php80
yum update
yum-config-manager --disable remi-php73
yum-config-manager --enable remi-php80
yum update
﻿
2. Installing the PHP Mongo driver for PHP 8.0
Shell
pecl install -f mongodb
echo "extension=mongodb.so" | tee /etc/php.d/20-mongodb.ini
systemctl restart httpd
pecl install -f mongodb
echo "extension=mongodb.so" | tee /etc/php.d/20-mongodb.ini
systemctl restart httpd
﻿
3. Installing Phalcon PHP extension for PHP 8.0
Shell
yum -y install php-mysql libtool pcre-devel php-psr php-curl
git clone -b v5.0.0beta3 --depth=1 "https://github.com/phalcon/cphalcon.git"
cd cphalcon/build
./install
echo "extension=phalcon.so" | tee /etc/php.d/50-phalcon.ini
systemctl restart httpd
yum -y install php-mysql libtool pcre-devel php-psr php-curl
git clone -b v5.0.0beta3 --depth=1 "https://github.com/phalcon/cphalcon.git"
cd cphalcon/build
./install
echo "extension=phalcon.so" | tee /etc/php.d/50-phalcon.ini
systemctl restart httpd
﻿
4. Updating Passwork source codes
Clone the repository using your username and password.
Shell
cd /var/www
git config --global --add safe.directory /var/www
git fetch
cd /var/www
git config --global --add safe.directory /var/www
git fetch
﻿
Shell
git reset --hard origin/v5
git checkout v5
git reset --hard origin/v5
git checkout v5
﻿
💡 The system will ask for a login and password to the repository, which you can find in your Passwork customer portal. If you don't have access to the customer portal, contact us.
Set permissions for folders and files.
Shell
find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R apache:apache /var/www/
systemctl restart httpd
find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R apache:apache /var/www/
systemctl restart httpd
﻿
5. 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 /etc/php.ini:
Shell
session.cookie_secure = On
session.cookie_secure = On
﻿
6. 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.
﻿Learn more about the background tasks and how to configure it﻿﻿

Updated 16 Aug 2024

Did this page help you?

Upgrade manual for Passwork 4→5 (CentOS 8 Stream)

Upgrade manual for Passwork 4→5 (Docker)