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

De SIU
Saltar a: navegación, buscar
 
(No se muestran 24 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:
−
<br>
 
−
[[SIU-Tehuelche/version_4.0 | < Volver]]
 
−
 
−
 
 
== Pre-requisitos para instalar ==
 
== Pre-requisitos para instalar ==
−
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
−
* composer
+
* Composer
−
* git
+
* Git
  
 
== Pasos de instalación ==
 
== Pasos de instalación ==
 
Para llevar a cabo la instalación se debe seguir cuidadosamente la siguiente serie de pasos.
 
Para llevar a cabo la instalación se debe seguir cuidadosamente la siguiente serie de pasos.
  
−
# Realizar el clone con git (Para la wiki cambiar el link al que usan los usuarios, que debería ser en el server mirror)
+
1) Copiar el código fuente desde el respositorio. Para esto utilizamos el comando ''clone'' de Git de las siguiente manera:
−
git clone https://gitlab.siu.edu.ar/siu/tehuelche.git
+
<br />
−
git clone -b release/4.0.0 https://gitlab.siu.edu.ar/siu/tehuelche.git
+
<source lang="php" enclose="div" style="font-style: italic;">
 +
git clone --branch 4.0.0 https://hub.siu.edu.ar/siu/tehuelche.git
 +
</source>
 +
<br />
  
−
# Correr la instalación de composer
+
2) Realizar la instalación de dependencias mediante Composer:
 +
<br />
 +
<source lang="php" enclose="div" style="font-style: italic;">
 
composer install
 
composer install
 +
</source>
 +
<br />
 +
 +
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.
 +
<br />
 +
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.
 +
<br />
 +
 +
4) Correr el instalador del proyecto. Para esto ejecutamos el siguiente comando:
 +
<br />
 +
<source lang="php" enclose="div" style="font-style: italic;">
 +
bin/instalador proyecto:instalar
 +
</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 />
 +
 +
 +
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.
 +
<br />
 +
 +
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):
 +
<br />
 +
<source lang="php" enclose="div" style="font-style: italic;">
 +
sudo ln -s /ruta_a_la_instalacion/instalacion/toba.conf /etc/apache2/sites-enabled/tehuelche.conf
 +
</source>
 +
<br />
 +
 +
7) Ejecutar un comando de copiado. Simplemente correr el siguiente comando (dentro de la raíz de la instalación):
 +
<br />
 +
<source lang="php" enclose="div" style="font-style: italic;">
 +
cp www/img/iso_tehuelche.png www/siu/manejador_salida_bootstrap/img/logo-iso.png
 +
</source>
 +
<br />
 +
 +
8) Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:
 +
<br />
 +
<source lang="php" enclose="div" style="font-style: italic;">
 +
sudo bin/instalador permisos:simple
 +
</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 />
 +
 +
10) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:
 +
<br />
 +
<source lang="php" enclose="div" style="font-style: italic;">
 +
sudo service apache2 reload
 +
</source>
 +
<br />
 +
 +
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:
 +
<source lang="php" enclose="div" style="font-style: italic;">
 +
bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
 +
</source>
 +
 +
<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>
 +
[[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

Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Tehuelche/version_4.0/instalacion&oldid=69005»