UYUNI Common Workflows User Guide

UYUNI Common Workflows

Prefacio

Capítulo 1

Flujos de trabajo comunes

Uyuni 2026.04

La Guía de flujos de trabajo comunes de Uyuni proporciona instrucciones paso a paso para los flujos de trabajo más utilizados para instalar, administrar y configurar clientes con Uyuni.

Cada flujo de trabajo de esta guía tiene un objetivo claro e incluye pasos detallados para ayudarle a lograrlo de manera eficiente.

Diseñada tanto para tareas rutinarias como avanzadas, esta guía no solo explica las acciones que debe realizar, sino que también destaca las opciones disponibles en cada caso.tage.

A lo largo de esta guía, cada tarea rutinaria se denomina flujo de trabajo.

Fecha de publicación:2026-04-29

Incorporación de clientes

Capítulo 2

Uyuni is all about managing client systems. So one of the first things you need to do is onboard some clients.
This workflow shows you how to set up your Uyuni Server to manage a new client, set up the software channels you need, and bootstrap the client using an activation key.

Caso de uso

Este flujo de trabajo le muestra cómo incorporar un cliente a su servidor Uyuni.

El cliente debe ejecutar un sistema operativo Linux compatible. Para obtener una lista de sistemas cliente compatibles, consulte Client-configuration › Supported-features.

Esta es una de las primeras tareas que debes realizar cuando configuras Uyuni por primera vez, y probablemente tendrás que hacerlo muchas más veces a medida que utilices el producto.

Resultado

When you have completed this workflow, your client is on boarded, and it can be seen in the systems list of the Uyuni Web Interfaz de usuario. Luego puedes usar Uyuni para administrar el cliente.

Preparación

Antes de empezar, ya deberías tener:

• Servidor Uyuni instalado, al que puedes acceder usando el Web UI.
• Máquina cliente con un sistema operativo instalado, al que puede acceder a través de la red en la que se encuentra su Servidor Uyuni, usando SSH.
• Suscripciones apropiadas de http://scc.suse.com para los productos que estás utilizando.

This workflow uses a SUSE Linux Enterprise Server 15 SP2 operating system. You can use other Linux operating systems, but some of the steps might be different. For more information on onboarding other clients, see Client-configuration › Registration-methods.

Instrucciones de flujo de trabajo paso a paso

Procedimiento: Configurar un nombre de dominio completo (FQDN) en su cliente

1. En el cliente, en el símbolo del sistema, muestre el nombre de host actual:
   hostname -f
   Este comando probablemente devolverá un error o mostrará algo como localhost.
2. Establezca un nuevo nombre de host. Su nuevo nombre de host debe tener un nombre de subdominio y, por lo tanto, incluir al menos dos puntos. en este example, we are using client1.MLM.example
   hostnamectl set-hostname client1.MLM.example
3. Comprueba que tu cambio se ha realizado correctamente:
   hostnamectl
4. Open YaST and navigate to Network Services › Hostnames. Edit the hostname to match the one you just
   set, and click [DE ACUERDO].
5. En YaST, vaya a Sistema › Configuración de red y vaya a la pestaña Nombre de host/DNS. En el campo Nombre de host estático, escriba su nuevo nombre de host.
6. Compruebe que el cambio se realizó correctamente:
   hostname -f
   This command should return your new FQDN

Procedimiento: Preparar Canales de Software en el Servidor de Uyuni

1. en el uyuni Web UI, navegue hasta Admin › Setup Wizard.
2. En la pestaña Credenciales de la organización, asegúrese de haber ingresado sus credenciales del Centro de atención al cliente de SUSE y de estar autenticado correctamente.
3. En la pestaña Productos, asegúrese de que el catálogo de productos esté completamente actualizado:
4. Use the product search bar to find the channels you need for your client operating system. Check the channels you want to install, and click [Añadir productos ]:
5. Espere a que los canales del producto se sincronicen completamente. Dependiendo de los productos que hayas elegido, esto podría llevar mucho tiempo.

Procedimiento: crear una clave de activación

1. en el uyuni Web UI, navegue hasta Sistemas › Activation Keys, y haga clic [Create Key].
2. Give your activation key a name, and select the base channel that matches the client you want to onboard.
   This should be the product you just enabled:
3. Check the child channels to include, and any add-on system types you want clients registered with this key to have. Click [Crear clave de activación].

Procedimiento: Iniciar el cliente

1. en el uyuni Web UI, navegue hasta Systems › Bootstrapping.
2. Escriba el nombre de host y proporcione las credenciales de autenticación para el cliente que desea incorporar y seleccione la clave de activación. Haga clic en [Bootstrap]:
3. Navegar a Systems › System List to manage your new client

Temas relacionados

• For more information about supported clients and client features, see Client-configuration › Supported features.
• For more information about different onboarding methods, and instructions for clients running various operating systems, see Client-configuration › Registration-methods.
• For more information about general client concepts, see Client-configuration › Channels.

Actualización de clientes mediante acciones recurrentes

Capítulo 3

Este flujo de trabajo muestra cómo automatizar la actualización de los clientes registrados en Uyuni mediante acciones recurrentes.

Use case / Situation

La actualización automatizada de clientes es beneficiosa cuando:

• Se desea actualizar una gran cantidad de clientes
• El flujo de trabajo no debe repetirse en cada ejecución.
• Existe una ventana de mantenimiento dedicada.

Resultado / Resolución

La finalización exitosa de este flujo de trabajo da como resultado un estado consistente y compatible.

Preparación

Before you start, you should have a number of clients on boarded. It may make sense to have them sorted into groups you want to update together. In this workflow we use a system group named infra-services.

Step-by-Step workflow instructions

Para actualizar un cliente se requieren dos pasos. Un tercer paso es opcional pero muy recomendable para finalizar el proceso de actualización.

Procedimiento: Creating a recurring action to update Salt itself

1. Como exampEs decir, creamos la acción de actualizar Salt como una acción recurrente para todos los sistemas de la organización. En Uyuni Web UI, navegue hasta Home › My Organization › Recurring Actions y haga clic [Crear].
2. Select Action Type Costumbre Estado and enter a Schedule Name like update salt .
3. Seleccione un horario. Por ejemploampel, Weekly: Wednesday, 9:00 am .
4. Asigne el estado de actualización de sal seleccionando la casilla de verificación.
5. Hacer clic [Save Changes ] to save the action.
6. You can edit the execution order of the states if needed. Click [Confirmar] to confirm the order.
7. Hacer clic [Create Schedule] to save the action.

Procedimiento: Creating a recurring action to apply all available updates to the systems

1. Como example we create the action to apply all updates as a recurring action for a system group called infraestructuras. en el uyuni Web UI go to Systems › System Groups and click on infra-services.
2. Now go to Recurring Actions and click [Crear].
3. Select Action Type Custom State and enter a Schedule Name like full system-update.
4. Seleccione un horario. Por ejemploampel, Weekly: Wednesday, 9:30 am . Keep enough time between this action and the update-salt action. The update salt actions must be finished on all systems before this action should be executed.
5. Assign the states util. syn call, certs, channels and A hoy by selecting the checkboxes. To perform a reboot afterwards you can also add reboot or reboot if needed.
6. Save the action by clicking [Guardar cambios ].
7. You can edit the execution order of the states. The order should be util. syn call, certs, channels, A hoy and finally reboot or reboot if needed if chosen. Click [Confirmar] to store the order.
8. Hacer clic [Create Schedule] to save the action.

Procedimiento: Creating a recurring action to run a high state after the update

1. Como example, we create the action to apply the high state for the same group which was fully updated before. In the Uyuni Web UI, navegue hasta Systems › System Groups and click infra-services.
2. Go to Recurring Actions and click [Crear].
3. Select Action Type estado alto and enter a Schedule Name like high state .
4. Seleccione un horario. Por ejemploampel, Weekly: Wednesday, 10:30 am . Again, keep enough time between this action and the full-system-update action.
5. Hacer clic [Create Schedule] to save the action.

Background information on up-to-date state

1. El A hoy state applies critical patches to the update components.
   • a. On SUSE-based systems, the state executes the command:
     zypper --non-interactive patch --updatestack-only
     Y luego el estado también actualiza Sal.
   • b. On all the other systems, not based on SUSE, the state only updates Salt.
2. The state runs the package manager, such as dnf, yum, apt, or zypper based on what is available on the client operating system to update the rest of the packages.
   • a. The state lists all of the upgradable packages, based on the synchronized package repositories in Uyuni.
   • b. The state upgrades the packages to their latest available version by using the client’s package manager. The executed command depends on the operating system of the client:
     • i. For Debian-based clients, such as Debian or Ubuntu, the action executes apt dist-upgrade -q -y $PACKAGES.
     • ii. For RPM-based clients that are not SUSE, such as Red Hat Enterprise Linux or SUSE Liberty Linux, the action executes yum –quiet -y update $PACKAGES or dnf –quiet -y upgrade $PACKAGES (depending on the package manager the client is using).
     • iii. For non-transactional SUSE clients, such as SUSE Linux Enterprise 15, the action executes zypper –non-interactive –auto-agree-with-licenses update $PACKAGES.
     • iv. For transactional SUSE clients, the action executes the same in a transactional shell.
3. Uyuni provides the reboot and reboot if needed actions. Use one of the actions if you want your client to reboot after the package upgrade.
   La detección de reinicio es específica del sistema operativo del cliente.
   • Para Debian o Ubuntu, consulte https://www.debian.org/doc/debian-policy/ch-opersys.html#signaling-that-a-reboot-is-required.
   • Para los clientes SUSE no transaccionales, Uyuni reinicia el cliente cuando zypper -x list-patches indica que los parches requieren un reinicio.
   • Para los clientes SUSE transaccionales, Uyuni reinicia el cliente si hay una transacción pendiente.
   • For the Red Hat-based clients, Uyuni reboots the client if dnf -q needs-restarting -r indicates that a reboot is required.

For more information, see the reboot_info.py module: https://github.com/uyuni-project/uyuni/blob/master/susemanager-utils/susemanager-sls/src/modules/reboot_info.py

Temas relacionados

• Para obtener más información sobre las acciones recurrentes, consulte Acciones recurrentes.
• For more information about custom info values, see Client-configuration › Custom-info.

Gestión de configuración

Capítulo 4

Puedes usar la configuración. files y canales para gestionar la configuración de sus clientes, en lugar de configurar cada cliente manualmente. Este flujo de trabajo le muestra cómo utilizar Uyuni. Web UI para crear una configuración administrada centralmente file, asígnelo a un cliente y aplique la configuración.

Caso de uso

Si administra muchos clientes, probablemente no desee aplicar manualmente los ajustes de configuración a cada uno de ellos por turno. Los canales de configuración se utilizan para organizar la configuración. files. Puede suscribir clientes a canales de configuración e implementar la configuración. files según sea necesario.

Resultado

Cuando haya completado este flujo de trabajo, tendrá un canal de configuración que contiene una configuración file, he asignado clientes al canal y he aplicado la configuración correctamente.

Preparación

Antes de empezar, ya deberías tener:

• Servidor Uyuni instalado, al que puedes acceder usando el Web UI.
• Al menos un cliente registrado en su servidor.
• Suscripciones apropiadas de http://scc.suse.com para los productos que estás utilizando.

Este flujo de trabajo utiliza una configuración administrada centralmente file and a Salt state. For more information about the different ways to manage configuration, see Client-configuration › Configuration-management.

Instrucciones de flujo de trabajo paso a paso

Procedimiento: crear un nuevo canal de configuración y File

1. en el uyuni Web UI, navegue hasta Configuration › Channels y haga clic [Create State Channel].
2. Escriba un nombre, etiqueta y descripción para su configuración filey escriba el contenido de su configuración file. un example that you can copy is at the end of this section.

Procedimiento: Asignar Clientes al Canal de Configuración

1. en el uyuni Web UI, navegue hasta Systems › Systems List and select the client you want to assign to your configuration channel.
2. Navegue a la pestaña Configuración. En el guimenu: Configuración terminadaview sección, haga clic [Subscribe to channels ].
3. Check the configuration channel you created earlier, and click [Continue].
4. If you have more than one configuration channel, you can rank them in order of importance, or click [Update Channel Rankings ] para terminar.

Procedimiento: aplique la configuración a su cliente

1. en el uyuni Web UI, navegue hasta Systems › Systems List and select the client you want to assign to your configuration channel.
2. Navigate to the Configuration tab. In the guimenu: Configuration Actions section, click [Implementar toda la configuración administrada files ]

Example

Estado de SLS para mantener a los clientes actualizados

include:
- channels
int_keep_system_up2date_updatestack:
pkg.latest:
- pkgs:
- salt
- salt-minion
{%- if grains.os_family == 'Suse'%}
- zypper
- libzypp
{%- elif grains['os_family'] == 'RedHat' %}
{%- if grains['osmajorrelease'] >= 8 %}
- dnf
{%- else %}
- yum
{%- endif %}
{%- endif %}
- require:
- sls: channels
- order: last
int_keep_system_up2date_pkgs:
pkg.up-to-date :

- require:
- sls: channels
- pkg: int_keep_system_up2date_updatestack
- order: last
int_reboot_if_needed:
cmd.run:
- name: shutdown -r +5
{%- if grains['os_family'] == 'RedHat' and grains['osmajorrelease'] >= 8 %}
- onlyif: 'dnf -q needs-restarting -r; [ $? -eq 1 ]'
{%- elif grains['os_family'] == 'RedHat' and grains['osmajorrelease'] <= 7 %}
- onlyif: 'needs-restarting -r; [ $? -eq 1 ]'
{%- elif grains['os_family'] == 'Debian' %}
- onlyif:
- test -e /var/run/reboot-required
{%- else %}
- onlyif: 'zypper ps -s; [ $? -eq 102 ]'
{%- endif %}

Temas relacionados

• For more information about configuration management, see Client-configuration › Configuration management.
• Para más información sobre SLS files, ver: https://docs.saltproject.io/en/latest/topics/tutorials/starting_states.html.

Gestión del ciclo de vida del contenido

Capítulo 5

Si administra muchos clientes y necesita aplicarles paquetes personalizados, puede utilizar la administración del ciclo de vida del contenido (CLM) para administrar sus paquetes. CLM le permite personalizar y probar paquetes antes de actualizar los clientes de producción. También es útil si necesita aplicar actualizaciones durante un período de mantenimiento limitado.

Caso de uso

La gestión del ciclo de vida del contenido le permite seleccionar canales de software como fuentes, ajustarlos según sea necesario para su entorno y probarlos minuciosamente antes de instalarlos en sus clientes de producción. Puede utilizar CLM para gestionar sus canales de software desde el desarrollo, pasando por las pruebas y la implementación de los cambios para sus clientes.

Resultado

Cuando haya completado este flujo de trabajo, tendrá configurado un proyecto de ciclo de vida del contenido. Habrá creado un proyecto CLM básico y lo habrá promovido a lo largo de su ciclo de vida.

Preparativos

Antes de empezar, ya deberías tener:

• Servidor Uyuni implementado y accesible mediante el Web UI.
• Máquina cliente con un sistema operativo instalado, al que puede acceder a través de la red en la que se encuentra su Servidor Uyuni, usando SSH.
• Suscripciones apropiadas de http://scc.suse.com para los productos que estás utilizando.

Instrucciones de flujo de trabajo paso a paso

Procedimiento: crear un nuevo proyecto CLM

1. en el uyuni Web UI, navegue hasta Content Lifecycle › Projects section, and click [Create Project].
   Type a name, label, and description for your project, and click [Crear].
2. In the Sources section, click [Attach/Detach Sources ].
   Seleccione el tipo de fuente y seleccione un canal base para su proyecto.
   The available child channels for the selected base channel are displayed, including information on whether the channel is mandatory or recommended. Check the child channels you require, and click [Ahorrar] to return to the project page.
3. Deje la sección Filtros en blanco por ahora, no los usaremos en este ejemplo.ample. Puede agregar filtros más adelante si es necesario.
4. In the Environment Lifecycle section, create three environments: production, testing, and development. Click [Add Environment] and complete the name and label for each.
   For the production environment, leave the Insert before field blank.
   For the testing environment, in the Insert before field, select production.
   For the development environment, in the Insert before field, select testing.
5. Hacer clic [Construir] to build version 1 of your project:

Procedimiento: Asignar Clientes

1. Navegar a Systems › System List, select the client to assign, and go to the Software › Software Channels pestaña.
2. En la sección Canal base, seleccione el proyecto CLM y el entorno al que desea asignar el cliente.
   Por ejemploample, if you want this client to receive updates from your CLM only when packages are in the production environment, assign the base channel < CLM _ Project _ Name> – production-<Channel _ Name >
   Alternatively, you could use this client as a way to test if your CLM packages are working as expected before you promote them to development, so you assign the base channel < CLM _ Project _ Name> – testing – <Channel _ Name >.
3. Hacer clic [Próximo] to assign the client.

Procedimiento: Promocionar Ambientes

1. en el uyuni Web UI, navegue hasta Content Lifecycle › Projects, and select the project you want to work with.
2. In the Environment Lifecycle section, locate the environment to promote to its successor, and click [Promote]. You can monitor build progress in the Environment Lifecycle section.

Temas relacionados

• For more information about CLM, including information about how to use filters, see Administration › Content-lifecycle.
• Para CLM examples, ver Administration › Content-lifecycle-exampLos.

Customize Apache Configuration

Capítulo 6.

This workflow shows you how to add custom configuration to Uyuni components, specifically the Apache HTTP server, within a containerized environment. It ensures that your custom configurations are stored in a persisted volume and are not overwritten during image updates.

Caso de uso

This workflow is beneficial when:

• You need to overwrite or extend the default Apache configuration.
• You need to ensure that configuration changes persist after a container image update.
• You want to add specific tuning configurations to the server.

Resultado

After completing this workflow, your custom Apache configuration will be active and will persist through future updates or restarts of the Uyuni containers.

Preparación

Before you start, you should have:

• Root access to the Uyuni Server host.
• Knowledge of the specific Apache directives you wish to apply.

Step-by-step workflow instructions

You should only add new configuration files, and not modify the existing configuration files provided by the image.

Procedure: Adding custom Apache configuration files

1. Open a terminal on your Uyuni Server.
2. Access the server container shell by running the following command:
   mgrctl term
3. Navigate to the configuration directory. You must create your new configuration file in the path /etc/apache2/conf. d, as this folder is persisted.
4. Create your new configuration file (por ejemploample, custom_ tuning. conf) and add your required Apache directives.
5. Una vez que hayas guardado tu file, exit the container with command:
   exit
6. Restart the Uyuni services to apply the changes:
   mgradm restart

Actualización del producto mediante Web UI

Capítulo 7

Si desea actualizar el paquete de cliente SUSE Linux Enterprise registrado a una versión más reciente del producto, puede hacerlo en la línea de comandos o mediante Web UI.

Este documento describe e ilustra en detalle la actualización del producto utilizando el Web UI.

Las versiones de productos utilizadas no reflejan las últimas versiones reales disponibles. Se utilizan únicamente con fines ilustrativos. como un examparchivo, el siguiente procedimiento describe la actualización a la versión 15 SP5 desde la versión 15 y anterior. Si su objetivo es una versión diferente, seleccione los canales y versiones correspondientes.

Procedimiento: actualización del producto a una versión más reciente utilizando Web UI

1. Ingresa a Uyuni Web UI and navigate to Admin › Setup Wizard › Products and search for SUSE Linux Enterprise Server 15 SP5 x86_64.
2. Seleccione los canales recomendados.
3. Hacer clic [Add Products ].
4. Navegar a Systems › Registered client › Software › Product Migration. You will see the targets available for that registered client.
5. Seleccione SUSE Linux Enterprise Server 15 SP5 x86_64. Esto se expandirá aún más.
6. Seleccione el canal base de destino como SLE-Product-SLES15-SP5-Pool para x86_64. Mantenga Permitir cambio de proveedor sin marcar.
7. Hacer clic [Schedule Migration]. The message will be highlighted It is better to do a dry run first so continuing with dry run first.
8. Haga clic en [Ejecución en seco] and check the status of the simulation in Events › History. You should see a return code 0 indicating a successful dry run.
9. Hacer clic [Schedule Migration] to perform the actual product migration. The message will be highlighted on top of the screen indicating the scheduling of the action.
10. When the upgrade is complete, check the status in Events › History.
11. en el uyuni Web UI side, verify the successfully completed product upgrade by going to Systems › Registered client › Details.
12. En el lado del cliente puedes verificarlo ejecutando:
    cat /etc/os-release
13. El resultado será similar a:

NAME="SLES"
VERSION="15-SP5"
VERSION_ID="15.5"
PRETTY_NAME="SUSE Linux Enterprise Server 15 SP5"
ID="sles"
ID_LIKE="suse"
ANSI_COLOR="0;32"
CPE_NAME="cpe:/o:suse:sles:15:sp5"
DOCUMENTATION_URL="https://documentation.suse.com/"

Licencia de Documentación Libre GNU

Capítulo 8

Copyright © 2000, 2001, 2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110- 1301 USA. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

PREÁMBULO

The purpose of this License is to make a manual, textbook, or other functional and useful document “free” in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or non commercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.

This License is a kind of “copy left”, which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copy left license designed for free software.

Hemos diseñado esta Licencia para usarla en manuales de software libre, porque el software libre necesita documentación libre: un programa libre debe venir con manuales que brinden las mismas libertades que el software. Pero esta Licencia no se limita a los manuales de software; se puede utilizar para cualquier trabajo textual, independientemente del tema o si se publica como un libro impreso. Recomendamos esta Licencia principalmente para trabajos cuyo propósito sea instructivo o de referencia.

APLICABILIDAD Y DEFINICIONES

Esta Licencia se aplica a cualquier manual u otro trabajo, en cualquier medio, que contenga un aviso colocado por el titular de los derechos de autor indicando que puede distribuirse según los términos de esta Licencia. Dicho aviso otorga una licencia mundial, libre de regalías y de duración ilimitada, para utilizar ese trabajo en las condiciones aquí establecidas. El “Documento”, a continuación, se refiere a dicho manual o trabajo. Cualquier miembro del público es un titular de licencia y se le llama "usted". Acepta la licencia si copia, modifica o distribuye el trabajo de una manera que requiera permiso según la ley de derechos de autor.

Una “Versión Modificada” del Documento significa cualquier trabajo que contenga el Documento o una parte del mismo, ya sea copiado palabra por palabra, o con modificaciones y/o traducido a otro idioma.

Una “Sección Secundaria” es un apéndice con nombre o una sección preliminar del Documento que trata exclusivamente de la relación de los editores o autores del Documento con el tema general del Documento (o asuntos relacionados) y no contiene nada que pueda caer directamente dentro de ese tema general. (Por lo tanto, si el Documento es en parte un libro de texto de matemáticas, una Sección Secundaria puede no explicar ninguna matemática.) La relación podría ser una cuestión de conexión histórica con el tema o con asuntos relacionados, o de carácter legal, comercial, filosófico, ético. o posición política respecto de ellos.

Las “Secciones Invariantes” son ciertas Secciones Secundarias cuyos títulos se designan, como los de las Secciones Invariantes, en el aviso que dice que el Documento se publica bajo esta Licencia. Si una sección no se ajusta a la definición anterior de Secundaria, no se permite designarla como Invariable. El Documento puede contener cero Secciones Invariantes. Si el Documento no identifica ninguna Sección Invariable, entonces no hay ninguna.

Los "Textos de portada" son ciertos pasajes breves de texto que se enumeran, como Textos de portada o Textos de contraportada, en el aviso que dice que el Documento se publica bajo esta Licencia. Un texto de portada puede tener un máximo de 5 palabras y un texto de contraportada puede tener un máximo de 25 palabras.

Una copia "Transparente" del Documento significa una copia legible por máquina, representada en un formato cuya especificación está disponible para el público en general, que es adecuada para revisar el documento directamente con editores de texto genéricos o (para imágenes compuestas de píxeles) pintura genérica programas o (para dibujos) algún editor de dibujo ampliamente disponible, y que sea adecuado para la entrada a formateadores de texto o para la traducción automática a una variedad de formatos adecuados para la entrada a formateadores de texto. Una copia hecha en otro modo Transparente file el formato cuyo marcado, o ausencia de marcado, se ha dispuesto para impedir o desalentar la modificación posterior por parte de los lectores no es transparente. Un formato de imagen no es transparente si se usa para una cantidad sustancial de texto. Una copia que no es "Transparente" se llama "Opaca".

Examples of suitable formats for Transparent copies include plain ASCII without markup, Tex info input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. ExampLos archivos de formatos de imagen transparente incluyen PNG, XCF y JPG. Los formatos opacos incluyen formatos propietarios que pueden ser leídos y editados solo por procesadores de texto propietarios, SGML o XML para los cuales las herramientas de procesamiento y/o DTD no están generalmente disponibles, y el HTML, PostScript o PDF generado por máquina producido por algunos procesadores de texto para fines de salida únicamente.

La "Página de título" significa, para un libro impreso, la página de título en sí, más las páginas siguientes que sean necesarias para contener, de manera legible, el material que esta Licencia requiere que aparezca en la página de título. Para obras en formatos que no tienen ninguna página de título como tal, “Página de título” significa el texto cerca de la aparición más destacada del título de la obra, que precede al comienzo del cuerpo del texto.

Una sección “Titulado XYZ” significa una subunidad nombrada del Documento cuyo título es precisamente XYZ o contiene XYZ entre paréntesis a continuación del texto que traduce XYZ en otro idioma. (Aquí XYZ representa un nombre de sección específico que se menciona a continuación, como "Agradecimientos", "Dedicatorias", "Aprobaciones" o "Historia"). "Conservar el título" de dicha sección cuando modifica el Documento significa que sigue siendo una sección “Titulado XYZ” según esta definición.

El Documento puede incluir Exenciones de garantía junto al aviso que establece que esta Licencia se aplica al Documento. Se considera que estas renuncias de garantía se incluyen por referencia en esta licencia, pero solo en lo que respecta a la renuncia de garantías: cualquier otra implicación que estas renuncias de garantía puedan tener es nula y no tiene ningún efecto sobre el significado de esta licencia.

COPIA VERBÁTIMA

You may copy and distribute the Document in any medium, either commercially or non commercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3.

También puede prestar copias, en las mismas condiciones establecidas anteriormente, y puede exhibir copias públicamente.

COPIA EN CANTIDAD

If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document’s license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible.

You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects.

Si los textos requeridos para cualquiera de las portadas son demasiado voluminosos para caber de manera legible, debe colocar los primeros enumerados (tantos como quepan razonablemente) en la portada real y continuar el resto en las páginas adyacentes.

Si publica o distribuye copias Opacas del Documento que suman más de 100, debe incluir una copia Transparente legible por máquina junto con cada copia Opaca, o indicar en o con cada copia Opaca una ubicación de red informática desde la cual la red general: usando public tiene acceso para descargar usando protocolos de red estándar públicos una copia transparente completa del Documento, libre de material agregado. Si utiliza la última opción, debe tomar medidas razonablemente prudentes, cuando comience a distribuir copias opacas en cantidad, para asegurarse de que esta copia transparente permanezca accesible en el lugar indicado hasta al menos un año después de la última vez que distribuya una copia. Copia opaca (directamente o a través de sus agentes o distribuidores) de esa edición al público.

Se solicita, pero no se requiere, que se comunique con los autores del Documento mucho antes de redistribuir una gran cantidad de copias, para darles la oportunidad de brindarle una versión actualizada del Documento.

MODIFICACIONES

Usted puede copiar y distribuir una Versión Modificada del Documento bajo las condiciones de las secciones 2 y 3 anteriores, siempre que publique la Versión Modificada bajo precisamente esta Licencia, con la Versión Modificada desempeñando el papel del Documento, autorizando así la distribución y modificación de la Versión Modificada a quien posea una copia de la misma. Además, debe hacer estas cosas en la versión modificada:

• A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document).
  You may use the same title as a previous version if the original publisher of that version gives permission.
• B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement.
• C. State on the Title page the name of the publisher of the Modified Version, as the publisher.
• D. Preserve all the copyright notices of the Document.
• E. Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
• F. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
• G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document’s license notice.
• H. Include an unaltered copy of this License.
• I. Preserve the section Entitled “History”, Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled “History” in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
• J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the “History” section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
• K. For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
• L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
• M. Delete any section Entitled “Endorsements”. Such a section may not be included in the Modified Version.
• N. Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with any Invariant Section.
• O. Preserve any Warranty Disclaimers.

Si la Versión Modificada incluye nuevas secciones preliminares o apéndices que califican como Secciones Secundarias y no contienen material copiado del Documento, usted puede, a su elección, designar algunas o todas estas secciones como invariables. Para hacer esto, agregue sus títulos a la lista de Secciones Invariantes en el aviso de licencia de la Versión Modificada. Estos títulos deben ser distintos de cualquier otro título de sección.

Puede agregar una sección titulada "Aprobaciones", siempre que no contenga más que aprobaciones de su Versión modificada por parte de varias partes, por ej.ample, declaraciones de pares review o que el texto ha sido aprobado por una organización como la definición autorizada de un estándar.

You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.

El(los) autor(es) y editor(es) del Documento no dan permiso por esta Licencia para usar sus nombres con fines publicitarios o para afirmar o implicar el respaldo de cualquier Versión Modificada.

COMBINACIÓN DE DOCUMENTOS

Puede combinar el Documento con otros documentos publicados bajo esta Licencia, según los términos definidos en la sección 4 anterior para versiones modificadas, siempre que incluya en la combinación todas las Secciones Invariantes de todos los documentos originales, sin modificar, y enumere todas como Secciones invariables de su trabajo combinado en su aviso de licencia, y que conserva todas sus Exenciones de garantía.

El trabajo combinado solo necesita contener una copia de esta Licencia, y varias Secciones Invariantes idénticas pueden reemplazarse con una sola copia. Si hay varias Secciones Invariantes con el mismo nombre pero contenido diferente, haga que el título de cada sección sea único agregando al final, entre paréntesis, el nombre del autor o editor original de esa sección, si se conoce, o bien un número único Haga el mismo ajuste a los títulos de las secciones en la lista de Secciones Invariantes en el aviso de licencia de la obra combinada.

En la combinación, debe combinar las secciones tituladas "Historia" en los diversos documentos originales, formando una sección titulada "Historia"; combine igualmente las secciones tituladas "Agradecimientos" y las secciones tituladas "Dedicatorias". Debe eliminar todas las secciones Tituladas "Respaldos".

COLECCIONES DE DOCUMENTOS

Puede hacer una colección que consista en el Documento y otros documentos publicados bajo esta Licencia, y reemplazar las copias individuales de esta Licencia en los diversos documentos con una sola copia que se incluye en la colección, siempre que siga las reglas de esta Licencia para copia textual de cada uno de los documentos en todo lo demás.

Puede extraer un solo documento de dicha colección y distribuirlo individualmente bajo esta Licencia, siempre que inserte una copia de esta Licencia en el documento extraído y siga esta Licencia en todos los demás aspectos con respecto a la copia literal de ese documento.

AGREGACIÓN CON OBRAS INDEPENDIENTES

Una compilación del Documento o sus derivados con otros documentos u obras separados e independientes, en o sobre un volumen de un medio de almacenamiento o distribución, se denomina "agregado" si los derechos de autor resultantes de la compilación no se utilizan para limitar los derechos legales. de los usuarios de la compilación más allá de lo que permiten las obras individuales. Cuando el Documento se incluye en un agregado, esta Licencia no se aplica a los otros trabajos en el agregado que no son en sí mismos trabajos derivados del Documento.

If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document’s Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form.
Otherwise they must appear on printed covers that bracket the whole aggregate.

TRADUCCIÓN

La traducción se considera un tipo de modificación, por lo que puede distribuir traducciones del Documento según los términos de la sección 4. Reemplazar Secciones invariantes con traducciones requiere un permiso especial de los titulares de los derechos de autor, pero puede incluir traducciones de algunas o todas las Secciones invariantes además de las versiones originales de estas Secciones Invariantes. Puede incluir una traducción de esta Licencia y todos los avisos de licencia en el Documento, y cualquier Descargo de responsabilidad de la garantía, siempre que también incluya la versión original en inglés de esta Licencia y las versiones originales de esos avisos y descargos de responsabilidad. En caso de desacuerdo entre la traducción y la versión original de esta Licencia o un aviso o descargo de responsabilidad, prevalecerá la versión original.

Si una sección del Documento se titula "Agradecimientos", "Dedicatorias" o "Historia", el requisito (sección 4) para conservar su título (sección 1) generalmente requerirá cambiar el título real.

TERMINACIÓN

No puede copiar, modificar, otorgar sublicencias ni distribuir el Documento excepto según lo dispuesto expresamente en esta Licencia. Cualquier otro intento de copiar, modificar, sublicenciar o distribuir el Documento es nulo y anulará automáticamente sus derechos bajo esta Licencia. Sin embargo, no se rescindirán las licencias de las partes que hayan recibido copias o derechos de usted en virtud de esta Licencia, siempre y cuando dichas partes sigan cumpliendo plenamente.

FUTURAS REVISIONES DE ESTA LICENCIA

La Free Software Foundation puede publicar versiones nuevas y revisadas de la Licencia de documentación libre GNU de vez en cuando. Estas nuevas versiones serán similares en espíritu a la versión actual, pero pueden diferir en detalles para abordar nuevos problemas o inquietudes. Ver http://www.gnu.org/copyleft/.

Cada versión de la Licencia recibe un número de versión distintivo. Si el Documento especifica que se aplica una versión numerada particular de esta Licencia "o cualquier versión posterior", tiene la opción de seguir los términos y condiciones de esa versión especificada o de cualquier versión posterior que se haya publicado (no como una borrador) de la Free Software Foundation. Si el Documento no especifica un número de versión de esta Licencia, puede elegir cualquier versión publicada (no como borrador) por la Free Software Foundation.

ANEXO: Cómo usar esta Licencia para sus documentos

Copyright (c) AÑO TU NOMBRE. Se concede permiso para copiar, distribuir y/o modificar este documento bajo los términos de la Licencia de documentación libre GNU, Versión 1.2 o cualquier versión posterior publicada por la Free Software Foundation; sin secciones invariantes, sin textos de portada ni textos de contraportada. Se incluye una copia de la licencia en la sección titulada “Licencia de documentación libre GNU”.