UYUNI Common Workflows User Guide

UYUNI Common Workflows

Předmluva

Kapitola 1

Společné pracovní postupy

Uyuni 2026.04

Průvodce běžnými pracovními postupy Uyuni poskytuje podrobné pokyny pro nejčastěji používané pracovní postupy pro instalaci, správu a konfiguraci klientů s Uyuni.

Každý pracovní postup v této příručce má jasný cíl a obsahuje podrobné kroky, které vám pomohou ho efektivně dosáhnout.

Tato příručka, určená pro běžné i pokročilé úkoly, nejen vysvětluje jednotlivé kroky, ale také zdůrazňuje dostupné možnosti v každém kroku.tage.

V celé této příručce je každý rutinní úkol označován jako pracovní postup.

Datum vydání: 2026-04-29

Přihlášení klienta

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

Use Case

Tento pracovní postup ukazuje, jak připojit klienta k serveru Uyuni.

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

Toto je jeden z prvních úkolů, který musíte udělat, když poprvé nastavujete Uyuni, a pravděpodobně to budete muset udělat ještě mnohokrát, jak budete produkt používat.

Výsledek

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. Ke správě klienta pak můžete použít Uyuni.

Příprava

Než začnete, měli byste již mít:

• Nainstalovaný server Uyuni, ke kterému můžete přistupovat pomocí Web UI.
• Klientský počítač s nainstalovaným operačním systémem, ke kterému máte přístup přes síť, na které je váš server Uyuni, pomocí SSH.
• Vhodné předplatné od http://scc.suse.com pro produkty, které používáte.

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.

Pokyny pro postup práce krok za krokem

Postup: Konfigurace plně kvalifikovaného doménového jména (FQDN) na vašem klientovi

1. Na klientovi na příkazovém řádku zobrazte aktuální název hostitele:
   hostname -f
   Tento příkaz pravděpodobně vrátí chybu nebo zobrazí něco jako localhost.
2. Nastavte nový název hostitele. Váš nový název hostitele by měl mít název subdomény, a tedy obsahovat alespoň dvě tečky. V tomto example, we are using client1.MLM.example
   hostnamectl set-hostname client1.MLM.example
3. Zkontrolujte, zda byla vaše změna úspěšná:
   hostnamectl
4. Open YaST and navigate to Network Services › Hostnames. Edit the hostname to match the one you just
   set, and click [OK].
5. V YaSTu přejděte do sekce Systém › Nastavení sítě a přejděte na kartu Název hostitele/DNS. Do pole Statický název hostitele zadejte nový název hostitele.
6. Zkontrolujte, zda byla změna úspěšná:
   hostname -f
   This command should return your new FQDN

Postup: Připravte softwarové kanály na serveru Uyuni

1. V Uyuni Web UI, přejděte na Admin › Setup Wizard.
2. Na kartě Pověření organizace se ujistěte, že jste zadali přihlašovací údaje zákaznického centra SUSE a že jste správně ověřeni.
3. Na kartě Produkty se ujistěte, že je katalog produktů plně aktualizován:
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 [Přidejte produkty ]:
5. Počkejte, až se kanály produktu plně synchronizují. V závislosti na produktech, které jste si vybrali, to může trvat dlouho.

Postup: Vytvořte aktivační klíč

1. V Uyuni Web UI, přejděte na Systémy › Activation Keys, a klikněte [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 [Vytvořit aktivační klíč].

Postup: Bootstrap klienta

1. V Uyuni Web UI, přejděte na Systems › Bootstrapping.
2. Zadejte název hostitele a poskytněte ověřovací údaje pro klienta, kterého chcete připojit, a vyberte aktivační klíč. Klikněte [Bootstrap]:
3. Přejděte na Systems › System List to manage your new client

Související témata

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

Aktualizace klientů pomocí opakujících se akcí

Kapitola 3

Tento pracovní postup ukazuje, jak automatizovat aktualizaci klientů registrovaných na Uyuni pomocí opakujících se akcí.

Use case / Situation

Automatická aktualizace klientů je výhodná, když:

• je požadována aktualizace velkého počtu klientů
• pracovní postup by se neměl opakovat při každém provedení
• existuje vyhrazené okno údržby.

Výsledek / Usnesení

Úspěšné dokončení tohoto pracovního postupu má za následek konzistentní a podporovaný stav.

Příprava

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

Aktualizace klienta vyžaduje dva kroky. Třetí krok je volitelný, ale důrazně se doporučuje k dokončení procesu aktualizace.

Postup: Creating a recurring action to update Salt itself

1. Jako example, vytvoříme akci k aktualizaci samotné Salt jako opakující se akci pro všechny systémy v organizaci. V Uyuni Web UI, přejděte na Home › My Organization › Recurring Actions a klikněte [Create].
2. Select Action Type Zvyk Stát and enter a Schedule Name like update salt .
3. Vyberte plán. Napřample, Weekly: Wednesday, 9:00 am .
4. Zaškrtnutím políčka přiřaďte stav aktualizace soli.
5. Klikněte [Save Changes ] to save the action.
6. You can edit the execution order of the states if needed. Click [Potvrdit] to confirm the order.
7. Klikněte [Create Schedule] to save the action.

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

1. Jako example we create the action to apply all updates as a recurring action for a system group called infra-services. V 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. Vyberte plán. Napřample, 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 aktuální by selecting the checkboxes. To perform a reboot afterwards you can also add reboot or reboot if needed.
6. Save the action by clicking [Uložit změny ].
7. You can edit the execution order of the states. The order should be util. syn call, certs, channels, aktuální and finally reboot or reboot if needed if chosen. Click [Potvrdit] to store the order.
8. Klikněte [Create Schedule] to save the action.

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

1. Jako example, we create the action to apply the high state for the same group which was fully updated before. In the Uyuni Web UI, přejděte na Systems › System Groups and click infra-services.
2. Go to Recurring Actions and click [Create].
3. Select Action Type Vysoký stav and enter a Schedule Name like high state .
4. Vyberte plán. Napřample, Weekly: Wednesday, 10:30 am . Again, keep enough time between this action and the full-system-update action.
5. Klikněte [Create Schedule] to save the action.

Background information on up-to-date state

1. The aktuální state applies critical patches to the update components.
   • a. On SUSE-based systems, the state executes the command:
     zypper --non-interactive patch --updatestack-only
     A pak stát také aktualizuje 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.
   Detekce restartu je specifická pro klientský operační systém.
   • Pro Debian nebo Ubuntu viz https://www.debian.org/doc/debian-policy/ch-opersys.html#signaling-that-a-reboot-is-required.
   • U netransakčních klientů SUSE Uyuni restartuje klienta, když příkaz zypper -x list-patches indikuje, že záplaty vyžadují restart.
   • U transakčních klientů SUSE Uyuni restartuje klienta, pokud existuje čekající transakce.
   • 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

Související témata

• Další informace o opakujících se akcích naleznete v Opakující se akce.
• For more information about custom info values, see Client-configuration › Custom-info.

Správa konfigurace

Kapitola 4

Můžete použít konfiguraci files a kanály ke správě konfigurace pro vaše klienty namísto ručního konfigurování každého klienta. Tento pracovní postup vám ukáže, jak používat Uyuni Web UI pro vytvoření centrálně spravované konfigurace file, přiřaďte jej klientovi a použijte konfiguraci.

Use Case

Pokud spravujete mnoho klientů, pravděpodobně nebudete chtít ručně aplikovat konfigurační nastavení postupně na každého z nich. Konfigurační kanály se používají k uspořádání konfigurace files. Klienty můžete přihlásit ke konfiguračním kanálům a nasadit konfiguraci files podle potřeby.

Výsledek

Po dokončení tohoto pracovního postupu budete mít konfigurační kanál obsahující konfiguraci file, přiřadili ke kanálu klienty a úspěšně použili konfiguraci.

Příprava

Než začnete, měli byste již mít:

• Nainstalovaný server Uyuni, ke kterému můžete přistupovat pomocí Web UI.
• Alespoň jeden klient registrovaný na vašem serveru.
• Vhodné předplatné od http://scc.suse.com pro produkty, které používáte.

Tento pracovní postup používá centrálně spravovanou konfiguraci file and a Salt state. For more information about the different ways to manage configuration, see Client-configuration › Configuration-management.

Pokyny k pracovnímu postupu krok za krokem

Postup: Vytvořte nový konfigurační kanál a File

1. V Uyuni Web UI, přejděte na Configuration › Channels a klikněte [Create State Channel].
2. Zadejte název, štítek a popis konfigurace filea zadejte obsah vaší konfigurace file. Bývalýample that you can copy is at the end of this section.

Postup: Přiřaďte klienty ke kanálu konfigurace

1. V Uyuni Web UI, přejděte na Systems › Systems List and select the client you want to assign to your configuration channel.
2. Přejděte na kartu Konfigurace. V guimenu: Configuration Overview sekce, klikněte [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 ] dokončit.

Postup: Použijte konfiguraci na svého klienta

1. V Uyuni Web UI, přejděte na 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 [Nasadit všechny spravované konfigurace files ]

Example

Stav SLS pro udržování aktualizace klientů

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

Související témata

• For more information about configuration management, see Client-configuration › Configuration management.
• Další informace o SLS files, viz: https://docs.saltproject.io/en/latest/topics/tutorials/starting_states.html.

Správa životního cyklu obsahu

Kapitola 5

Pokud spravujete mnoho klientů a potřebujete na ně použít přizpůsobené balíčky, můžete ke správě svých balíčků použít správu životního cyklu obsahu (CLM). CLM vám umožňuje přizpůsobit a otestovat balíčky před aktualizací produkčních klientů. Je také užitečné, pokud potřebujete použít aktualizace během omezeného okna údržby.

Use Case

Správa životního cyklu obsahu vám umožňuje vybrat softwarové kanály jako zdroje, upravit je podle potřeby pro vaše prostředí a důkladně je otestovat před instalací do vašich produkčních klientů. CLM můžete použít ke správě svých softwarových kanálů od vývoje, přes testování a zavádění změn svým klientům.

Výsledek

Po dokončení tohoto pracovního postupu budete mít nastaven projekt životního cyklu obsahu. Vytvoříte základní projekt CLM a budete jej propagovat během jeho životního cyklu.

Přípravky

Než začnete, měli byste již mít:

• Server Uyuni je nasazen a přístupný pomocí Web UI.
• Klientský počítač s nainstalovaným operačním systémem, ke kterému máte přístup přes síť, na které je váš server Uyuni, pomocí SSH.
• Vhodné předplatné od http://scc.suse.com pro produkty, které používáte.

Pokyny pro postup práce krok za krokem

Postup: Vytvořte nový projekt CLM

1. V Uyuni Web UI, přejděte na 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 ].
   Vyberte typ zdroje a vyberte základní kanál pro váš projekt.
   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 [Uložit] to return to the project page.
3. Sekci Filtry nechte prozatím prázdnou, v tomto příkladu je nepoužijemeample. V případě potřeby můžete filtry přidat později.
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. Klikněte [Stavět] to build version 1 of your project:

Postup: Přiřaďte klienty

1. Přejděte na Systems › System List, select the client to assign, and go to the Software › Software Channels tab.
2. V sekci Základní kanál vyberte projekt CLM a prostředí, ke kterému chcete klienta přiřadit.
   Napřample, 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. Klikněte [Další] to assign the client.

Postup: Propagujte prostředí

1. V Uyuni Web UI, přejděte na 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.

Související témata

• For more information about CLM, including information about how to use filters, see Administration › Content-lifecycle.
• Pro CLM napřamples, viz Administration › Content-lifecycle-examples.

Customize Apache Configuration

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

Případ použití

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.

Výsledek

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

Příprava

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 (napřample, custom_ tuning. conf) and add your required Apache directives.
5. Jakmile si uložíte file, exit the container with command:
   exit
6. Restart the Uyuni services to apply the changes:
   mgradm restart

Upgrade produktu prostřednictvím Web UI

Kapitola 7

Pokud chcete upgradovat registrovaný klientský balíček SUSE Linux Enterprise na novější verzi produktu, lze to provést buď z příkazového řádku, nebo pomocí Web UI.

Tento dokument podrobně popisuje a ilustruje upgrade produktu pomocí Web UI.

Použité verze produktu neodrážejí aktuální dostupné verze. Jsou použity pouze pro ilustrační účely. Jako example, následující postup popisuje upgrade na verzi 15 SP5 z a starší verze 15. Pokud cílíte na jinou verzi, vyberte odpovídající kanály a verze.

Postup: Upgrade produktu na novější verzi pomocí Web UI

1. Přihlaste se do Uyuni Web UI and navigate to Admin › Setup Wizard › Products and search for SUSE Linux Enterprise Server 15 SP5 x86_64.
2. Vyberte doporučené kanály.
3. Klikněte [Add Products ].
4. Přejděte na Systems › Registered client › Software › Product Migration. You will see the targets available for that registered client.
5. Vyberte SUSE Linux Enterprise Server 15 SP5 x86_64. To se bude dále rozšiřovat.
6. Vyberte cílový základní kanál jako SLE-Product-SLES15-SP5-Pool pro x86_64. Povolit změnu dodavatele ponechte nezaškrtnuté.
7. Klikněte [Schedule Migration]. The message will be highlighted It is better to do a dry run first so continuing with dry run first.
8. Klikněte na [Suchý běh] and check the status of the simulation in Events › History. You should see a return code 0 indicating a successful dry run.
9. Klikněte [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. Na Uyuni Web UI side, verify the successfully completed product upgrade by going to Systems › Registered client › Details.
12. Na straně klienta to můžete ověřit spuštěním:
    cat /etc/os-release
13. Výstup bude vypadat podobně jako:

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 Free Documentation License

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

PREAMBULE

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.

Tuto licenci jsme navrhli, abychom ji mohli používat pro příručky pro svobodný software, protože svobodný software potřebuje svobodnou dokumentaci: bezplatný program by měl být dodáván s příručkami poskytujícími stejné svobody jako software. Tato licence však není omezena na softwarové příručky; lze jej použít pro jakékoli textové dílo, bez ohledu na téma nebo zda je vydáváno jako tištěná kniha. Tuto licenci doporučujeme především pro díla, jejichž účelem je instrukce nebo odkaz.

POUŽITELNOST A DEFINICE

Tato licence se vztahuje na jakoukoli příručku nebo jiné dílo na jakémkoli médiu, které obsahuje poznámku umístěnou držitelem autorských práv, že může být šířeno za podmínek této licence. Takové oznámení uděluje celosvětovou bezplatnou licenci, neomezenou na dobu trvání, k použití tohoto díla za podmínek zde uvedených. Níže uvedený „dokument“ odkazuje na jakoukoli takovou příručku nebo práci. Každý člen veřejnosti je držitelem licence a je oslovován jako „vy“. Souhlasíte s licencí, pokud kopírujete, upravujete nebo distribuujete dílo způsobem vyžadujícím povolení podle autorského zákona.

„Upravená verze“ dokumentu znamená jakékoli dílo obsahující dokument nebo jeho část, buď doslovně zkopírované, nebo s úpravami a/nebo přeložené do jiného jazyka.

„Sekundární oddíl“ je pojmenovaná příloha nebo úvodní část dokumentu, která se zabývá výhradně vztahem vydavatelů nebo autorů dokumentu k celkovému předmětu dokumentu (nebo souvisejícím záležitostem) a neobsahuje nic, co by mohlo přímo spadat. v rámci tohoto celkového předmětu. (Pokud je tedy dokument zčásti učebnicí matematiky, sekundární část nemusí vysvětlovat žádnou matematiku.) Vztah může být věcí historické souvislosti s předmětem nebo souvisejícími záležitostmi nebo právní, obchodní, filozofické, etické nebo politický postoj k nim.

„Neměnné oddíly“ jsou určité sekundární oddíly, jejichž názvy jsou označeny jako názvy neměnných oddílů v oznámení, které říká, že dokument je uvolněn na základě této licence. Pokud sekce nesplňuje výše uvedenou definici Sekundární, pak nemůže být označena jako Invariantní. Dokument může obsahovat nula neměnných oddílů. Pokud dokument neidentifikuje žádné neměnné části, pak žádné neexistují.

„Texty obálky“ jsou určité krátké pasáže textu, které jsou uvedeny jako texty přední obálky nebo texty zadní obálky v oznámení, které říká, že dokument je uvolněn na základě této licence. Text přední obálky může mít maximálně 5 slov a text zadní obálky může mít maximálně 25 slov.

„Transparentní“ kopie dokumentu znamená strojově čitelnou kopii reprezentovanou ve formátu, jehož specifikace je dostupná široké veřejnosti a která je vhodná pro přímou revizi dokumentu pomocí obecných textových editorů nebo (u obrázků složených z pixelů) obecným nátěrem. programy nebo (pro výkresy) nějaký široce dostupný kreslicí editor, který je vhodný pro vstup do formátovačů textu nebo pro automatický překlad do různých formátů vhodných pro vstup do formátovačů textu. Kopie zhotovená v jinak průhledné podobě file formát, jehož označení nebo absence označení bylo uspořádáno tak, aby zmařilo nebo odrazovalo od následné úpravy čtenáři, není transparentní. Formát obrázku není průhledný, pokud je použit pro velké množství textu. Kopie, která není „průhledná“, se nazývá „neprůhledná“.

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. Exampmezi transparentní obrazové formáty patří PNG, XCF a JPG. Neprůhledné formáty zahrnují proprietární formáty, které lze číst a upravovat pouze proprietárními textovými procesory, SGML nebo XML, pro které nejsou DTD a/nebo nástroje pro zpracování obecně dostupné, a strojově generované HTML, PostScript nebo PDF vytvořené některými textovými procesory pro pouze pro výstupní účely.

„Titulní strana“ znamená v případě tištěné knihy samotnou titulní stranu plus takové následující stránky, které jsou potřebné pro čitelné uložení materiálu, který tato licence vyžaduje, aby se objevil na titulní stránce. U děl ve formátech, které jako takové nemají žádnou titulní stranu, „titulní strana“ znamená text poblíž nejvýraznějšího vzhledu názvu díla, který předchází začátku hlavního textu.

Část „S názvem XYZ“ znamená pojmenovanou podjednotku dokumentu, jehož název je buď přesně XYZ, nebo obsahuje XYZ v závorkách za textem, který překládá XYZ do jiného jazyka. (XYZ zde znamená konkrétní název oddílu uvedený níže, například „Poděkování“, „Věnování“, „Potvrzení“ nebo „Historie“.) „Zachovat název“ takového oddílu, když upravíte dokument, znamená, že zůstává podle této definice oddílem „s názvem XYZ“.

Dokument může obsahovat prohlášení o vyloučení záruky vedle oznámení, které uvádí, že tato licence se vztahuje na dokument. Tato vyloučení záruky jsou považována za zahrnutá v této licenci formou odkazu, ale pouze pokud jde o odmítnutí záruk: jakýkoli jiný důsledek, který může mít tato vyloučení záruky, je neplatný a nemá žádný vliv na význam této licence.

DOSLOVNÉ KOPÍROVÁNÍ

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.

Můžete také půjčovat kopie za stejných podmínek uvedených výše a můžete kopie veřejně vystavovat.

KOPÍROVÁNÍ VE MNOŽSTVÍ

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.

Pokud jsou požadované texty pro kteroukoli obálku příliš objemné, než aby se vešly čitelně, měli byste umístit první uvedené texty (tolik, kolik se přiměřeně vejde) na skutečnou obálku a zbytek pokračovat na sousední stránky.

Pokud publikujete nebo distribuujete neprůhledné kopie dokumentu s číslováním více než 100, musíte ke každé neprůhledné kopii přiložit strojově čitelnou průhlednou kopii, nebo v každé neprůhledné kopii uvést umístění v počítačové síti, ze kterého bude obecná síť using public má přístup ke stažení pomocí veřejných standardních síťových protokolů kompletní průhlednou kopii dokumentu bez přidaných materiálů. Pokud použijete druhou možnost, musíte při zahájení distribuce neprůhledných kopií ve velkém množství podniknout přiměřeně obezřetné kroky, abyste zajistili, že tato průhledná kopie zůstane takto přístupná na uvedeném místě alespoň jeden rok po vaší poslední distribuci. Neprůhledná kopie (přímo nebo prostřednictvím vašich zástupců nebo prodejců) tohoto vydání pro veřejnost.

Je požadováno, ale není to vyžadováno, abyste před redistribucí velkého počtu kopií kontaktovali autory dokumentu, abyste jim dali příležitost poskytnout vám aktualizovanou verzi dokumentu.

MODIFIKACE

Můžete kopírovat a distribuovat upravenou verzi dokumentu za podmínek uvedených v oddílech 2 a 3 výše, za předpokladu, že uvolníte upravenou verzi přesně na základě této licence, přičemž upravená verze plní roli dokumentu, čímž licencujete distribuci a úpravy dokumentu. upravenou verzi komukoli, kdo vlastní její kopii. Kromě toho musíte v upravené verzi provést tyto věci:

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

Pokud upravená verze obsahuje nové úvodní části nebo přílohy, které se kvalifikují jako sekundární části a neobsahují žádný materiál zkopírovaný z dokumentu, můžete podle svého uvážení označit některé nebo všechny tyto části jako neměnné. Chcete-li to provést, přidejte jejich názvy do seznamu invariantních oddílů v oznámení o licenci upravené verze. Tyto názvy musí být odlišné od jakýchkoli jiných názvů oddílů.

Můžete přidat část nazvanou „Potvrzení“, za předpokladu, že neobsahuje nic jiného než schválení vaší upravené verze různými stranami – např.ample, prohlášení peer review nebo že text byl schválen organizací jako směrodatná definice normy.

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.

Autor (autoři) a vydavatel (vydavatelé) dokumentu touto licencí nedávají svolení k použití jejich jmen pro publicitu nebo pro tvrzení či naznačování podpory jakékoli upravené verze.

KOMBINOVÁNÍ DOKUMENTŮ

Dokument můžete kombinovat s jinými dokumenty vydanými na základě této licence, za podmínek definovaných v části 4 výše pro upravené verze, za předpokladu, že do kombinace zahrnete všechny neměnné části všech původních dokumentů, nezměněné, a uvedete je všechny. jako neměnné části vašeho kombinovaného díla v jeho oznámení o licenci a že zachováte všechna jejich prohlášení o vyloučení záruky.

Kombinované dílo musí obsahovat pouze jednu kopii této licence a více identických neměnných oddílů může být nahrazeno jedinou kopií. Pokud existuje více neměnných sekcí se stejným názvem, ale odlišným obsahem, udělejte název každé z těchto sekcí jedinečným tím, že na jeho konec v závorkách přidáte jméno původního autora nebo vydavatele dané sekce, pokud je znám, nebo jedinečné číslo. Proveďte stejnou úpravu názvů oddílů v seznamu Invariantních oddílů v oznámení o licenci ke kombinovanému dílu.

V této kombinaci musíte zkombinovat jakékoli oddíly s názvem „Historie“ v různých originálních dokumentech a vytvořit jeden oddíl s názvem „Historie“; rovněž zkombinujte jakékoli části s názvem „Poděkování“ a jakékoli části s názvem „Věnování“. Musíte smazat všechny části s názvem „Potvrzení“.

SBÍRKY DOKUMENTŮ

Můžete vytvořit sbírku obsahující dokument a další dokumenty vydané na základě této licence a nahradit jednotlivé kopie této licence v různých dokumentech jedinou kopií, která je součástí sbírky, za předpokladu, že budete dodržovat pravidla této licence pro doslovné kopírování každého z dokumentů ve všech ostatních ohledech.

Můžete vyjmout jeden dokument z takové sbírky a distribuovat jej jednotlivě na základě této licence za předpokladu, že vložíte kopii této licence do extrahovaného dokumentu a budete se touto licencí řídit ve všech ostatních ohledech týkajících se doslovného kopírování tohoto dokumentu.

AGREGACE SE SAMOSTATNÝMI DÍLY

Kompilace dokumentu nebo jeho derivátů s jinými samostatnými a nezávislými dokumenty nebo díly v nebo na objemu paměťového nebo distribučního média se nazývá „souhrn“, pokud autorská práva vyplývající z kompilace nejsou použita k omezení zákonných práv. uživatelů kompilace nad rámec toho, co jednotlivá díla dovolují. Pokud je dokument zahrnut jako celek, tato licence se nevztahuje na ostatní díla v souhrnu, která sama o sobě nejsou odvozenými díly z dokumentu.

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.

PŘEKLAD

Překlad je považován za určitý druh úpravy, takže můžete distribuovat překlady dokumentu za podmínek uvedených v části 4. Nahrazení neměnných sekcí překlady vyžaduje zvláštní povolení od jejich držitelů autorských práv, můžete však kromě původní verze těchto neměnných sekcí. Můžete zahrnout překlad této licence a všech licenčních oznámení v dokumentu a veškerá prohlášení o vyloučení záruky za předpokladu, že zahrnete také původní anglickou verzi této licence a původní verze těchto oznámení a prohlášení o vyloučení odpovědnosti. V případě neshody mezi překladem a původní verzí této licence nebo v případě upozornění či vyloučení odpovědnosti má přednost původní verze.

Pokud je část dokumentu nazvaná „Poděkování“, „Věnování“ nebo „Historie“, bude požadavek (část 4) na zachování jejího názvu (část 1) obvykle vyžadovat změnu skutečného názvu.

UKONČENÍ

Nesmíte kopírovat, upravovat, poskytovat sublicence nebo distribuovat dokument jinak, než je výslovně uvedeno v této licenci. Jakýkoli jiný pokus o kopírování, úpravu, sublicenci nebo distribuci dokumentu je neplatný a automaticky ukončí vaše práva vyplývající z této licence. Nicméně stranám, které od vás obdržely kopie nebo práva na základě této licence, nebudou jejich licence ukončeny, pokud budou tyto strany plně dodržovat.

BUDOUCÍ REVIZE TÉTO LICENCE

Free Software Foundation může čas od času publikovat nové, revidované verze GNU Free Documentation License. Takové nové verze budou mít podobný duch jako současná verze, ale mohou se lišit v detailech, aby řešily nové problémy nebo obavy. Vidět http://www.gnu.org/copyleft/.

Každá verze licence má rozlišující číslo verze. Pokud dokument uvádí, že se na něj vztahuje konkrétní očíslovaná verze této licence „nebo jakákoli pozdější verze“, máte možnost se řídit podmínkami buď této specifikované verze, nebo jakékoli pozdější verze, která byla zveřejněna (nikoli jako draft) od Free Software Foundation. Pokud dokument neurčuje číslo verze této licence, můžete si vybrat jakoukoli verzi, kterou kdy Free Software Foundation vydala (nikoli jako koncept).

DODATEK: Jak používat tuto licenci pro vaše dokumenty

Copyright (c) ROK VAŠEHO JMÉNA. Je povoleno kopírovat, šířit a/nebo upravovat tento dokument za podmínek GNU Free Documentation License, verze 1.2 nebo kterékoli pozdější verze publikované Free Software Foundation; bez neměnných sekcí, bez textů na přední straně obálky a bez textů na zadní straně obálky. Kopie licence je obsažena v části nazvané „GNU Free Documentation License“.