Diferencia entre revisiones de «SIU-Tehuelche/version 4.0/instalacion»

De SIU
Saltar a: navegación, buscar
 
(No se muestran 7 ediciones intermedias de 2 usuarios)
Línea 2: Línea 2:
 
Para instalar SIU-Tehuelche es necesario contar con los siguientes requisitos:
 
Para instalar SIU-Tehuelche es necesario contar con los siguientes requisitos:
 
* Apache
 
* Apache
* PHP 7.2
+
* PHP mayor o igual a 7.1  y menor que 7.3
 
* Postgres 9 o superior
 
* Postgres 9 o superior
 
* Yarn
 
* Yarn
Línea 14: Línea 14:
 
<br />
 
<br />
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
git clone -b 4.0.0 --single-branch https://hub.siu.edu.ar/siu/tehuelche.git
+
git clone --branch 4.0.0 https://hub.siu.edu.ar/siu/tehuelche.git
 
</source>
 
</source>
 
<br />
 
<br />
Línea 28: Línea 28:
 
<br />
 
<br />
 
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:
 
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:
* Configurar la variable '''PROYECTO_DB_DBNAME''' que contiene el nombre de la base de datos de negocio.
+
* Configurar la variable '''PROYECTO_DB_DBNAME,''' indicará el nombre de la base de datos de negocio.
* Configurar la variable '''BASE DE TOBA'''.
+
* Configurar la variable '''TOBA_DB_DBNAME,''' indicará el nombre de la base de datos de toba.
* Configurar el '''TOBA_ALIAS_PROYECTO'''.
+
* 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.
 
* 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.
 
* 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.
Línea 40: Línea 40:
 
bin/instalador proyecto:instalar
 
bin/instalador proyecto:instalar
 
</source>
 
</source>
 +
''Observación'': Durante la instalación, al finalizar el paso 4 (Instalar proyecto) puede suceder que arroje el siguiente mensaje de error:
 +
<source lang="php" enclose="div" style="font-style: italic;">
 +
[ERROR] No se pudo generar el autoload porque existen clases repetidas.
 +
</source>
 +
El mismo, no representa un error en sí mismo y es posible seguir adelante sin ningún problema.
 
<br />
 
<br />
 +
  
 
5) Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos
 
5) Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos
Línea 65: Línea 71:
 
sudo bin/instalador permisos:simple
 
sudo bin/instalador permisos:simple
 
</source>
 
</source>
 +
 +
<br />
 +
9) 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í.
 
<br />
 
<br />
  
9) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:
+
10) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:
 
<br />
 
<br />
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
Línea 74: Línea 84:
 
<br />
 
<br />
  
10) Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:
+
11) 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'''.
 
* 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:
 
* Otra opción es utilizar el siguiente comando del instalador:
<br />
 
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
 
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
 
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
 
</source>
 
</source>
<br />
 
 
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í.
 
<br />
 
 
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:
 
 
<br />
 
 
* Configurar el servicio rest guarani, dentro de '''i__produccion/p__tehuelche/rest/guarani/cliente.ini''' incorporando una nueva conexión.
 
<source lang="php" enclose="div" style="font-style: italic;">
 
[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
 
</source>
 
 
* Configurar el servicio rest kolla, dentro de '' i__produccion/p__tehuelche/rest/kolla/cliente.ini''' incorporando una nueva conexión.
 
<source lang="php" enclose="div" style="font-style: italic;">
 
[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
 
</source>
 
 
<br />
 
 
13) Configurar arhivos de tehuelche para que Guaraní pueda consumir la API REST provista por tehuelche. Para esto se deben configurar dos archivos:
 
 
<br />
 
 
* El archivo '''i__produccion/p__tehuelche/rest/servidor.ini'' debe configurarse con la autentificación deseada, por ejemplo:
 
<source lang="php" enclose="div" style="font-style: italic;">
 
autenticacion = digest
 
</source>
 
* 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
 
<source lang="php" enclose="div" style="font-style: italic;">
 
[nombre_usuario]
 
password = calve_del_usuario
 
</source>
 
 
<br />
 
  
14) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación '''instalador.env'''.
+
<br />12) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación '''instalador.env'''.
  
 
<br>
 
<br>
 
[[SIU-Tehuelche/version_4.0 | < Volver]]
 
[[SIU-Tehuelche/version_4.0 | < Volver]]

Revisión actual del 13:54 2 oct 2020

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 --branch 4.0.0 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

Observación: Durante la instalación, al finalizar el paso 4 (Instalar proyecto) puede suceder que arroje el siguiente mensaje de error:

[ERROR] No se pudo generar el autoload porque existen clases repetidas.

El mismo, no representa un error en sí mismo y es posible seguir adelante sin ningún problema.


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) 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í.


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

sudo service apache2 reload


11) 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


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


< Volver