UYUNI Common Workflows User Guide

UYUNI Common Workflows

Hitzaurrea

1. kapitulua

Lan-fluxu komunak

Uyuni 2026.04

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.

Argitalpen Data: 2026-04-29

Bezeroen barneratzea

2. kapitulua

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.

Erabilera kasua

Lan-fluxu honek bezero bat zure Uyuni zerbitzarian nola txertatu erakusten dizu.

Bezeroak onartzen duen Linux sistema eragile bat exekutatu behar du. Onartutako bezero sistemen zerrenda ikusteko, ikus Client-configuration › Supported-features.

Hau da Uyuni lehen aldiz konfiguratzen duzunean egin behar duzun lehen zereginetako bat, eta ziurrenik produktua erabiltzen duzun heinean hainbat aldiz gehiago egin beharko duzu.

Emaitza

When you have completed this workflow, your client is on boarded, and it can be seen in the systems list of the Uyuni Web UI. Ondoren, Uyuni erabil dezakezu bezeroa kudeatzeko.

Prestaketa

Hasi baino lehen, eduki beharko zenuke:

• Uyuni zerbitzaria instalatuta, erabil dezakezu atzitzeko Web UI.
• Sistema eragile bat instalatuta duen bezero-makina, zure Uyuni zerbitzaria dagoen sarean sar zaitezke, SSH erabiliz.
• Harpidetza egokiak http://scc.suse.com erabiltzen ari zaren produktuetarako.

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.

Urratsez urratseko lan-fluxuaren jarraibideak

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

1. Bezeroan, komando-gonbitan, erakutsi uneko ostalari-izena:
   hostname -f
   Komando honek ziurrenik errore bat itzuliko du, edo localhost bezalako zerbait erakutsiko du.
2. Ezarri ostalari-izen berri bat. Zure ostalari-izen berriak azpidomeinu-izen bat izan behar du eta, beraz, gutxienez bi puntu izan behar ditu. Adib honetanample, we are using client1.MLM.example
   hostnamectl set-hostname client1.MLM.example
3. Egiaztatu zure aldaketa arrakastatsua izan dela:
   hostnamectl
4. Open YaST and navigate to Network Services › Hostnames. Edit the hostname to match the one you just
   set, and click [ADOS].
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. Egiaztatu aldaketa arrakastatsua izan dela:
   hostname -f
   This command should return your new FQDN

Prozedura: Prestatu software-kanalak Uyuni zerbitzarian

1. Uyunian Web UI, nabigatu Admin › Setup Wizard.
2. Erakundearen kredentzialak fitxan, ziurtatu SUSE Customer Center-en kredentzialak sartu dituzula eta behar bezala autentifikatu duzula.
3. Produktuak fitxan, ziurtatu produktuen katalogoa guztiz eguneratuta dagoela:
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 [Gehitu produktuak ]:
5. Itxaron produktuen kanalak guztiz sinkronizatzen diren arte. Aukeratu dituzun produktuen arabera, denbora luzea izan daiteke.

Prozedura: Sortu aktibazio-gako bat

1. Uyunian Web UI, nabigatu Sistemak › Activation Keys, eta egin klik [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 [Sortu aktibazio-gakoa].

Prozedura: Bezeroa abiarazi

1. Uyunian Web UI, nabigatu Systems › Bootstrapping.
2. Idatzi ostalari-izena eta eman sartu nahi duzun bezeroaren autentifikazio-kredentzialak, eta hautatu aktibazio-gakoa. Egin klik [Bootstrap]:
3. Nabigatu Systems › System List to manage your new client

Lotutako Gaiak

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

Bezeroak eguneratzen dira ekintza errepikakorrak erabiliz

3. kapitulua

Lan-fluxu honek Uyunin erregistratutako bezeroen eguneratzea nola automatizatu erakusten du errepikatzen diren ekintzak erabiliz.

Use case / Situation

Bezeroen eguneratze automatikoa onuragarria da:

• bezero kopuru handi baten eguneratzea nahi da
• lan-fluxua ez da berriro egin behar exekuzio guztietan
• mantentze-leiho dedikatu bat dago.

Emaitza / Ebazpena

Lan-fluxu hau arrakastaz amaitzean egoera koherentea eta onargarria da.

Prestaketa

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

Bezero bat eguneratzeko bi urrats egin behar dira. Hirugarren urratsa aukerakoa da baina oso gomendagarria eguneratze-prozesua amaitzeko.

Prozedura: Creating a recurring action to update Salt itself

1. Example, Salt bera eguneratzeko ekintza sortzen dugu, erakundeko sistema guztien ekintza errepikakor gisa. Uyunian Web UI, nabigatu Home › My Organization › Recurring Actions eta egin klik [Create].
2. Select Action Type Pertsonalizatua Estatua and enter a Schedule Name like update salt .
3. Hautatu ordutegi bat. Adibidezample, Weekly: Wednesday, 9:00 am .
4. Esleitu eguneratze-gatza egoera kontrol-laukia hautatuta.
5. Egin klik [Save Changes ] to save the action.
6. You can edit the execution order of the states if needed. Click [Berretsi] to confirm the order.
7. Egin klik [Create Schedule] to save the action.

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

1. Example we create the action to apply all updates as a recurring action for a system group called azpizerbitzuak. Uyunian 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. Hautatu ordutegi bat. Adibidezample, 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 eguneratuta by selecting the checkboxes. To perform a reboot afterwards you can also add reboot or reboot if needed.
6. Save the action by clicking [Gorde aldaketak ].
7. You can edit the execution order of the states. The order should be util. syn call, certs, channels, eguneratuta and finally reboot or reboot if needed if chosen. Click [Berretsi] to store the order.
8. Egin klik [Create Schedule] to save the action.

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

1. Example, we create the action to apply the high state for the same group which was fully updated before. In the Uyuni Web UI, nabigatu Systems › System Groups and click infra-services.
2. Go to Recurring Actions and click [Create].
3. Select Action Type Egoera altua and enter a Schedule Name like high state .
4. Hautatu ordutegi bat. Adibidezample, Weekly: Wednesday, 10:30 am . Again, keep enough time between this action and the full-system-update action.
5. Egin klik [Create Schedule] to save the action.

Background information on up-to-date state

1. The eguneratuta 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

Lotutako gaiak

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

Konfigurazioaren kudeaketa

4. kapitulua

Konfigurazioa erabil dezakezu files eta kanalak zure bezeroen konfigurazioa kudeatzeko, bezero bakoitza eskuz konfiguratu beharrean. Lan-fluxu honek Uyuni nola erabili erakusten dizu Web Zentralki kudeatutako konfigurazio bat sortzeko UI file, esleitu bezero bati eta aplikatu konfigurazioa.

Erabilera kasua

Bezero asko kudeatzen ari bazara, ziurrenik ez dituzu eskuz ezarri nahi horietako bakoitzari konfigurazio-ezarpenak txandaka. Konfigurazio kanalak konfigurazioa antolatzeko erabiltzen dira files. Bezeroak konfigurazio-kanaletara harpidetu ditzakezu eta konfigurazioa zabaldu files behar bezala.

Emaitza

Lan-fluxu hau amaitzen duzunean, konfigurazio bat duen konfigurazio-kanal bat izango duzu file, bezeroak kanalari esleitu dizkiote eta konfigurazioa behar bezala aplikatu.

Prestaketa

Hasi baino lehen, eduki beharko zenuke:

• Uyuni zerbitzaria instalatuta, erabil dezakezu atzitzeko Web UI.
• Gutxienez bezero bat zure zerbitzarian erregistratu da.
• Harpidetza egokiak http://scc.suse.com erabiltzen ari zaren produktuetarako.

Lan-fluxu honek zentralki kudeatutako konfigurazio bat erabiltzen du file and a Salt state. For more information about the different ways to manage configuration, see Client-configuration › Configuration-management.

Urratsez urrats Lan-fluxuaren argibideak

Prozedura: Konfigurazio kanal berri bat sortu eta File

1. Uyunian Web UI, nabigatu Configuration › Channels eta egin klik [Create State Channel].
2. Idatzi izena, etiketa eta deskribapena zure konfiguraziorako file, eta idatzi zure konfigurazioaren edukia file. Adibample that you can copy is at the end of this section.

Prozedura: esleitu bezeroak konfigurazio kanalari

1. Uyunian Web UI, nabigatu Systems › Systems List and select the client you want to assign to your configuration channel.
2. Nabigatu Konfigurazioa fitxara. Gidaliburuan: Konfigurazioa amaituview atalean, egin klik [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 ] amaitzeko.

Prozedura: Aplikatu konfigurazioa zure bezeroari

1. Uyunian Web UI, nabigatu 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

SLS egoera bezeroak eguneratuta mantentzeko

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

Lotutako Gaiak

• For more information about configuration management, see Client-configuration › Configuration management.
• SLSri buruzko informazio gehiago lortzeko files, ikusi: https://docs.saltproject.io/en/latest/topics/tutorials/starting_states.html.

Edukiaren Bizi-zikloaren Kudeaketa

5. kapitulua

Bezero asko kudeatzen ari bazara eta pakete pertsonalizatuak aplikatu behar badituzu, edukien bizi-zikloaren kudeaketa (CLM) erabil dezakezu paketeak kudeatzeko. CLM-k paketeak pertsonalizatzeko eta probatzeko aukera ematen dizu ekoizpen-bezeroak eguneratu aurretik. Era berean, erabilgarria da eguneratzeak aplikatu behar badituzu mantentze-leiho mugatu batean.

Erabilera kasua

Edukiaren bizi-zikloaren kudeaketak software-kanalak iturburu gisa hautatzea ahalbidetzen dizu, zure ingurunerako behar den moduan doitzeko eta ondo probatu zure ekoizpen-bezeroetan instalatu aurretik. CLM erabil dezakezu zure software-kanalak kudeatzeko garapenetik, probak eta aldaketak zure bezeroei zabaltzeko.

Emaitza

Lan-fluxu hau amaitzen duzunean, edukiaren bizi-zikloko proiektu bat ezarriko duzu. Oinarrizko CLM proiektu bat sortuko duzu, eta bere bizi-zikloan sustatu.

Prestaketak

Hasi baino lehen, eduki beharko zenuke:

• Uyuni Server deployed, and accessible using the Web UI.
• Sistema eragile bat instalatuta duen bezero-makina, zure Uyuni zerbitzaria dagoen sarean sar zaitezke, SSH erabiliz.
• Harpidetza egokiak http://scc.suse.com erabiltzen ari zaren produktuetarako.

Urratsez urratseko lan-fluxuaren jarraibideak

Prozedura: CLM Proiektu berri bat sortu

1. Uyunian Web UI, nabigatu 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 [Gorde] to return to the project page.
3. Utzi oraingoz Iragazkiak atala hutsik, ez ditugu erabiliko adibide honetanample. Iragazkiak gehi ditzakezu geroago, behar izanez gero.
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. Egin klik [Eraiki] to build version 1 of your project:

Prozedura: Bezeroak esleitu

1. Nabigatu Systems › System List, select the client to assign, and go to the Software › Software Channels fitxa.
2. In the Base Channel section, select the CLM project and environment you want to assign the client to.
   Adibidezample, 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. Egin klik [Hurrengoa] to assign the client.

Prozedura: Inguruneak sustatzea

1. Uyunian Web UI, nabigatu 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.

Lotutako Gaiak

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

Customize Apache Configuration

6 kapitulua.

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.

Erabilera kasua

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.

Emaitza

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

Prestaketa

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 (adibidezample, custom_ tuning. conf) and add your required Apache directives.
5. Behin gordeta duzunean file, exit the container with command:
   exit
6. Restart the Uyuni services to apply the changes:
   mgradm restart

Produktua berritzea bidez Web UI

7. kapitulua

Erregistratutako SUSE Linux Enterprise bezero paketea produktuaren bertsio berriago batera eguneratu nahi baduzu, komando lerroan edo bidez egin daiteke. Web UI.

Dokumentu honek xehetasunez deskribatzen eta ilustratzen du produktuaren bertsio berritzea erabiliz Web UI.

Erabilitako produktuen bertsioak ez dira eskuragarri dauden azken bertsioak islatzen. Ilustraziorako soilik erabiltzen dira. Example, hurrengo prozedurak 15 SP5 bertsiora eta 15. bertsio zaharragora eguneratzea deskribatzen du. Beste bertsio batera bideratzen bazara, hautatu dagozkion kanalak eta bertsioak.

Prozedura: Produktua bertsio berriago batera eguneratzea erabiliz Web UI

1. Hasi saioa Uyuni-n Web UI and navigate to Admin › Setup Wizard › Products and search for SUSE Linux Enterprise Server 15 SP5 x86_64.
2. Hautatu gomendatutako kanalak.
3. Egin klik [Add Products ].
4. Nabigatu Systems › Registered client › Software › Product Migration. You will see the targets available for that registered client.
5. Hautatu SUSE Linux Enterprise Server 15 SP5 x86_64. Hau gehiago zabalduko da.
6. Hautatu helburuko oinarrizko kanala SLE-Product-SLES15-SP5-Pool gisa x86_64-rako. Mantendu baimendu saltzaile-aldaketa desmarkatuta.
7. Egin klik [Schedule Migration]. The message will be highlighted It is better to do a dry run first so continuing with dry run first.
8. Egin klik [Korrika lehorra] and check the status of the simulation in Events › History. You should see a return code 0 indicating a successful dry run.
9. Egin klik [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. Uyuni gainean Web UI side, verify the successfully completed product upgrade by going to Systems › Registered client › Details.
12. Bezeroaren aldean egiazta dezakezu exekutatzen:
    cat /etc/os-release
13. Irteerak antzeko itxura izango du:

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/"

GNU Doako Dokumentazio Lizentzia

8. kapitulua

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.

HITZAURREA

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.

Lizentzia hau software librearen eskuliburuetarako erabiltzeko diseinatu dugu, software libreak doako dokumentazioa behar duelako: programa libre batek softwareak dituen askatasun berberak eskaintzen dituzten eskuliburuekin etorri behar du. Baina Lizentzia hau ez da software-eskuliburuetara mugatzen; edozein testu-lanetarako erabil daiteke, gaia edozein dela ere edo inprimatutako liburu gisa argitaratzen den. Lizentzia hau gomendatzen dugu batez ere instrukzioa edo erreferentzia duten lanetarako.

APLIKAGARRITASUNA ETA DEFINIZIOAK

Lizentzia hau eskuliburu edo bestelako lanari aplikatzen zaio, edozein euskarritan, copyright-jabeak Lizentzia honen baldintzen arabera banatu daitekeela dioen ohar bat daukan. Jakinarazpen horrek mundu osoko eskubiderik gabeko lizentzia bat ematen du, iraupen mugagabea, lan hori hemen adierazitako baldintzetan erabiltzeko. Beheko "Dokumentuak" eskuliburu edo lan horiei egiten die erreferentzia. Herritar oro lizentziadun bat da, eta "zu" gisa zuzentzen da. Lizentzia onartzen duzu lana kopiatu, aldatzen edo banatzen baduzu, copyright-legearen arabera baimena behar duen moduan.

Dokumentuaren "Bertsio Aldatu" batek Dokumentua edo haren zati bat duen edozein lan esan nahi du, hitzez hitz kopiatua, edo aldaketak dituena eta/edo beste hizkuntza batera itzulita.

"Bigarren Atala" Dokumentuaren argitaletxeek edo egileek Dokumentuaren gai orokorrarekin (edo erlazionatutako gaiekin) duten harremanaz soilik lantzen duen eranskin izendatua edo atal bat da, eta zuzenean eror daitekeen ezer ez dauka. irakasgai orokor horren barruan. (Horrela, Dokumentua zati batean matematikako testu-liburua bada, Bigarren Atal batek ezingo du matematikarik azaldu.) Harremana gaiarekin edo erlazionatutako gaiekin lotura historikoa izan daiteke, edo legezko, merkataritza, filosofiko, etikoko kontua izan daiteke. edo haien inguruko jarrera politikoa.

"Atal aldaezinak" Bigarren Atal batzuk dira, zeinen izenburuak izendatzen diren, Atal aldaezinak diren bezala, Dokumentua Lizentzia honen arabera kaleratu dela dioen oharrean. Atal bat bigarren mailako definizioarekin bat ez badator, ezin izango da aldaezin gisa izendatu. Dokumentuak zero atal aldaezinak izan ditzake. Dokumentuak ez badu atal aldaezinrik identifikatzen, ez dago.

"Azaleko testuak" dokumentua Lizentzia honen pean kaleratu dela dioen oharrean, aurreko azaleko testuak edo atzeko azaleko testuak gisa zerrendatzen diren testu-pasarte labur batzuk dira. Atzeko azaleko testuak 5 hitz izan ditzake gehienez, eta atzeko azaleko testuak 25 hitz izan ditzake gehienez.

Dokumentuaren kopia "garden" batek makinaz irakur daitekeen kopia bat esan nahi du, zeinaren zehaztapena publiko orokorrarentzat eskuragarri dagoen formatuan irudikatuta, dokumentua zuzenean berrikusteko egokia dena testu-editore generikoekin edo (pixelez osatutako irudietarako) pintura generikoarekin. programak edo (marrazkietarako) erabilgarri dauden marrazki-editore batzuk, eta egokia da testu-formatatzaileetan sartzeko edo testu-formatatzaileetarako egokiak diren hainbat formatutara itzultzeko automatikoki. Bestela garden batean egindako kopia bat file Bere markaketa, edo markarik eza, irakurleek ondorengo aldaketak oztopatzeko edo galarazteko antolatu duten formatua ez da Gardena. Irudi formatua ez da gardena testu kopuru handi batean erabiltzen bada. "Gardena" ez den kopiari "Opakua" deitzen zaio.

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. ExampIrudi formatu gardenen fitxategiak PNG, XCF eta JPG dira. Formatu opakuek testu-prozesadore jabedunek soilik irakurri eta edita ditzaketen formatu jabedunek, DTD eta/edo prozesatzeko tresnak orokorrean erabilgarri ez dituzten SGML edo XML-ek eta testu-prozesadore batzuek ekoitzitako makinaz sortutako HTML, PostScript edo PDF irteerako helburuetarako soilik.

"Izenburua"-k esan nahi du, inprimatutako liburu baten kasuan, izenburu-orrialdea bera, gehi ondorengo orrialdeak, Lizentzia honek behar duen materiala karatulean agertzeko modu irakurgarrian edukitzeko. Titulu-orririk ez duten formatuetako lanen kasuan, "Izenburua"-k lanaren izenburuaren agerpen nabarmenaren ondoan dagoen testua esan nahi du, testuaren gorputzaren hasieraren aurretik.

"XYZ tituluduna" atal batek Dokumentuaren azpiunitate izendatua esan nahi du, zeinaren izenburua XYZ den edo XYZ duen XYZ beste hizkuntza batean itzultzen duen testuaren ondotik parentesi artean. (Hemen XYZ-k behean aipatzen den atal-izen espezifiko bat adierazten du, hala nola, "Aitorpenak", "Dedikazioak", "Abalak" edo "Historia".) Dokumentua aldatzen duzunean atal baten "Izenburua gordetzeak" esan nahi du "XYZ tituluduna" atal bat izaten jarraitzen du definizio honen arabera.

Dokumentuak Lizentzia hau Dokumentuari aplikatzen zaiola dioen oharraren ondoan Bermearen Ezeztapenak izan ditzake. Bermearen ukapen hauek Lizentzia honetan erreferentzia gisa sartuta daudela jotzen da, baina bermeei uko egiteari dagokionez soilik: Bermearen ukapen hauek izan dezaketen beste edozein inplikazio baliogabea da eta ez du inolako eraginik Lizentzia honen esanahian.

HITZEZKO KOPIA

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.

Kopiak ere maileguan eman ditzakezu, goian adierazitako baldintza berdinetan, eta kopiak publikoki erakutsi ditzakezu.

KANTITATEAN KOPIATZEA

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.

Azalerako behar diren testuak zabalegiak badira irakurtzeko modukoa izateko, zerrendatutako lehenak (zentzuzkoa den adina) jarri beharko dituzu benetako azalean, eta gainerakoak ondoko orrialdeetan jarraitu.

100etik gorako zenbakia duten Dokumentuaren kopia opakuak argitaratzen edo banatzen badituzu, makinaz irakur daitekeen kopia garden bat sartu beharko duzu kopia opaku bakoitzarekin batera, edo kopia opaku bakoitzean sare orokorraren sareko kokapen bat adierazi beharko duzu. publiko erabiltzeak sare publiko estandarren protokoloak erabiliz deskargatzeko sarbidea du Dokumentuaren kopia garden osoa, material erantsirik gabea. Azken aukera hau erabiltzen baduzu, neurri nahiko zuhur hartu beharko dituzu kopia Opakuak kantitatean banatzen hasten zarenean, kopia Gardena hori adierazitako tokian eskuragarri egongo dela ziurtatzeko, gutxienez urtebetera arte banatzen duzun azken alditik. Edizio horren kopia opakoa (zuzenean edo zure agente edo saltzaileen bidez) publikoarentzat.

Eskatzen da, baina ez da beharrezkoa, Dokumentuaren egileekin harremanetan jartzea kopia kopuru handi bat birbanatu aurretik, Dokumentuaren bertsio eguneratua emateko aukera emateko.

ALDAKETAK

Dokumentuaren Bertsio Aldatua kopiatu eta banatu dezakezu goiko 2. eta 3. ataletako baldintzen arabera, baldin eta Bertsio Aldatua Lizentzia honen pean argitaratzen baduzu, Bertsio Aldatuak Dokumentuaren eginkizuna betez, eta, beraz, banaketa eta aldaketaren lizentzia emanez. Aldatutako Bertsioa kopia bat duenari. Horrez gain, gauza hauek egin behar dituzu Aldatutako Bertsioan:

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

Aldatutako Bertsioak bigarren mailako atal gisa sailkatzen diren atal edo eranskin berriak baditu eta Dokumentutik kopiatutako materialik ez badute, nahi duzunean atal horiek guztiak edo aldaezin gisa izenda ditzakezu. Horretarako, gehitu haien izenburuak Aldatutako Bertsioaren lizentzia-oharrean dagoen Atal aldaezinen zerrendara. Izenburu hauek beste edozein atal tituluetatik bereizi behar dira.

"Abalak" izeneko atal bat gehi dezakezu, baldin eta hainbat alderdik zure Aldatutako Bertsioaren abalak besterik ez baditu, adibidez.ample, peer re adierazpenakview edo testua erakunde batek onartu duela estandar baten definizio autoritario gisa.

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.

Dokumentuaren egileek eta argitaratzaileek ez dute baimenik ematen beren izenak publizitaterako erabiltzeko edo aldatutako bertsioren bat baieztatzen edo onartzeko.

DOKUMENTUAK KONBINATZEA

Dokumentua Lizentzia honen arabera kaleratutako beste dokumentu batzuekin konbina dezakezu, aurreko 4. atalean zehaztutako baldintzetan, bertsio aldatuetarako, baldin eta jatorrizko dokumentu guztien atal aldaezin guztiak bateratzen badituzu, aldatu gabe, eta guztiak zerrendatzen badituzu. zure lan konbinatuaren atal aldaezinak gisa bere lizentzia-oharrean, eta haien Berme-erantzunkizun guztiak gordetzen dituzula.

Lan konbinatuak Lizentzia honen kopia bakarra izan behar du, eta hainbat Atal Aldaezin berdinak kopia bakarrarekin ordezkatu daitezke. Izen bereko baina eduki ezberdineko Atal aldaezin bat baino gehiago badaude, egin atal bakoitzaren izenburua bakarra, honen amaieran gehituz, parentesi artean, atal horren jatorrizko egilearen edo argitaratzailearen izena ezagutzen bada, edo bestela zenbaki bakarra. Egin egokitzapen bera lan konbinatuaren lizentzia-oharrean Atal aldaezinen zerrendako atalen izenburuetan.

Konbinazioan, “Historia” izeneko atalak konbinatu behar dituzu jatorrizko dokumentu ezberdinetan, “Historia” izeneko atal bat osatuz; era berean, konbinatu “Eskerrpenak” izeneko atalak eta “Dedikazioak” izeneko atalak. "Abalak" izeneko atal guztiak ezabatu behar dituzu.

DOKUMENTU-BILDUMAK

Dokumentuarekin eta Lizentzia honen arabera kaleratutako beste dokumentu batzuekin osatutako bilduma bat egin dezakezu, eta Lizentzia honen kopia indibidualak dokumentu ezberdinetan bildutako kopia bakarrarekin ordezkatu ditzakezu, baldin eta Lizentzia honen arauak betetzen badituzu. dokumentu bakoitzaren hitzez hitz kopiatzea gainerako alderdi guztietan.

Bilduma horretatik dokumentu bakar bat atera dezakezu eta banaka bana dezakezu Lizentzia honen arabera, baldin eta Lizentzia honen kopia bat txertatzen baduzu ateratako dokumentuan, eta Lizentzia hau jarraitzen baduzu dokumentu horren hitzez hitz kopiatzeari dagokionez.

LAN INDEPENDENTEEKIN BATZE

Dokumentua edo bere eratorriak beste dokumentu edo lan bereizi eta independenteekin biltzeari, biltegiratze edo banaketa euskarri baten bolumen batean edo bolumen batean, "agregatua" deritzo bilketaren ondoriozko egile-eskubideak lege-eskubideak mugatzeko erabiltzen ez badira. bildumaren erabiltzaileen lan indibidualek baimentzen dutenetik haratago. Dokumentua agregatu batean sartzen denean, Lizentzia hau ez zaie aplikatuko berez Dokumentuaren eratorritako lanak ez diren agregazioko gainerako lanei.

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.

ITZULPENA

Itzulpena aldaketa modukotzat hartzen da, beraz, Dokumentuaren itzulpenak banatu ditzakezu 4. ataleko baldintzen arabera. Atal aldaezinak itzulpenekin ordezkatzeak baimen berezia behar du haien copyright-jabeen, baina atal aldaezin batzuen edo guztien itzulpenak ere sar ditzakezu. Atal aldaezin hauen jatorrizko bertsioak. Lizentzia honen itzulpena, eta lizentzia-ohar guztiak Dokumentuan eta edozein Berme-uespen-oharrak sar ditzakezu, baldin eta Lizentzia honen jatorrizko ingelesezko bertsioa eta ohar eta ukapen horien jatorrizko bertsioak ere sartzen badituzu. Itzulpenaren eta Lizentzia honen jatorrizko bertsioaren edo jakinarazpen edo erantzukizun-ukapenaren artean adostasunik ez badago, jatorrizko bertsioa izango da nagusi.

Dokumentuko atal batek "Eskintzak", "Dedikazioak" edo "Historia" izenburua badu, bere Izenburua gordetzeko eskakizunak (4. atala) (1. atala) benetako titulua aldatzea eskatuko du normalean.

AMAIERA

Ezin duzu kopiatu, aldatu, azpilizentziatu edo banatu Dokumentua Lizentzia honetan espresuki aurreikusitakoa izan ezik. Dokumentua kopiatzeko, aldatzeko, azpilizentziatzeko edo banatzeko beste edozein saiakera baliogabea da, eta Lizentzia honen arabera dituzun eskubideak automatikoki amaituko dira. Hala ere, Lizentzia honen arabera zuregandik kopiak edo eskubideak jaso dituzten alderdiei ez zaie lizentzia amaituko alderdi horiek guztiz betetzen jarraitzen duten bitartean.

LIZENTZI HONEN ETORKIZUNEKO BERRIKUSKETAK

Free Software Foundation-ek GNU Free Documentation License-ren bertsio berri eta berrituak argitaratu ditzake noizean behin. Bertsio berri horiek oraingo bertsioaren antzekoak izango dira, baina xehetasunez desberdinak izan daitezke arazo edo kezka berriei aurre egiteko. Ikusi http://www.gnu.org/copyleft/.

Lizentziaren bertsio bakoitzari bertsio-zenbaki bereizgarri bat ematen zaio. Dokumentuan zehazten bada Lizentzia honen "edo geroagoko edozein bertsio" zenbakidun bertsio jakin bat aplikatzen zaiola, zehaztutako bertsio horren edo argitaratu den beste edozein bertsioren baldintza eta baldintzak jarraitzeko aukera duzu (ez gisa zirriborroa) Free Software Foundation-en eskutik. Dokumentuak ez badu Lizentzia honen bertsio-zenbakirik zehazten, Free Software Foundation-ek argitaratutako edozein bertsio aukeratu dezakezu (ez zirriborro gisa).

GEHIGINA: Nola erabili Lizentzia hau zure dokumentuetarako

Copyright (c) URTE ZURE IZENA. Dokumentu hau kopiatzeko, banatzeko eta/edo aldatzeko baimena ematen da GNU Free Documentation License, 1.2 bertsioaren edo Free Software Foundation-ek argitaratutako edozein bertsioren arabera; Atal aldaezinak, aurreko azaleko testurik eta atzeko azaleko testurik gabe. Lizentziaren kopia bat dago “GNU Doako Dokumentazio Lizentzia” izeneko atalean.