Upgrade Standard Procedure to ProcessMaker 2.5.x

Overview

According to the Upgrade Road Map, this document explains the standard procedure to upgrade from ProcessMaker versions 2.0.3x or 2.0.4x to ProcessMaker versions 2.5.0x or 2.5.2x based on these supported operating systems:

• Linux
• Windows

Linux

Follow these steps to upgrade from ProcessMaker 2.0.x to ProcessMaker 2.5.x in Linux platforms:

1. In the terminal, log on as root or with the root privileges:

   su

   or:

   sudo su -

2. Copy the processmaker-2.5.x.tar.gz file to the /opt directory:

   cp processmaker-2.5.x.tar.gz /opt/

3. Overwrite any existing files in the /opt directory:

   cd /opt tar -xzvf processmaker-2.5.x.tar.gz

4. Configure the permissions for the processmaker directory:

   chmod -R 770 processmaker/

5. Set the Apache user as the owner of the files within the processmaker directory:

   chown -R apache:apache processmaker

   Note: The Apache user and group are named apache:apache in CentOS/Red Hat, www-data:www-data in Debian/Ubuntu and wwwrun:www in SUSE/OpenSUSE.

6. Go to the processmaker directory:

   cd processmaker

7. Upgrade ProcessMaker files, the ProcessMaker database, and the translation files as described at ProcessMaker Command:

   ./processmaker upgrade

8. Flush the cache:

   ./processmaker flush-cache

Windows

Follow these steps to upgrade from ProcessMaker 2.0.x to ProcessMaker 2.5.x in Windows platforms:

1. Copy the processmaker-2.5.x.tar.gz file to the C:\opt directory.

2. Use a program like WinRAR or 7-Zip to extract processmaker-2.5.x.tar.gz to the C:\opt directory.

3. In a terminal, go to the C:\opt\processmaker directory:

   cd C:\opt\processmaker

4. Upgrade ProcessMaker files, the ProcessMaker database, and the translation files as described at ProcessMaker Command:

   php -f processmaker upgrade

5. Flush the cache:

   php -f processmaker flush-cache