Please rate how useful you found this document: 
No votes yet

Overview

According to the Upgrade Road Map, this document explains the standard procedure to upgrade to ProcessMaker versions 3.2.2 or 3.2.3 from the following ProcessMaker versions:

  • 2.5.x
  • 2.8
  • 2.9
  • 3.0.x
  • 3.1.x
  • 3.2

Refer to the following sections to upgrade from the above ProcessMaker versions to ProcessMaker 3.2.2 or 3.2.3:

Before Upgrading to ProcessMaker 3.2.2 - 3.2.3

Before upgrading to ProcessMaker 3.2.2 or 3.2.3 in both platforms Linux and Windows, run the following query in the ProcessMaker database that will be upgraded:

UPDATE CONTENT SET CON_VALUE = 'none' WHERE CON_CATEGORY = 'WEE_DESCRIPTION' AND CON_LANG = 'en' AND CON_VALUE = '';
UPDATE CONTENT
SET CON_VALUE = 'untitled'
WHERE CON_CATEGORY IN ('WEE_DESCRIPTION', 'WEE_TITLE', 'DYN_TITLE', 'OUT_DOC_TITLE', 'REP_TAB_TITLE', 'TRI_TITLE') AND CON_VALUE = '' AND CON_LANG = 'en';

Steps to Upgrade to ProcessMaker 3.2.2 - 3.2.3

Steps to Upgrade to ProcessMaker 3.2.2 or 3.2.3 based on these supported operating systems:

Linux

Follow these steps to upgrade from the allowed ProcessMaker versions to ProcessMaker 3.2.2 or 3.2.3 in Linux platforms, which involves the Apache and NGINX web servers:

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

    su or: sudo su -
  2. Copy the processmaker-3.2.x.tar.gz file to the /opt directory:

    cp processmaker-3.2.x.tar.gz /opt/
  3. Overwrite any existing files in the /opt directory:

    cd /opt tar -xzvf processmaker-3.2.x.tar.gz
  4. Configure the permissions for the processmaker directory:

    chmod -R 770 processmaker/
  5. Give permission to access the following files in the /processmaker directory:

    cd processmaker chmod -R 775 bootstrap bootstrap/cache config framework cd thirdparty/html2ps_pdf/ chmod -R 775 cache/ out/ temp/
  6. Depending on the supported stacks, set the Apache or NGINX user as the owner of the files within the processmaker directory:

    chown -R apache:apache processmaker

    or nginx:

    chown -R nginx:nginx processmaker
  7. Upgrade ProcessMaker files, the ProcessMaker database, and the translation files as described at ProcessMaker Command:

    ./processmaker upgrade [workspace]

    Note: If you are upgrading from ProcessMaker Community edition 2.x or later to ProcessMaker Enterprise edition 3.2.2 or 3.2.3, perform the following command to migrate your cases from the Community edition to the upgraded Enterprise edition: ./processmaker migrate-new-cases-lists If you want to check the database schema and upgrade it if necessary you can use: ./processmaker database-upgrade [workspace]

  8. Flush the cache:

    ./processmaker flush-cache

Windows

Follow these steps to upgrade from the allowed ProcessMaker versions to ProcessMaker 3.2.2 or 3.2.3 in Windows platforms:

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

  2. Use a program like WinRAR or 7-Zip to extract processmaker-3.2.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 [workspace]

    Note: If you are upgrading from ProcessMaker Community edition 2.x or later to ProcessMaker Enterprise edition 3.2.2 or 3.2.3, perform the following command to migrate your cases from the Community edition to the upgraded Enterprise edition: php -f processmaker migrate-new-cases-lists If you want to check the database schema and upgrade it if necessary you can use: php -f processmaker database-upgrade [workspace]

  5. Flush the cache:

    php -f processmaker flush-cache