Instalación en Español

Contenidos:

Tabla de contenidos

• 1. Verifique que puede instalar LimeSurvey en su servidor
• 2. Descargue el archivo comprimido de LimeSurvey
• 3. Descomprima el archivo comprimido de LimeSurvey
• 4. Recoja información sobre su servidor
• 5. Configuración de LimeSurvey
  • 5.1 Parámetros de revisión Obligatoria
  • 5.2 Parámetros de revisión Opcional (puede dejarlos tal y como están)
  • 5.3 Configuración del correo electrónico
  • 5.4 Ajustes de las herramientas de producción de estadísticas y visualización de respuestas
  • 5.5 Configuración de LDAP
• 6. Suba los archivos a su servidor web
• 7. Ejecute el script de instalación
• 8. Acceda a la plataforma por primera vez
• 9. Qué puede hacer si tiene problemas...

1. Verifique que puede instalar LimeSurvey en su servidor

Por favor, compruebe que el servidor en el que va a realizar la instalación de LimeSurvey cumple con los siguientes requisitos mínimos:

• Aproximadamente 9 Megabytes de espacio el en disco duro.
• PHP 4.3.2 o una versión posterior de PHP 4 o PHP 5.x o una versión posterior
• MySQL 4.1.0 o una versión posterior o Microsoft SQL Server 2000 o una versión posterior
• Módulos de PHP Obligatorios
  • Módulo mysql4 o mysql5
• Módulos de PHP Opcionales
  • Módulo mbstring (Multibyte String Functions) para poder utilizar un idioma distinto al inglés (vea también Installation FAQ)
  • Módulo para la librería GD (Captchas en las autenticaciones y registros) vea GD-Library PHP Documentation
  • Módulo para LDAP (para importar población encuestada usando consultas LDAP) vea PHP LDAP Documentation

En la mayoría de los casos, si usted utiliza algún tipo de hospedaje, su proveedor le habrá informado y ayudará en este sentido, pero siempre puede probar a hacer un archivo simple tipo prueba.php:

y ejecutarlo en su navegador con la dirección http://midominio.org/prueba.php para ver qué configuración tiene su instalación de PHP

2. Descargue el archivo comprimido de LimeSurvey

Visite el sitio de SourceForge para descargar la última versión de LimeSurvey: http://sourceforge.net/projects/limesurvey/
El archivo (comprimido en formato zip) tiene un tamaño aproximado de 4 Mb. Descárguelo y guárdelo en la ubicación deseada
para ser accesible según la configuración de su servidor web.

3. Descomprima el archivo comprimido de LimeSurvey

Descomprima el archivo zip en el directorio deseado utilizando la herramienta de descompresión de su preferencia. Asegúrese de que se descomprima la estructura de directorios y los archivos (es el comportamiento por defecto en la mayoría de utilidades de descompresión).

Permisos en los directorios

• Algunos directorios deben tener permiso de escritura para el servidor web, a fin de que se pueda importar encuestas y archivos de encuestados así como la creación y modificación de plantillas. Estos son:
  [+]
  • +limesurvey/tmp+-
  • -+limesurvey/templates+-
• El resto de archivos y directorios deberían tener permiso sólo de lectura

4. Recoja información sobre su servidor

En algunos casos necesitará conocer los siguientes aspectos para instalar LimeSurvey correctamente en su servidor, aunque algunos de ellos son averiguados automáticamente por LimeSurvey.

• La dirección web (URL) donde van a encontrarse los scripts de LimeSurvey (por ejemplo: 'http://mi.dominio.com/limesurvey')
• La ubicación en el disco duro del servidor donde estarán guardados los scripts (por ejemplo: '/var/www/midominio/limesurvey')
• La IP o dirección donde se encontrará el servidor de bases de datos (si se encuentra en el mismo servidor es 'localhost')
• El puerto donde el servidor de bases de datos atiende peticiones si no es el puerto habitual (MySQL es el 3306). Si usted utiliza un servidor GNU/Linux o similar con MySQL y tiene acceso de interfaz de comandos puede probar a ejecutar ps aux | grep mysql y revisar los detalles de los procesos de mysql (parámetro 'port')
• Su nombre de usuario y contraseña para abrir una sesión en su servidor de bases de datos
• La mayoría de proveedores de hospedaje (hosting) no permitirán al script de instalación que se cree la base de datos, por lo que tendrá que crearla usted mismo con los mecanismos que su proveedor disponga para este fin. El nombre de la base de datos puede ser por ejemplo 'limesurvey', aunque usted puede denominarla como guste.

5. Configuración de LimeSurvey

Edite el archivo config.php que se encuentra en el directorio 'limesurvey' utilizando su editor preferido. Debe revisar y ajustar los siguientes parámetros:

5.1 Parámetros de revisión Obligatoria

• $databasetype: Tipo de Base de Datos. En el momento presente usted puede asignar "mysql" para un servidor de bases de datos MySQL y "odbc_mssql" para Microsoft SQL server. Por el momento esos son los que han sido probados.
• $databaselocation: Ajuste este parámetro a la dirección de red donde esté el servidor de Bases de Datos. Si está en el mismo servidor que los scripts, "localhost" es el valor adecuado.
• $databaseport: Ponga el puerto usado por el servidor de BD como se mencionó anteriormente. En la mayoría de los casos "default" es lo adecuado, pero si su servidor usa un puerto no standard cambie 'default' por el número de puerto.
• $databasename: El nombre de la base de datos que contendrá las tablas de LimeSurvey. Usted puede crear una base de datos con el script de instalación (sólo en casos en que disponga de ciertos permisos en el servidor), crear la base de datos por otros mecanismos o utilizar una base de datos ya existente. Se aconseja utilizar una base de datos que no contenga tablas de versiones muy antiguas de LimeSurvey.
• $databaseuser: El nombre de usuario para acceder a su servidor de base de datos
• $databasepass: La contraseña del usuario antedicho
• $dbprefix: Usted puede dejar este parámetro en blanco, es decir, $dbprefix=""; si usted está utilizando una base de datos en exclusiva para LimeSurvey, sin embargo, si va a compartir una base de datos con otras aplicaciones, es MUY conveniente que ponga un prefijo para las tablas de LimeSurvey, por ejemplo "lime_".
• $databasetabletype: Motor de almacenamiento que mysql usará cuando se creen las tablas de resultados (si se usa mysql). Si usted supiera que InnoDB está disponible se lo recomendamos, aunque el motor por defecto es MyISAM.
• $rooturl: Este parámetro debe contener la dirección web (URL) de los scripts de LimeSurvey. El valor por defecto es la configuración más habitual, por lo que es muy probable que no tenga que cambiarlo (la variable global de PHP {$_SERVER['SERVER_NAME']} intentará hacerlo automáticamente). Si ésto no funcionara, ponga la URL del servidor manualmente, por ejemplo "http://www.midominio.com/limesurvey".)
• $rootdir: Aquí debe indicar la ruta en el disco duro a sus scripts. Igual que en el caso anterior, el valor por defecto intentará averiguar este valor por defecto (el valor dirname(FILE) es el responsable de ello), por lo que en la mayoría de los casos no tendrá que cambiar nada. Si no funcionara, ponga la ruta manualmente, por ejemplo "/var/www/midominio/limesurvey".
• $sitename: Este es el nombre de la página web que se mostrará en las páginas de administración como. Puede ponerle algo como "Plataforma de Encuestas en línea de XYZ"
• $defaultuser: Usuario administrador por defecto.
• $defaultpass: Constraseña inicial del usuario administrador. No es necesario cambiar este parámetro cuando haya modificado dicha contraseña a través de
• $defaultlang: Este parámetro es el lenguaje por defecto que se utilizará en sus scripts de administración así como el que se tomará por defecto en las encuestas, pudiendo ser cambiado por los usuarios de la plataforma así como en cada encuesta. Por defecto el valor es 'en' (inglés), muy probablemente usted desee poner 'es' para el lenguaje español.

5.2 Parámetros de revisión Opcional (puede dejarlos tal y como están)

Los siguientes parámetros de ubicación funcionarán en una instalación normal de LimeSurvey, es decir, donde no se ha cambiado la estructura de directorios predefinida, por tanto no los cambie (excepto que haya renombrado o movido directorios).

• $homeurl: Ubicación URL de los scripts de administración. Estos scripts se encuentran por defecto en el directorio /limesurvey/admin. Este parámetro debe ser una dirección web, por ejemplo "http://www.midominio.com/limesurvey/html/admin". No añada una '/' al final!.
• $publicurl: Ubicación URL de los scripts públicos. Estos suelen encontrarse directamente en el directorio 'limesurvey' tal como aparece después de descomprimir el paquete de LimeSurvey.
• $tempurl: Ubicación URL del directorio de almacenamiento temporal, habitualmente "tmp" dentro del directorio "limesurvey", o bien un directorio donde LimeSurvey a través del servidor web pueda almacenar ficheros temporales. Recuerde que este directorio debe tener los permisos adecuados para que el servidor web pueda escribir en él.
• $imagefiles: Ubicación URL de los archivos de imágenes
• $homedir: Ruta en el disco duro a los scripts de administración (recuerde no poner la '/' al final).
• $tempdir: Idem para el directorio de archivos temporales
• $publicdir: Idem para los scripts públicos
• $scriptname: Deje este parámetro como "admin.php" salvo que usted haya cambiado el nombre del script principal de administración.

A continuación se presentan otros parámetros de ajuste del funcionamiento interno de LimeSurvey.

• $accesscontrol: Ponga este parámetro a 1 para controlar el acceso a la administración mediante usuario/contraseña, 0 para desactivarlo. Este parámetro es obsoleto a partir de la versión 1.52 de LimeSurvey (quien querría acceso irrestricto a la sección de administración?)
• $lwcdropdowns: Esta variable puede ser "L" o "R". En las preguntas de tipo 'Lista con comentarios', las opciones posibles se presentaran como botones radiales si es "R" o bien como una lista desplegable si es "L".
• $dropdownthreshold: Máximo número de opciones para que una pregunta de tipo lista de botones radiales se convierta en una lista desplegable. Si usted tiene una pregunta que plantea muchas opciones de respuesta, mostrar todas las opciones como botones radiales sería muy poco práctico y es más conveniente mostrarlas como una lista desplegable. El valor por defecto es 25.
• $repeatheadings: En las preguntas de tipo matriz a menudo se evalúan muchos conceptos, los cuales (a la hora de mostrarlos en la página web) ocupan más del alto de la pantalla. Este parámetro define cada cuantas opciones se repetirá la fila de encabezamiento de la matriz. Un valor adecuado para esta opción es 15, pero si desea anular por completo esta opción de repetición de encabezado, póngalo a 0.
• $minrepeatheadings: Como complemento al parámetro anterior, número mínimo de respuestas restantes requeridas para que se repita el encabezado (a fin de no repetir el encabezado cuando quedan muy pocas filas en la matriz).
• $timeadjust: Si su servidor está en un huso horario distinto a la ubicación donde se van a plantear las encuestas, introduzca acá la diferencia en horas entre ambos. Por ejemplo, si usted tuviera el servidor en Centroamérica y las encuestas estuvieran dirigidas a público en España, el servidor estaría ubicado 8 horas menos que la hora en la península ibérica, por lo que colocaría en este parámetro el valor "8". El sentido de este parámetro es el de asignar correctamente el día y la hora en la que una encuesta es finalizada y marcada temporalmente.
• $allowmandbackwards: El valor 1 en esta variable permite a los/as participantes volver atrás en el cuestionario aunque no hayan respondido a una pregunta obligatoria. Si tiene el valor 0, deberán responder a todas las preguntas obligatorias en la página antes de poder retroceder.
• $deletenonvalues: LimeSurvey tiene la virtud de hacer aparecer/desaparecer preguntas según las respuestas de preguntas realizadas anteriormente (preguntas condicionadas). Una vez que un encuestado responde una pregunta condicionada y posteriormente cambia de opinión y cambia la respuesta de la pregunta que la hizo aparecer, LimeSurvey puede recordar o no el valor de la pregunta que ahora está oculta. Si esta variable tiene el valor 0, la respuesta a la pregunta oculta se guardará con las demás respuestas (violando de algún modo la lógica del cuestionario, pero salvando información que quizá pudiera ser interesante), por el contrario, si tiene el valor 1, las respuestas guardadas del cuestionario serán fieles a las condiciones impuestas, y las respuestas a preguntas condicionadas que hayan sido ocultadas se eliminarán.
• $shownoanswer: Cuando una pregunta que presenta diferentes opciones de respuesta (es decir, listas, opción múltiple o matrices) no es obligatoria, el valor 1 hará que se presente una opción "No disponible" (seleccionada por defecto), mientras que el valor 0 simplemente dejará a el/la encuestado/a la posibilidad de no marcar respuesta alguna.
• $debug: Con este parámetro se configura el nivel de exposición de errores de PHP al valor "E_ALL", lo que implica que cualquier defecto de programación en los scripts se muestren. Esta configuración sólo debería ponerse al valor 1 si está usted realizando algún tipo de pruebas o trazado de las aplicaciones. No aconsejamos que lo active cuando tenga un sistema en producción, porque ello podría exponer información sobre ubicación de las rutas de los scripts y otros datos que podrían suponer cierta vulnerabilidad, es por ello que este parámetro tiene como valor por defecto 0.
• $translationmode: Si el idioma seleccionado para la interfaz no están funcionando correctamente (es decir, siempre sale en inglés aunque se haya seleccionado otro idioma), esto puede deberse a un error que tienen algunas versiones de PHP. Ponga este parámetro a 1 para activar una solución a este problema (esta opción apareció en la versión 1.52).
• $sessionlifetime: Este parámetro establece cuantos segundos pueden permanecer inactivas las personas encuestadas (es decir, sin cambiar de página) antes de que su sesión expire y los datos de la página se pierdan. Por defecto el valor es 3600 segundos (1 hora).
• $stripQueryFromRefurl: Este parámetro determina si la dirección de la página en el navegador que se puede guardar como página referente de la encuesta contendrá todos los parámetros o no (es decir, la página desde donde se accedió al cuestionario). Por defecto el valor es "false" (lo que implica que sí se guardan los parámetros). Si se establece como "true" se eliminarán de la antedicha URL todos los parámetros.
• $embedded: Si usted desea integrar LimeSurvey dentro de otra página (por ejemplo en un sistema gestor de contenidos o CMS), puede deshabilitarse el envío de las cabeceras HTML y apuntar a funciones o cabeceras diferentes.

5.3 Configuración del correo electrónico

• $siteadminemail: Dirección de email de la persona administradora de la plataforma, se usará para mensajes del sistema y como dirección de contacto de la plataforma en general.
• $siteadminname: Nombre real o puesto institucional de la persona administradora.
• $emailmethod: Mecanismo de envío de correo electrónico. Están disponibles las siguientes opciones:
  • mail: usará PHP mailer
  • sendmail: usará mecanismos de tipo sendmail
  • smtp: usará una repetidor SMTP (relay)
• $emailsmtphost: Si configuró 'smtp' como $emailmethod entonces deberá especificar el nombre del servidor que enviará los correos electrónicos (SMTP)
• $emailsmtpuser: si su servidor SMTP necesita autentificación para el envío de correos, introduzca acá su nombre de usuario, en otro caso déjelo en blanco.
• $emailsmtppassword: al igual que el anterior, escriba la contraseña del usuario antedicho o bien déjela en blanco.
• $maxemails: Cuando se envían invitaciones o recordatorios masivos a las personas participantes en una encuesta, a fin de no sobrepasar el tiempo máximo de respuesta permitido para un script de PHP (configurado habitualmente a 30 segundos), es posible limitar el número de correos enviados a la vez (que para 30 segundos suele ser de unos 100 correos). Si se excede este tiempo de respuesta, el script de envío de correos expirará y causará errores. Si esto sucediera se debe reducir este número.

5.4 Ajustes de las herramientas de producción de estadísticas y visualización de respuestas

• $usejpgraph: La librería JPGraph permite que en la elaboración de estadísticas sobre los resultados de una encuesta se muestren bonitas gráficas de pastel (preguntas de respuesta única) o de barras (respuesta múltiple). Si dispone de JPgraph instalado en su servidor y desea que éste sea utilizado ponga este parámetro a 1, o déjelo en 0 para desactivarlo. Si usted desea instalar JPgraph por su cuenta preste atención a que PHP4 necesita una versión de JPgraph distinta a la de PHP5.
• $jpgraphdir: La ruta en el disco duro de los scripts de JPgraph (el directorio que contiene el archivo llamado jpgraph.php)
• $jpgraphfont: La fuente de letra que se usará en las gráficas. La opción por defecto es "FF_FONT1", la cual funciona sin configuración adicional, sin embargo esta fuente de tipo fijo no soporta tildes, eñes, etc., por lo que en ese caso debería especificar una fuente de letra TrueType y configurar adecuadamente JPgraph para que utilice dicha fuente.
• $filterout_incomplete_answers: Ponga el valor a 'true' si usted desea que LimeSurvey no tome en cuenta las respuestas incompletas (es decir, las guardadas por los encuestados y pendientes de conclusión) en la revisión y análisis de respuestas. Estas respuestas incompletas son obviamente separadas de las completas para no introducir inconsistencias en las estadísticas, sin embargo existe la posibilidad de incluirlas en los reportes y este parámetro ajusta cuál será la opción por defecto.

5.5 Configuración de LDAP

Actualmente el uso de consultas a un servidor de directorio de identidades (LDAP) es usada para importar población encuestada, pero es posible que en el futuro sea ampliada para que la autentificación del acceso a la plataforma se pueda realicar mediante este tipo de consultas. Para ello necesitará habilitarlo en el parámetro $enableLdap del archivo config.php (poniéndolo a true) y configurar adecuadamente lo indicado en el archivo config-ldap.php.
Si desea más información consulte Ajustes de LDAP

6. Suba los archivos a su servidor web

Si usted hizo todo lo anterior directamente en el servidor no es necesario este paso, sin embargo si usted realizó la descompresión y ajustes en su computadora local, en este momento debería usar un cliente de transferencia de archivos a su servidor (FTP o SCP) para conectarse al servidor y trasladar todos los archivos y directorios.

7. Ejecute el script de instalación

En su navegador indique que desea visualizar la página "http://your.domain.com/limesurvey/admin/install". Si configuró correctamente todos los parámetros relativos a la conexión con el servidor de base de datos se le preguntará si desea crear la base de datos y/o crear las tablas de LimeSurvey dentro de la base de datos especificada. Hágalo!. Después de ello, el script le anunciará que ha creado la estructura de tablas exitosamente, y entonces será necesario (por motivos de seguridad) que renombre o elimine el directorio limesurvey/admin/install.
If you configured everything correctly you will be asked to create the database and/or create the tables inside the database. Do it. After you are done and the script tells you that it successfully created the tables, rename or delete the /install directory.

8. Acceda a la plataforma por primera vez

Después de los pasos antedichos, todo está listo para que acceda a la plataforma desde su navegador. Para ello indique en su navegador que desea visitar la página web que contiene el script de administración, si hizo una instalación estándar esta dirección será algo similar a "http://midominio.com/limesurvey/admin/admin.php". Aparecerá una pantalla solicitándole su usuario y contraseña, que tendrán como nombre y usuario los que usted indicó por defecto en el archivo config.php, credenciales que habitualmente son:


Recuerde cambiar la contraseña por defecto cuando usted acceda por primera vez

9. Qué puede hacer si tiene problemas...

Como en cualquier aplicación informática, en la mayoría de ocasiones las cosas sucederán tal como está previsto en las instrucciones, pero en otras ocasiones no, y hay demasiadas particularidades que no se ajustan a lo explicado anteriormente. Si usted tiene problemas en primer lugar puede consultar las Installation FAQ, y si no encuentra respuesta allí podría revisar si su circunstancia ha sido ya experimentada y quizá solucionada por otras personas en los foros de LimeSurvey en limesurvey.org, pudiendo opinar y/o remitir nuevas problemáticas para que pueda ser ayudado.

También le sugerimos que se una a la conversación que se mantiene en el Canal de IRC de LimeSurvey en Freenode: #limesurvey

---