manual de instalacion process maker en ubuntu (gutsy gibbon)

MANUAL DE INSTALACION
PROCESS MAKER
EN UBUNTU (GUTSY GIBBON)
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)
Manual creado por:
Esteban Allende Prieto
Diego Díaz Espinoza

Índice de contenido
Requisitos para instalar Process Maker:............................................................................................... 4
Instalando Apache................................................................................................................................ 4
Instalando MySql..................................................................................................................................5
Instalando PHP..................................................................................................................................... 6
Instalando ProcessMaker......................................................................................................................7
Configuración.......................................................................................................................................8
Definiciones........................................................................................................................................12
Apache:.......................................................................................................................................... 12
MySQL.......................................................................................................................................... 12
PHP:............................................................................................................................................... 12
WAMP............................................................................................................................................12
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

0 Requisitos para instalar Process Maker:
Para ejecutar Process Maker en su ordenador deberá tener instalado los siguientes
servicios:
Apache 2.2.3 ó más reciente, con los siguientes módulos activados:
Deflate
Expires
Rewrite
Vhost_alias
MySQL 4.1.20 ó más reciente, con un superusuario (nombre de usuario y password).
PHP 5.1.6 ó más reciente, con los siguientes módulos instalados:
php­gd
php­mysql
php­xml
php­soap
php_mbstring
Si ya los tiene instalados puede saltarse al paso Instalando ProcessMaker.
1 Instalando Apache.
En Ubuntu está disponible Apache desde el repositorio. Para instalarlo puede abrirse el
Gestor de Paquetes Synaptic (Sistema­>Administración­>Gestor de Paquetes Synaptic),
buscar apache2 en el buscador y seleccionar el paquete Apache2 (actualmente se
encuentra disponible la versión 2.2.4). Las dependencias necesarias se instalan
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

automáticamente con el Gestor de Paquetes Synaptic.
Equivalentemente puede abrirse un terminal e ingresar el comando:
sudo apt-get install apache2
El instalador pedirá confirmación para instalar las dependencias necesarias.
Una vez terminada la instalación de Apache deben activarse los módulos expires, rewrite,
deflate y vhost_alias. Para ello debe abrir una terminal y tipear:
sudo a2enmod expires
sudo a2enmod rewrite
sudo a2enmod deflate
sudo a2enmod vhost_alias
Si en algún momento desea desactivar dichos modulos sólo debe reemplazar el comando
a2enmod por a2dismod.
2 Instalando MySql.
En Ubuntu está disponible MySql desde el repositorio. Para instalarlo puede abrirse el
Gestor de Paquetes Synaptic (Sistema­>Administración­>Gestor de Paquetes Synaptic),
buscar mysql en el buscador y seleccionar el paquete MySql­5.0 (actualmente se
encuentra disponible la versión 5.0). Las dependencias necesarias se instalan
automáticamente con el Gestor de Paquetes Synaptic; debe asegurarse que las
siguientes dependencias sean instaladas: mysql­server y mysql­client. Adicionalmente se
recomienda instalar un administrador de bases de datos MySql (este ayuda enormemente
a crear y editar tablas de forma amigable); para ello seleccione también mysql­
adminsitrator y mysql­query­browser en dicho gestor.
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

Alternativamente MySql puede ser instalado por linea de comando, para ello: abra una
terminal y tipe el siguiente comando:
sudo apt-get install mysql-server-5.0 mysql-client-5.0
Adicionalmente puede instalar MySql Administrator y Query Browser mediante:
sudo apt-get install mysql-admin mysql-query-browser
3 Instalando PHP.
En Ubuntu está disponible PHP desde el repositorio. Para instalarlo puede abrirse el
Gestor de Paquetes Synaptic (Sistema­>Administración­>Gestor de Paquetes Synaptic),
buscar PHP en el buscador y seleccionar el paquete php5 (actualmente se encuentra
disponible la versión 5.2.3). Las dependencias necesarias son php­gd, php­mysql, php­
xml, php­soap, php_mbstring, debe entonces seleccionar adicionalmente estas
dependencias.
Alternativamente PHP puede ser instalado por linea de comando, para ello: abra una
terminal y tipe el siguiente comando:
sudo apt-get install php5 php-gd php-mysql php-xml php-soap
php_mbstring
Además PHP necesita la siguiente configuración en el archivo php.ini
asp_tags = On
short_open_tag = On
file_uploads = On
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

egister_globals = On
memory_limit = 80M
Para cambiar dichas variables puede editar el archivo /etc/php5/apache2/php.ini usando
por ejemplo gedit:
sudo gedit /etc/php5/apache2/php.ini
Busque las variables en el archivo, ajuste sus valores y guarde.
Para eliminar cualquier paquete instalado mediante el Gestor de Paquetes Synaptic, abra
dicho programa, busque el paquete a desinstalar, click con el botón derecho del mouse y
seleccione “marcar para eliminar completamente”. Alternativamente puede desinstalarlo
desde la terminal mediante:
sudo apt-get remove
4 Instalando ProcessMaker.
ProcessMaker no está incluido en los repositorios de Ubuntu, por lo tanto debe instalarse
manualmente. Para ello vaya al sitio http://www.processmaker.com
haga click en
“Download Process Maker OSS”, luego click en Download ProcessMaker Open Source
luego en “Browse All Files”, y escoja pmos­1.1­1654.noarch.rpm . Una vez que haya
descargado dicho archivo, abra una terminal y ubíquese donde se descargó el archivo,
luego tipee
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

sudo alien -d pmos-1.1-1654.noarch.rpm
Esto crea un archivo .deb. Para instalar dicho archivo tipee:
sudo dpkg –install pmos-1.1-1654.noarch.deb
Con esto quedará instalado ProcessMaker en /opt/processmaker .
Para desinstalar processmaker utilice
sudo dpkg –purge pmos-1.1-1654.noarch.rpm
En una terminal. Esto elimina completamente el paquete instalado.
Opcionalmente puede instalar archivos tar.gz descomprimiendo los mismos en la
carpeta /opt/processmaker.
5 Configuración
5.1
Configurar directorios de ProcessMaker:
cambiar los permisos de los siguientes directorios (y sus subdirectorios) a 777.
/opt/processmaker/workflow/engine/config/
/opt/processmaker/workflow/engine/content/languages/
/opt/processmaker/workflow/engine/js/labels
Para ello desde la terminal ejecute:
sudo chmod 777 -R /opt/processmaker/workflow/engine/config/
sudo chmod 777 -R /opt/processmaker/workflow/engine/content/languages/
sudo chmod 777 -R /opt/processmaker/workflow/engine/js/labels
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

Además debe darle permisos a los usuarios web mediante:
5.2
sudo chown www-data:www-data -R /opt/processmaker
Enlazar Apache a la carpeta de trabajo de ProcessMaker
Copie el archivo /opt/processmaker/etc/pmos.conf en /etc/apache2/sites­available/ , para
ello puede usar el siguiente comando en una terminal:
sudo cp /opt/processmaker/etc/pmos.conf /etc/apache2/sitesavailable/
Luego edite el archivo destino mediante:
sudo gedit /etc/apache2/sites-available/pmos.conf
Añada la siguiente linea después de “DirectoryIndex....”
php_value magic_quotes_gpc 0
También verifique y complete los siguientes datos en pmos.conf
NameVirtualHost dirección_ip
ServerName "dominio_process_maker"
Puede obtener su IP mediante el comando:
ifconfig
Y buscando en la salida su tarjeta de red, wlan u otros.
El archivo pmos.conf contiene la información general de configuración del programa
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

Process Maker para ser procesada por Apache. Para activar este nuevo sitio en apache
utilice el siguiente comando en una terminal:
sudo a2ensite pmos.conf
Para desabilitar un sitio utilice:
sudo a2dissite
Si ud. desea puede asignar un alias a su dirección ip mediante edición del
archivo /etc/hosts, insertando:
Así por ejemplo:
192.168.0.190 MyProcessMaker
Asigna la dirección http://MyProcessMaker a su sitio de Process Maker instalado.
5.3
Crear super­usuario para MySql
Ingrese a MySql mediante linea de comando (terminal) con:
mysql -u -p
Una vez dentro, tipee:
grant all on *.* to 'usuario@localhost' identified by 'clave'
with grant option;
Luego
exit
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

Para salir.
5.4
Creación del primer Workspace.
Finalmente, debe ejecutar la instalación de un WorkSpace para Process Maker, para ello
ingrese en su browser (por ejemplo FireFox) la dirección en la que instaló Process Maker,
en nuestro ejemplo: http://MyProcessMaker o equivalentemente http://192.168.0.190
Si todo ha salido bien debiera obtener solamente palabras “PASSED” (en verde)
confirmando que la configuración para instalar el WorkSpace están correcta. Si saliese
alguna palabra “FAILED” (en rojo) debe revisar el paso concreto que está fallando. En
particular, la conexión a la base de datos debiera fallar pues no se ha ingresado ni el
usuario ni el password con los privilegios de superusuario para acceder a ella; ingrese
superusuario y password y luego click en Test para confirmar. Si todo anda correcto
debiera entonces tener sólo palabras “PASSED”. Si es así presione Install. Una vez
instalado presione “Finish Install”. Con esto está creado nuestro Workspace. Para ingresar
a él tipee la dirección de Process Maker (ejemplo: http://MyProcessMaker) y luego ingrese
el usuario “admin”, password “admin” y workspace “workflow”.
Para crear un nuevo workspace, ingrese a la siguiente dirección en su browser:
http:///sys/en/green/install/newSite
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)

Definiciones
Apache:
En este caso se está usando el HTTP server de apache. El HTTP server es un servidor
HTTP, es decir, permite que su computadora reciba peticiones de páginas html guardadas
en su interior y las despliegue en la máquina destino que las peticiona.
MySQL:
MySql es un servidor de bases de datos basada basado en el lenguaje SQL. El permite
tener funcionando una base de datos MySql en su computador y recibir peticiones desde
computadores remotos o locales a su máquina.
PHP:
Es un lenguaje usado especialmente para Web. Se basa en la interpretación de código
incrustado dentro de archivos HTML. Con esto su computador hará de servidor web de
páginas con lenguaje PHP.
WAMP:
Es un programa que se dedica a instalar y configurar Apache, MySql y PHP en Windows
(de allí WAMP).
Manual de instalación Process Maker en Ubuntu (Gutsy Gibbon)