sw-lnx-00000004 - proceso de instalacion y configuracion del portal de clientes para vtigercrm...

Proceso de Instalación y Configuración del Portal deProceso de Instalación y Configuración del Portal de Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1Clientes para VtigerCRM 5.1.0RC en openSUSE 11.1

SW-LNX-00000004SW-LNX-00000004

Revisión: 3 Revisión: 3 Fecha: 31/03/2010Fecha: 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.0RCPortal de Clientes 5.1.0RC para la aplicación web “VtigerCRMVtigerCRM” versión 5.1.0RC5.1.0RC, en el Sistema Operativo: openSUSE 11.1Sistema Operativo: openSUSE 11.1.Fuente: Fuente: http://vtiger.comhttp://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.0RCPortal de Clientes 5.1.0RC les permite a los Contactos autorizados, entre otras características, gestionar información relacionada con: • Mis PreferenciasMis Preferencias (puede modificar la contraseña de acceso al Portal)• IncidenciasIncidencias (puede crear una nueva incidencia)• Base ConocimientoBase Conocimiento (puede acceder a las FAQsFAQs publicadas)• FacturasFacturas • PresupuestosPresupuestos •• ProductosProductos•• ServiciosServicios•• DocumentosDocumentos•• ContactosContactos• CuentasCuentas (con acceso restringido, aunque se puede habilitar)

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

11//88

http://vtiger.com/


SW-LNX-00000004SW-LNX-00000004


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.0RCVtigerCRM 5.1.0RC en el documento:

“SW-LNX-00000002 - Proceso de Instalacion y Configuracion deSW-LNX-00000002 - Proceso de Instalacion y Configuracion de VTIGERCRM en openSUSE 11-1 REV_6VTIGERCRM en openSUSE 11-1 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.0RCInstalación del Portal de Clientes 5.1.0RC para VtigerCRM 5.1.0RC:

ItemItem Comandos a ejecutar y Detalle de la acciónComandos a ejecutar y Detalle de la acción

11 #> cd /srv/www/htdocs/

Ubicarse en el directorio ""Documento RaízDocumento Raíz"" del Servidor HTTP Apache2Servidor HTTP Apache2

22 #> su

Obtener los privilegios de usuario administradorusuario administrador "rootroot":

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

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

44 #> cd /srv/www/htdocs/vtigercustomerportal

Ubicarse en el nuevo directorio.

55 #> /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.VtigerCRM Customer Portal Plugin 5.1.0RC.

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

Descomprimir el archivo descargado.

77 #> cd /srv/www/htdocs/vtigercustomerportal/language

En nuestro caso, para poder usar el Lenguaje EspañolLenguaje Español primero debemos copiar unos archivos necesarios que se obtienen del Spanish Languaje Pack para el VtigerCRM 5.1.0RC Spanish Languaje Pack para el VtigerCRM 5.1.0RC en el directorio “languagelanguage”.

88 #> /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.0RCSpanish Language Pack para VtigerCRM 5.1.0RC: es_es.lang.phpes_es.lang.php


22//88


SW-LNX-00000004SW-LNX-00000004




99 #> /bin/vi /srv/www/htdocs/vtigercustomerportal/PortalConfig.php

De acuerdo a la ayuda del VtigerCRM Customer Portal Plugin 5.1.0RC 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.phpPortalConfig.php En nuestro caso la ruta absoluta al archivo es: /srv/www/htdocs/vtigercustomerportal/PortalConfig.php/srv/www/htdocs/vtigercustomerportal/PortalConfig.phpEditar el archivo “PortalConfig.phpPortalConfig.php”. Durante la edición del archivo “PortalConfig.phpPortalConfig.php” hay que especificar las siguientes opciones:

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

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

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

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

languageslanguages: Para permitir la selección de los dos Lenguajespermitir la selección de los dos Lenguajes, 'en_us' y 'es_es''en_us' y 'es_es', lo modificamos y cambiamos por:

$languages = Array('en_us'=>'US English','es_es'=>'ES Spanish'); $languages = Array('en_us'=>'US English','es_es'=>'ES Spanish');

Luego guardamos los cambios hechos al archivo: /srv/www/htdocs/vtigercustomerportal/PortalConfig.php/srv/www/htdocs/vtigercustomerportal/PortalConfig.php


33//88

http://192.168.0.2/vtigercustomerportal

http://192.168.0.2/vtigercrm

http://wiki.vtiger.com/index.php/vtiger510:Plugin_Customer_Portal


SW-LNX-00000004SW-LNX-00000004




1010 #> /bin/vi /srv/www/htdocs/vtigercrm/config.inc.php

También se debe editar el archivo config.inc.phpconfig.inc.php que pertenece al VtigerCRM 5.1.0RCVtigerCRM 5.1.0RC:Editar el archivo config.inc.phpconfig.inc.php del directorio /srv/www/htdocs/vtigercrm./srv/www/htdocs/vtigercrm.Durante la edición del archivo config.inc.phpconfig.inc.php hay que especificar la siguientes opciones:

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

$HELPDESK_SUPPORT_NAME = 'your-support name';$HELPDESK_SUPPORT_NAME = 'your-support name'; Lo modificamos a nuestro gusto: $HELPDESK_SUPPORT_NAME = 'Equipo de Soporte de SUEmpresaIT';$HELPDESK_SUPPORT_NAME = 'Equipo de Soporte de SUEmpresaIT';

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

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

Modificar los permisos del nuevo directorio.

1212 #> /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.


44//88

http://www.sudominio.com.ar/vtigercustomerportal


SW-LNX-00000004SW-LNX-00000004




1313 ...

Para que funcione el "VtigerCRM Customer Portal Extension Module 5.1.0RCVtigerCRM Customer Portal Extension Module 5.1.0RC" debemos importarloimportarlo desde el "Module ManagerModule Manager". Esta extensión, de VtigerCRM 5.1.0RCVtigerCRM 5.1.0RC nos permite realizar algunas configuraciones que se aplican sobre el VtigerCRM Customer Portal Plugin 5.1.0RCVtigerCRM Customer Portal Plugin 5.1.0RC. El archivo de extensión del Gestor de Módulosextensión del Gestor de Módulos es:/srv/www/htdocs/vtigercrm/packages/5.1.0/optional/CustomerPortal.zip/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.gzvtigercrm-5.1.0RC.tar.gz Para agregar la Extensión del Customer Portal para el Gestor de MódulosExtensión del Customer Portal para el Gestor de Módulos de VtigerCRMVtigerCRM 5.1.0RC5.1.0RC, debemos efectuar los siguientes pasos:

1. Acceder a la aplicación web VtigerCRM 5.1.0RCVtigerCRM 5.1.0RC mediante la URL: http://192.168.0.2/vtigercrmhttp://192.168.0.2/vtigercrm con el usuario "adminadmin" y su contraseñacontraseña de acceso.

2. Ir al "Module ManagerModule Manager" mediante la Solapa: "Settings → Module ManagerSettings → Module Manager"Seleccionar "Custom ModulesCustom Modules" y clickear sobre "Import NewImport New" Luego debe navegar el sistema de archivos hasta encontrar: CustomerPortal.zipCustomerPortal.zip

3. Finalizado el proceso de importaciónFinalizado el proceso de importación del Módulo de Extensión delódulo de Extensión del Customer PortalCustomer Portal se obtiene el mensaje en pantalla: " "

Creating Module CustomerPortal ... STARTED Creating Module CustomerPortal ... STARTED Initializing module permissions ... DONE Initializing module permissions ... DONE Updating tabdata file ... DONE Updating tabdata file ... DONE Creating Module CustomerPortal ... DONE Creating Module CustomerPortal ... DONE SQL: CREATE TABLE `vtiger_customerportal_tabs` ( `tabid` int(19) NOT NULL, `visible`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=InnoDBint(1) default '1', `sequence` int(1) default NULL, PRIMARY KEY (`tabid`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 ... DONE DEFAULT CHARSET=utf8 ... DONE

SQL: CREATE TABLE `vtiger_customerportal_fields` ( `tabid` int(19) NOT NULL, `fieldid`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 ...int(19) default NULL, `visible` int(1) default NULL ) ENGINE=InnoDB DEFAULT CHARSET=utf8 ... DONE DONE

SQL: CREATE TABLE `vtiger_customerportal_prefs` ( `tabid` int(11) NOT NULL, `prefkey`SQL: CREATE TABLE `vtiger_customerportal_prefs` ( `tabid` int(11) NOT NULL, `prefkey` varchar(100) default NULL, `prefvalue` int(20) default NULL ) ENGINE=InnoDB DEFAULTvarchar(100) default NULL, `prefvalue` int(20) default NULL ) ENGINE=InnoDB DEFAULT CHARSET=utf8 ... DONE CHARSET=utf8 ... DONE

SQL: ALTER TABLE vtiger_customerportal_prefs ADD INDEX tabid_idx(tabid) ... 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 ...START Invoking vtlib_handler for module.postinstall ...DONE Invoking vtlib_handler for module.postinstall ...DONE ""

4.4. Si el proceso de importación ha finalizado bien, en la Solapa "Si el proceso de importación ha finalizado bien, en la Solapa "SettingsSettings" bajo el título" bajo el título ""Other SettingsOther Settings" debería aparecer la opción del "" debería aparecer la opción del "Customer PortalCustomer Portal""

5. Realizaremos los mismos pasosmismos pasos con las otras Extensionesotras Extensiones para el “Module ManagerModule Manager”:•• /srv/www/htdocs/vtigercrm/packages/5.1.0/optional/FieldFormulas.zip /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/RecycleBin.zip •• /srv/www/htdocs/vtigercrm/packages/5.1.0/optional/Tooltip.zip /srv/www/htdocs/vtigercrm/packages/5.1.0/optional/Tooltip.zip

• /srv/www/htdocs/vtigercrm/packages/5.1.0/optional/Webforms./srv/www/htdocs/vtigercrm/packages/5.1.0/optional/Webforms.zip zip 6. Una vez que hemos importado todas las Extensioneshemos importado todas las Extensiones para el “Module ManagerModule Manager” del

VtigerCRM 5.1.0RCVtigerCRM 5.1.0RC, cerramos la sesióncerramos la sesión del usuario "adminadmin"


55//88


SW-LNX-00000004SW-LNX-00000004




1414 ...

Vamos a realizar una prueba de acceso al VtigerCRM Customer Portal 5.1.0RCVtigerCRM Customer Portal 5.1.0RC. Para ello seguiremos los siguientes pasos:

1. En VtigerCRM 5.1.0RCVtigerCRM 5.1.0RC, accederacceder con nuestro nombre de usuario y contraseñausuario y contraseña para crearcrear un ContactoContacto ficticioficticio con una cuenta de e-mail a la que tengamos accesocuenta de e-mail a la que tengamos acceso.

2. En los Detalles del ContactoDetalles del Contacto debemos tildartildar la opción: "Usuario del PortalUsuario del Portal" para indicar "SiSi"

3. Automáticamente se nos enviarán los detalles para acceder al VtigerCRM Customer PortalVtigerCRM Customer Portal 5.1.0RC5.1.0RC a la cuenta de e-mailcuenta de e-mail del Contacto ficticioContacto ficticio

4. Hay que ingresar al VtigerCRM Customer Portal 5.1.0RCVtigerCRM Customer Portal 5.1.0RC con la cuenta de e-mailcuenta de e-mail y la contraseñacontraseña que recibimos en el e-mail. Para poder ingresaringresar, simulando ser un Contactosimulando ser un Contacto que está ubicado en otro lugar y conectado a Interneten otro lugar y conectado a Internet, podemos usar un Proxy Webusar un Proxy Web, como por ejemplopor ejemplo: http://www.hidemyass.com y visitar la urlvisitar la url correspondiente: http://www.sudominio.com.ar/vtigercustomerportalhttp://www.sudominio.com.ar/vtigercustomerportal

5. Una vez que ha ingresado al Portal de Clientes de VtigerCRM 5.1.0RCingresado al Portal de Clientes de VtigerCRM 5.1.0RC podrá ver las siguientes SolapasSolapas:

• IncidenciasIncidencias

• Base ConocimientoBase Conocimiento

• FacturasFacturas

• PresupuestosPresupuestos

• ProductosProductos

• ServiciosServicios

• DocumentosDocumentos

• ContactosContactos

• CuentasCuentas (acceso restringido, por defecto)También puede modificar la contraseña en “Mis PreferenciasMis Preferencias” Una vez que ha terminado puede SalirSalir del Portal de ClientesPortal de Clientes

6. También puede cerrar la sesióncerrar la sesión en VtigerCRM 5.1.0RCVtigerCRM 5.1.0RC7. Cerrar la sesión de usuario "root"Cerrar la sesión de usuario "root" en la línea de comandos: línea de comandos: #> exit


66//88

http://www.hidemyass.com/


SW-LNX-00000004SW-LNX-00000004


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

ItemItem Referencia y URLReferencia y URL

11 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

22 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

33 VtigerCRM 5.1.0 Customer Portal Manual:• http://www.vtiger.com/archives/validation/5.1.0-val2/ VtigerCRM_5.1.0_Customer_Portal.pdf

44 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=a98db72c6d1a004b3d6985f4e5e189cc (“The Version is not compatible”)

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


77//88

http://forums.vtiger.com/viewtopic.php?t=24560&start=0&postdays=0&postorder=asc&highlight=&sid=ec1a776bff15563b7269a6d936cfb8e7



http://forums.vtiger.com/viewforum.php?f=96&sid=889d551a5c5718cc76afcfdc6f87e727

http://forums.vtiger.com/viewtopic.php?t=25904&start=0&postdays=0&postorder=asc&highlight=&sid=a98db72c6d1a004b3d6985f4e5e189cc



http://forums.vtiger.com/viewforum.php?f=99&sid=3c4d255a7a07718f112cb181f15a379a

http://forums.vtiger.com/viewtopic.php?t=26607

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

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

http://forge.vtiger.com/frs/download.php/781/es_es.lang.php

http://forge.vtiger.com/frs/download.php/781/es_es.lang.php

http://forge.vtiger.com/frs/download.php/745/Spanish_es_es_TSolucio_510GA.zip

http://forge.vtiger.com/frs/download.php/745/Spanish_es_es_TSolucio_510GA.zip

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






SW-LNX-00000004SW-LNX-00000004


Historia de Cambios

RevisiónRevisión AutorAutor FechaFecha DescripciónDescripción

11Ezequiel Hernán

Villanueva15/10/2009 Creación del documento

22Ezequiel Hernán

Villanueva30/03/2010

Modificación del documento:• en el Punto:

2.1 Requerimientos previos de Software: se actualiza la Referencia al Documento:“SW-LNX-00000002 - Proceso de Instalacion y“SW-LNX-00000002 - Proceso de Instalacion y Configuracion de VTIGERCRM en openSUSE 11-1Configuracion de VTIGERCRM en openSUSE 11-1 REV_5”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.

33Ezequiel Hernán

Villanueva31/03/2010

Modificación del documento:• en el Punto:

2.1 Requerimientos previos de Software: se actualiza la Referencia al Documento:“SW-LNX-00000002 - Proceso de Instalacion y“SW-LNX-00000002 - Proceso de Instalacion y Configuracion de VTIGERCRM en openSUSE 11-1Configuracion de VTIGERCRM en openSUSE 11-1 REV_6”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.


88//88

sw-lnx-00000004 - proceso de instalacion y configuracion del portal de clientes para vtigercrm...

Documents