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

De SIU
Saltar a: navegación, buscar
 
 
(No se muestran 4 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
 
== 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 2.4
−
* PHP mayor o igual a 7.3
+
* PHP >= 7.3 y < 8
−
* Postgres 13
+
* PostgreSQL 13
 
* Yarn
 
* Yarn
−
* Composer 1.x.x
+
* Composer
 
* Git
 
* Git
  
Línea 11: Línea 11:
 
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.
  
−
1) Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, si por ejemplo nuestra ruta al proyecto tehuelche es '''/siu/tehuelche''', vamos a crear allí dentro la carpeta para la nueva instalación, obteniendo en este caso '''/siu/tehuelche/4.3.0'''.
+
1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, si por ejemplo nuestra ruta al proyecto tehuelche es '''/siu/tehuelche''', vamos a crear allí dentro la carpeta para la nueva instalación, obteniendo en este caso '''/siu/tehuelche/4.3.0'''. Luego, debemos clonar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de la siguiente manera:
−
Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:
 
  
−
<br />
 
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
 
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .
 
git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .
 
</source>
 
</source>
−
<br />
 
  
−
2) Realizar la instalación de dependencias mediante Composer, para ello desde la raíz ejecutar:
+
2. Realizar la instalación de dependencias mediante Composer, para ello desde la raíz ejecutar:
−
<br />
+
 
 
<source lang="php" enclose="div" style="font-style: italic;">
 
<source lang="php" enclose="div" style="font-style: italic;">
−
composer install
+
composer install --no-dev
 
</source>
 
</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.
+
3. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando:
 +
 
 +
cp -a instalador.env.dist instalador.env
 +
 
 +
4. Configurar archivo '''instalador.env'''
 +
 
 +
Configurar el archivo instalador.env con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador se debe configurar para que la base de datos de negocio de Tehuelche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto).
 +
 
 +
###### CONFIG DE TOBA ######<br /><br />
 +
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br />
 +
TOBA_USUARIO="<usuario admin inicial>"<br />
 +
TOBA_PASSWORD="<contraseña para el usuario admin>"<br />
 +
TOBA_ALIAS_PROYECTO="<alias de acceso a Tehuelche>"<br />
 +
TOBA_ALIAS_NUCLEO="<alias para toba>"<br />
 +
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"
 +
 
 +
'''Sólo a modo de ejemplo:'''
 +
 
 +
###### CONFIG DE TOBA ######<br /><br />
 +
TOBA_URL_BASE="<nowiki>http://localhost</nowiki>"<br />
 +
TOBA_USUARIO="toba"<br />
 +
TOBA_PASSWORD="toba1234"<br />
 +
TOBA_ALIAS_PROYECTO="/siu/tehuelche"<br />
 +
TOBA_ALIAS_NUCLEO="/siu/toba/tehuelche"<br />
 +
TOBA_ALIAS_TOBA_USUARIOS="/siu/toba_usuarios/tehuelche"
 +
 
 +
7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
 +
 
 +
chmod +x bin/instalador
 +
 
 +
8. Ejecutar el instalador de la siguiente manera:
  
 +
./bin/instalador proyecto:instalar
  
−
Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:
+
9. Revisar el archivo '''instalador.log''' para verificar que el proceso haya culminado con éxito. Si se quiere seguir el log del proceso de instalación, en otra terminal ejecutar:
−
* 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:
+
tail -f instalador.log
−
<br />
+
 
−
<source lang="php" enclose="div" style="font-style: italic;">
+
10. Seguir las instrucciones que brinda el instalador para:
−
bin/instalador proyecto:instalar
+
 
−
</source>
+
* Acomodar permisos de archivos y direcotorios
−
<br />
+
 
 +
sudo ./bin/instalador permisos:simple
  
−
5) Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos
+
* Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)
−
* Es muy probable que haya configuraciones del archivo ''/etc/php/<versión PHP>/cli/php.ini'' que nos informe el instalador que debemos modificar.
+
* Quitar el modo mantenimiento del proyecto
−
<br />
 
  
−
6) Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:
+
  ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
−
<br />
 
−
<source lang="php" enclose="div" style="font-style: italic;">
 
−
sudo bin/instalador permisos:simple
 
−
</source>
 
−
<br />
 
  
−
7) 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):
+
11. Reiniciar el servidor web para que tome los nuevos cambios.
−
<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 />
 
  
−
8) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:
+
Para obtener mas ayuda sobre el comando de instalación ejecutar
−
<br />
 
−
<source lang="php" enclose="div" style="font-style: italic;">
 
−
sudo service apache2 reload
 
−
</source>
 
−
<br />
 
  
−
9) Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:
+
./bin/instalador proyecto:instalar -h
−
* 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 />10) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación '''instalador.env'''.
+
12. Importar desde SIU-Guaraní los datos pertenecientes a las propuestas formativas. Para ello realizar los siguientes pasos:
  
−
<br>
 
−
11) Importar desde SIU-Guaraní los datos pertenecientes a las propuestas formativas. Para ello realizar los siguientes pasos:
 
 
# [[SIU-Tehuelche/version_4.3/integracion | Vincular SIU-Tehuelche con SIU-Guaraní.]]
 
# [[SIU-Tehuelche/version_4.3/integracion | Vincular SIU-Tehuelche con SIU-Guaraní.]]
 
# Dirigirse a la operación Sincronizar Propuestas dentro del menú de Administración e importarlas.
 
# Dirigirse a la operación Sincronizar Propuestas dentro del menú de Administración e importarlas.

Revisión actual del 11:31 4 ene 2022

Pre-requisitos para instalar

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

  • Apache 2.4
  • PHP >= 7.3 y < 8
  • PostgreSQL 13
  • Yarn
  • Composer
  • Git

Pasos de instalación

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

1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, si por ejemplo nuestra ruta al proyecto tehuelche es /siu/tehuelche, vamos a crear allí dentro la carpeta para la nueva instalación, obteniendo en este caso /siu/tehuelche/4.3.0. Luego, debemos clonar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de la siguiente manera:

git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .

2. Realizar la instalación de dependencias mediante Composer, para ello desde la raíz ejecutar:

composer install --no-dev

3. Copiar el archivo instalador.env.dist y renombrar a instalador.env. En linux se puede utilizar el siguiente comando: 

cp -a instalador.env.dist instalador.env

4. Configurar archivo instalador.env

Configurar el archivo instalador.env con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador se debe configurar para que la base de datos de negocio de Tehuelche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto). 

###### CONFIG DE TOBA ######


TOBA_URL_BASE="http://localhost"

TOBA_USUARIO="<usuario admin inicial>"

TOBA_PASSWORD="<contraseña para el usuario admin>"

TOBA_ALIAS_PROYECTO="<alias de acceso a Tehuelche>"

TOBA_ALIAS_NUCLEO="<alias para toba>"

TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"

Sólo a modo de ejemplo: 

###### CONFIG DE TOBA ######


TOBA_URL_BASE="http://localhost"

TOBA_USUARIO="toba"

TOBA_PASSWORD="toba1234"

TOBA_ALIAS_PROYECTO="/siu/tehuelche"

TOBA_ALIAS_NUCLEO="/siu/toba/tehuelche"

TOBA_ALIAS_TOBA_USUARIOS="/siu/toba_usuarios/tehuelche"

7. El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar: 

chmod +x bin/instalador

8. Ejecutar el instalador de la siguiente manera: 

./bin/instalador proyecto:instalar

9. Revisar el archivo instalador.log para verificar que el proceso haya culminado con éxito. Si se quiere seguir el log del proceso de instalación, en otra terminal ejecutar: 

tail -f instalador.log

10. Seguir las instrucciones que brinda el instalador para:

  • Acomodar permisos de archivos y direcotorios
sudo ./bin/instalador permisos:simple
  • Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)
  • Quitar el modo mantenimiento del proyecto
 ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento

11. Reiniciar el servidor web para que tome los nuevos cambios.

Para obtener mas ayuda sobre el comando de instalación ejecutar 

./bin/instalador proyecto:instalar -h

12. Importar desde SIU-Guaraní los datos pertenecientes a las propuestas formativas. Para ello realizar los siguientes pasos:

  1. Vincular SIU-Tehuelche con SIU-Guaraní.
  2. Dirigirse a la operación Sincronizar Propuestas dentro del menú de Administración e importarlas.


< Volver

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