README_XAMPP

Instrucciones para instalar AgilityContest en Windows 7 o superior con XAMPP
===================================================================================

Estas instrucciones asumen la instalación en un Pendrive conectado como disco F:
No obstante son aplicables a cualquier unidad, incluído el disco duro local C:\
sin más que substituir F: por la letra correcta

- Se necesita Windows 7 o superior
- Al menos 2GB de espacio en disco disponible
- En caso de usar un pendrive, este deberá estar formateado en FAT32 o NTFS

1- Descarga y preparación del software

- Comprobar que el disco donde se va a instalar la aplicación ( asumimos F:) está conectadò

- Descargar la versión .zip de portable-xampp y descomprimirla en el directorio raíz del disco destino
http://sourceforge.net/projects/xampp/files/XAMPP%20Windows/5.6.3/xampp-portable-win32-5.6.3-0-VC11.zip/download

- Descargar desde github la última version de AgilityContest en formato .zip
https://github.com/jonsito/AgilityContest/archive/master.zip

- Descomprimir el fichero .zip en el directorio raiz del disco de instalacion (F:\)

2- Instalacion y configuración 

- Asumimos que el disco de instalación será el F: En caso negativo, substituir esta letra por la correcta en el resto de las instrucciones

- Copiar el fichero F:\AgilityContest-master\agility\extras\AgilityContest_xampp.conf
  al directorio F:\xampp\apache\conf\extra\AgilityContest_xampp.conf

- Editar con "wordpad" el fichero de configuracion de mysql F:\xampp\mysql\bin\my.ini
  * donde pone: ( o al final del fichero, si esta linea no aparece )

  key_buffer  = 16M

  * debe poner:

  key_buffer_size = 16M
  explicit_defaults_for_timestamp = 1

- Editar con "wordpad" el fichero F:\xampp\apache\conf\httpd.conf y añadir al final del fichero las lineas:

  <IfModule mpm_winnt_module>
    ThreadStackSize 8388608
  </IfModule>
  Include "conf/extra/AgilityContest_xampp.conf"
  
- Activar la extensión "php_openssl.dll" de manejo de funciones de cifrado en php.
  Para ello hay que editar con "wordpad" el fichero F:\xampp\php\php.ini:
  * donde pone:
  ; extension=php_openssl.dll
  * debe poner:
  extension=php_openssl.dll

- Del mismo modo comprobar que las extensiones "php_gettext.dll" y ""php_curl.dll" estan activadas

- 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 portableapps abrir una shell e invocar el interprete de mysql
  para instalar la base de datos y los usuarios de la aplicacion
  
F:\xampp\mysql\bin\mysql.exe -u root
  DROP DATABASE IF EXISTS agility;
  CREATE DATABASE agility;
  USE agility;
  source F:\AgilityContest-master\extras\agility.sql
  source F:\AgilityContest-master\extras\users.sql
  quit

- Abrir la página "http://localhost/agility" desde el navegador para comprobar que todo funciona

3- Uso diario
- Insertar el pendrive
- Arrancar xampp control-panel
- Comprobar que Apache y MySQL estan arrancados y funcionando
- Abrir el navegador en la pagina http://localhost/agility

4- Consideraciones sobre el Firewall y el uso de 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 "jsonp" sobre HTTPS. Esto puede ocasionar algunos problemas en sistemas windows con una configuración de firewall excesivamente restrictiva

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