Legacy
...
How to upgrade Passwork 4→5 ve...
Upgrade manual for Passwork 4→...

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

10min

This manual describes how to upgrade Passwork from version 4 to version 5 for CentOS 8. 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

💡 This installation guide is not suitable for CentOS Linux 8, which expired on December 31, 2021.

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.

Resetting PHP versions and selecting a repository

Shell


Installing PHP and optional extensions

Shell


2. Installing the PHP Mongo driver for PHP 8.0

Shell


3. Installing Phalcon PHP extension for PHP 8.0

Shell


4. Updating Passwork source codes

Clone the repository using your username and password.

Shell

Shell


💡 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


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


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.