Skip to content

Instalacion

Jump to bottom Edit New page
Juan Antonio Martinez edited this page May 2, 2015 · 21 revisions

Table of Contents

Equipo Recomendado:

  • PC con procesador i3 o superior
  • Al menos 2Gb de Memoria
  • 2Gb libres en disco duro o pendrive
  • Sistemas Operativos:
    • Linux: Ubuntu 14.04 / Fedora 20 o superior
    • Windows: Windows 7 o superior
    • Mac: Mac OS X v10.8 "Mountain Lion" o superior

Consideraciones sobre el firewall, seguridad y uso de protocolo HTTPS

Si bien AgilityContest está pensado tanto para su uso con protocolo HTTP como HTTPS, por motivos de seguridad todo el proceso de envio de contraseñas se realiza con protocolo ajax y jsonp sobre HTTPS. Esto puede ocasionar algunos problemas en sistemas windows con una configuración de firewall excesivamente restrictiva. Por ello se recomienda desactivar el firewall de windows asociado a la red doméstica, o al menos permitir el acceso a los puertos 80 y 443

Para que el proceso de autenticación funcione correctamente es preciso que el navegador reconozca el certificado que el servidor apache provee por defecto. Para ello será preciso AL MENOS UNA VEZ acceder a la página en modo seguro en la dirección https://localhost/agility e instruir al navegador para que acepte de forma permanente el certificado

Instrucciones para instalar en un pen-drive bajo Windows XAMPP

Descarga e instalación del software

  • Preparar un pendrive de al menos 2Gb. ( recomendable 4Gb )
  • Insertar el pendrive, y comprobar que esta formateado (FAT32)
  • (Para aquellos que no tengan instalado xampp en el equipo) Descargar la versión .zip de portable-xampp y descomprimirla en el directorio raíz del pen-drive
http://sourceforge.net/projects/xampp/files/XAMPP%20Windows/5.6.3/xampp-portable-win32-5.6.3-0-VC11.zip/download

Instalacion y configuración

  • Asumimos que el pendrive se asigna al disco F: En caso negativo, substituir esta letra por la correcta en el resto de las instrucciones
  • Copiar el fichero F:\AgilityContest-<version>\extras\xampp_httpd.conf al fichero F:\xampp\apache\conf\extra\xampp_httpd.conf. (cambiar <version> por "1.2.2" o "master" )
  • Editar con "wordpad" el fichero F:\xampp\apache\conf\httpd.conf y añadir al final del fichero las líneas:
  &lt;IfModule mpm_winnt_module&gt;
    ThreadStackSize 8388608
  &lt;/IfModule&gt;
 Include 'conf/extra/xampp_httpd.conf'
Guardar el fichero en modo texto
  • Editar con "wordpad" el fichero F:\xampp\apache\conf\extras\xampp_httpd.conf y ajustar el nombre "AgilityContest-master" a la versión que hayamos descargado. ( cambiar en caso necesario "master" por "1.2.2" )
  • Editar con "WordPad" el fichero F:\xampp\php\php.ini, y descomentar (quitar el ';' inicial) la entrada que pone:
 extension=php_openssl.dll
Guardar igualmente el fichero en modo texto
  • Arrancar el panel de control de xampp (ejecutar F:\xampp\xampp-control.exe)
  • Verificar que los servicios "Apache" y "MySQL" estan correctamente arrancados
  • Desde el menú de inicio abrir un terminal (ejecutar cmd.exe) e invocar el interprete de mysql
para instalar la base de datos y los usuarios de la aplicacion. Substituír <version> por "master" o "1.2.2" según sea la versión que hayamos descargado 
 F:\xampp\mysql\bin\mysql.exe -u root
 mysql> drop database if exists agility;
 mysql> create database agility;
 mysql> use agility;
 mysql> source F:\AgilityContest-&lt;version&gt;\extras\agility.sql
 mysql> source F:\AgilityContest-&lt;version&gt;\extras\users.sql
 mysql> quit
  • Abrir la página "https://localhost/agility" desde el navegador para comprobar que todo funciona. Pulsar en el navegador la opción de "Aceptar el certificado de forma permanente"

Instrucciones para usuarios con Windows XAMPP pre-instalado en disco duro

En este caso no es preciso descargar ni instalar xampp, basta simplemente con descargar la última versión de AgilityContest desde Github y reemplazar la carpeta que contiene la versión anterior. Las únicas operaciones a realizar son:

  • comprobar -y en su caso actualizar- el fichero c:\xampp\apache\conf\extra\xampp_httpd.conf
  • En el caso de que la estructurade la base de datos haya cambiado (consultar el fichero Changelog), regenerar la base de datos siguiendo el procedimiento indicado para la instalación desde pen-drive

Uso diario en Windows

  • En el caso de instalación en disco USB
    • Insertar el pendrive
    • Arrancar F:\xampp\xampp-control.exe
    • Activar apache y mysql desde el panel de control de xampp
    • Abrir el navegador en la pagina https://localhost/agility
  • En el caso de instalación en disco duro
    • comprobar que xampp esta ejecutándose y tiene activados apache y mysql
    • Abrir el navegador en la pagina https://localhost/agility

Instrucciones para instalar AgilityContest en un sistema Linux

Requerimientos. Descarga y preparación del software

  • Tener instalados y funcionando
    • phpmyAdmin
    • apache >=2.4
    • MySQL >=5.5
    • mod_phpmysqlnd (modulo php_mysql con driver nativo)
  • Escoger un directorio ${BASE} de instalacion
  • Descargar desde github la version deseada "master" o "1.2.2" de AgilityContest en formato .zip
  • Escoger un directorio de instalación, al que denominaremos ${BASE}. Se recomiendan dos ubicaciones:
    • /var/www/html/AgilityContest-<version></version> si se instala ( como root ) en una carpeta del sistema
    • /home/${USER}/public_html/AgilityContest-<version></version> si se instala en un directorio de usuario
  • Descomprimir el fichero .zip en el directorio ${BASE}

Instalacion y configuración (ficheros)

  • Copiar el fichero ${BASE}/extras/linux_httpd.conf a /etc/httpd/conf.d/agility.conf
  • Editar el fichero ajustando los campos Alias y Directory
  • Reiniciar apache y comprobar que se accede a la pagina principal
  • En sistemas Fedora, y dependiendo de si se instala en un directorio bajo home, puede ser necesario ajustar SELinux
 root&amp;&#35;35&#59; setsebool &amp;&#35;45&#59;P httpd_enable_homedirs on
 root&amp;&#35;35&#59; setsebool &amp;&#35;45&#59;P httpd_read_user_content on
 root&amp;&#35;35&#59; chcon &amp;&#35;45&#59;Rv &amp;&#35;45&#59;&amp;&#35;45&#59;type&amp;&#35;61&#59;httpd_user_rw_content_t $&amp;&#35;123&#59;BASE&amp;&#35;125&#59;/agility/images/logos
 root&amp;&#35;35&#59; chcon &amp;&#35;45&#59;Rv &amp;&#35;45&#59;&amp;&#35;45&#59;type&amp;&#35;61&#59;httpd_user_rw_content_t $&amp;&#35;123&#59;BASE&amp;&#35;125&#59;/logs
 root&amp;&#35;35&#59; chcon &amp;&#35;45&#59;v &amp;&#35;45&#59;&amp;&#35;45&#59;type&amp;&#35;61&#59;httpd_user_rw_content_t $&amp;&#35;123&#59;BASE&amp;&#35;125&#59;/agility/server/auth/config.ini

Instalacion y configuracion (base de datos)

  • Ejecutar el interprete de comandos de mysql
 root&amp;&#35;35&#59; mysql &amp;&#35;45&#59;u root
 mysql&amp;gt&#59; drop database if exists agility&amp;&#35;59&#59;
 mysql&amp;gt&#59; create database agility&amp;&#35;59&#59;
 mysql&amp;gt&#59; use agility&amp;&#35;59&#59;
 mysql&amp;gt&#59; source $&amp;&#35;123&#59;BASE&amp;&#35;125&#59;/extras/agility.sql
 mysql&amp;gt&#59; source i$&amp;&#35;123&#59;BASE&amp;&#35;125&#59;/extras/users.sql
 mysql&amp;gt&#59; quit
  • Abrir la página "https://localhost/agility" desde el navegador para comprobar que todo funciona. Pulsar en el navegador la opción de "Aceptar el certificado de forma permanente"

Uso diario en Linux

  • Asegurarse que tanto Apache como el servidor mysql están en ejecución
  • Abrir la página "http://localhost/agility" desde el navegador.

Instrucciones específicas para sistemas Ubuntu

Los equipos con Ubuntu traen de serie un apache y un mysql con características "especiales" de segurida, que hace mucho más complicada su instalación. A continuación se describe una sesión de consola con el procedimiento completo para instalar AgilityContest en un sistema Ubuntu-Gnome recién instalado y actualizado:

Instalacion en Ubuntu 14.04

Add a custom footer
Add a custom sidebar
Clone this wiki locally