<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="es">
		<id>https://documentacion.siu.edu.ar/wiki/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Ndominguez</id>
		<title>SIU - Contribuciones del usuario [es]</title>
		<link rel="self" type="application/atom+xml" href="https://documentacion.siu.edu.ar/wiki/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Ndominguez"/>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/Especial:Contribuciones/Ndominguez"/>
		<updated>2026-08-18T04:46:01Z</updated>
		<subtitle>Contribuciones del usuario</subtitle>
		<generator>MediaWiki 1.30.0</generator>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche&amp;diff=104926</id>
		<title>SIU-Mapuche</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche&amp;diff=104926"/>
				<updated>2025-01-31T15:01:15Z</updated>
		
		<summary type="html">&lt;p&gt;Ndominguez: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&lt;br /&gt;
[[Archivo:siu-mapuche.png|derecha|link=]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
SIU-Mapuche recoge toda la información de los RRHH de una institución en un Legajo Electrónico Único (sistema integrado), está diseñado para brindar al operador -ya sea al trabajador del área o al encargado de liquidaciones- todos los servicios necesarios para disminuir las posibilidades de error y hacer más sencillo su trabajo, teniendo en cuenta los cambios en la legislación laboral vigente.&lt;br /&gt;
&lt;br /&gt;
== Trabajemos juntos para poner en marcha el sistema ==&lt;br /&gt;
&lt;br /&gt;
La implementación del sistema es una etapa vital para asegurar su correcto funcionamiento a futuro, es el proceso que sienta las bases y, por lo tanto, requiere de una especial atención. Es muy importante que prestes atención a las recomendaciones y realices todas las consultas que consideres necesarias para asegurarte que vas en el camino correcto. Acá podes ver los distintos canales en los que podés interactuar con el equipo de implementación y demás miembros de la comunidad.&lt;br /&gt;
&lt;br /&gt;
== Primeros pasos... todo lo que tenés que saber para poner el sistema en marcha ==&lt;br /&gt;
&lt;br /&gt;
===== [https://documentacion.siu.edu.ar/wiki/C%C3%B3mo_obtener_el_Ecosistema_SIU Conformación del equipo de implementación] =====&lt;br /&gt;
&lt;br /&gt;
===== [http://www.siu.edu.ar/rd/institucional/Requerimientos_Equipamiento.pdf Requerimientos Mínimos de Equipamiento] =====&lt;br /&gt;
&lt;br /&gt;
===== [[SIU-Mapuche/Plan de implementacion|Plan de Implementación]] =====&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Documentación ==&lt;br /&gt;
'''[[SIU-Mapuche/version3.29.0|Versión 3.29.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.28.1|Versión 3.28.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.28.0|Versión 3.28.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.27.1|Versión 3.27.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.27.0|Versión 3.27.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.26.1|Versión 3.26.1]]'''&lt;br /&gt;
&lt;br /&gt;
===== [[SIU-Mapuche/Versiones Anteriores|Documentación versiones anteriores]] =====&lt;/div&gt;</summary>
		<author><name>Ndominguez</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.28.0/Documentacion_de_las_operaciones/impuestos_ganancias/configuracionganancias&amp;diff=103402</id>
		<title>SIU-Mapuche/Version3.28.0/Documentacion de las operaciones/impuestos ganancias/configuracionganancias</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.28.0/Documentacion_de_las_operaciones/impuestos_ganancias/configuracionganancias&amp;diff=103402"/>
				<updated>2024-09-27T15:36:47Z</updated>
		
		<summary type="html">&lt;p&gt;Ndominguez: Página creada con «&amp;lt;  Documentación de las Operaciones  == Seteos Generales de Configuración ==  Estas opciones se encuentran...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[SIU-Mapuche/Version3.25.0/Documentacion de las operaciones|&amp;lt;  Documentación de las Operaciones]]&lt;br /&gt;
&lt;br /&gt;
== Seteos Generales de Configuración ==&lt;br /&gt;
&lt;br /&gt;
Estas opciones se encuentran dentro del menú '''''Configuración &amp;gt; Impositivos &amp;gt; Parámetros para Ganancias'''''&lt;br /&gt;
&lt;br /&gt;
[[Archivo: Configuracion_ganancias.png|Configuracion]]&lt;br /&gt;
&lt;br /&gt;
==== Período de Inicio de Retención ====&lt;br /&gt;
Para los que utilizaban Escritorio queda el mismo. Esto es útil cuando se empieza a realizar el cálculo en un período distinto al inicio del año fiscal.&lt;br /&gt;
&lt;br /&gt;
==== Ejecución Cálculo de Ganancias ====&lt;br /&gt;
Debe estar en Web para poder visualizar opciones en Mapuche y realizar el Cálculo de Ganancias &lt;br /&gt;
&lt;br /&gt;
==== Institución Enteramente en Zona Patagónica ====&lt;br /&gt;
Esta opción debe estar tildada para que el Mapuche entienda que debe completar campos adecuados en el Formulario 1357, de lo contrario AFIP valida los topes sin los incrementos indicados por la Zona.&lt;br /&gt;
&lt;br /&gt;
==== Mes sobre el cual se realizará el Ajuste del SAC en relación a las 12avas partes adelantadas ====&lt;br /&gt;
Además de definir en el mes que se realiza por defecto el Ajuste de SAC, se puede realizar de manera individual en el Cálculo de Ganancias del período, Anual e Informativa.&lt;br /&gt;
&lt;br /&gt;
==== Parentesco ====&lt;br /&gt;
Es importante indicar cuál de los parentescos que tiene la Institución definidos corresponde a Cónyuge, Hijos e Hijastros para evaluar las Deducciones Personales que corresponden.&lt;br /&gt;
&lt;br /&gt;
==== Año Fiscal ====&lt;br /&gt;
El mismo puede ir de enero a diciembre o desde diciembre a noviembre. &lt;br /&gt;
&lt;br /&gt;
==== Considerar Deducciones para el Cálculo ====&lt;br /&gt;
Las Deducciones indicadas en el cuadro pueden configurarse para que se consideren todos los meses (Mensual), sumarizadas en diciembre (Diciembre) o directamente en el cálculo Anual. &lt;br /&gt;
&lt;br /&gt;
==== Orden de Reducción de Deducciones Personales ====&lt;br /&gt;
Hay casos en que no pueden efectuarse todas las deducciones personales porque eso implica una Remuneración Neta Sujeta a Impuestos inferior a 0.  Es por ello que se aplican las deducciones con un cierto orden, indicando cuáles son las que se van a reducir hasta llevarlas a 0 en caso que sea necesario.&lt;/div&gt;</summary>
		<author><name>Ndominguez</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101349</id>
		<title>SIU-Mapuche/Version3.26.1/Instalacion</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101349"/>
				<updated>2024-07-30T13:05:44Z</updated>
		
		<summary type="html">&lt;p&gt;Ndominguez: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[SIU-Mapuche/version3.26.1|&amp;lt; Documentación versión]]&lt;br /&gt;
&lt;br /&gt;
== Requerimientos ==&lt;br /&gt;
&lt;br /&gt;
Para poder comenzar con la instalación como requisito previo debe tener conexión a internet, tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.&lt;br /&gt;
&lt;br /&gt;
Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar. &lt;br /&gt;
&lt;br /&gt;
Las versiones recomendadas son las siguientes:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
!Requisito!!Versión&lt;br /&gt;
|-&lt;br /&gt;
|PostgreSQL&lt;br /&gt;
||11.x&lt;br /&gt;
|-&lt;br /&gt;
|Apache&lt;br /&gt;
||2.4.x&lt;br /&gt;
|-&lt;br /&gt;
|PHP&lt;br /&gt;
||7.3.x (con las extensiones: php_dbase, php_gd, php_mbstring, php_pdo, php_pdo_pgsql,php_xsl, php_zip, phpCAS, simplesamlphp, securimage, poidsy, php_soap)&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
&lt;br /&gt;
La instalación del sistema SIU-Mapuche se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.&lt;br /&gt;
&lt;br /&gt;
=== Pasos previos a un proceso de instalación ===&lt;br /&gt;
&lt;br /&gt;
#Descargar el sistema de SIU-Mapuche desde el sitio http://portal.comunidad.siu.edu.ar/ cuyo nombre es '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche_X.Y.Z.zip''''. &lt;br /&gt;
#Descomprimir el archivo y copiar el directorio donde se desea instalar el sistema.&lt;br /&gt;
#Luego ingresar al directorio recién descomprimido de SIU-Mapuche (ultima versión) y ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#Copiar el archivo instalador.env.dist y renombrar a instalador.env, en linux se puede utilizar el siguiente comando: &lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp instalador.env.dist instalador.env&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#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 Mapuche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto). Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link:  [http://documentacion.siu.edu.ar/wiki/SIU-Mapuche/version2.6.0instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]&lt;br /&gt;
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
chmod +x bin/instalador&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Instalación desde cero ===&lt;br /&gt;
&lt;br /&gt;
Para realizar una instalación de cero, puede realizarla en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.&lt;br /&gt;
&lt;br /&gt;
El instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:&lt;br /&gt;
&lt;br /&gt;
Para instalar en entorno de producción con una base de datos existente vacía ejecutar:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía (demo_universidad):&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar --crear-db&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir.&lt;br /&gt;
&lt;br /&gt;
Si desea obtener mas ayuda sobre el comando de instalación ejecutar&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar -h&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Actualización ==&lt;br /&gt;
&lt;br /&gt;
=== Recomendaciones previas a la actualización ===&lt;br /&gt;
&lt;br /&gt;
Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración del entorno de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche-anterior/instalacion/entorno_toba.env''''&lt;br /&gt;
&lt;br /&gt;
Para el caso de una instalación en un sistema operativo Linux la estructura del archivo sera la siguiente, verificar si se encuentra correctamente configurado nuestra ruta de instalación a SIU-Mapuche&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
export TOBA_DIR=/ruta_instalacion_mapuche/vendor/siu-toba/framework&lt;br /&gt;
export TOBA_INSTANCIA=produccion&lt;br /&gt;
export TOBA_INSTALACION_DIR=/ruta_instalacion_mapuche/instalacion&lt;br /&gt;
export PATH=&amp;quot;$TOBA_DIR/bin:$PATH&amp;quot;&lt;br /&gt;
echo &amp;quot;Entorno cargado.&amp;quot;&lt;br /&gt;
echo &amp;quot;Ejecute 'toba' para ver la lista de comandos disponibles.&amp;quot;&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración de la instancia de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche/instalacion/i__produccion/instancia.ini'&amp;lt;nowiki/&amp;gt;''' y dentro de este verificar si esta configurado el parámetro '&amp;lt;nowiki/&amp;gt;'''usar_perfiles_propios = &amp;quot;1&amp;quot;'''' el cual es &lt;br /&gt;
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.&lt;br /&gt;
&lt;br /&gt;
===== Verificar permisos de lectura y escritura de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Durante el proceso de actualización es necesario que el usuario del sistema el cual ejecuta el instalador tenga permisos de lectura y escritura sobre el SIU-Mapuche anterior.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Actualización de una instalación ===&lt;br /&gt;
&lt;br /&gt;
Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Mapuche/Version_X.Y.Z/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]&lt;br /&gt;
&lt;br /&gt;
Para actualizar en entorno de producción se ejecuta el siguiente comando:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Post Instalación/Actualización ==&lt;br /&gt;
&lt;br /&gt;
Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.&lt;br /&gt;
&lt;br /&gt;
=== Verificar archivo de log del instalador ===&lt;br /&gt;
El instalador durante el proceso de ejecución de cada comando genera un archivo de log en la raíz del proyecto, dentro de este archivo se encuentra detallado toda la historia de ejecución de procesos y &lt;br /&gt;
en el podemos detectar cualquier tipo de error o advertencia que pueda ocurrir durante su ejecución, por eso es de mucha utilidad verificar este archivo y ayuda a entender cualquier falla.&lt;br /&gt;
&lt;br /&gt;
Una de las alternativas para visualizar el archivo de log es de la siguiente manera:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
less instalador.log&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Modificar permisos ===&lt;br /&gt;
Permite modificar los permisos del proyecto, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración. &lt;br /&gt;
&lt;br /&gt;
Al ejecutar el comando intentara identificar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache, con la posibilidad de definir ambos parámetros en el caso de que sean distintos a los sugeridos.&lt;br /&gt;
&lt;br /&gt;
Ejecute el siguiente comando como superusuario: &lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Como parámetros opcionales se puede enviar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache como argumentos mediante el siguiente parámetro:&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple -U usuario -W www-data&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración del servidor de aplicaciones ===&lt;br /&gt;
&lt;br /&gt;
Para la configuración del servidor web les proponemos las siguientes opciones.&lt;br /&gt;
&lt;br /&gt;
Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
ln -s /ruta_instalacion/mapuche/instalacion/toba.conf /etc/apache2/sites-enabled/mapuche_xyz.conf    &lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.&lt;br /&gt;
&lt;br /&gt;
== Uso de imágenes docker en SIU-Mapuche ==&lt;br /&gt;
=== Acceso a imágenes docker SIU-Mapuche ===&lt;br /&gt;
Para poder descargar la imagen de docker de SIU-Mapuche se debe contar con un usuario en hub.siu.edu.ar. Se debe realizar una solicitud de vinculación por nota. El responsable de proyecto debe ponerse en contacto para iniciar el proceso de acceso al repositorio.&lt;br /&gt;
&lt;br /&gt;
=== '''Parámetros disponibles en entrypoint''' ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! width=&amp;quot;25%&amp;quot; | Parametro&lt;br /&gt;
! width=&amp;quot;75%&amp;quot; | Descripcion&lt;br /&gt;
|-&lt;br /&gt;
| --fix-permissions&lt;br /&gt;
| Configura los permisos de archivos para la aplicación&lt;br /&gt;
|-&lt;br /&gt;
| --reconfigure&lt;br /&gt;
| Configura los permisos de archivos para la aplicación&lt;br /&gt;
|-&lt;br /&gt;
| --reconfigure-alias&lt;br /&gt;
| Realiza la reconfiguración de los alias&lt;br /&gt;
|-&lt;br /&gt;
| --compilar-perfiles&lt;br /&gt;
| Compila los perfiles funcionales&lt;br /&gt;
|-&lt;br /&gt;
| --create-db&lt;br /&gt;
| Compila los perfiles funcionales&lt;br /&gt;
|-&lt;br /&gt;
| --db-existente&lt;br /&gt;
| Indica que se debe utilizar una base de negocio existente al correr un proceso de instalación.&lt;br /&gt;
|-&lt;br /&gt;
| --db-initialize&lt;br /&gt;
| Inicializa la base de datos.&lt;br /&gt;
|-&lt;br /&gt;
| --db-migrate&lt;br /&gt;
| Realiza la migración del proyecto.&lt;br /&gt;
|-&lt;br /&gt;
| --change-apache-usr&lt;br /&gt;
| Cambia usuario apache&lt;br /&gt;
|-&lt;br /&gt;
| --serve&lt;br /&gt;
| Queda ejecutando servicio&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Ejemplo de uso de las imágenes docker en SIU-Mapuche ===&lt;br /&gt;
&lt;br /&gt;
==== Inicializar base SIU-Mapuche ====&lt;br /&gt;
Este comando inicializa la BD del proyecto&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker run --rm -it \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--name mapuche-new-db hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z --db-initialize --create-db&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
==== Correr SIU-Mapuche x.y.z ====&lt;br /&gt;
Este comando permite correr el contenedor de SIU-Mapuche, con los parámetros del entrypoint mencionados anteriormente.&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker run --detach \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--name mapuche_x.y.z hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z--reconfigure --reconfigure-alias --serve --fix-permissions --change-apache-usr&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== Actualización SIU-Mapuche a x.y+1.z ==== &lt;br /&gt;
Exportar instancia&lt;br /&gt;
En primer lugar se debe exportar la instancia de la versión anterior.&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker exec -i mapuche_x.y.z /usr/local/app/bin/toba instancia exportar_local -­i produccion&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Luego copiar la instancia exportada fuera del contenedor&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker cp mapuche_x.y.z:/usr/local/app/instalacion /tmp/instalacion_exportada/&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Migración de db negocio, db toba e importación de usuarios y perfiles&lt;br /&gt;
Finalmente correr el comando de migración con la imagen de la nueva versión. En este ejemplo se monta un volumen con la instalación exportada en el paso anterior. El comando docker:db-actualizar realiza la migración de la base de negocio, de la base de toba y la migración de usuarios y perfiles.&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker run --rm -it \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
-v /tmp/instalacion_exportada:/tmp/instalacion_exportada \&lt;br /&gt;
--name mapuche-update-db hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z -- bin/instalador docker:db-actualizar -p /tmp/instalacion_exportada --no-interaction --no-progress&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==== Correr SIU-Mapuche x.y+1.z ====&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker run --detach \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--name mapuche_x.y+1.z hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z --reconfigure --reconfigure-alias --serve --fix-permissions --change-apache-usr --compilar-perfiles&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;/div&gt;</summary>
		<author><name>Ndominguez</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101348</id>
		<title>SIU-Mapuche/Version3.26.1/Instalacion</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101348"/>
				<updated>2024-07-30T12:59:25Z</updated>
		
		<summary type="html">&lt;p&gt;Ndominguez: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[SIU-Mapuche/version3.26.1|&amp;lt; Documentación versión]]&lt;br /&gt;
&lt;br /&gt;
== Requerimientos ==&lt;br /&gt;
&lt;br /&gt;
Para poder comenzar con la instalación como requisito previo debe tener conexión a internet, tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.&lt;br /&gt;
&lt;br /&gt;
Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar. &lt;br /&gt;
&lt;br /&gt;
Las versiones recomendadas son las siguientes:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
!Requisito!!Versión&lt;br /&gt;
|-&lt;br /&gt;
|PostgreSQL&lt;br /&gt;
||11.x&lt;br /&gt;
|-&lt;br /&gt;
|Apache&lt;br /&gt;
||2.4.x&lt;br /&gt;
|-&lt;br /&gt;
|PHP&lt;br /&gt;
||7.3.x (con las extensiones: php_dbase, php_gd, php_mbstring, php_pdo, php_pdo_pgsql,php_xsl, php_zip, phpCAS, simplesamlphp, securimage, poidsy, php_soap)&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
&lt;br /&gt;
La instalación del sistema SIU-Mapuche se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.&lt;br /&gt;
&lt;br /&gt;
=== Pasos previos a un proceso de instalación ===&lt;br /&gt;
&lt;br /&gt;
#Descargar el sistema de SIU-Mapuche desde el sitio http://portal.comunidad.siu.edu.ar/ cuyo nombre es '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche_X.Y.Z.zip''''. &lt;br /&gt;
#Descomprimir el archivo y copiar el directorio donde se desea instalar el sistema.&lt;br /&gt;
#Luego ingresar al directorio recién descomprimido de SIU-Mapuche (ultima versión) y ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#Copiar el archivo instalador.env.dist y renombrar a instalador.env, en linux se puede utilizar el siguiente comando: &lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp instalador.env.dist instalador.env&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#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 Mapuche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto). Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link:  [http://documentacion.siu.edu.ar/wiki/SIU-Mapuche/version2.6.0instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]&lt;br /&gt;
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
chmod +x bin/instalador&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Instalación desde cero ===&lt;br /&gt;
&lt;br /&gt;
Para realizar una instalación de cero, puede realizarla en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.&lt;br /&gt;
&lt;br /&gt;
El instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:&lt;br /&gt;
&lt;br /&gt;
Para instalar en entorno de producción con una base de datos existente vacía ejecutar:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía (demo_universidad):&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar --crear-db&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir.&lt;br /&gt;
&lt;br /&gt;
Si desea obtener mas ayuda sobre el comando de instalación ejecutar&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar -h&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Actualización ==&lt;br /&gt;
&lt;br /&gt;
=== Recomendaciones previas a la actualización ===&lt;br /&gt;
&lt;br /&gt;
Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración del entorno de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche-anterior/instalacion/entorno_toba.env''''&lt;br /&gt;
&lt;br /&gt;
Para el caso de una instalación en un sistema operativo Linux la estructura del archivo sera la siguiente, verificar si se encuentra correctamente configurado nuestra ruta de instalación a SIU-Mapuche&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
export TOBA_DIR=/ruta_instalacion_mapuche/vendor/siu-toba/framework&lt;br /&gt;
export TOBA_INSTANCIA=produccion&lt;br /&gt;
export TOBA_INSTALACION_DIR=/ruta_instalacion_mapuche/instalacion&lt;br /&gt;
export PATH=&amp;quot;$TOBA_DIR/bin:$PATH&amp;quot;&lt;br /&gt;
echo &amp;quot;Entorno cargado.&amp;quot;&lt;br /&gt;
echo &amp;quot;Ejecute 'toba' para ver la lista de comandos disponibles.&amp;quot;&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración de la instancia de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche/instalacion/i__produccion/instancia.ini'&amp;lt;nowiki/&amp;gt;''' y dentro de este verificar si esta configurado el parámetro '&amp;lt;nowiki/&amp;gt;'''usar_perfiles_propios = &amp;quot;1&amp;quot;'''' el cual es &lt;br /&gt;
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.&lt;br /&gt;
&lt;br /&gt;
===== Verificar permisos de lectura y escritura de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Durante el proceso de actualización es necesario que el usuario del sistema el cual ejecuta el instalador tenga permisos de lectura y escritura sobre el SIU-Mapuche anterior.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Actualización de una instalación ===&lt;br /&gt;
&lt;br /&gt;
Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Mapuche/Version_X.Y.Z/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]&lt;br /&gt;
&lt;br /&gt;
Para actualizar en entorno de producción se ejecuta el siguiente comando:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Post Instalación/Actualización ==&lt;br /&gt;
&lt;br /&gt;
Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.&lt;br /&gt;
&lt;br /&gt;
=== Verificar archivo de log del instalador ===&lt;br /&gt;
El instalador durante el proceso de ejecución de cada comando genera un archivo de log en la raíz del proyecto, dentro de este archivo se encuentra detallado toda la historia de ejecución de procesos y &lt;br /&gt;
en el podemos detectar cualquier tipo de error o advertencia que pueda ocurrir durante su ejecución, por eso es de mucha utilidad verificar este archivo y ayuda a entender cualquier falla.&lt;br /&gt;
&lt;br /&gt;
Una de las alternativas para visualizar el archivo de log es de la siguiente manera:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
less instalador.log&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Modificar permisos ===&lt;br /&gt;
Permite modificar los permisos del proyecto, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración. &lt;br /&gt;
&lt;br /&gt;
Al ejecutar el comando intentara identificar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache, con la posibilidad de definir ambos parámetros en el caso de que sean distintos a los sugeridos.&lt;br /&gt;
&lt;br /&gt;
Ejecute el siguiente comando como superusuario: &lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Como parámetros opcionales se puede enviar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache como argumentos mediante el siguiente parámetro:&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple -U usuario -W www-data&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración del servidor de aplicaciones ===&lt;br /&gt;
&lt;br /&gt;
Para la configuración del servidor web les proponemos las siguientes opciones.&lt;br /&gt;
&lt;br /&gt;
Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
ln -s /ruta_instalacion/mapuche/instalacion/toba.conf /etc/apache2/sites-enabled/mapuche_xyz.conf    &lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.&lt;br /&gt;
&lt;br /&gt;
== Uso de imágenes docker en SIU-Mapuche ==&lt;br /&gt;
=== Acceso a imágenes docker SIU-Mapuche ===&lt;br /&gt;
Para poder descargar la imagen de docker de SIU-Mapuche se debe contar con un usuario en hub.siu.edu.ar. Se debe realizar una solicitud de vinculación por nota. El responsable de proyecto debe ponerse en contacto para iniciar el proceso de acceso al repositorio.&lt;br /&gt;
&lt;br /&gt;
=== '''Parámetros disponibles en entrypoint''' ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! width=&amp;quot;25%&amp;quot; | Parametro&lt;br /&gt;
! width=&amp;quot;75%&amp;quot; | Descripcion&lt;br /&gt;
|-&lt;br /&gt;
| --fix-permissions&lt;br /&gt;
| Configura los permisos de archivos para la aplicación&lt;br /&gt;
|-&lt;br /&gt;
| --reconfigure&lt;br /&gt;
| Configura los permisos de archivos para la aplicación&lt;br /&gt;
|-&lt;br /&gt;
| --reconfigure-alias&lt;br /&gt;
| Realiza la reconfiguración de los alias&lt;br /&gt;
|-&lt;br /&gt;
| --compilar-perfiles&lt;br /&gt;
| Compila los perfiles funcionales&lt;br /&gt;
|-&lt;br /&gt;
| --create-db&lt;br /&gt;
| Compila los perfiles funcionales&lt;br /&gt;
|-&lt;br /&gt;
| --db-existente&lt;br /&gt;
| Indica que se debe utilizar una base de negocio existente al correr un proceso de instalación.&lt;br /&gt;
|-&lt;br /&gt;
| --db-initialize&lt;br /&gt;
| Inicializa la base de datos.&lt;br /&gt;
|-&lt;br /&gt;
| --db-migrate&lt;br /&gt;
| Realiza la migración del proyecto.&lt;br /&gt;
|-&lt;br /&gt;
| --change-apache-usr&lt;br /&gt;
| Cambia usuario apache&lt;br /&gt;
|-&lt;br /&gt;
| --serve&lt;br /&gt;
| Queda ejecutando servicio&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Ejemplo de uso de las imágenes docker en SIU-Mapuche ===&lt;br /&gt;
&lt;br /&gt;
==== Inicializar base SIU-Mapuche ====&lt;br /&gt;
Este comando inicializa la BD del proyecto&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker run --rm -it \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--name mapuche-new-db hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z --db-initialize --create-db&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
==== Correr SIU-Mapuche x.y.z ====&lt;br /&gt;
Este comando permite correr el contenedor de SIU-Mapuche, con los parámetros del entrypoint mencionados anteriormente.&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;php&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
docker run --detach \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--name mapuche_x.y.z hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z--reconfigure --reconfigure-alias --serve --fix-permissions --change-apache-usr&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Actualización SIU-Mapuche a x.y+1.z / &lt;br /&gt;
Exportar instancia&lt;br /&gt;
En primer lugar se debe exportar la instancia de la versión anterior.&lt;br /&gt;
&lt;br /&gt;
docker exec -i mapuche_x.y.z /usr/local/app/bin/toba instancia exportar_local -­i produccion&lt;br /&gt;
Luego copiar la instancia exportada fuera del contenedor&lt;br /&gt;
&lt;br /&gt;
docker cp mapuche_x.y.z:/usr/local/app/instalacion /tmp/instalacion_exportada/&lt;br /&gt;
&lt;br /&gt;
Migración de db negocio, db toba e importación de usuarios y perfiles&lt;br /&gt;
Finalmente correr el comando de migración con la imagen de la nueva versión. En este ejemplo se monta un volumen con la instalación exportada en el paso anterior. El comando docker:db-actualizar realiza la migración de la base de negocio, de la base de toba y la migración de usuarios y perfiles.&lt;br /&gt;
&lt;br /&gt;
docker run --rm -it \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
-v /tmp/instalacion_exportada:/tmp/instalacion_exportada \&lt;br /&gt;
--name mapuche-update-db hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z -- bin/instalador docker:db-actualizar -p /tmp/instalacion_exportada --no-interaction --no-progress&lt;br /&gt;
&lt;br /&gt;
Correr SIU-Mapuche x.y+1.z&lt;br /&gt;
docker run --detach \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--name mapuche_x.y+1.z hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z --reconfigure --reconfigure-alias --serve --fix-permissions --change-apache-usr --compilar-perfiles&lt;/div&gt;</summary>
		<author><name>Ndominguez</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101347</id>
		<title>SIU-Mapuche/Version3.26.1/Instalacion</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101347"/>
				<updated>2024-07-30T12:51:17Z</updated>
		
		<summary type="html">&lt;p&gt;Ndominguez: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[SIU-Mapuche/version3.26.1|&amp;lt; Documentación versión]]&lt;br /&gt;
&lt;br /&gt;
== Requerimientos ==&lt;br /&gt;
&lt;br /&gt;
Para poder comenzar con la instalación como requisito previo debe tener conexión a internet, tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.&lt;br /&gt;
&lt;br /&gt;
Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar. &lt;br /&gt;
&lt;br /&gt;
Las versiones recomendadas son las siguientes:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
!Requisito!!Versión&lt;br /&gt;
|-&lt;br /&gt;
|PostgreSQL&lt;br /&gt;
||11.x&lt;br /&gt;
|-&lt;br /&gt;
|Apache&lt;br /&gt;
||2.4.x&lt;br /&gt;
|-&lt;br /&gt;
|PHP&lt;br /&gt;
||7.3.x (con las extensiones: php_dbase, php_gd, php_mbstring, php_pdo, php_pdo_pgsql,php_xsl, php_zip, phpCAS, simplesamlphp, securimage, poidsy, php_soap)&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
&lt;br /&gt;
La instalación del sistema SIU-Mapuche se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.&lt;br /&gt;
&lt;br /&gt;
=== Pasos previos a un proceso de instalación ===&lt;br /&gt;
&lt;br /&gt;
#Descargar el sistema de SIU-Mapuche desde el sitio http://portal.comunidad.siu.edu.ar/ cuyo nombre es '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche_X.Y.Z.zip''''. &lt;br /&gt;
#Descomprimir el archivo y copiar el directorio donde se desea instalar el sistema.&lt;br /&gt;
#Luego ingresar al directorio recién descomprimido de SIU-Mapuche (ultima versión) y ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#Copiar el archivo instalador.env.dist y renombrar a instalador.env, en linux se puede utilizar el siguiente comando: &lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp instalador.env.dist instalador.env&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#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 Mapuche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto). Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link:  [http://documentacion.siu.edu.ar/wiki/SIU-Mapuche/version2.6.0instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]&lt;br /&gt;
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
chmod +x bin/instalador&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Instalación desde cero ===&lt;br /&gt;
&lt;br /&gt;
Para realizar una instalación de cero, puede realizarla en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.&lt;br /&gt;
&lt;br /&gt;
El instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:&lt;br /&gt;
&lt;br /&gt;
Para instalar en entorno de producción con una base de datos existente vacía ejecutar:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía (demo_universidad):&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar --crear-db&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir.&lt;br /&gt;
&lt;br /&gt;
Si desea obtener mas ayuda sobre el comando de instalación ejecutar&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar -h&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Actualización ==&lt;br /&gt;
&lt;br /&gt;
=== Recomendaciones previas a la actualización ===&lt;br /&gt;
&lt;br /&gt;
Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración del entorno de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche-anterior/instalacion/entorno_toba.env''''&lt;br /&gt;
&lt;br /&gt;
Para el caso de una instalación en un sistema operativo Linux la estructura del archivo sera la siguiente, verificar si se encuentra correctamente configurado nuestra ruta de instalación a SIU-Mapuche&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
export TOBA_DIR=/ruta_instalacion_mapuche/vendor/siu-toba/framework&lt;br /&gt;
export TOBA_INSTANCIA=produccion&lt;br /&gt;
export TOBA_INSTALACION_DIR=/ruta_instalacion_mapuche/instalacion&lt;br /&gt;
export PATH=&amp;quot;$TOBA_DIR/bin:$PATH&amp;quot;&lt;br /&gt;
echo &amp;quot;Entorno cargado.&amp;quot;&lt;br /&gt;
echo &amp;quot;Ejecute 'toba' para ver la lista de comandos disponibles.&amp;quot;&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración de la instancia de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche/instalacion/i__produccion/instancia.ini'&amp;lt;nowiki/&amp;gt;''' y dentro de este verificar si esta configurado el parámetro '&amp;lt;nowiki/&amp;gt;'''usar_perfiles_propios = &amp;quot;1&amp;quot;'''' el cual es &lt;br /&gt;
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.&lt;br /&gt;
&lt;br /&gt;
===== Verificar permisos de lectura y escritura de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Durante el proceso de actualización es necesario que el usuario del sistema el cual ejecuta el instalador tenga permisos de lectura y escritura sobre el SIU-Mapuche anterior.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Actualización de una instalación ===&lt;br /&gt;
&lt;br /&gt;
Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Mapuche/Version_X.Y.Z/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]&lt;br /&gt;
&lt;br /&gt;
Para actualizar en entorno de producción se ejecuta el siguiente comando:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Post Instalación/Actualización ==&lt;br /&gt;
&lt;br /&gt;
Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.&lt;br /&gt;
&lt;br /&gt;
=== Verificar archivo de log del instalador ===&lt;br /&gt;
El instalador durante el proceso de ejecución de cada comando genera un archivo de log en la raíz del proyecto, dentro de este archivo se encuentra detallado toda la historia de ejecución de procesos y &lt;br /&gt;
en el podemos detectar cualquier tipo de error o advertencia que pueda ocurrir durante su ejecución, por eso es de mucha utilidad verificar este archivo y ayuda a entender cualquier falla.&lt;br /&gt;
&lt;br /&gt;
Una de las alternativas para visualizar el archivo de log es de la siguiente manera:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
less instalador.log&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Modificar permisos ===&lt;br /&gt;
Permite modificar los permisos del proyecto, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración. &lt;br /&gt;
&lt;br /&gt;
Al ejecutar el comando intentara identificar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache, con la posibilidad de definir ambos parámetros en el caso de que sean distintos a los sugeridos.&lt;br /&gt;
&lt;br /&gt;
Ejecute el siguiente comando como superusuario: &lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Como parámetros opcionales se puede enviar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache como argumentos mediante el siguiente parámetro:&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple -U usuario -W www-data&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración del servidor de aplicaciones ===&lt;br /&gt;
&lt;br /&gt;
Para la configuración del servidor web les proponemos las siguientes opciones.&lt;br /&gt;
&lt;br /&gt;
Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
ln -s /ruta_instalacion/mapuche/instalacion/toba.conf /etc/apache2/sites-enabled/mapuche_xyz.conf    &lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.&lt;br /&gt;
&lt;br /&gt;
== Uso de imágenes docker en SIU-Mapuche ==&lt;br /&gt;
=== Acceso a imágenes docker SIU-Mapuche ===&lt;br /&gt;
Para poder descargar la imagen de docker de SIU-Mapuche se debe contar con un usuario en hub.siu.edu.ar. Se debe realizar una solicitud de vinculación por nota. El responsable de proyecto debe ponerse en contacto para iniciar el proceso de acceso al repositorio.&lt;br /&gt;
&lt;br /&gt;
=== Parámetros disponibles en entrypoint ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
!Parametro!!Descripcion&lt;br /&gt;
|-&lt;br /&gt;
|PostgreSQL&lt;br /&gt;
||11.x&lt;br /&gt;
|-&lt;br /&gt;
|Apache&lt;br /&gt;
||2.4.x&lt;br /&gt;
|-&lt;br /&gt;
|PHP&lt;br /&gt;
||7.3.x (con las extensiones: php_dbase, php_gd, php_mbstring, php_pdo, php_pdo_pgsql,php_xsl, php_zip, phpCAS, simplesamlphp, securimage, poidsy, php_soap)&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--fix-permissions	Configura los permisos de archivos para la aplicación&lt;br /&gt;
&lt;br /&gt;
@Ver que hace el reconfigure&lt;br /&gt;
--reconfigure	Configura los permisos de archivos para la aplicación&lt;br /&gt;
&lt;br /&gt;
--reconfigure-alias	Realiza la reconfiguración de los alias&lt;br /&gt;
--compilar-perfiles	Compila los perfiles funcionales&lt;br /&gt;
--create-db Indica que se debe crear la base de datos al correr un proceso de instalación&lt;br /&gt;
--db-existente	Indica que se debe utilizar una base de negocio existente al correr un proceso de instalación.&lt;br /&gt;
--db-initialize	Inicializa la base de datos.&lt;br /&gt;
--db-migrate	Realiza la migración del proyecto.&lt;br /&gt;
--change-apache-usr	Cambia usuario apache&lt;br /&gt;
--serve	Queda ejecutando servicio&lt;br /&gt;
&lt;br /&gt;
Ejemplo de uso de las imágenes docker en SIU-Mapuche&lt;br /&gt;
Inicializar base SIU-Mapuche&lt;br /&gt;
Este comando inicializa la BD del proyecto&lt;br /&gt;
&lt;br /&gt;
docker run --rm -it \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--name mapuche-new-db hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z --db-initialize --create-db&lt;br /&gt;
&lt;br /&gt;
Correr SIU-Mapuche x.y.z&lt;br /&gt;
Este comando permite correr el contenedor de SIU-Mapuche, con los parámetros del entrypoint mencionados anteriormente.&lt;br /&gt;
&lt;br /&gt;
docker run --detach \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--name mapuche_x.y.z hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z--reconfigure --reconfigure-alias --serve --fix-permissions --change-apache-usr&lt;br /&gt;
&lt;br /&gt;
Actualización SIU-Mapuche a x.y+1.z / &lt;br /&gt;
Exportar instancia&lt;br /&gt;
En primer lugar se debe exportar la instancia de la versión anterior.&lt;br /&gt;
&lt;br /&gt;
docker exec -i mapuche_x.y.z /usr/local/app/bin/toba instancia exportar_local -­i produccion&lt;br /&gt;
Luego copiar la instancia exportada fuera del contenedor&lt;br /&gt;
&lt;br /&gt;
docker cp mapuche_x.y.z:/usr/local/app/instalacion /tmp/instalacion_exportada/&lt;br /&gt;
&lt;br /&gt;
Migración de db negocio, db toba e importación de usuarios y perfiles&lt;br /&gt;
Finalmente correr el comando de migración con la imagen de la nueva versión. En este ejemplo se monta un volumen con la instalación exportada en el paso anterior. El comando docker:db-actualizar realiza la migración de la base de negocio, de la base de toba y la migración de usuarios y perfiles.&lt;br /&gt;
&lt;br /&gt;
docker run --rm -it \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
-v /tmp/instalacion_exportada:/tmp/instalacion_exportada \&lt;br /&gt;
--name mapuche-update-db hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z -- bin/instalador docker:db-actualizar -p /tmp/instalacion_exportada --no-interaction --no-progress&lt;br /&gt;
&lt;br /&gt;
Correr SIU-Mapuche x.y+1.z&lt;br /&gt;
docker run --detach \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--name mapuche_x.y+1.z hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z --reconfigure --reconfigure-alias --serve --fix-permissions --change-apache-usr --compilar-perfiles&lt;/div&gt;</summary>
		<author><name>Ndominguez</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101346</id>
		<title>SIU-Mapuche/Version3.26.1/Instalacion</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101346"/>
				<updated>2024-07-30T12:49:14Z</updated>
		
		<summary type="html">&lt;p&gt;Ndominguez: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[SIU-Mapuche/version3.26.1|&amp;lt; Documentación versión]]&lt;br /&gt;
&lt;br /&gt;
== Requerimientos ==&lt;br /&gt;
&lt;br /&gt;
Para poder comenzar con la instalación como requisito previo debe tener conexión a internet, tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.&lt;br /&gt;
&lt;br /&gt;
Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar. &lt;br /&gt;
&lt;br /&gt;
Las versiones recomendadas son las siguientes:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
!Requisito!!Versión&lt;br /&gt;
|-&lt;br /&gt;
|PostgreSQL&lt;br /&gt;
||11.x&lt;br /&gt;
|-&lt;br /&gt;
|Apache&lt;br /&gt;
||2.4.x&lt;br /&gt;
|-&lt;br /&gt;
|PHP&lt;br /&gt;
||7.3.x (con las extensiones: php_dbase, php_gd, php_mbstring, php_pdo, php_pdo_pgsql,php_xsl, php_zip, phpCAS, simplesamlphp, securimage, poidsy, php_soap)&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
&lt;br /&gt;
La instalación del sistema SIU-Mapuche se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.&lt;br /&gt;
&lt;br /&gt;
=== Pasos previos a un proceso de instalación ===&lt;br /&gt;
&lt;br /&gt;
#Descargar el sistema de SIU-Mapuche desde el sitio http://portal.comunidad.siu.edu.ar/ cuyo nombre es '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche_X.Y.Z.zip''''. &lt;br /&gt;
#Descomprimir el archivo y copiar el directorio donde se desea instalar el sistema.&lt;br /&gt;
#Luego ingresar al directorio recién descomprimido de SIU-Mapuche (ultima versión) y ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#Copiar el archivo instalador.env.dist y renombrar a instalador.env, en linux se puede utilizar el siguiente comando: &lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp instalador.env.dist instalador.env&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#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 Mapuche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto). Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link:  [http://documentacion.siu.edu.ar/wiki/SIU-Mapuche/version2.6.0instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]&lt;br /&gt;
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
chmod +x bin/instalador&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Instalación desde cero ===&lt;br /&gt;
&lt;br /&gt;
Para realizar una instalación de cero, puede realizarla en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.&lt;br /&gt;
&lt;br /&gt;
El instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:&lt;br /&gt;
&lt;br /&gt;
Para instalar en entorno de producción con una base de datos existente vacía ejecutar:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía (demo_universidad):&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar --crear-db&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir.&lt;br /&gt;
&lt;br /&gt;
Si desea obtener mas ayuda sobre el comando de instalación ejecutar&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar -h&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Actualización ==&lt;br /&gt;
&lt;br /&gt;
=== Recomendaciones previas a la actualización ===&lt;br /&gt;
&lt;br /&gt;
Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración del entorno de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche-anterior/instalacion/entorno_toba.env''''&lt;br /&gt;
&lt;br /&gt;
Para el caso de una instalación en un sistema operativo Linux la estructura del archivo sera la siguiente, verificar si se encuentra correctamente configurado nuestra ruta de instalación a SIU-Mapuche&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
export TOBA_DIR=/ruta_instalacion_mapuche/vendor/siu-toba/framework&lt;br /&gt;
export TOBA_INSTANCIA=produccion&lt;br /&gt;
export TOBA_INSTALACION_DIR=/ruta_instalacion_mapuche/instalacion&lt;br /&gt;
export PATH=&amp;quot;$TOBA_DIR/bin:$PATH&amp;quot;&lt;br /&gt;
echo &amp;quot;Entorno cargado.&amp;quot;&lt;br /&gt;
echo &amp;quot;Ejecute 'toba' para ver la lista de comandos disponibles.&amp;quot;&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración de la instancia de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche/instalacion/i__produccion/instancia.ini'&amp;lt;nowiki/&amp;gt;''' y dentro de este verificar si esta configurado el parámetro '&amp;lt;nowiki/&amp;gt;'''usar_perfiles_propios = &amp;quot;1&amp;quot;'''' el cual es &lt;br /&gt;
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.&lt;br /&gt;
&lt;br /&gt;
===== Verificar permisos de lectura y escritura de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Durante el proceso de actualización es necesario que el usuario del sistema el cual ejecuta el instalador tenga permisos de lectura y escritura sobre el SIU-Mapuche anterior.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Actualización de una instalación ===&lt;br /&gt;
&lt;br /&gt;
Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Mapuche/Version_X.Y.Z/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]&lt;br /&gt;
&lt;br /&gt;
Para actualizar en entorno de producción se ejecuta el siguiente comando:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Post Instalación/Actualización ==&lt;br /&gt;
&lt;br /&gt;
Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.&lt;br /&gt;
&lt;br /&gt;
=== Verificar archivo de log del instalador ===&lt;br /&gt;
El instalador durante el proceso de ejecución de cada comando genera un archivo de log en la raíz del proyecto, dentro de este archivo se encuentra detallado toda la historia de ejecución de procesos y &lt;br /&gt;
en el podemos detectar cualquier tipo de error o advertencia que pueda ocurrir durante su ejecución, por eso es de mucha utilidad verificar este archivo y ayuda a entender cualquier falla.&lt;br /&gt;
&lt;br /&gt;
Una de las alternativas para visualizar el archivo de log es de la siguiente manera:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
less instalador.log&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Modificar permisos ===&lt;br /&gt;
Permite modificar los permisos del proyecto, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración. &lt;br /&gt;
&lt;br /&gt;
Al ejecutar el comando intentara identificar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache, con la posibilidad de definir ambos parámetros en el caso de que sean distintos a los sugeridos.&lt;br /&gt;
&lt;br /&gt;
Ejecute el siguiente comando como superusuario: &lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Como parámetros opcionales se puede enviar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache como argumentos mediante el siguiente parámetro:&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple -U usuario -W www-data&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración del servidor de aplicaciones ===&lt;br /&gt;
&lt;br /&gt;
Para la configuración del servidor web les proponemos las siguientes opciones.&lt;br /&gt;
&lt;br /&gt;
Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
ln -s /ruta_instalacion/mapuche/instalacion/toba.conf /etc/apache2/sites-enabled/mapuche_xyz.conf    &lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.&lt;br /&gt;
&lt;br /&gt;
== Uso de imágenes docker en SIU-Mapuche ==&lt;br /&gt;
=== Acceso a imágenes docker SIU-Mapuche ===&lt;br /&gt;
Para poder descargar la imagen de docker de SIU-Mapuche se debe contar con un usuario en hub.siu.edu.ar. Se debe realizar una solicitud de vinculación por nota. El responsable de proyecto debe ponerse en contacto para iniciar el proceso de acceso al repositorio.&lt;br /&gt;
&lt;br /&gt;
=== Parámetros disponibles en entrypoint ===&lt;br /&gt;
Parametro	Descripcion&lt;br /&gt;
--fix-permissions	Configura los permisos de archivos para la aplicación&lt;br /&gt;
&lt;br /&gt;
@Ver que hace el reconfigure&lt;br /&gt;
--reconfigure	Configura los permisos de archivos para la aplicación&lt;br /&gt;
&lt;br /&gt;
--reconfigure-alias	Realiza la reconfiguración de los alias&lt;br /&gt;
--compilar-perfiles	Compila los perfiles funcionales&lt;br /&gt;
--create-db Indica que se debe crear la base de datos al correr un proceso de instalación&lt;br /&gt;
--db-existente	Indica que se debe utilizar una base de negocio existente al correr un proceso de instalación.&lt;br /&gt;
--db-initialize	Inicializa la base de datos.&lt;br /&gt;
--db-migrate	Realiza la migración del proyecto.&lt;br /&gt;
--change-apache-usr	Cambia usuario apache&lt;br /&gt;
--serve	Queda ejecutando servicio&lt;br /&gt;
&lt;br /&gt;
Ejemplo de uso de las imágenes docker en SIU-Mapuche&lt;br /&gt;
Inicializar base SIU-Mapuche&lt;br /&gt;
Este comando inicializa la BD del proyecto&lt;br /&gt;
&lt;br /&gt;
docker run --rm -it \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--name mapuche-new-db hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z --db-initialize --create-db&lt;br /&gt;
&lt;br /&gt;
Correr SIU-Mapuche x.y.z&lt;br /&gt;
Este comando permite correr el contenedor de SIU-Mapuche, con los parámetros del entrypoint mencionados anteriormente.&lt;br /&gt;
&lt;br /&gt;
docker run --detach \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--name mapuche_x.y.z hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z--reconfigure --reconfigure-alias --serve --fix-permissions --change-apache-usr&lt;br /&gt;
&lt;br /&gt;
Actualización SIU-Mapuche a x.y+1.z / &lt;br /&gt;
Exportar instancia&lt;br /&gt;
En primer lugar se debe exportar la instancia de la versión anterior.&lt;br /&gt;
&lt;br /&gt;
docker exec -i mapuche_x.y.z /usr/local/app/bin/toba instancia exportar_local -­i produccion&lt;br /&gt;
Luego copiar la instancia exportada fuera del contenedor&lt;br /&gt;
&lt;br /&gt;
docker cp mapuche_x.y.z:/usr/local/app/instalacion /tmp/instalacion_exportada/&lt;br /&gt;
&lt;br /&gt;
Migración de db negocio, db toba e importación de usuarios y perfiles&lt;br /&gt;
Finalmente correr el comando de migración con la imagen de la nueva versión. En este ejemplo se monta un volumen con la instalación exportada en el paso anterior. El comando docker:db-actualizar realiza la migración de la base de negocio, de la base de toba y la migración de usuarios y perfiles.&lt;br /&gt;
&lt;br /&gt;
docker run --rm -it \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
-v /tmp/instalacion_exportada:/tmp/instalacion_exportada \&lt;br /&gt;
--name mapuche-update-db hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z -- bin/instalador docker:db-actualizar -p /tmp/instalacion_exportada --no-interaction --no-progress&lt;br /&gt;
&lt;br /&gt;
Correr SIU-Mapuche x.y+1.z&lt;br /&gt;
docker run --detach \&lt;br /&gt;
--env APACHE_RUN_USER=$(id -u) \&lt;br /&gt;
--env-file instalador.env \&lt;br /&gt;
--name mapuche_x.y+1.z hub.siu.edu.ar:5005/siu/mapuche/mapuche:vx.y.z --reconfigure --reconfigure-alias --serve --fix-permissions --change-apache-usr --compilar-perfiles&lt;/div&gt;</summary>
		<author><name>Ndominguez</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101344</id>
		<title>SIU-Mapuche/Version3.26.1/Instalacion</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche/Version3.26.1/Instalacion&amp;diff=101344"/>
				<updated>2024-07-29T16:21:21Z</updated>
		
		<summary type="html">&lt;p&gt;Ndominguez: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;[[SIU-Mapuche/version3.26.1|&amp;lt; Documentación versión]]&lt;br /&gt;
&lt;br /&gt;
== Requerimientos ==&lt;br /&gt;
&lt;br /&gt;
Para poder comenzar con la instalación como requisito previo debe tener conexión a internet, tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.&lt;br /&gt;
&lt;br /&gt;
Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar. &lt;br /&gt;
&lt;br /&gt;
Las versiones recomendadas son las siguientes:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
!Requisito!!Versión&lt;br /&gt;
|-&lt;br /&gt;
|PostgreSQL&lt;br /&gt;
||11.x&lt;br /&gt;
|-&lt;br /&gt;
|Apache&lt;br /&gt;
||2.4.x&lt;br /&gt;
|-&lt;br /&gt;
|PHP&lt;br /&gt;
||7.3.x (con las extensiones: php_dbase, php_gd, php_mbstring, php_pdo, php_pdo_pgsql,php_xsl, php_zip, phpCAS, simplesamlphp, securimage, poidsy, php_soap)&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Instalación ==&lt;br /&gt;
&lt;br /&gt;
La instalación del sistema SIU-Mapuche se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.&lt;br /&gt;
&lt;br /&gt;
=== Pasos previos a un proceso de instalación ===&lt;br /&gt;
&lt;br /&gt;
#Descargar el sistema de SIU-Mapuche desde el sitio http://portal.comunidad.siu.edu.ar/ cuyo nombre es '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche_X.Y.Z.zip''''. &lt;br /&gt;
#Descomprimir el archivo y copiar el directorio donde se desea instalar el sistema.&lt;br /&gt;
#Luego ingresar al directorio recién descomprimido de SIU-Mapuche (ultima versión) y ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
composer install --no-dev&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#Copiar el archivo instalador.env.dist y renombrar a instalador.env, en linux se puede utilizar el siguiente comando: &lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
cp instalador.env.dist instalador.env&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
#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 Mapuche y la de Toba queden dentro de una misma base de datos (como es la opción por defecto). Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link:  [http://documentacion.siu.edu.ar/wiki/SIU-Mapuche/version2.6.0instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]&lt;br /&gt;
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:&lt;br /&gt;
#:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
chmod +x bin/instalador&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Instalación desde cero ===&lt;br /&gt;
&lt;br /&gt;
Para realizar una instalación de cero, puede realizarla en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.&lt;br /&gt;
&lt;br /&gt;
El instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:&lt;br /&gt;
&lt;br /&gt;
Para instalar en entorno de producción con una base de datos existente vacía ejecutar:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía (demo_universidad):&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar --crear-db&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir.&lt;br /&gt;
&lt;br /&gt;
Si desea obtener mas ayuda sobre el comando de instalación ejecutar&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:instalar -h&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Actualización ==&lt;br /&gt;
&lt;br /&gt;
=== Recomendaciones previas a la actualización ===&lt;br /&gt;
&lt;br /&gt;
Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración del entorno de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche-anterior/instalacion/entorno_toba.env''''&lt;br /&gt;
&lt;br /&gt;
Para el caso de una instalación en un sistema operativo Linux la estructura del archivo sera la siguiente, verificar si se encuentra correctamente configurado nuestra ruta de instalación a SIU-Mapuche&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
export TOBA_DIR=/ruta_instalacion_mapuche/vendor/siu-toba/framework&lt;br /&gt;
export TOBA_INSTANCIA=produccion&lt;br /&gt;
export TOBA_INSTALACION_DIR=/ruta_instalacion_mapuche/instalacion&lt;br /&gt;
export PATH=&amp;quot;$TOBA_DIR/bin:$PATH&amp;quot;&lt;br /&gt;
echo &amp;quot;Entorno cargado.&amp;quot;&lt;br /&gt;
echo &amp;quot;Ejecute 'toba' para ver la lista de comandos disponibles.&amp;quot;&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
===== Verificar configuración de la instancia de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '&amp;lt;nowiki/&amp;gt;'''SIU-Mapuche/instalacion/i__produccion/instancia.ini'&amp;lt;nowiki/&amp;gt;''' y dentro de este verificar si esta configurado el parámetro '&amp;lt;nowiki/&amp;gt;'''usar_perfiles_propios = &amp;quot;1&amp;quot;'''' el cual es &lt;br /&gt;
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.&lt;br /&gt;
&lt;br /&gt;
===== Verificar permisos de lectura y escritura de la instalación anterior =====&lt;br /&gt;
&lt;br /&gt;
Durante el proceso de actualización es necesario que el usuario del sistema el cual ejecuta el instalador tenga permisos de lectura y escritura sobre el SIU-Mapuche anterior.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Actualización de una instalación ===&lt;br /&gt;
&lt;br /&gt;
Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Mapuche/Version_X.Y.Z/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]&lt;br /&gt;
&lt;br /&gt;
Para actualizar en entorno de producción se ejecuta el siguiente comando:&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Post Instalación/Actualización ==&lt;br /&gt;
&lt;br /&gt;
Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.&lt;br /&gt;
&lt;br /&gt;
=== Verificar archivo de log del instalador ===&lt;br /&gt;
El instalador durante el proceso de ejecución de cada comando genera un archivo de log en la raíz del proyecto, dentro de este archivo se encuentra detallado toda la historia de ejecución de procesos y &lt;br /&gt;
en el podemos detectar cualquier tipo de error o advertencia que pueda ocurrir durante su ejecución, por eso es de mucha utilidad verificar este archivo y ayuda a entender cualquier falla.&lt;br /&gt;
&lt;br /&gt;
Una de las alternativas para visualizar el archivo de log es de la siguiente manera:&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
less instalador.log&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Modificar permisos ===&lt;br /&gt;
Permite modificar los permisos del proyecto, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración. &lt;br /&gt;
&lt;br /&gt;
Al ejecutar el comando intentara identificar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache, con la posibilidad de definir ambos parámetros en el caso de que sean distintos a los sugeridos.&lt;br /&gt;
&lt;br /&gt;
Ejecute el siguiente comando como superusuario: &lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Como parámetros opcionales se puede enviar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache como argumentos mediante el siguiente parámetro:&lt;br /&gt;
&lt;br /&gt;
:&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
sudo ./bin/instalador permisos:simple -U usuario -W www-data&lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Configuración del servidor de aplicaciones ===&lt;br /&gt;
&lt;br /&gt;
Para la configuración del servidor web les proponemos las siguientes opciones.&lt;br /&gt;
&lt;br /&gt;
Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;source lang=&amp;quot;bash&amp;quot; enclose=&amp;quot;div&amp;quot;&amp;gt;&lt;br /&gt;
ln -s /ruta_instalacion/mapuche/instalacion/toba.conf /etc/apache2/sites-enabled/mapuche_xyz.conf    &lt;br /&gt;
&amp;lt;/source&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.&lt;br /&gt;
&lt;br /&gt;
== Docker ==&lt;/div&gt;</summary>
		<author><name>Ndominguez</name></author>	</entry>

	<entry>
		<id>https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche&amp;diff=101340</id>
		<title>SIU-Mapuche</title>
		<link rel="alternate" type="text/html" href="https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Mapuche&amp;diff=101340"/>
				<updated>2024-07-25T15:47:07Z</updated>
		
		<summary type="html">&lt;p&gt;Ndominguez: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOTOC__&lt;br /&gt;
&lt;br /&gt;
[[Archivo:siu-mapuche.png|derecha|link=]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
SIU-Mapuche recoge toda la información de los RRHH de una institución en un Legajo Electrónico Único (sistema integrado), está diseñado para brindar al operador -ya sea al trabajador del área o al encargado de liquidaciones- todos los servicios necesarios para disminuir las posibilidades de error y hacer más sencillo su trabajo, teniendo en cuenta los cambios en la legislación laboral vigente.&lt;br /&gt;
&lt;br /&gt;
== Trabajemos juntos para poner en marcha el sistema ==&lt;br /&gt;
&lt;br /&gt;
La implementación del sistema es una etapa vital para asegurar su correcto funcionamiento a futuro, es el proceso que sienta las bases y, por lo tanto, requiere de una especial atención. Es muy importante que prestes atención a las recomendaciones y realices todas las consultas que consideres necesarias para asegurarte que vas en el camino correcto. Acá podes ver los distintos canales en los que podés interactuar con el equipo de implementación y demás miembros de la comunidad.&lt;br /&gt;
&lt;br /&gt;
== Primeros pasos... todo lo que tenés que saber para poner el sistema en marcha ==&lt;br /&gt;
&lt;br /&gt;
===== [https://documentacion.siu.edu.ar/wiki/C%C3%B3mo_obtener_el_Ecosistema_SIU Conformación del equipo de implementación] =====&lt;br /&gt;
&lt;br /&gt;
===== [http://www.siu.edu.ar/rd/institucional/Requerimientos_Equipamiento.pdf Requerimientos Mínimos de Equipamiento] =====&lt;br /&gt;
&lt;br /&gt;
===== [[SIU-Mapuche/Plan de implementacion|Plan de Implementación]] =====&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Documentación ==&lt;br /&gt;
'''[[SIU-Mapuche/version3.26.1|Versión 3.26.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.26.0|Versión 3.26.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.25.1|Versión 3.25.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.25.0|Versión 3.25.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.24.0|Versión 3.24.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.23.0|Versión 3.23.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.22.1|Versión 3.22.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.22.0|Versión 3.22.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.21.0|Versión 3.21.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.20.0|Versión 3.20.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.19.0|Versión 3.19.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.18.0|Versión 3.18.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.17.0|Versión 3.17.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.16.0|Versión 3.16.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.15.1|Versión 3.15.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.15.0|Versión 3.15.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.14.0|Versión 3.14.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.13.0|Versión 3.13.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.12.3|Versión 3.12.3]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.12.2|Versión 3.12.2]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.12.1|Versión 3.12.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.12.0|Versión 3.12.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.11.1|Versión 3.11.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.11.0|Versión 3.11.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.10.2|Versión 3.10.2]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.10.1|Versión 3.10.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.10.0|Versión 3.10.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.9.1|Versión 3.9.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.9.0|Versión 3.9.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.8.0|Versión 3.8.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.7.0|Versión 3.7.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.6.1|Versión 3.6.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.6.0|Versión 3.6.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.5.1|Versión 3.5.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.5.0|Versión 3.5.0]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.4.5|Versión 3.4.5]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.4.4|Versión 3.4.4]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.4.3|Versión 3.4.3]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.4.2|Versión 3.4.2]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.4.1|Versión 3.4.1]]'''&lt;br /&gt;
&lt;br /&gt;
'''[[SIU-Mapuche/version3.4.0|Versión 3.4.0]]'''&lt;/div&gt;</summary>
		<author><name>Ndominguez</name></author>	</entry>

	</feed>