Proceso de Instalación y Configuración del Portal de SW-LNX-00000004

Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1

Revisión: 3
Fecha: 31/03/2010

Proceso de Instalación y Configuración del Portal de Clientes

para VtigerCRM 5.1.0RC en openSUSE 11.1
1. Propósito:

Describir el procedimiento necesario para la puesta en funcionamiento del Plugin:

Portal de Clientes 5.1.0RC para la aplicación web “VtigerCRM
VtigerCRM” versión
5.1.0RC,
5.1.0RC en el Sistema Operativo: openSUSE 11.1. 11.1
Fuente: http://vtiger.com
Funcionalidad principal del Software: Portal de Autoservicio para ser utilizado por
los Contactos autorizados, miembros de las Cuentas que tengamos
almacenadas en el VtigerCRM 5.1.0RC.
El Portal de Clientes 5.1.0RC les permite a los Contactos autorizados, entre
otras características, gestionar información relacionada con:
• Mis Preferencias (puede modificar la contraseña de acceso al Portal)
• Incidencias (puede crear una nueva incidencia)
• Base Conocimiento (puede acceder a las FAQs publicadas)
• Facturas
• Presupuestos
• Productos
• Servicios
• Documentos
• Contactos
• Cuentas (con acceso restringido, aunque se puede habilitar)

Este documento tiene validez solamente dentro del Sistema de Gestión de Calidad.
1/8
 Proceso de Instalación y Configuración del Portal de SW-LNX-00000004
Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1
Revisión: 3
Fecha: 31/03/2010

2. Proceso:

2.1. Requerimientos previos de Software:

Se describen los requerimientos previos de Software y los procedimientos de

configuración necesarios para la puesta en funcionamiento de la aplicación web
VtigerCRM 5.1.0RC en el documento:

“SW-LNX-00000002
SW-LNX-00000002 - Proceso de Instalacion y Configuracion de
VTIGERCRM en openSUSE 11-1 REV_6”
REV_6

Para mayores detalles, lea este documento.

2.2. Instalación del Portal de Clientes 5.1.0RC para VtigerCRM 5.1.0RC:

Instalación del Portal de Clientes 5.1.0RC para VtigerCRM 5.1.0RC:

5.1.0RC
Item Comandos a ejecutar y Detalle de la acción
1 #> cd /srv/www/htdocs/
Ubicarse en el directorio "Documento Raíz"
Raíz" del Servidor HTTP Apache2

2 #> su
Obtener los privilegios de usuario administrador "root
root":

3 #> /bin/mkdir /srv/www/htdocs/vtigercustomerportal

Crear un nuevo directorio destinado a alojar el VtigerCRM Customer Portal Plugin 5.1.0RC.

4 #> cd /srv/www/htdocs/vtigercustomerportal
Ubicarse en el nuevo directorio.

5 #> /usr/bin/wget
http://downloads.sourceforge.net/project/vtigercrm/vtiger%20CRM%20Release
%20Archive/vtiger%20CRM%205.1.0RC/Add-ons/vtigercrm-customerportal-
5.1.0RC.zip?use_mirror=ufpr
Descargar el VtigerCRM Customer Portal Plugin 5.1.0RC.

6 #> /usr/bin/unzip vtigercrm-customerportal-5.1.0RC.zip

Descomprimir el archivo descargado.

7 #> cd /srv/www/htdocs/vtigercustomerportal/language
En nuestro caso, para poder usar el Lenguaje Español primero debemos copiar unos archivos
necesarios que se obtienen del Spanish Languaje Pack para el VtigerCRM 5.1.0RC en el directorio
“language
language”.

8 #> /usr/bin/wget
http://forge.vtiger.com/frs/download.php/781/es_es.lang.php
Descargar el archivo del Spanish Language Pack para VtigerCRM 5.1.0RC:
5.1.0RC es_es.lang.php

Este documento tiene validez solamente dentro del Sistema de Gestión de Calidad.
2/8
 Proceso de Instalación y Configuración del Portal de SW-LNX-00000004
Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1
Revisión: 3
Fecha: 31/03/2010

Instalación del Portal de Clientes 5.1.0RC para VtigerCRM 5.1.0RC:

5.1.0RC
Item Comandos a ejecutar y Detalle de la acción
9 #> /bin/vi /srv/www/htdocs/vtigercustomerportal/PortalConfig.php
De acuerdo a la ayuda del VtigerCRM Customer Portal Plugin 5.1.0RC
que se encuentra en la URL: http://wiki.vtiger.com/index.php/vtiger510:Plugin_Customer_Portal
Se debe editar el archivo: PortalConfig.php
En nuestro caso la ruta absoluta al archivo es:
/srv/www/htdocs/vtigercustomerportal/PortalConfig.php
Editar el archivo “PortalConfig.php
PortalConfig.php”. Durante la edición del archivo “PortalConfig.php
PortalConfig.php”
hay que especificar las siguientes opciones:

Server_Path:
Server_Path
Especificar la ruta absoluta (URL) de acceso local (LAN) a la aplicación web VtigerCRM
5.1.0RC.
5.1.0RC
En nuestro caso: $Server_Path = "http://192.168.0.2/vtigercrm
"http://192.168.0.2/vtigercrm";
";

Authenticate_Path:
Authenticate_Path
Especificar la ruta absoluta (URL) de acceso local (LAN) a la aplicación web VtigerCRM
Customer Portal Plugin 5.1.0RC.
5.1.0RC
En nuestro caso: $Authenticate_Path = "http://192.168.0.2/vtigercustomerportal
"http://192.168.0.2/vtigercustomerportal";
";

upload_dir:
upload_dir
Especificar un directorio temporal en el cuál se almacenarán los archivos adjuntos de los Tickets
(Incidencias).
(Incidencias)
En nuestro, lo dejamos como está: $upload_dir = '/tmp';

default_language:
default_language
Especificar el Lenguaje preseleccionado para usar.
En nuestro caso, vamos a dejar preseleccionado: $default_language = 'es_es';

languages:
languages
Para permitir la selección de los dos Lenguajes,
Lenguajes 'en_us' y 'es_es',
'es_es' lo modificamos y cambiamos
por:
$languages = Array('en_us'=>'US English','es_es'=>'ES Spanish');

Luego guardamos los cambios hechos al archivo:

/srv/www/htdocs/vtigercustomerportal/PortalConfig.php

Este documento tiene validez solamente dentro del Sistema de Gestión de Calidad.
3/8
 Proceso de Instalación y Configuración del Portal de SW-LNX-00000004
Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1
Revisión: 3
Fecha: 31/03/2010

Instalación del Portal de Clientes 5.1.0RC para VtigerCRM 5.1.0RC:

5.1.0RC
Item Comandos a ejecutar y Detalle de la acción
10 #> /bin/vi /srv/www/htdocs/vtigercrm/config.inc.php
También se debe editar el archivo config.inc.php que pertenece al VtigerCRM 5.1.0RC:
5.1.0RC
Editar el archivo config.inc.php del directorio /srv/www/htdocs/vtigercrm.
Durante la edición del archivo config.inc.php hay que especificar la siguientes opciones:

$PORTAL_URL = 'http://vtiger.com/customerportal';
Lo modificamos para indicar la URL de acceso mediante una conexión de Internet (WAN),
(WAN) de
manera que puedan ingresar los Contactos a los que se les concedió permiso:
En nuestro caso:
$PORTAL_URL = 'http://www.sudominio.com.ar/vtigercustomerportal
'http://www.sudominio.com.ar/vtigercustomerportal';';

$HELPDESK_SUPPORT_NAME = 'your-support name';

Lo modificamos a nuestro gusto:
$HELPDESK_SUPPORT_NAME = 'Equipo de Soporte de SUEmpresaIT';

Luego guardamos los cambios hechos al archivo: /srv/www/htdocs/vtigercrm/config.inc.php

11 #> /bin/chmod -R a+rw vtigercustomerportal

Modificar los permisos del nuevo directorio.

12 #> /bin/chown -R wwwrun:www vtigercustomerportal

Asignación de uid=wwwrun y gid=www al directorio /srv/www/htdocs/vtigercustomerportal y todo su
contenido en forma recursiva.

Este documento tiene validez solamente dentro del Sistema de Gestión de Calidad.
4/8
 Proceso de Instalación y Configuración del Portal de SW-LNX-00000004
Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1
Revisión: 3
Fecha: 31/03/2010

Instalación del Portal de Clientes 5.1.0RC para VtigerCRM 5.1.0RC:

5.1.0RC
Item Comandos a ejecutar y Detalle de la acción
13 ...
Para que funcione el "VtigerCRM
VtigerCRM Customer Portal Extension Module 5.1.0RC" 5.1.0RC debemos
importarlo desde el "Module
Module Manager".
Manager Esta extensión, de VtigerCRM 5.1.0RC nos permite realizar
algunas configuraciones que se aplican sobre el VtigerCRM Customer Portal Plugin 5.1.0RC.5.1.0RC
El archivo de extensión del Gestor de Módulos es:
/srv/www/htdocs/vtigercrm/packages/5.1.0/optional/CustomerPortal.zip
Sinó se lo encuentra allí, lo puede obtener desde el archivo comprimido: vtigercrm-5.1.0RC.tar.gz
Para agregar la Extensión del Customer Portal para el Gestor de Módulos de VtigerCRM
5.1.0RC,
5.1.0RC debemos efectuar los siguientes pasos:
1. Acceder a la aplicación web VtigerCRM 5.1.0RC mediante la URL:
http://192.168.0.2/vtigercrm con el usuario "admin
admin" y su contraseña de acceso.
2. Ir al "Module
Module Manager"
Manager mediante la Solapa: "Settings
Settings → Module Manager"
Manager
Seleccionar "Custom
Custom Modules"
Modules y clickear sobre "Import
Import New"
New
Luego debe navegar el sistema de archivos hasta encontrar: CustomerPortal.zip
3. Finalizado el proceso de importación del Módulo ódulo de Extensión del Customer Portal se
obtiene el mensaje en pantalla:
"
Creating Module CustomerPortal ... STARTED
Initializing module permissions ... DONE
Updating tabdata file ... DONE
Creating Module CustomerPortal ... DONE
SQL: CREATE TABLE `vtiger_customerportal_tabs` ( `tabid` int(19) NOT NULL, `visible`
int(1) default '1', `sequence` int(1) default NULL, PRIMARY KEY (`tabid`) ) ENGINE=InnoDB
DEFAULT CHARSET=utf8 ... DONE
SQL: CREATE TABLE `vtiger_customerportal_fields` ( `tabid` int(19) NOT NULL, `fieldid`
int(19) default NULL, `visible` int(1) default NULL ) ENGINE=InnoDB DEFAULT CHARSET=utf8 ...
DONE
SQL: CREATE TABLE `vtiger_customerportal_prefs` ( `tabid` int(11) NOT NULL, `prefkey`
varchar(100) default NULL, `prefvalue` int(20) default NULL ) ENGINE=InnoDB DEFAULT
CHARSET=utf8 ... DONE
SQL: ALTER TABLE vtiger_customerportal_prefs ADD INDEX tabid_idx(tabid) ... DONE
Invoking vtlib_handler for module.postinstall ...START
Invoking vtlib_handler for module.postinstall ...DONE
"
4. Si el proceso de importación ha finalizado bien, en la Solapa "Settings"Settings"" bajo el título
"Other Settings"
Settings" debería aparecer la opción del "Customer
"Customer Portal"
Portal"
5. Realizaremos los mismos pasos con las otras Extensiones para el “Module Module Manager”:
Manager
• /srv/www/htdocs/vtigercrm/packages/5.1.0/optional/FieldFormulas.zip
• /srv/www/htdocs/vtigercrm/packages/5.1.0/optional/RecycleBin.zip
• /srv/www/htdocs/vtigercrm/packages/5.1.0/optional/Tooltip.zip
• /srv/www/htdocs/vtigercrm/packages/5.1.0/optional/Webforms.zip
/srv/www/htdocs/vtigercrm/packages/5.1.0/optional/Webforms.zip
6. Una vez que hemos importado todas las Extensiones para el “Module Module Manager”
Manager del
VtigerCRM 5.1.0RC,
5.1.0RC cerramos la sesión del usuario "admin
admin"

Este documento tiene validez solamente dentro del Sistema de Gestión de Calidad.
5/8
 Proceso de Instalación y Configuración del Portal de SW-LNX-00000004
Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1
Revisión: 3
Fecha: 31/03/2010

Instalación del Portal de Clientes 5.1.0RC para VtigerCRM 5.1.0RC:

5.1.0RC
Item Comandos a ejecutar y Detalle de la acción
14 ...
Vamos a realizar una prueba de acceso al VtigerCRM Customer Portal 5.1.0RC.
5.1.0RC
Para ello seguiremos los siguientes pasos:
1. En VtigerCRM 5.1.0RC,
5.1.0RC acceder con nuestro nombre de usuario y contraseña para crear
un Contacto ficticio con una cuenta de e-mail a la que tengamos acceso.
acceso
2. En los Detalles del Contacto debemos tildar la opción: "Usuario
Usuario del Portal"
Portal para indicar
"Si
Si"
3. Automáticamente se nos enviarán los detalles para acceder al VtigerCRM Customer Portal
5.1.0RC a la cuenta de e-mail del Contacto ficticio
4. Hay que ingresar al VtigerCRM Customer Portal 5.1.0RC con la cuenta de e-mail y la
contraseña que recibimos en el e-mail. Para poder ingresar,
ingresar simulando ser un Contacto
que está ubicado en otro lugar y conectado a Internet,
Internet podemos usar un Proxy Web,Web
como por ejemplo:
ejemplo http://www.hidemyass.com y visitar la url correspondiente:
http://www.sudominio.com.ar/vtigercustomerportal
5. Una vez que ha ingresado al Portal de Clientes de VtigerCRM 5.1.0RC podrá ver las
siguientes Solapas:
Solapas
• Incidencias
• Base Conocimiento
• Facturas
• Presupuestos
• Productos
• Servicios
• Documentos
• Contactos
• Cuentas (acceso restringido, por defecto)
También puede modificar la contraseña en “Mis
Mis Preferencias”
Preferencias
Una vez que ha terminado puede Salir del Portal de Clientes
6. También puede cerrar la sesión en VtigerCRM 5.1.0RC
7. Cerrar la sesión de usuario "root" en la línea de comandos: #> exit

Este documento tiene validez solamente dentro del Sistema de Gestión de Calidad.
6/8
 Proceso de Instalación y Configuración del Portal de SW-LNX-00000004
Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1
Revisión: 3
Fecha: 31/03/2010

3. Referencias y Fuentes de Información en Internet:

Item Referencia y URL

1 VtigerCRM Customer Portal Plugin 5.1.0RC:
• http://downloads.sourceforge.net/project/vtigercrm/vtiger%20CRM%20Release
%20Archive/vtiger%20CRM%205.1.0RC/Add-ons/vtigercrm-customerportal-5.1.0RC.zip?
use_mirror=ufpr

2 VtigerCRM es_es Spanish Language Pack for 5_1_0:

• http://forge.vtiger.com/frs/download.php/745/Spanish_es_es_TSolucio_510GA.zip
• http://forge.vtiger.com/frs/download.php/781/es_es.lang.php

3 VtigerCRM 5.1.0 Customer Portal Manual:

• http://www.vtiger.com/archives/validation/5.1.0-val2/VtigerCRM_5.1.0_Customer_Portal.pdf

4 VtigerCRM Forums
• http://forums.vtiger.com/viewtopic.php?t=26607 (“customer portal in 5.1”)

• http://forums.vtiger.com/viewtopic.php?
t=25904&start=0&postdays=0&postorder=asc&highlight=&sid=a98db72c6d1a004b3
d6985f4e5e189cc (“The Version is not compatible”)

• http://forums.vtiger.com/viewtopic.php?
t=24560&start=0&postdays=0&postorder=asc&highlight=&sid=ec1a776bff15563b72
69a6d936cfb8e7 (“NO PERMISSION TO VIEW ANY MODULE”)

Este documento tiene validez solamente dentro del Sistema de Gestión de Calidad.
7/8
 Proceso de Instalación y Configuración del Portal de SW-LNX-00000004
Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1
Revisión: 3
Fecha: 31/03/2010

Historia de Cambios

Revisión Autor Fecha Descripción

Ezequiel
1 Hernán 15/10/2009 Creación del documento
Villanueva
Modificación del documento:
• en el Punto:
2.1 Requerimientos previos de Software:
se actualiza la Referencia al Documento:
Ezequiel “SW-LNX-00000002 - Proceso de Instalacion y
2 Hernán 30/03/2010 Configuracion de VTIGERCRM en openSUSE 11-1
Villanueva REV_5”
• en el Punto:
2.2 Instalación del Portal de Clientes 5.1.0RC para
VtigerCRM 5.1.0RC:
se modifica el diseño de la Tabla.
Modificación del documento:
• en el Punto:
2.1 Requerimientos previos de Software:
se actualiza la Referencia al Documento:
Ezequiel “SW-LNX-00000002 - Proceso de Instalacion y
3 Hernán 31/03/2010 Configuracion de VTIGERCRM en openSUSE 11-1
Villanueva REV_6”
• en el punto:
2.2 Instalación del Portal de Clientes 5.1.0RC para
VtigerCRM 5.1.0RC:
se efectúan correcciones.

Este documento tiene validez solamente dentro del Sistema de Gestión de Calidad.
8/8