SIU-Tehuelche/version 4.0/instalacion

Pre-requisitos para instalar

Para instalar SIU-Tehuelche es necesario contar con los siguientes requisitos:

• Apache
• PHP mayor o igual a 7.1 y menor que 7.3
• Postgres 9 o superior
• Yarn
• Composer
• Git

Pasos de instalación

Para llevar a cabo la instalación se debe seguir cuidadosamente la siguiente serie de pasos.

1) Copiar el código fuente desde el respositorio. Para esto utilizamos el comando clone de Git de las siguiente manera:

git clone -b 4.0.0 --single-branch https://hub.siu.edu.ar/siu/tehuelche.git

2) Realizar la instalación de dependencias mediante Composer:

composer install

3) Configurar el archivo de instalación. Dentro de la carpeta de instalación se encuentra el archivo instalador.env.dist. Debemos copiar este y renombrarlo como instalador.env. Una vez hecho esto, podemos editar este nuevo archivo de configuración, ingresando los valores que deseamos utilizar en la instalación.
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:

• Configurar la variable PROYECTO_DB_DBNAME, indicará el nombre de la base de datos de negocio.
• Configurar la variable TOBA_DB_DBNAME, indicará el nombre de la base de datos de toba.
• Configurar la variable TOBA_ALIAS_PROYECTO.
• Configurar el usuario TOBA_USUARIO y su respectiva contraseña mediante TOBA_PASSWORD. Con estos datos ingresaremos al sistema por primera vez.
• Es importante que en la variable PROYECTO_DB_SCHEMA este configurada con el valor tehuelche. Caso contrario fallará la carga inicial de datos en la instalación.

4) Correr el instalador del proyecto. Para esto ejecutamos el siguiente comando:

bin/instalador proyecto:instalar

5) Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos

• Es muy probable que haya configuraciones del archivo /etc/php/7.2/cli/php.ini que nos informe el instalador que debemos modificar.

6) Correr el comando para incorporar el link simbólico. El instalador indicará en pantalla un comando similar al siguiente, que deberemos ejecutar (notar que ruta_a_la_instalación dependerá de la instalación puntual realizada):

sudo ln -s /ruta_a_la_instalacion/instalacion/toba.conf /etc/apache2/sites-enabled/tehuelche.conf

7) Ejecutar un comando de copiado. Simplemente correr el siguiente comando (dentro de la raíz de la instalación):

cp www/img/iso_tehuelche.png www/siu/manejador_salida_bootstrap/img/logo-iso.png

8) Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:

sudo bin/instalador permisos:simple

9) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:

sudo service apache2 reload

10) Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:

• Es posible editar el archivo proyecto.ini y asignar cero a la variable modo_mantenimiento.
• Otra opción es utilizar el siguiente comando del instalador:

bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento

11) Cargar en la base de datos de tehuelche la información de tablas que dependen de la instalación de Guaraní utilizada. Para esto debemos ingresar a el contenido de las siguiente tabla (puede utilizar el software de administración de bases de datos postgres que usted desee):

• En la tabla sg_propuestas volcar el contenido de la tabla sga_propuestas de la instalación de Guaraní.

12) Configurar los servicios rest editando los archivos correspondientes o por medio de toba usuarios. Si desea editarlos de manera manual debe acceder al directorio i__produccion y editar los siguientes archivos de configuración:

• Configurar el servicio rest guarani, dentro de i__produccion/p__tehuelche/rest/guarani/cliente.ini incorporando una nueva conexión.

[conexion]
;Recuerde dejar una barra (/) al finalizar la URL
to = "http://dirección_a_servicio_rest_provisto_por_guarani/"
auth_tipo = tipo_de_autentificacion_utilizada
auth_usuario = nombre_usuario_rest
auth_password = contraseña_usuario_rest

• Configurar el servicio rest kolla, dentro de i__produccion/p__tehuelche/rest/kolla/cliente.ini' incorporando una nueva conexión.

[conexion]
;Recuerde dejar una barra (/) al finalizar la URL
to = "http://dirección_a_servicio_rest_provisto_por_kolla/"
auth_tipo = tipo_de_autentificacion_utilizada
auth_usuario = nombre_usuario_rest
auth_password = contraseña_usuario_rest

13) Configurar arhivos de tehuelche para que Guaraní pueda consumir la API REST provista por tehuelche. Para esto se deben configurar dos archivos:

• El archivo 'i__produccion/p__tehuelche/rest/servidor.ini debe configurarse con la autentificación deseada, por ejemplo:

autenticacion = digest

• El archivo i__produccion/p__tehuelche/rest/servidor_usuarios.ini debe configurarse con el usuario y password que debe utilizar el sistema que consuma la API REST

[nombre_usuario]
password = calve_del_usuario

14) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación instalador.env.

< Volver