UYUNI Common Workflows User Guide

UYUNI Common Workflows

Предговор

Поглавље 1

Уобичајени токови посла

Ујуни 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.

Датум објаве: 2026-04-29

Цлиент Онбоардинг

Поглавље 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.

Случај употребе

Овај ток посла вам показује како да укључите клијента на ваш Уиуни сервер.

Клијент мора да користи подржани Линук оперативни систем. За листу подржаних клијентских система, погледајте Client-configuration › Supported-features.

Ово је један од првих задатака које треба да урадите када први пут постављате Уиуни и вероватно ћете то морати да урадите још много пута док користите производ.

Исход

When you have completed this workflow, your client is on boarded, and it can be seen in the systems list of the Uyuni Web УИ. Затим можете користити Уиуни за управљање клијентом.

Припрема

Пре него што почнете, требало би да већ имате:

• Инсталиран је Уиуни сервер којем можете приступити помоћу Web УИ.
• Клијентска машина са инсталираним оперативним системом, којој можете приступити преко мреже на којој је ваш Уиуни сервер, користећи ССХ.
• Одговарајуће претплате од http://scc.suse.com за производе које користите.

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.

Корак по корак упутства за радни ток

Процедура: Configure a Fully Qualified Domain Name (FQDN) on Your Client

1. На клијенту, на командној линији, покажите тренутно име хоста:
   hostname -f
   Ова команда ће вероватно вратити грешку или ће показати нешто попут лоцалхост.
2. Подесите ново име хоста. Ваше ново име хоста треба да има име поддомена и да садржи најмање две тачке. У овом екample, we are using client1.MLM.example
   hostnamectl set-hostname client1.MLM.example
3. Проверите да ли је ваша промена успела:
   hostnamectl
4. Open YaST and navigate to Network Services › Hostnames. Edit the hostname to match the one you just
   set, and click [У РЕДУ].
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. Проверите да ли је промена успела:
   hostname -f
   This command should return your new FQDN

Процедура: Припремите софтверске канале на Уиуни серверу

1. У Ујунију Web УИ, идите на Admin › Setup Wizard.
2. На картици Организацијски акредитиви уверите се да сте унели своје акредитиве СУСЕ корисничког центра и да ли сте исправно проверени.
3. На картици Производи проверите да ли је каталог производа потпуно ажуриран:
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 [Додајте производе ]:
5. Сачекајте да се канали производа у потпуности синхронизују. У зависности од производа које сте изабрали, ово може потрајати.

Процедура: Креирајте активациони кључ

1. У Ујунију Web УИ, идите на Системи › Activation Keys, и кликните [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 [Креирајте кључ за активирање].

Процедура: Боотстрап клијента

1. У Ујунију Web УИ, идите на Systems › Bootstrapping.
2. Унесите име хоста и наведите акредитиве за аутентификацију за клијента који желите да укључите и изаберите кључ за активирање. Кликните [Bootstrap]:
3. Дођите до Systems › System List to manage your new client

Повезане теме

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

Ажурирање клијената помоћу понављајућих радњи

Поглавље 3

Овај ток посла показује како да аутоматизујете ажурирање клијената регистрованих на Уиуни користећи понављајуће радње.

Use case / Situation

Аутоматско ажурирање клијената је корисно када:

• тражи се ажурирање великог броја клијената
• ток посла не би требало да се понавља при сваком извршењу
• постоји наменски прозор за одржавање.

Исход / Резолуција

Успешан завршетак овог тока посла доводи до доследног и подржаног стања.

Припрема

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

За ажурирање клијента потребна су два корака. Трећи корак је опционалан, али се препоручује да се процес ажурирања заврши.

Процедура: Creating a recurring action to update Salt itself

1. Као бившиampЗатим креирамо акцију да ажурирамо сам Салт као радњу која се понавља за све системе у организацији. У Ујунију Web УИ, идите на Home › My Organization › Recurring Actions и кликните [Create].
2. Select Action Type Цустом Држава and enter a Schedule Name like update salt .
3. Изаберите распоред. Фор екampле, Weekly: Wednesday, 9:00 am .
4. Доделите статус ажурирања тако што ћете означити поље за потврду.
5. Кликните [Save Changes ] to save the action.
6. You can edit the execution order of the states if needed. Click [Потврди] to confirm the order.
7. Кликните [Create Schedule] to save the action.

Процедура: Creating a recurring action to apply all available updates to the systems

1. Као бившиample we create the action to apply all updates as a recurring action for a system group called инфра-услуге. У Ујунију 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. Изаберите распоред. Фор екampле, 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 актуелан by selecting the checkboxes. To perform a reboot afterwards you can also add reboot or reboot if needed.
6. Save the action by clicking [Сачувај промене ].
7. You can edit the execution order of the states. The order should be util. syn call, certs, channels, актуелан and finally reboot or reboot if needed if chosen. Click [Потврди] to store the order.
8. Кликните [Create Schedule] to save the action.

Процедура: Creating a recurring action to run a high state after the update

1. Као бившиample, we create the action to apply the high state for the same group which was fully updated before. In the Uyuni Web УИ, идите на Systems › System Groups and click infra-services.
2. Go to Recurring Actions and click [Create].
3. Select Action Type Високо стање and enter a Schedule Name like high state .
4. Изаберите распоред. Фор екampле, Weekly: Wednesday, 10:30 am . Again, keep enough time between this action and the full-system-update action.
5. Кликните [Create Schedule] to save the action.

Background information on up-to-date state

1. Тхе актуелан 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).
     • иии. 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

Повезане теме

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

Управљање конфигурацијом

Поглавље 4

Можете користити конфигурацију fileи канале за управљање конфигурацијом за ваше клијенте, уместо да ручно конфигуришете сваког клијента. Овај ток посла вам показује како да користите Уиуни Web УИ за креирање централно управљане конфигурације file, доделите га клијенту и примените конфигурацију.

Случај употребе

Ако управљате великим бројем клијената, вероватно не желите да ручно примењујете подешавања конфигурације на сваког од њих редом. Конфигурациони канали се користе за организовање конфигурације fileс. Можете претплатити клијенте на конфигурационе канале и применити конфигурацију fileс по потреби.

Исход

Када завршите овај ток посла, имаћете конфигурациони канал који садржи конфигурацију file, доделили клијенте каналу и успешно применили конфигурацију.

Припрема

Пре него што почнете, требало би да већ имате:

• Инсталиран је Уиуни сервер којем можете приступити помоћу Web УИ.
• Најмање један клијент је регистрован на вашем серверу.
• Одговарајуће претплате од http://scc.suse.com за производе које користите.

Овај ток посла користи централно управљану конфигурацију file and a Salt state. For more information about the different ways to manage configuration, see Client-configuration › Configuration-management.

Корак по корак упутства за радни ток

Процедура: Креирајте нови конфигурациони канал и File

1. У Ујунију Web УИ, идите на Configuration › Channels и кликните [Create State Channel].
2. Унесите назив, ознаку и опис за своју конфигурацију file, и откуцајте садржај своје конфигурације file. Бившиample that you can copy is at the end of this section.

Процедура: Доделите клијенте на конфигурациони канал

1. У Ујунију Web УИ, идите на Systems › Systems List and select the client you want to assign to your configuration channel.
2. Идите на картицу Конфигурација. У гуимену: Конфигурација је завршенаview одељак, кликните [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 ] завршити.

Процедура: Примените конфигурацију на свог клијента

1. У Ујунију Web УИ, идите на 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

СЛС стање за ажурирање клијената

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

Повезане теме

• For more information about configuration management, see Client-configuration › Configuration management.
• За више информација о СЛС-у fileс, види: https://docs.saltproject.io/en/latest/topics/tutorials/starting_states.html.

Управљање животним циклусом садржаја

Поглавље 5

Ако управљате великим бројем клијената и морате да примените прилагођене пакете на њих, можете да користите управљање животним циклусом садржаја (ЦЛМ) за управљање својим пакетима. ЦЛМ вам омогућава да прилагодите и тестирате пакете пре ажурирања производних клијената. Такође је корисно ако треба да примените ажурирања током ограниченог периода одржавања.

Случај употребе

Управљање животним циклусом садржаја омогућава вам да изаберете софтверске канале као изворе, прилагодите их према потреби за ваше окружење и темељно их тестирате пре инсталирања на ваше производне клијенте. Можете да користите ЦЛМ да управљате својим софтверским каналима од развоја, преко тестирања и доношења промена вашим клијентима.

Исход

Када завршите овај ток посла, имаћете подешен пројекат животног циклуса садржаја. Направићете основни ЦЛМ пројекат и промовисати га кроз његов животни циклус.

Припреме

Пре него што почнете, требало би да већ имате:

• Uyuni Server deployed, and accessible using the Web УИ.
• Клијентска машина са инсталираним оперативним системом, којој можете приступити преко мреже на којој је ваш Уиуни сервер, користећи ССХ.
• Одговарајуће претплате од http://scc.suse.com за производе које користите.

Корак по корак упутства за радни ток

Процедура: Креирајте нови ЦЛМ пројекат

1. У Ујунију Web УИ, идите на 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 [Сачувај] to return to the project page.
3. Оставите одељак Филтери за сада празан, нећемо их користити у овом екampле. Можете додати филтере касније ако је потребно.
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. Кликните [Изградња] to build version 1 of your project:

Процедура: Додела клијената

1. Дођите до Systems › System List, select the client to assign, and go to the Software › Software Channels таб.
2. In the Base Channel section, select the CLM project and environment you want to assign the client to.
   Фор ек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. Кликните [Следећи] to assign the client.

Процедура: Промовисање животне средине

1. У Ујунију Web УИ, идите на 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.

Повезане теме

• For more information about CLM, including information about how to use filters, see Administration › Content-lifecycle.
• За ЦЛМ екampлес, види Administration › Content-lifecycle-exampлес.

Customize Apache Configuration

Поглавље 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.

Случај употребе

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.

Исход

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

Припрема

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 (нпрample, custom_ tuning. conf) and add your required Apache directives.
5. Када сачувате своје file, exit the container with command:
   exit
6. Restart the Uyuni services to apply the changes:
   mgradm restart

Надоградња производа преко Web UI

Поглавље 7

Ако желите да надоградите регистровани СУСЕ Линук Ентерприсе клијентски пакет на новију верзију производа, то се може урадити или на командној линији или преко Web УИ.

Овај документ описује и детаљно илуструје надоградњу производа коришћењем Web УИ.

Коришћене верзије производа не одражавају стварне најновије доступне верзије. Користе се само у илустрације. Као бившиampда, следећа процедура описује надоградњу на верзију 15 СП5 са и на старију верзију 15. Ако циљате на другу верзију, изаберите одговарајуће канале и верзије.

Процедура: Надоградња производа на новију верзију помоћу Web UI

1. Пријавите се на Уиуни Web UI and navigate to Admin › Setup Wizard › Products and search for SUSE Linux Enterprise Server 15 SP5 x86_64.
2. Изаберите препоручене канале.
3. Кликните [Add Products ].
4. Дођите до Systems › Registered client › Software › Product Migration. You will see the targets available for that registered client.
5. Изаберите СУСЕ Линук Ентерприсе Сервер 15 СП5 к86_64. Ово ће се даље проширити.
6. Изаберите Таргет Басе Цханнел као СЛЕ-Продуцт-СЛЕС15-СП5-Поол за к86_64. Не означите Дозволи промену добављача.
7. Кликните [Schedule Migration]. The message will be highlighted It is better to do a dry run first so continuing with dry run first.
8. Кликните [Трчање на суво] and check the status of the simulation in Events › History. You should see a return code 0 indicating a successful dry run.
9. Кликните [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. На Ујуни Web UI side, verify the successfully completed product upgrade by going to Systems › Registered client › Details.
12. На страни клијента то можете да проверите тако што ћете покренути:
    cat /etc/os-release
13. Излаз ће изгледати слично:

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

ГНУ-ова лиценца за слободну документацију

Поглавље 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.

ПРЕАМБУЛА

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.

Дизајнирали смо ову лиценцу да бисмо је користили за приручнике за слободни софтвер, јер слободном софтверу је потребна бесплатна документација: бесплатни програм треба да долази са приручницима који пружају исте слободе као и софтвер. Али ова лиценца није ограничена на софтверске приручнике; може се користити за било које текстуално дело, без обзира на тему или да ли је објављено као штампана књига. Препоручујемо ову лиценцу првенствено за радове чија је сврха упутство или референца.

ПРИМЕНЉИВОСТ И ДЕФИНИЦИЈЕ

Ова Лиценца се примењује на било који приручник или други рад, на било ком медију, који садржи обавештење постављено од стране носиоца ауторских права да се може дистрибуирати под условима ове Лиценце. Такво обавештење даје светску, бесплатну лиценцу, неограничену у трајању, за коришћење тог дела под условима наведеним у овом документу. „Документ“ у наставку се односи на било који такав приручник или рад. Сваки члан јавности је корисник лиценце и ословљава се са „ви“. Прихватате лиценцу ако копирате, модификујете или дистрибуирате дело на начин који захтева дозволу према закону о ауторским правима.

„Измењена верзија“ документа означава свако дело које садржи Документ или његов део, било дословно копирано, или са модификацијама и/или преведено на други језик.

„Секундарни одељак“ је именовани додатак или главни одељак Документа који се бави искључиво односом издавача или аутора Документа према општој теми Документа (или сродним стварима) и не садржи ништа што би могло директно да падне у оквиру тог свеукупног предмета. (Дакле, ако је Документ делом уџбеник математике, Секундарни део не може да објашњава никакву математику.) Однос може бити питање историјске везе са предметом или сродним стварима, или правног, комерцијалног, филозофског, етичког или политички став у вези са њима.

„Непроменљиви одељци“ су одређени Секундарни одељци чији су наслови означени, као наслови непроменљивих одељака, у обавештењу које каже да је Документ објављен под овом лиценцом. Ако одељак не одговара горњој дефиницији секундарног, онда није дозвољено да буде означен као непроменљив. Документ може да садржи нула непроменљивих одељака. Ако документ не идентификује ниједан непроменљиви одељак, онда их нема.

„Текстови на насловној страни“ су одређени кратки одломци текста који су наведени, као текстови на предњој корици или текстови на задњој корици, у обавештењу које каже да је Документ објављен под овом лиценцом. Текст на предњој корици може имати највише 5 речи, а текст на задњој корици може имати највише 25 речи.

„Транспарентна“ копија документа означава машински читљиву копију, представљену у формату чија је спецификација доступна широј јавности, која је погодна за директну ревизију документа помоћу генеричких уређивача текста или (за слике састављене од пиксела) генеричке боје програме или (за цртеже) неки широко доступни уређивач цртежа, а који је погодан за унос у форматере текста или за аутоматско превођење у различите формате погодне за унос у форматере текста. Копија направљена у иначе провидном file формат чије је означавање, или одсуство означавања, уређено да спречи или обесхрабрује накнадне измене од стране читалаца, није транспарентан. Формат слике није транспарентан ако се користи за било коју значајну количину текста. Копија која није „Транспарентна” назива се „Непрозирна”.

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. ExampПровидни формати слика укључују ПНГ, КСЦФ и ЈПГ. Непрозирни формати укључују власничке формате које могу да читају и уређују само власнички програми за обраду текста, СГМЛ или КСМЛ за које ДТД и/или алати за обраду нису генерално доступни, и машински генерисани ХТМЛ, ПостСцрипт или ПДФ који производе неки процесори текста за само за излазне сврхе.

„Насловна страница“ значи, за штампану књигу, саму насловну страну, плус следеће странице које су потребне да би се материјал који је овом лиценцом захтевао да би се појавио на насловној страни, читљиво. За дела у форматима који немају насловну страницу као такву, „Насловна страница“ означава текст близу најистакнутијег изгледа наслова дела, који претходи почетку текста.

Одељак „Наслов КСИЗ“ означава именовану подјединицу документа чији је наслов тачно КСИЗ или садржи КСИЗ у загради иза текста који преводи КСИЗ на други језик. (Овде КСИЗ означава назив одређеног одељка који се помиње у наставку, као што је „Захвалнице”, „Посвете”, „Потврде” или „Историја”.) „Сачувати наслов” таквог одељка када модификујете документ значи да остаје одељак „Под називом КСИЗ“ према овој дефиницији.

Документ може да садржи Одрицање од одговорности за гаранцију поред обавештења у коме се наводи да се ова Лиценца примењује на Документ. Сматра се да су ова Одрицања од одговорности укључена у ову Лиценцу као референца, али само у погледу одрицања од гаранција: свака друга импликација коју ова Одрицања одговорности могу имати је неважећа и нема утицаја на значење ове Лиценце.

ВЕРБАТИМ ЦОПИИНГ

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.

Такође можете да позајмите копије, под истим условима наведеним горе, и можете јавно приказати копије.

КОПИРАЊЕ У КОЛИЧИНИ

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.

Ако су потребни текстови за било коју корицу превише обимни да би стали читљиво, требало би да ставите прве наведене (колико год одговара разумно) на стварну корицу, а остале наставите на суседне странице.

Ако објављујете или дистрибуирате непрозирне копије Документа које броје више од 100, морате или укључити машински читљиву Транспарент копију заједно са сваком непрозирном копијом, или навести у или са сваком непрозирном копијом локацију рачунарске мреже са које је општа мрежа- коришћење публиц има приступ за преузимање преко јавних стандардних мрежних протокола комплетне транспарентне копије документа, без додатног материјала. Ако користите потоњу опцију, морате предузети разумно опрезне кораке када започнете дистрибуцију непрозирних копија у количини, како бисте осигурали да ће ова Транспарентна копија остати доступна на наведеној локацији до најмање годину дана након што сте последњи пут дистрибуирали Непровидна копија (директно или преко ваших агената или продаваца) тог издања за јавност.

Захтева се, али није обавезно, да контактирате ауторе Документа много пре него што поново дистрибуирате било који велики број копија, како бисте им дали прилику да вам доставе ажурирану верзију Документа.

МОДИФИКАЦИЈЕ

Можете копирати и дистрибуирати Измењену верзију Документа под условима горњих одељака 2 и 3, под условом да издате Измењену верзију под управо овом Лиценцом, при чему Измењена верзија испуњава улогу Документа, чиме се лиценцира дистрибуција и модификација измењену верзију свакоме ко поседује њену копију. Поред тога, морате да урадите ове ствари у модификованој верзији:

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

Ако Измењена верзија укључује нове одељке или додатке који се квалификују као Секундарни одељци и не садрже материјал копиран из Документа, можете по својој жељи да одредите неке или све ове одељке као непроменљиве. Да бисте то урадили, додајте њихове наслове на листу непроменљивих секција у обавештењу о лиценци за модификовану верзију. Ови наслови морају да се разликују од свих других наслова секција.

Можете да додате одељак под називом „Препоруке“, под условом да не садржи ништа осим подршке Ваше модификоване верзије од стране различитих страна—нпр.ampле, изјаве вршњака реview или да је текст одобрила организација као ауторитативна дефиниција стандарда.

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.

Аутор(и) и издавач(и) Документа овом лиценцом не дају дозволу да користе своја имена за рекламирање или за тврдњу или имплицирање одобравања било које измењене верзије.

КОМБИНОВАЊЕ ДОКУМЕНТА

Документ можете комбиновати са другим документима објављеним под овом лиценцом, под условима дефинисаним у одељку 4 изнад за модификоване верзије, под условом да у комбинацију укључите све непроменљиве одељке свих оригиналних докумената, неизмењених, и наведете их све као непроменљиве делове вашег комбинованог рада у обавештењу о лиценци, и да чувате сва њихова одрицања одговорности.

Комбиновано дело треба да садржи само једну копију ове лиценце, а више идентичних непроменљивих одељака може бити замењено једном копијом. Ако постоји више непроменљивих одељака са истим именом, али различитим садржајем, учините наслов сваког таквог одељка јединственим додавањем на крају, у загради, име оригиналног аутора или издавача тог одељка ако је познато, или у супротном јединствени број. Направите исто прилагођавање наслова одељака на листи непроменљивих секција у обавештењу о лиценци комбинованог дела.

У комбинацији, морате комбиновати све одељке под називом „Историја“ у различитим оригиналним документима, формирајући један одељак под називом „Историја“; исто тако комбинујте све одељке под називом „Захвалнице“ и све одељке под називом „Посвете“. Морате избрисати све одељке под насловом „Препоруке“.

ЗБИРКЕ ДОКУМЕНТА

Можете направити колекцију која се састоји од Документа и других докумената издатих под овом Лиценцом и заменити појединачне копије ове Лиценце у различитим документима са једном копијом која је укључена у збирку, под условом да поштујете правила ове Лиценце за дословно преписивање сваког од докумената у свим осталим аспектима.

Можете издвојити један документ из такве колекције и дистрибуирати га појединачно под овом лиценцом, под условом да уметнете копију ове лиценце у екстраховани документ и да следите ову лиценцу у свим осталим аспектима у вези са дословном копирањем тог документа.

ЗБИРАЊЕ СА САМОСТАЛНИМ РАДОВИМА

Компилација Документа или његових деривата са другим засебним и независним документима или делима, у или на медијуму за складиштење или дистрибуцију, назива се „агрегатом“ ако се ауторска права која проистичу из компилације не користе за ограничавање законских права корисника компилације изван онога што појединачни радови дозвољавају. Када је Документ укључен у агрегат, ова Лиценца се не примењује на друга дела у збиру која сами по себи нису изведена дела Документа.

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.

ТРАНСЛАТИОН

Превод се сматра врстом модификације, тако да можете дистрибуирати преводе Документа под условима из одељка 4. Замена непроменљивих одељака преводима захтева посебну дозволу од власника њихових ауторских права, али можете укључити преводе неких или свих непроменљивих одељака поред оригиналне верзије ових непроменљивих одељака. Можете да укључите превод ове Лиценце и сва обавештења о лиценци у Документу, као и сва одрицања одговорности, под условом да укључите и оригиналну енглеску верзију ове Лиценце и оригиналне верзије тих обавештења и одрицања одговорности. У случају неслагања између превода и оригиналне верзије ове лиценце или обавештења или одрицања одговорности, оригинална верзија ће имати предност.

Ако је одељак у документу насловљен „Признања”, „Посвете” или „Историја”, захтев (одељак 4) да се сачува његов наслов (одељак 1) обично захтева промену стварног наслова.

ПРЕСТАНАК

Не можете копирати, модификовати, подлиценцирати или дистрибуирати Документ осим како је изричито предвиђено овом лиценцом. Сваки други покушај копирања, модификације, подлиценцирања или дистрибуције Документа је неважећи и аутоматски ће укинути ваша права по овој лиценци. Међутим, странама које су од вас добиле копије или права по овој лиценци неће бити укинуте лиценце све док се такве стране у потпуности придржавају.

БУДУЋЕ РЕВИЗИЈЕ ОВЕ ЛИЦЕНЦЕ

Фондација за слободни софтвер може с времена на време објављивати нове, ревидиране верзије ГНУ лиценце за слободну документацију. Такве нове верзије ће по духу бити сличне садашњој верзији, али се могу разликовати у детаљима како би одговориле на нове проблеме или недоумице. Видите http://www.gnu.org/copyleft/.

Свака верзија Лиценце има посебан број верзије. Ако Документ наводи да се одређена нумерисана верзија ове лиценце „или било која каснија верзија“ односи на њега, имате могућност да следите одредбе и услове било те наведене верзије или било које касније верзије која је објављена (не као нацрт) од стране Фондације за слободни софтвер. Ако Документ не наводи број верзије ове Лиценце, можете одабрати било коју верзију коју је икада објавила (не као нацрт) Фондације за слободни софтвер.

ДОДАТАК: Како користити ову лиценцу за своје документе

Ауторска права (ц) ГОДИНА ВАШЕ ИМЕ. Даје се дозвола за копирање, дистрибуцију и/или измену овог документа под условима ГНУ лиценце за слободну документацију, верзије 1.2 или било које новије верзије коју је објавила Фондација за слободни софтвер; без непроменљивих одељака, без текста на предњој корици и без текста на задњој корици. Копија лиценце је укључена у одељак под насловом „ГНУ слободна лиценца за документацију“.