UYUNI Common Workflows User Guide

UYUNI Common Workflows

Pròleg

Capítol 1

Fluxos de treball comuns

Uyuni 2026.04/XNUMX

The Uyuni Common Workflows Guide provides step-by-step instructions for the most frequently used workflows to install, manage, and configure clients with Uyuni.

Each workflow in this guide has a clear objective and includes detailed steps to help you achieve it efficiently.

Designed for both routine and advanced tasks, this guide not only explains the actions you take but also highlights the available options at each stage.

Throughout this guide, each routine task is referred to as a Workflow.

Data de publicació: 2026-04-29

Incorporació del client

Capítol 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.

Cas d'ús

Aquest flux de treball us mostra com incorporar un client al vostre servidor Uyuni.

The client must be running a supported Linux operating system. For a list of supported client systems, see Client-configuration › Supported-features.

Aquesta és una de les primeres tasques que heu de fer quan configureu Uyuni per primera vegada, i probablement ho haureu de fer moltes més vegades a mesura que utilitzeu el producte.

Resultat

When you have completed this workflow, your client is on boarded, and it can be seen in the systems list of the Uyuni Web IU. A continuació, podeu utilitzar Uyuni per gestionar el client.

Preparació

Abans de començar, ja hauríeu de tenir:

• Uyuni Server instal·lat, al qual podeu accedir mitjançant el Web IU.
• Màquina client amb un sistema operatiu instal·lat, al qual podeu accedir a través de la xarxa on es troba el vostre servidor Uyuni, mitjançant SSH.
• Subscripcions adequades de http://scc.suse.com pels productes que utilitzeu.

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.

Instruccions de flux de treball pas a pas

Procediment: Configure a Fully Qualified Domain Name (FQDN) on Your Client

1. Al client, a l'indicador d'ordres, mostreu el nom d'amfitrió actual:
   hostname -f
   Aquesta ordre probablement retornarà un error o mostrarà alguna cosa com localhost.
2. Estableix un nom d'amfitrió nou. El vostre nou nom d'amfitrió hauria de tenir un nom de subdomini i, per tant, incloure almenys dos punts. En aquest example, we are using client1.MLM.example
   hostnamectl set-hostname client1.MLM.example
3. Comproveu que el vostre canvi s'hagi realitzat correctament:
   hostnamectl
4. Open YaST and navigate to Network Services › Hostnames. Edit the hostname to match the one you just
   set, and click [D'ACORD].
5. In YaST, navigate to System › Network Settings and go to the Hostname/DNS tab. In the Static hostname field, type your new hostname.
6. Comproveu que el canvi s'hagi realitzat correctament:
   hostname -f
   This command should return your new FQDN

Procediment: preparar els canals de programari al servidor d'Uyuni

1. A l'Uyuni Web IU, navegueu a Admin › Setup Wizard.
2. A la pestanya Credencials de l'organització, assegureu-vos d'haver introduït les credencials de SUSE Customer Center i d'haver autenticat correctament.
3. A la pestanya Productes, assegureu-vos que el catàleg de productes estigui completament actualitzat:
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 [Afegeix productes ]:
5. Espereu que els canals del producte es sincronitzin completament. Depenent dels productes que hàgiu escollit, això pot trigar molt de temps.

Procedure: Create an Activation Key

1. A l'Uyuni Web IU, navegueu a Sistemes › Activation Keys, i feu 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 [Crea la clau d'activació].

Procediment: Bootstrap el client

1. A l'Uyuni Web IU, navegueu a Systems › Bootstrapping.
2. Escriviu el nom d'amfitrió i proporcioneu les credencials d'autenticació per al client que voleu incorporar i seleccioneu la clau d'activació. Feu clic [Bootstrap]:
3. Navega a Systems › System List to manage your new client

Temes relacionats

• 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.

Actualització dels clients mitjançant accions recurrents

Capítol 3

Aquest flux de treball mostra com automatitzar l'actualització dels clients registrats a Uyuni mitjançant accions recurrents.

Use case / Situation

L'actualització automàtica dels clients és beneficiosa quan:

• es vol actualitzar un gran nombre de clients
• el flux de treball no s'ha de tornar a fer cada execució
• existeix una finestra de manteniment dedicada.

Resultat / Resolució

La finalització correcta d'aquest flux de treball dóna com a resultat un estat coherent i compatible.

Preparació

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

Per actualitzar un client calen dos passos. Un tercer pas és opcional però molt recomanable per finalitzar el procés d'actualització.

Procediment: Creating a recurring action to update Salt itself

1. Com a exampi, creem l'acció per actualitzar la pròpia Salt com a acció recurrent per a tots els sistemes de l'organització. A l'Uyuni Web IU, navegueu a Home › My Organization › Recurring Actions i feu clic [Create].
2. Select Action Type Personalitzat Estat and enter a Schedule Name like update salt .
3. Seleccioneu un horari. Per exampel, Weekly: Wednesday, 9:00 am .
4. Assigneu l'estat d'actualització de sal marcant la casella de selecció.
5. Feu 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. Feu clic [Create Schedule] to save the action.

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

1. Com a example we create the action to apply all updates as a recurring action for a system group called infra-services. A l'Uyuni Web UI go to Systems › System Groups and click on infra-services.
2. Now go to Recurring Actions and click [Create].
3. Select Action Type Custom State and enter a Schedule Name like full system-update.
4. Seleccioneu una programació. Per exampel, 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 actualitzat by selecting the checkboxes. To perform a reboot afterwards you can also add reboot or reboot if needed.
6. Save the action by clicking [Desa els canvis ].
7. You can edit the execution order of the states. The order should be util. syn call, certs, channels, actualitzat and finally reboot or reboot if needed if chosen. Click [Confirmar] to store the order.
8. Feu clic [Create Schedule] to save the action.

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

1. Com a example, we create the action to apply the high state for the same group which was fully updated before. In the Uyuni Web IU, navegueu a Systems › System Groups and click infra-services.
2. Go to Recurring Actions and click [Create].
3. Select Action Type Estat alt and enter a Schedule Name like high state .
4. Seleccioneu una programació. Per exampel, Weekly: Wednesday, 10:30 am . Again, keep enough time between this action and the full-system-update action.
5. Feu clic [Create Schedule] to save the action.

Background information on up-to-date state

1. El actualitzat state applies critical patches to the update components.
   • a. On SUSE-based systems, the state executes the command:
     zypper --non-interactive patch --updatestack-only
     And then, the state also updates Salt.
   • 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.
   Reboot detection is specific to the client operating system.
   • For Debian or Ubuntu, see https://www.debian.org/doc/debian-policy/ch-opersys.html#signaling-that-a-reboot-is-required.
   • For non-transactional SUSE clients, Uyuni reboots the client when zypper -x list-patches indicates that the patches require a reboot.
   • For transactional SUSE clients, Uyuni reboots the client if there is a pending transaction.
   • 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

Temes relacionats

• For more information about recurring actions, see Recurring Actions.
• For more information about custom info values, see Client-configuration › Custom-info.

Gestió de la configuració

Capítol 4

Podeu utilitzar la configuració files i canals per gestionar la configuració dels vostres clients, en lloc de configurar cada client manualment. Aquest flux de treball us mostra com utilitzar l'Uyuni Web Interfície d'usuari per crear una configuració gestionada de manera centralitzada file, assigneu-lo a un client i apliqueu la configuració.

Cas d'ús

Si esteu gestionant molts clients, probablement no vulgueu aplicar manualment els paràmetres de configuració a cadascun d'ells al seu torn. Els canals de configuració s'utilitzen per organitzar la configuració files. Podeu subscriure clients als canals de configuració i desplegar la configuració files segons sigui necessari.

Resultat

Quan hàgiu completat aquest flux de treball, tindreu un canal de configuració que conté una configuració file, han assignat clients al canal i han aplicat la configuració correctament.

Preparació

Abans de començar, ja hauríeu de tenir:

• Uyuni Server instal·lat, al qual podeu accedir mitjançant el Web IU.
• Almenys un client registrat al vostre servidor.
• Subscripcions adequades de http://scc.suse.com pels productes que utilitzeu.

Aquest flux de treball utilitza una configuració gestionada de manera centralitzada file and a Salt state. For more information about the different ways to manage configuration, see Client-configuration › Configuration-management.

Instruccions de flux de treball pas a pas

Procediment: Creeu un nou canal de configuració i File

1. A l'Uyuni Web IU, navegueu a Configuration › Channels i feu clic [Create State Channel].
2. Escriviu un nom, una etiqueta i una descripció per a la vostra configuració filei escriviu el contingut de la vostra configuració file. Un example that you can copy is at the end of this section.

Procediment: Assigneu clients al canal de configuració

1. A l'Uyuni Web IU, navegueu a Systems › Systems List and select the client you want to assign to your configuration channel.
2. Aneu a la pestanya Configuració. Al menú: Configuració acabadaview secció, feu 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 ] per acabar.

Procediment: apliqueu la configuració al vostre client

1. A l'Uyuni Web IU, navegueu a 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 [Deploy all managed config files ]

Example

Estat SLS per mantenir els clients actualitzats

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 %}

Temes relacionats

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

Gestió del cicle de vida del contingut

Capítol 5

Si esteu gestionant molts clients i necessiteu aplicar-los paquets personalitzats, podeu utilitzar la gestió del cicle de vida del contingut (CLM) per gestionar els vostres paquets. CLM us permet personalitzar i provar paquets abans d'actualitzar els clients de producció. També és útil si necessiteu aplicar actualitzacions durant un període de manteniment limitat.

Cas d'ús

La gestió del cicle de vida del contingut us permet seleccionar canals de programari com a fonts, ajustar-los segons sigui necessari per al vostre entorn i provar-los a fons abans d'instal·lar-los als vostres clients de producció. Podeu utilitzar CLM per gestionar els vostres canals de programari des del desenvolupament, passant per proves i implementant els canvis als vostres clients.

Resultat

Quan hàgiu completat aquest flux de treball, tindreu configurat un projecte de cicle de vida del contingut. Haureu creat un projecte bàsic de CLM i l'haureu promogut al llarg del seu cicle de vida.

Preparatius

Abans de començar, ja hauríeu de tenir:

• Uyuni Server deployed, and accessible using the Web IU.
• Màquina client amb un sistema operatiu instal·lat, al qual podeu accedir a través de la xarxa on es troba el vostre servidor Uyuni, mitjançant SSH.
• Subscripcions adequades de http://scc.suse.com pels productes que utilitzeu.

Instruccions de flux de treball pas a pas

Procediment: creeu un nou projecte CLM

1. A l'Uyuni Web IU, navegueu a Content Lifecycle › Projects section, and click [Create Project].
   Type a name, label, and description for your project, and click [Create].
2. In the Sources section, click [Attach/Detach Sources ].
   Select the source type, and select a base channel for your project.
   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 [Desa] to return to the project page.
3. Deixeu la secció Filtres en blanc de moment, no els farem servir en aquest exempleample. Podeu afegir filtres més endavant si ho necessiteu.
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. Feu clic [Construir] to build version 1 of your project:

Procediment: assignar clients

1. Navega a Systems › System List, select the client to assign, and go to the Software › Software Channels pestanya.
2. In the Base Channel section, select the CLM project and environment you want to assign the client to.
   Per example, 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. Feu clic [Pròxim] to assign the client.

Procediment: Promoció dels Entorns

1. A l'Uyuni Web IU, navegueu a 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.

Temes relacionats

• For more information about CLM, including information about how to use filters, see Administration › Content-lifecycle.
• Per a CLM examples, veus Administration › Content-lifecycle-examples.

Customize Apache Configuration

Capítol 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.

Cas d'ús

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.

Resultat

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

Preparació

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 (per example, custom_ tuning. conf) and add your required Apache directives.
5. Un cop hàgiu desat el vostre file, exit the container with command:
   exit
6. Restart the Uyuni services to apply the changes:
   mgradm restart

Actualització del producte mitjançant Web UI

Capítol 7

Si voleu actualitzar el paquet de client SUSE Linux Enterprise registrat a una versió més nova del producte, podeu fer-ho a la línia d'ordres o mitjançant Web IU.

Aquest document descriu i il·lustra amb detall l'actualització del producte mitjançant el Web IU.

Les versions de producte utilitzades no reflecteixen les últimes versions disponibles. S'utilitzen només amb finalitats il·lustratives. Com a exampel procediment següent descriu l'actualització a la versió 15 SP5 des de la versió 15 i anterior. Si us orienteu a una versió diferent, seleccioneu els canals i les versions corresponents.

Procediment: Actualització del producte a una versió més nova utilitzant Web UI

1. Inicieu sessió a Uyuni Web UI and navigate to Admin › Setup Wizard › Products and search for SUSE Linux Enterprise Server 15 SP5 x86_64.
2. Seleccioneu els canals recomanats.
3. Feu clic [Add Products ].
4. Navega a Systems › Registered client › Software › Product Migration. You will see the targets available for that registered client.
5. Seleccioneu SUSE Linux Enterprise Server 15 SP5 x86_64. Això s'ampliarà encara més.
6. Seleccioneu Target Base Channel com a SLE-Product-SLES15-SP5-Pool per a x86_64. Manteniu l'opció Permet el canvi de proveïdor desmarcada.
7. Feu clic [Schedule Migration]. The message will be highlighted It is better to do a dry run first so continuing with dry run first.
8. Feu clic a [Cursa en sec] and check the status of the simulation in Events › History. You should see a return code 0 indicating a successful dry run.
9. Feu 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. A l'Uyuni Web UI side, verify the successfully completed product upgrade by going to Systems › Registered client › Details.
12. Al costat del client, podeu verificar-ho executant:
    cat /etc/os-release
13. La sortida serà semblant 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/"

Llicència de documentació lliure GNU

Capítol 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ÀMBUL

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.

Hem dissenyat aquesta llicència per utilitzar-la per a manuals de programari lliure, perquè el programari lliure necessita documentació gratuïta: un programa lliure hauria de venir amb manuals que proporcionin les mateixes llibertats que el programari. Però aquesta llicència no es limita als manuals de programari; es pot utilitzar per a qualsevol obra textual, independentment de la temàtica o si es publica com a llibre imprès. Recomanem aquesta llicència principalment per a obres que tinguin com a finalitat la instrucció o la referència.

APLICABILITAT I DEFINICIONS

Aquesta llicència s'aplica a qualsevol manual o altre treball, en qualsevol mitjà, que contingui un avís col·locat pel titular dels drets d'autor dient que es pot distribuir sota els termes d'aquesta llicència. Aquest avís atorga una llicència mundial, lliure de drets d'autor, de durada il·limitada, per utilitzar aquesta obra en les condicions que s'estableixen aquí. El "Document", a continuació, fa referència a qualsevol manual o treball d'aquest tipus. Qualsevol membre del públic és un llicenciatari i s'adreça com a "tu". Accepteu la llicència si copieu, modifiqueu o distribuïu l'obra d'una manera que requereixi permís segons la llei de drets d'autor.

Una "Versió modificada" del Document significa qualsevol obra que contingui el Document o una part del mateix, ja sigui copiada textualment, amb modificacions i/o traduïda a un altre idioma.

Una "Secció secundària" és un apèndix nomenat o una secció principal del Document que tracta exclusivament de la relació dels editors o autors del Document amb el tema general del Document (o amb qüestions relacionades) i no conté res que pugui caure directament. dins d'aquesta assignatura global. (Per tant, si el Document és en part un llibre de text de matemàtiques, una Secció Secundària pot no explicar cap matemàtica.) La relació podria ser una qüestió de connexió històrica amb l'assignatura o amb qüestions relacionades, o de caràcter jurídic, comercial, filosòfic, ètic. o posició política respecte a ells.

Les "Seccions Invariants" són determinades Seccions Secundàries els títols de les quals es designen, com els de les Seccions Invariants, a l'avís que diu que el Document es publica sota aquesta Llicència. Si una secció no s'ajusta a la definició anterior de secundària, no es pot designar com a invariant. El document pot contenir zero seccions invariants. Si el document no identifica cap secció invariant, no n'hi ha cap.

Els "Textos de coberta" són determinats passatges breus de text que s'enumeren, com a Textos de la portada o de la contraportada, a l'avís que diu que el Document es publica sota aquesta Llicència. Un text de portada pot tenir com a màxim 5 paraules i un text de contraportada pot tenir com a màxim 25 paraules.

Una còpia "transparent" del document significa una còpia llegible per màquina, representada en un format l'especificació del qual està disponible per al públic en general, que és adequada per revisar el document directament amb editors de text genèrics o (per a imatges compostes per píxels) pintura genèrica. programes o (per a dibuixos) algun editor de dibuixos àmpliament disponible, i que és adequat per a l'entrada a formatadors de text o per a la traducció automàtica a una varietat de formats adequats per a l'entrada a formatadors de text. Una còpia feta en una altra manera transparent file El format del qual el marcatge, o l'absència d'etiquetatge, s'hagi organitzat per frustrar o desanimar la modificació posterior per part dels lectors no és Transparent. Un format d'imatge no és transparent si s'utilitza per a una quantitat substancial de text. Una còpia que no és "Transparent" s'anomena "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. ExampEls fitxers de formats d'imatge transparents inclouen PNG, XCF i JPG. Els formats opacs inclouen formats propietaris que només poden ser llegits i editats per processadors de text propietaris, SGML o XML per als quals la DTD i/o les eines de processament no estan generalment disponibles, i l'HTML, PostScript o PDF generat per màquina produït per alguns processadors de text per a només amb finalitats de sortida.

La "Pàgina de títol" significa, per a un llibre imprès, la pròpia pàgina de títol, més les pàgines següents que siguin necessàries per contenir, de manera llegible, el material que aquesta Llicència requereix per aparèixer a la pàgina de títol. Per a les obres en formats que no tenen cap portada com a tal, "Pàgina de títol" significa el text proper a l'aparença més destacada del títol de l'obra, abans de l'inici del cos del text.

Una secció "XYZ titulada" significa una subunitat anomenada del document el títol de la qual és precisament XYZ o conté XYZ entre parèntesis després del text que tradueix XYZ en un altre idioma. (Aquí XYZ significa un nom de secció específic esmentat a continuació, com ara "Agraïments", "Dedicacions", "Avals" o "Història".) "Preservar el títol" d'aquesta secció quan modifiqueu el document significa que segueix sent una secció "Títol XYZ" segons aquesta definició.

El document pot incloure exempcions de responsabilitat de la garantia al costat de l'avís que indica que aquesta llicència s'aplica al document. Es considera que aquestes exempcions de responsabilitat de la garantia s'inclouen per referència en aquesta llicència, però només pel que fa a les exempcions de garanties: qualsevol altra implicació que aquestes exempcions de responsabilitat puguin tenir és nul·la i no té cap efecte sobre el significat d'aquesta llicència.

CÒPIA 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.

També podeu prestar còpies, amb les mateixes condicions indicades anteriorment, i podeu mostrar còpies públicament.

CÒPIA EN QUANTITAT

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 els textos necessaris per a qualsevol de les cobertes són massa voluminosos per encaixar de manera llegible, hauríeu de posar els primers llistats (tants com siguin raonables) a la portada real i continuar la resta a les pàgines adjacents.

Si publiqueu o distribuïu còpies opaques del document amb una numeració superior a 100, haureu d'incloure una còpia transparent llegible per màquina juntament amb cada còpia opaca, o bé indicar a cada còpia opaca una ubicació de la xarxa informàtica des de la qual la xarxa general- using public té accés a descarregar mitjançant protocols de xarxa estàndard públics una còpia transparent completa del document, sense material afegit. Si utilitzeu aquesta darrera opció, haureu de prendre mesures raonablement prudents, quan comenci a distribuir còpies opaques en quantitat, per assegurar-vos que aquesta còpia transparent romandrà així accessible al lloc indicat fins almenys un any després de l'última vegada que distribuïu una còpia. Còpia opaca (directament o a través dels vostres agents o minoristes) d'aquesta edició al públic.

Es demana, però no és obligatori, que us poseu en contacte amb els autors del Document molt abans de redistribuir un gran nombre de còpies, per donar-los l'oportunitat de proporcionar-vos una versió actualitzada del Document.

MODIFICACIONS

Podeu copiar i distribuir una versió modificada del document d'acord amb les condicions de les seccions 2 i 3 anteriors, sempre que allibereu la versió modificada precisament sota aquesta llicència, amb la versió modificada omplint el paper del document, donant així llicència a la distribució i modificació de la Versió Modificada a qui en tingui una còpia. A més, heu de fer aquestes coses a la versió 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ó modificada inclou seccions o apèndixs nous que es qualifiquen com a seccions secundàries i no contenen cap material copiat del document, podeu designar algunes o totes aquestes seccions com a invariants, a la vostra opció. Per fer-ho, afegiu els seus títols a la llista de seccions invariants de l'avís de llicència de la versió modificada. Aquests títols han de ser diferents de qualsevol altre títol de secció.

Podeu afegir una secció titulada "Avals", sempre que no contingui res més que aprovacions de la vostra versió modificada per part de diverses parts, per exempleample, declaracions de peer review o que el text ha estat aprovat per una organització com a definició autoritzada d'una norma.

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.

Els autors i editors del Document no donen permís per aquesta Llicència per utilitzar els seus noms per a publicitat o per afirmar o implicar l'aprovació de cap Versió Modificada.

COMBINACIÓ DE DOCUMENTS

Podeu combinar el document amb altres documents publicats sota aquesta llicència, sota els termes definits a la secció 4 anterior per a les versions modificades, sempre que inclogueu a la combinació totes les seccions invariants de tots els documents originals, sense modificar-los, i els enumereu tots. com a Seccions Invariants de la vostra obra combinada al seu avís de llicència, i que conserveu totes les seves exempcions de garantia.

El treball combinat només ha de contenir una còpia d'aquesta llicència, i es poden substituir diverses seccions invariants idèntiques per una única còpia. Si hi ha diverses seccions invariants amb el mateix nom però amb continguts diferents, feu que el títol de cada secció sigui únic afegint al final, entre parèntesis, el nom de l'autor original o de l'editor d'aquesta secció si es coneix, o bé un número únic. Feu el mateix ajust als títols de les seccions de la llista de seccions invariants de l'avís de llicència de l'obra combinada.

En la combinació, heu de combinar qualsevol apartat titulat "Història" en els diferents documents originals, formant una secció titulada "Història"; de la mateixa manera, combina qualsevol secció titulada "Agraïments" i qualsevol secció titulada "Dedicacions". Heu de suprimir totes les seccions titulades "Avals".

COL·LECCIONS DE DOCUMENTS

Podeu fer una col·lecció consistent en el document i altres documents publicats sota aquesta llicència, i substituir les còpies individuals d'aquesta llicència en els diferents documents per una única còpia inclosa a la col·lecció, sempre que seguiu les regles d'aquesta llicència per còpia textual de cadascun dels documents en tots els altres aspectes.

Podeu extreure un únic document d'aquesta col·lecció i distribuir-lo individualment sota aquesta Llicència, sempre que inseriu una còpia d'aquesta Llicència al document extret i seguiu aquesta Llicència en tots els altres aspectes pel que fa a la còpia textual d'aquest document.

AGREGACIÓ AMB OBRES INDEPENDENTS

Una compilació del document o els seus derivats amb altres documents o obres independents i independents, en o sobre un volum d'un mitjà d'emmagatzematge o distribució, s'anomena "agregat" si el copyright resultant de la compilació no s'utilitza per limitar els drets legals. dels usuaris de la compilació més enllà del que permeten les obres individuals. Quan el Document s'inclou en un conjunt, aquesta Llicència no s'aplica a les altres obres del conjunt que no siguin obres derivades del Document.

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Ó

La traducció es considera una mena de modificació, per la qual cosa podeu distribuir traduccions del document segons els termes de la secció 4. La substitució de les seccions invariants per traduccions requereix un permís especial dels seus titulars dels drets d'autor, però podeu incloure traduccions d'algunes o totes les seccions invariants a més de les versions originals d'aquestes seccions invariants. Podeu incloure una traducció d'aquesta llicència, i tots els avisos de llicència al document, i qualsevol exempció de responsabilitat de la garantia, sempre que també inclogueu la versió original en anglès d'aquesta llicència i les versions originals d'aquests avisos i exempcions de responsabilitat. En cas de desacord entre la traducció i la versió original d'aquesta Llicència o un avís o exempció de responsabilitat, prevaldrà la versió original.

Si una secció del document es titula "Agraïments", "Dedicacions" o "Història", el requisit (secció 4) per preservar el seu títol (secció 1) normalment requerirà canviar el títol real.

TERMINACIÓ

No podeu copiar, modificar, sublicenciar o distribuir el Document excepte en el que s'estableix expressament en aquesta Llicència. Qualsevol altre intent de copiar, modificar, sublicenciar o distribuir el Document és nul i automàticament cancel·larà els vostres drets en virtut d'aquesta Llicència. No obstant això, les parts que hagin rebut còpies, o drets, de vostè en virtut d'aquesta llicència no se'ls cancel·laran les llicències mentre aquestes parts segueixin complint totalment.

FUTURES REVISIONS D'AQUESTA LLICÈNCIA

La Free Software Foundation pot publicar de tant en tant versions noves i revisades de la Llicència de documentació lliure GNU. Aquestes noves versions seran similars en esperit a la versió actual, però poden diferir en detall per abordar nous problemes o preocupacions. Mireu http://www.gnu.org/copyleft/.

Cada versió de la llicència té un número de versió distintiu. Si el document especifica que s'hi aplica una versió numerada concreta d'aquesta llicència "o qualsevol versió posterior", teniu l'opció de seguir els termes i condicions d'aquesta versió especificada o de qualsevol versió posterior que s'hagi publicat (no com a esborrany) per la Free Software Foundation. Si el document no especifica un número de versió d'aquesta llicència, podeu triar qualsevol versió publicada (no com a esborrany) per la Free Software Foundation.

ANNEX: Com utilitzar aquesta llicència per als vostres documents

Copyright (c) ANY EL TEU NOM. Es concedeix permís per copiar, distribuir i/o modificar aquest document sota els termes de la Llicència de documentació lliure GNU, versió 1.2 o qualsevol versió posterior publicada per la Free Software Foundation; sense seccions invariants, sense textos de portada i sense textos de contraportada. S'inclou una còpia de la llicència a la secció titulada "Llicència de documentació lliure GNU".