'''Instructivo para poner en producción Guarani 3W en las facultades'''

Respetar el siguiente orden para poner en producción:

'''1. Descarga del sitio'''

Hacer un svn checkout en el servidor web desde la dirección [http://svncdc.unsa.edu.ar/svn/siu_guarani/unsa/3w/versiones/2.x.x.x]

'''2. Permisos en el sitio'''

'''IMPORTANTE:''' Todo el sitio debe tener como dueño al usuario www-data con sus correspondientes permisos. 

Darle permisos a las siguientes carpetas para que el usuario Apache puede escribir:

 * instalacion/log
 * instalacion/cache
 * instalacion/temp
 * instalacion/operaciones_inactivas
 * src/siu/www/js/escalas/

'''3. Editar archivos de configuración'''

Armar los archivos de configuración a partir de los templates. Dentro de la carpeta instalación:

Compararlos con los archivos de configuración de la versión anterior instalada, e ir editando los de la nueva versión


{{{
/home/<USUARIO>/proyectos/guarani2/3w/versiones/2.9.x.0/instalacion$ cp alias_template.conf alias.conf
/home/<USUARIO>/proyectos/guarani2/3w/versiones/2.9.x.0/instalacion$ cp config_template.php config.php
/home/<USUARIO>/proyectos/guarani2/3w/versiones/2.9.x.0/instalacion$ cp login_template.php login.php
/home/<USUARIO>/proyectos/guarani2/3w/versiones/2.9.x.0/instalacion$ cp servicios_web_config_template.php servicios_web_config.php
}}}

'''4. Editar los archivos para backup de logs y envio de emails'''

 * Editar los siguientes archivos, con referencia al nuevo directorio donde esta la aplicación 


{{{
/home/<USUARIO>/proyectos/guarani2/3w/versiones/2.9.x.0/bin/backup.sh
/home/<USUARIO>/proyectos/guarani2/3w/versiones/2.9.x.0/bin/enviar_mails.sh
/home/<USUARIO>/proyectos/guarani2/3w/versiones/2.9.x.0/bin/importar_fotos.sh
}}}


 * Editar la tarea de www-data, crontab -e, con referencia al nuevo directorio en las tareas. 


{{{
#Backup de logs de g3w
0 3 * * * /var/www/guarani3w/2.9.x.0/bin/./backup.sh
#Envio de mails
0 12 * * *  /var/www/guarani3w/2.9.x.0/bin/enviar_mails.sh
0 23 * * *  /var/www/guarani3w/2.9.x.0/bin/enviar_mails.sh
#Sincronizar/Importar fotos
0 1 * * *  /var/www/guarani3w/2.9.x.0/bin/importar_fotos.sh

}}}



'''5. Configurar el servidor web'''

Incluir el archivo instalacion/alias.conf en la configuración del servidor web:


{{{
ln -s /usr/local/proyectos/guarani2/3w/versiones/2.9.x.0/instalacion/alias.conf /etc/apache2/sites-enabled/g3w2_29x.conf 
(cambiar el nombre del archivo, antes hacer unlink del archivo de la versión anterior)
}}}


''' 6. Generar Escalas'''

En el directorio raíz del proyecto, entrar a /bin y ejecutar:


{{{
./guarani generar_escalas_js [bloque_acceso del config.php]
}}}

'''Con este comando se crea el archivo ''cond_res.js'' en ''\src\siu\www\js\escalas\carpeta con nombre de la unidad academica'''''


''' 7. Compilar recursos'''

    1. Compilar recursos javascript y css

   
{{{
 guarani compilar_recursos
}}}


    Este comando reune todos los recursos js y css del proyecto, los minimiza y los ubica en la carpeta /usr/local/proyectos/guarani2/3w/versiones/2.8.3/src/siu/www/_comp.''' Con este comando se CREA la carpeta _comp.''' Si se desea servir los recursos desde otro lugar hay que pasarle la ruta como el segundo parametro al comando. Después hay que modificar config.php para indicar la url de los recursos.
   
    2. Chequear que apache pueda escribir en las carpetas 

    /usr/local/proyectos/guarani2/3w/versiones/2.9.x.0/instalacion/temp : En este directorio se guarda la cache de los templates twig del sistema.Al compilar recursos la carpeta esta vacia, se generan los templates con el acceso y uso del sistema.
    /usr/local/proyectos/guarani2/3w/versiones/2.9.x.0/src/siu/www/_comp 

    
    3. Cambiar permisos a la carpeta que contiene las escalas de notas. Esta carpeta se crea luego de compilar recursos

    El archivo ''''cond_res.js''' de la carpeta '''\src\siu\www\js\escalas\carpeta con nombre de la unidad academica''' (creada en el punto anterior) se copia a '''src\siu\www\_comp\siu\js\escalas\carpeta con nombre de la unidad academica''' junto con los recursos ya compilados.

   La carpeta se encuentra en:


{{{
path proyecto/src/siu/www/_comp/siu/js/escalas/carpeta con nombre de la unidad academica
}}}


 A fin de evitar consultas a la base y mejorar la performance, con el comando generar_escalas_js se bajan las escalas de notas a un archivo js y se usa en la validación del ingreso de notas en las actas desde el 3w (docente). este archivo debe compilarse para poder usarse en modo producción (así como todos los js). Por este motivo se debe respetar ese orden:

1) generar_escalas_js [[BR]]

2) compilar_recursos
 [[BR]]

    4. Activar el modo producción en config.php.

   
{{{
 produccion: true
}}}

[[BR]]

'''8. Importar fotos'''

 * Editar en '''config.php''' la entrada ''''imagen_alumno_dir'''' => '/var/www/guarani3w/trunk/2.9.x.0/src/siu/www/_comp/_img_alumnos', se debe indicar el path de la aplicación 

 * Editar en '''config.php''' la entrada ''''imagen_alumno_url'''' => '​http://170.210.203.67/ecodes93/_comp/_img_alumnos', se debe indicar la ip del servidor web. 

 * Correr el siguiente comando en pathG3w/bin '''./guarani importar_fotos [bloque_acceso]''', finalizado el proceso verificar si se creo la carpeta '''_img_alumnos''' en '''src/siu/www/_comp''', darle permiso de escritura y lectua a www-data. 
[[BR]]


''' 9. Migrar claves al nuevo esquema de encriptación''' Si no se migró las claves en versiones anterior (2.8.2 o 2.8.3) se debe hacer.

Una vez finalizada la configuración se deben migrar las claves al nuevo esquema de encriptación:

Ejecutar:


{{{
/var/www/unsa/3w/trunk/2.9.x.0/bin$ ./guarani migrar_claves des01
}}}

Donde des01 es el ID del bloque de acceso para migrar las claves

'''IMPORTANTE:''' Para poder migrar las claves sin que se corte el proceso, se debe aumentar el tamaño de memoria de la máquina virtual que aloja el sitio.
[[BR]]
[[BR]]