G3w3 – Instalación desde cero
Descripción de los pasos:
1 Requisitos
• Solicitar al SIU una URL específica para la institución, dentro de colab. Realizar la solicitud mediante un GDS.
• Extensiones PHP:
php_apc,
mbstring,
php_mcrypt
• Módulos de Apache:
rewrite_module,
setenvif_module
2 Instalación de la versión 3.8.0
2.1 Creación de carpeta
Crear una carpeta en la ubicación deseada, por ejemplo:
/usr/local/proyectos/g3w3 en entornos Linux ó C:\proyectos\g3w3 en entornos Windows
2.2 Descarga del proyecto
- Efectuar un svn checkout desde la URL correspondiente en Colab. Ejemplo con la carpeta creada para uba-fcen:
https://colab.siu.edu.ar/svn/guarani3/nodos/uba-fcen/3w/trunk/3.8.0
- Darle permisos a las siguientes carpetas para que el usuario apache puede escribir
- instalacion/log
- instalacion/cache
- instalacion/temp
- src/siu/www/js/escalas/
2.3 Configurar el proyecto
Crear el archivo instalacion/config.php tomando como base el template instalacion/config_template.php.
Editar el archivo instalacion/config.php y modificar:
• La entrada “ini_debug”, colocando el valor ‘false’.
• La/s entrada/s de la sección “accesos”, donde se definen el/los punto/s de acceso a la aplicación.
Debe haber al menos uno y tener correctamente configurada la conexión a la base de datos.
Ejemplo:
'accesos' => array(
'des01' => array(
'ua' => 5, (institución dueña de la instalación)
'personalizacion' => NULL,
'database' => array(
'vendor' => 'pgsql',
'dbname' => 'guarani_3_0',
'schema' => 'public',
'host' => 'localhost',
'port' => '5432',
'pdo_user' => 'postgres',
'pdo_passwd' => 'postgres')))
2.4 Editar alias
Crear el archivo instalacion/alias.conf tomando como base el template instalacion/alias_template.conf.
Editar el archivo instalacion/alias.conf y definir:
- El/los alias (uno por unidad académica).
Ejemplo:
Alias /humanidades "/usr/local/proyectos/g3w3/src/siu/www"
- La sección “Directory”.
Ejemplo:
<Directory "/usr/local/proyectos/g3w3/src/siu/www"> Options FollowSymLinks DirectoryIndex index.php Order allow,deny Allow from all AddDefaultCharset ISO-8859-1 Include /usr/local/proyectos/g3w3/instalacion/rewrite.conf </Directory>
- La sección “Location”.
Ejemplo:
<Location ~ "/humanidades/*"> SetEnv ACC_ID des01 SetEnvIf always_match ^ ACC_ALIAS=/humanidades </Location>
2.5 Configurar el servidor web
Incluir el archivo instalacion/alias.conf en la configuración del servidor web:
• En entornos Windows, editar el archivo
'<path instalación Apache>\Apache2\conf\httpd.conf'
agregando la siguiente directiva:
Include C:/proyectos/g3w3/instalacion/alias.conf
• En entornos Linux, ejecutar el siguiente comando como superusuario para realizar el link simbólico a la instalación:
ln -s /usr/local/proyectos/g3w3/instalacion/alias.conf /etc/apache2/sites-enabled/g3w3.conf
Reiniciar el servidor web y verificar el acceso al alias configurado, por ejemplo: http://localhost/humanidades.
2.6 Verificar la aplicación
Realizar un test de conexión a la base de datos:
/usr/local/proyectos/guarani/g3w3/bin# ./guarani test_conexion
Finalmente reiniciar apache.
3 Pasaje a Producción
Para poner el sistema en modo producción hay que ejecutar los siguientes pasos. Durante todo este documento se asume que el archivo /path/to/projects/g3w3/bin/guarani se encuentra en el path.
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 /path/to/projects/g3w3/src/siu/www/_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.yml para indicar la url de los recursos. Chequear que apache pueda escribir en la carpeta /path/to/projects/g3w3/instalacion/temp. En este directorio se guarda la cache de los templates twig del sistema. Activar el modo producción en config.php.
produccion: true
