ProcessMaker Generic Installation

From ProcessMaker

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)
Mozilla Firefox (recommended) or Internet Explorer 7 or greater

PHP Settings

ProcessMaker needs a minimum of 80MB RAM to run. Go to PHP's configuration file php.ini and make sure that the following parameters in PHP are set as follows:

file_uploads = On
memory_limit = 80M

If using ProcessMaker version 1.2-2552 or previous, turn on ASP tags and short tags:

asp_tags = On
short_open_tag = On

If using a version of ProcessMaker before 1.0-1286, turn off magic quotes:

magic_quotes_gpc = Off

Make sure that the following modules are loaded in PHP: mbstring, gd, soap, curl, ldap, xml, mysql

The modules can be verified by issuing the following command from the command line in Linux:

php -m

or with the function phpinfo() in a web page.

After changing the PHP configuration, restart the Apache service.

Installation

In order to begin, it is necessary to install the following ProcessMaker dependencies: php-gd, php-mysql, php-xml, php-soap, php_mbstring.

Download the latest ProcessMaker tarball from http://sourceforge.net/projects/processmaker/files

The files are in .tar.gz format and can be extracted using most compression tools, like the command tar in Linux or the Winrar Programm in Windows. Due to security reasons, it is highly recommended to install ProcessMaker under the /opt/ directory. Thereby extract the pmos-x.x-xtar.gz file under the directory /opt/

 Linux/UNIX:
  tar -xvzf pmos-x.x-x.tar.gz /opt/

 MS WINDOWS:
  Use Winrar or 7-Zip to extract the file pmos-x.x-x.tar.gz in c:\opt\

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

To use the development version of ProcessMaker (which isn't recommended unless it contains some needed feature), download the source code from the ProcessMaker Subversion repository. In Linux/UNIX:

svn co svn://source.colosa.net/newgulliver/trunk

In Windows, use TortoiseSVN to download the source code from svn://source.colosa.net/newgulliver/trunk

Make sure that the following subdirectories are world writable

 LINUX
  cd /opt/processmaker
  mkdir compiled shared
  chmod 777 compiled shared
  chmod 777 /opt/processmaker/workflow/engine/config/
  chmod 777 /opt/processmaker/workflow/engine/content/languages/
  chmod 777 /opt/processmaker/workflow/engine/js/labels/
  chmod 777 /opt/processmaker/workflow/engine/plugins/
  chmod 777 /opt/processmaker/workflow/engine/xmlform/

  WINDOWS
  Right click on the following folders, choose option: "Properties", on the window "Properties" uncheck the option "Readonly"
   C:\opt\processmaker\workflow\engine\config\
   C:\opt\processmaker\workflow\engine\content\languages\
   C:\opt\processmaker\workflow\engine\js\labels\
   C:\opt\processmaker\workflow\engine\js\plugins\
   C:\opt\processmaker\workflow\engine\js\ xmlform\

Apache Configuration

Define a Virtual Host in Apache for ProcessMaker. To do that, create a new file pmos.conf with the following definition:

  # Please change the ip address with your server ip address and
  # the ServerName with you own subdomains.
  NameVirtualHost your_ip_address
  #processmaker virtual host
  <VirtualHost your_ip_address >
    ServerName "your_processmaker_domain"
    DocumentRoot your_processmaker_directory
    DirectoryIndex index.html index.php
    <Directory  "your_processmaker_directory">
       AddDefaultCharset UTF-8
       AllowOverRide none
       Options FollowSymlinks
       Order allow,deny
       Allow from all
       RewriteEngine on
       RewriteRule ^.*/(.*)$ sysGeneric.php [NC,L]
  #    ExpiresActive On
  #    ExpiresDefault "access plus 1 day"
  #    ExpiresByType image/gif "access plus 1 day"
  #    ExpiresByType image/png "access plus 1 day"
  #    ExpiresByType image/jpg "access plus 1 day"
  #    ExpiresByType text/css "access plus 1 day"
  #    ExpiresByType text/javascript "access plus 1 day"
  #    AddOutputFilterByType DEFLATE text/html
    </Directory>
  </VirtualHost>

WHERE:
- your_ip_address IP Adresses of the Server/Computer where ProcessMaker is installed.
- your_processmaker_domain Domain for ProcessMaker defined in your DNS or your hosts file. If you don't have a domain, you should put instead "your_processmaker_domain" the value of "your_ip_adress" in the Virtual Host Definition presented before.
- your_processmaker_directory corresponds to the /public_html directory of ProcessMaker.

  LINUX
  /opt/processmaker/workflow/public_html
  WINDOWS
  C:\opt\processmaker\workflow\public_html

Save the pmos.conf file in the following directory.

  LINUX
  The virtual server defined in pmos.conf will be dynamically loaded in Apache from this directory: 
     /etc/httpd/conf.d/pmos.conf

  WINDOWS
     C:\wamp\bin\apache\apache2.2.8\conf\extra\pmos.conf
  Please add the following line in your httpd.conf file, so that the 
  ProcessMaker Virtual Configuration can proceed: 
     Include "C:\wamp\bin\apache\apache2.2.8\conf\extra\pmos.conf"

Note: It is also possible to define the virtual host for ProcessMaker directly in the htttp.conf file. That can be done by adding the above exposed virtual server definition.

Note: If Apache is using the default port 80, then configure Skype and other programs to not use port 80. You can check whether a program is currently listening on port 80 with netstat -anb in Windows or netstat -tanp in Linux/UNIX.

To configure Skype to stop listening on port 80, go to Tools > Options. Under the Advanced section of the "Options" dialog box, select the Connection tab. Deselect the option Use port 80 and 443 as alternatives for incoming connections.

ProcessMaker Configuration

Open your browser and load the ProcessMaker site (in our virtual server example this means http://your-processmaker-server). You should see the test page.

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

On the test page,
- Enter your MySQL database account information, which should have privileges to create databases and users.
- Test your connection and paths, by clicking the Test option upper right-hand corner.
After that, click on the tab "Install" (in the upper right-hand corner)
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.
To login to ProcessMaker use these credentials:

 	user:      admin
 	password:  admin
 	workspace: workflow

More information and licence

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/

ProcessMaker Generic Installation

From ProcessMaker

Contents

Requirements

PHP Settings

Installation

Apache Configuration

ProcessMaker Configuration

More information and licence

Credits

Views

Personal tools

Navigation

Search

Toolbox