ProcessMaker Installation in Hosted Environment

From ProcessMaker

The following instructions are valid from release pmos-1.1-1705 on. Please make sure that you are installing the correct release.

Contents 1 Requirements 2 PHP Settings 3 Installation 4 Subdomain Creation 5 MySql Databases Creation 6 ProcessMaker Configuration 7 More information and licence 8 Credits

Requirements

Make sure that your Service Provider meets the following requirements:

• Apache 2.2.3 or greater with the following modules:
  • Deflate
  • Expires
  • Rewrite
  • Vhost_alias
• MySQL 4.1.20 or greater
• PHP 5.1.6 or greater (but not PHP 5.3.0 due to this bug)

PHP Settings

• Make sure that the parameters in PHP are set as follows:

  asp_tags = On
  short_open_tag = On
  file_uploads = On
  memory_limit = 80M    

ProccesMaker needs a minimum of 80MB in the parameter "memory_limit" of PHP.

• ProcessMaker requires the following dependencies: php-gd, php-mysql, php-xml, php-soap, php_mbstring.

Installation

• Download the latest ProcessMaker tarball from [http://sourceforge.net/projects/processmaker/]

• Extract the pmos-x.x-xtar.gz file under your /public_html/ directory

This will create a new directory "processmaker/" containing all ProcessMaker files and directories.

• Make sure that the following subdirectories are world writable.

  chmod 777 /home/your_account/public_html/processmaker/workflow/engine/config/
  chmod 777 /home/your_account/public_html/processmaker/workflow/engine/content/languages/
  chmod 777 /home/your_account/public_html/processmaker/workflow/engine/js/labels

In case you don't have access to the command line in your server, make these changes from your file manager.

• Create the following directories. Please make sure that these directories are not included in your /public_html/ directory:

   mkdir /home/your_account/processmaker
   mkdir /home/your_account/processmaker/shared
   mkdir /home/your_account/processmaker/compiled

In case you don't have access to the command line in your server, make these changes from your file manager.

Subdomain Creation

• Create a new subdomain: ProcessMaker. The document root of this subdomain should be defined as:

  /public_html/processmaker/workflow/public_html/

As shown in the following illustration:

MySql Databases Creation

• Create a new MySql User: pmuser

• Create the following three databases:

1. workflow for your workflow information

2. rbac for your user information

3. report for your report information

• Add the pmuser to the three created databases:

• Assign to pmuser - ALL priviliges - for the three created databases:

NOTE: In the illustrations the user_account is AJAXLAB

ProcessMaker Configuration

• Open your browser and load the created ProcessMaker Subdomain. You should see the test page.

If you don't see it, please check the installation steps.

• On the test page,

1. Enter your MySQL database account information, corresponding to the created pmuser

2. Enter your MySQL ProcessMaker database , corresponding to the three created databases: Workflow, Rbac, Report

3. Enter the Workflow Data Directory and the Compiled Templates Directory. (Please check out the last step of installation section)

4. Enter the credentials of ProcessMaker Admin user. By default it is defined as:

 	user:      admin
 	password:  admin

5. Test your connection and paths, by clicking the on the tab "Test" option upper right-hand corner.

6. After that, click on the tab "Install" (in the upper right-hand corner)

7. After few seconds you will get the confirmation of your installation. If it was successful, click on the button "Finish installation" and enjoy ProccessMaker. Otherwise, please visit our forums (http://forum.processmaker.com/) to get support.

8. To login to ProcessMaker use the credentials defined in step 4 of this section. By default they are:

 	user:      admin
 	password:  admin
 	workspace: workflow

NOTE: In the illustrations the user_account is AJAXLAB

More information and licence

ProcessMaker - Automate your Processes Copyright (C) 2002 - 2008 Colosa Inc.

Licensed under the terms of the GNU Affero General Public License version 3: http://www.affero.org/oagpl.html

For further information visit: http://www.processmaker.com/

Credits

- ProcessMaker - Automate your Processes Copyright (C) 2002-2008 Colosa http://www.processmaker.com/