UYUNI Common Workflows User Guide

UYUNI Common Workflows

Pratarmė

1 skyrius

Bendros darbo eigos

Naujasis 2026.04 m. XNUMX d

„Uyuni“ bendrųjų darbo eigų vadove pateikiamos nuoseklios instrukcijos, kaip įdiegti, valdyti ir konfigūruoti klientus naudojant „Uyuni“.

Kiekvienas šiame vadove aprašytas darbo eigas turi aiškų tikslą ir apima išsamius veiksmus, padėsiančius jums jį efektyviai pasiekti.

Šis vadovas, skirtas tiek įprastiems, tiek sudėtingesniems uždaviniams, ne tik paaiškina atliekamus veiksmus, bet ir pabrėžia galimus kiekvienoje situacijoje variantus.tage.

Šiame vadove kiekviena įprasta užduotis vadinama darbo eiga.

Paskelbimo data: 2026-04-29

Kliento priėmimas

2 skyrius

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.

Naudojimo dėklas

Ši darbo eiga parodo, kaip įtraukti klientą į Uyuni serverį.

Klientas turi veikti palaikomą „Linux“ operacinę sistemą. Palaikomų klientų sistemų sąrašą žr Client-configuration › Supported-features.

Tai yra viena iš pirmųjų užduočių, kurias turite atlikti pirmą kartą nustatydami Uyuni, ir tikriausiai turėsite tai atlikti dar daug kartų, kai naudosite produktą.

Rezultatas

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. Tada galite naudoti Uyuni klientui valdyti.

Pasiruošimas

Prieš pradėdami, jau turėtumėte turėti:

• Įdiegtas Uyuni serveris, kurį galite pasiekti naudodami Web Vartotojo sąsaja
• Kliento įrenginys su įdiegta operacine sistema, kurią galite pasiekti tinkle, kuriame yra jūsų Uyuni serveris, naudodami SSH.
• Atitinkamos prenumeratos nuo http://scc.suse.com už jūsų naudojamus produktus.

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.

Žingsnis po žingsnio darbo eigos instrukcijos

Procedūra: Konfigūruokite visiškai kvalifikuotą domeno vardą (FQDN) savo kliente

1. Kliento komandų eilutėje parodykite dabartinį pagrindinio kompiuterio pavadinimą:
   hostname -f
   Ši komanda tikriausiai grąžins klaidą arba parodys kažką panašaus į localhost.
2. Nustatykite naują pagrindinio kompiuterio pavadinimą. Jūsų naujame prieglobos pavadinime turi būti padomenio pavadinimas, todėl jame turi būti bent du taškai. Šiame buvample, we are using client1.MLM.example
   hostnamectl set-hostname client1.MLM.example
3. Patikrinkite, ar pakeitimas buvo sėkmingas:
   hostnamectl
4. Open YaST and navigate to Network Services › Hostnames. Edit the hostname to match the one you just
   set, and click [GERAI].
5. „YaST“ programoje eikite į Sistema › Tinklo nustatymai ir eikite į skirtuką Pagrindinio kompiuterio pavadinimas / DNS. Lauke „Statinis pagrindinio kompiuterio pavadinimas“ įveskite savo naują pagrindinio kompiuterio pavadinimą.
6. Patikrinkite, ar pakeitimas buvo sėkmingas:
   hostname -f
   This command should return your new FQDN

Procedūra: Paruoškite programinės įrangos kanalus Uyuni serveryje

1. Uyuni mieste Web UI, eikite į Admin › Setup Wizard.
2. Skirtuke Organizacijos kredencialai įsitikinkite, kad įvedėte SUSE klientų centro kredencialus ir esate tinkamai autentifikuoti.
3. Skirtuke Produktai įsitikinkite, kad produktų katalogas yra visiškai atnaujintas:
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 [Pridėti produktus ]:
5. Palaukite, kol gaminio kanalai bus visiškai sinchronizuoti. Priklausomai nuo jūsų pasirinktų produktų, tai gali užtrukti ilgai.

Procedūra: Sukurkite aktyvinimo raktą

1. Uyuni mieste Web UI, eikite į Sistemos › Activation Keys, ir spustelėkite [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 [Sukurti aktyvinimo raktą].

Procedūra: paleiskite klientą

1. Uyuni mieste Web UI, eikite į Systems › Bootstrapping.
2. Įveskite pagrindinio kompiuterio pavadinimą ir pateikite autentifikavimo kredencialus klientui, kurį norite įtraukti, ir pasirinkite aktyvinimo raktą. Spustelėkite [Bootstrap]:
3. Eikite į Systems › System List to manage your new client

Susijusios temos

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

Klientai atnaujina naudodami pasikartojančius veiksmus

3 skyrius

Ši darbo eiga parodo, kaip automatizuoti Uyuni registruotų klientų atnaujinimą naudojant pasikartojančius veiksmus.

Use case / Situation

Automatinis klientų atnaujinimas yra naudingas, kai:

• norima atnaujinti daug klientų
• darbo eiga neturėtų būti kartojama kiekvieną kartą
• yra specialus priežiūros langas.

Rezultatas / sprendimas

Sėkmingai užbaigus šią darbo eigą, būsena yra nuosekli ir palaikoma.

Pasiruošimas

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

Norint atnaujinti klientą, reikia atlikti du veiksmus. Trečiasis veiksmas yra neprivalomas, bet labai rekomenduojamas norint užbaigti atnaujinimo procesą.

Procedūra: Creating a recurring action to update Salt itself

1. Kaip buvęsample, kuriame veiksmą, skirtą pačiai druskai atnaujinti, kaip pasikartojantį veiksmą visoms organizacijos sistemoms. Uyuni mieste Web UI, eikite į Home › My Organization › Recurring Actions ir spustelėkite [Create].
2. Select Action Type Pasirinktinis valstybė and enter a Schedule Name like update salt .
3. Pasirinkite tvarkaraštį. Pavyzdžiui,ample, Weekly: Wednesday, 9:00 am .
4. Priskirkite atnaujinimo druskos būseną pažymėdami žymimąjį laukelį.
5. Spustelėkite [Save Changes ] to save the action.
6. You can edit the execution order of the states if needed. Click [Patvirtinti] to confirm the order.
7. Spustelėkite [Create Schedule] to save the action.

Procedūra: Creating a recurring action to apply all available updates to the systems

1. Kaip buvęsample we create the action to apply all updates as a recurring action for a system group called infrastruktūros paslaugos. Uyuni mieste 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. Pasirinkite tvarkaraštį. Pavyzdžiui,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 naujausia by selecting the checkboxes. To perform a reboot afterwards you can also add reboot or reboot if needed.
6. Save the action by clicking [Išsaugoti pakeitimus ].
7. You can edit the execution order of the states. The order should be util. syn call, certs, channels, naujausia and finally reboot or reboot if needed if chosen. Click [Patvirtinti] to store the order.
8. Spustelėkite [Create Schedule] to save the action.

Procedūra: Creating a recurring action to run a high state after the update

1. Kaip buvęsample, we create the action to apply the high state for the same group which was fully updated before. In the Uyuni Web UI, eikite į Systems › System Groups and click infra-services.
2. Go to Recurring Actions and click [Create].
3. Select Action Type Aukšta būsena and enter a Schedule Name like high state .
4. Pasirinkite tvarkaraštį. Pavyzdžiui,ample, Weekly: Wednesday, 10:30 am . Again, keep enough time between this action and the full-system-update action.
5. Spustelėkite [Create Schedule] to save the action.

Background information on up-to-date state

1. The naujausia state applies critical patches to the update components.
   • a. On SUSE-based systems, the state executes the command:
     zypper --non-interactive patch --updatestack-only
     Ir tada valstybė taip pat atnaujina 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.
   Perkrovimo aptikimas būdingas kliento operacinei sistemai.
   • Debian arba Ubuntu atveju žr. https://www.debian.org/doc/debian-policy/ch-opersys.html#signaling-that-a-reboot-is-required.
   • Netransakciniams SUSE klientams „Uyuni“ perkrauna klientą, kai „zypper -x list-patches“ nurodo, kad pataisymams reikia perkrauti.
   • Transakcinių SUSE klientų atveju „Uyuni“ perkrauna klientą, jei yra laukiama transakcijų.
   • 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

Susijusios temos

• Daugiau informacijos apie pasikartojančius veiksmus žr. Pasikartojantys veiksmai.
• For more information about custom info values, see Client-configuration › Custom-info.

Konfigūracijos valdymas

4 skyrius

Galite naudoti konfigūraciją files ir kanalus, kad galėtumėte valdyti savo klientų konfigūraciją, o ne konfigūruoti kiekvieną klientą rankiniu būdu. Ši darbo eiga parodo, kaip naudoti Uyuni Web UI, kad sukurtumėte centralizuotai valdomą konfigūraciją file, priskirkite jį klientui ir pritaikykite konfigūraciją.

Naudojimo dėklas

Jei tvarkote daug klientų, tikriausiai nenorite kiekvienam iš jų rankiniu būdu taikyti konfigūracijos nustatymų. Konfigūracijos kanalai naudojami konfigūracijai organizuoti files. Galite užsiprenumeruoti klientų konfigūravimo kanalus ir įdiegti konfigūraciją files pagal poreikį.

Rezultatas

Kai baigsite šią darbo eigą, turėsite konfigūracijos kanalą su konfigūracija file, kanalui priskyrė klientus ir sėkmingai pritaikė konfigūraciją.

Pasiruošimas

Prieš pradėdami, jau turėtumėte turėti:

• Įdiegtas Uyuni serveris, kurį galite pasiekti naudodami Web Vartotojo sąsaja
• Bent vienas klientas užsiregistravo jūsų serveryje.
• Atitinkamos prenumeratos nuo http://scc.suse.com už jūsų naudojamus produktus.

Šioje darbo eigoje naudojama centralizuotai valdoma konfigūracija file and a Salt state. For more information about the different ways to manage configuration, see Client-configuration › Configuration-management.

Žingsnis po žingsnio darbo eigos instrukcijos

Procedūra: sukurkite naują konfigūracijos kanalą ir File

1. Uyuni mieste Web UI, eikite į Configuration › Channels ir spustelėkite [Create State Channel].
2. Įveskite savo konfigūracijos pavadinimą, etiketę ir aprašą fileir įveskite savo konfigūracijos turinį file. Buvęsample that you can copy is at the end of this section.

Procedūra: priskirkite klientus konfigūravimo kanalui

1. Uyuni mieste Web UI, eikite į Systems › Systems List and select the client you want to assign to your configuration channel.
2. Eikite į skirtuką Konfigūracija. Gimenu: Konfigūracija baigtaview skyrių, spustelėkite [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 ] pabaigti.

Procedūra: pritaikykite konfigūraciją savo klientui

1. Uyuni mieste Web UI, eikite į 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 [Įdiekite visą valdomą konfigūraciją files ]

Example

SLS būsena, skirta nuolat atnaujinti klientus

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

Susijusios temos

• For more information about configuration management, see Client-configuration › Configuration management.
• Daugiau informacijos apie SLS files, žiūrėkite: https://docs.saltproject.io/en/latest/topics/tutorials/starting_states.html.

Turinio gyvavimo ciklo valdymas

5 skyrius

Jei tvarkote daug klientų ir jums reikia pritaikyti jiems pritaikytus paketus, paketams tvarkyti galite naudoti turinio gyvavimo ciklo valdymą (CLM). CLM leidžia tinkinti ir išbandyti paketus prieš atnaujinant gamybos klientus. Tai taip pat naudinga, jei reikia taikyti naujinimus per ribotą priežiūros laikotarpį.

Naudojimo dėklas

Turinio gyvavimo ciklo valdymas leidžia pasirinkti programinės įrangos kanalus kaip šaltinius, pritaikyti juos pagal jūsų aplinką ir nuodugniai išbandyti juos prieš diegiant gamybiniuose klientuose. Galite naudoti CLM norėdami valdyti programinės įrangos kanalus nuo kūrimo iki testavimo ir pakeitimų pateikimo klientams.

Rezultatas

Kai baigsite šią darbo eigą, turėsite sukurti turinio gyvavimo ciklo projektą. Būsite sukūrę pagrindinį CLM projektą ir jį reklamuodami per visą jo gyvavimo ciklą.

Preparatai

Prieš pradėdami, jau turėtumėte turėti:

• „Uyuni“ serveris įdiegtas ir pasiekiamas naudojant Web Vartotojo sąsaja
• Kliento įrenginys su įdiegta operacine sistema, kurią galite pasiekti tinkle, kuriame yra jūsų Uyuni serveris, naudodami SSH.
• Atitinkamos prenumeratos nuo http://scc.suse.com už jūsų naudojamus produktus.

Žingsnis po žingsnio darbo eigos instrukcijos

Procedūra: sukurkite naują CLM projektą

1. Uyuni mieste Web UI, eikite į 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 ].
   Pasirinkite šaltinio tipą ir pasirinkite pagrindinį savo projekto kanalą.
   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 [Išsaugoti] to return to the project page.
3. Kol kas palikite filtrų skiltį tuščią, mes jų nenaudosimeample. Jei reikės, vėliau galėsite pridėti filtrų.
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. Spustelėkite [Sukurti] to build version 1 of your project:

Procedūra: priskirkite klientus

1. Eikite į Systems › System List, select the client to assign, and go to the Software › Software Channels skirtuką.
2. Skiltyje „Bazinis kanalas“ pasirinkite CLM projektą ir aplinką, kuriai norite priskirti klientą.
   Pavyzdžiui,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. Spustelėkite [Kitas] to assign the client.

Procedūra: Skatinkite aplinką

1. Uyuni mieste Web UI, eikite į 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.

Susijusios temos

• For more information about CLM, including information about how to use filters, see Administration › Content-lifecycle.
• CLM, pvzamples, žiūrėk Administration › Content-lifecycle-examples.

Customize Apache Configuration

6 skyrius.

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.

Naudojimo atvejis

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.

Rezultatas

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

Pasiruošimas

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 (pvzample, custom_ tuning. conf) and add your required Apache directives.
5. Kai išsaugojote savo file, exit the container with command:
   exit
6. Restart the Uyuni services to apply the changes:
   mgradm restart

Produkto atnaujinimas per Web UI

7 skyrius

Jei norite atnaujinti registruotą SUSE Linux Enterprise kliento paketą į naujesnę produkto versiją, tai galite padaryti komandinėje eilutėje arba naudodami Web Vartotojo sąsaja

Šiame dokumente išsamiai aprašomas ir iliustruojamas gaminio atnaujinimas naudojant Web Vartotojo sąsaja

Naudojamos gaminio versijos neatspindi naujausių galimų versijų. Jie naudojami tik iliustravimo tikslais. Kaip buvęsample, ši procedūra aprašo atnaujinimą į 15 SP5 versiją iš ir senesnės 15 versijos. Jei taikote pagal kitą versiją, pasirinkite atitinkamus kanalus ir versijas.

Procedūra: gaminio atnaujinimas į naujesnę versiją naudojant Web UI

1. Prisijunkite prie Uyuni Web UI and navigate to Admin › Setup Wizard › Products and search for SUSE Linux Enterprise Server 15 SP5 x86_64.
2. Pasirinkite rekomenduojamus kanalus.
3. Spustelėkite [Add Products ].
4. Eikite į Systems › Registered client › Software › Product Migration. You will see the targets available for that registered client.
5. Pasirinkite SUSE Linux Enterprise Server 15 SP5 x86_64. Tai dar labiau išsiplės.
6. Pasirinkite tikslinį pagrindinį kanalą kaip SLE-Product-SLES15-SP5-Pool, skirtą x86_64. Leisti keisti tiekėją palikite nepažymėtą.
7. Spustelėkite [Schedule Migration]. The message will be highlighted It is better to do a dry run first so continuing with dry run first.
8. Spustelėkite [Sausas bėgimas] and check the status of the simulation in Events › History. You should see a return code 0 indicating a successful dry run.
9. Spustelėkite [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. Ant Uyuni Web UI side, verify the successfully completed product upgrade by going to Systems › Registered client › Details.
12. Kliento pusėje galite tai patikrinti paleisdami:
    cat /etc/os-release
13. Išvestis atrodys panašiai:

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 nemokama dokumentacijos licencija

8 skyrius

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.

PREAMBULĖ

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.

Sukūrėme šią Licenciją, kad galėtume ją naudoti nemokamos programinės įrangos vadovams, nes nemokama programinė įranga turi būti nemokama dokumentacija: nemokama programa turi būti su vadovais, suteikiančiais tokias pačias laisves kaip ir programinė įranga. Tačiau ši Licencija neapsiriboja programinės įrangos žinynais; jis gali būti naudojamas bet kokiam tekstiniam kūriniui, nepriklausomai nuo temos ir ar jis išleistas kaip spausdinta knyga. Mes rekomenduojame šią Licenciją daugiausia darbams, kurių tikslas yra instrukcija arba nuoroda.

TAIKYMAS IR APIBRĖŽIMAI

Ši Licencija taikoma bet kokiam vadovui ar kitam darbui bet kokioje laikmenoje, kuriame yra autorių teisių savininko pranešimas, kuriame teigiama, kad jis gali būti platinamas pagal šios Licencijos sąlygas. Toks pranešimas suteikia pasaulinę nemokamą neribotos trukmės licenciją naudoti tą kūrinį čia nurodytomis sąlygomis. Žemiau esantis „Dokumentas“ reiškia bet kurį tokį vadovą ar darbą. Bet kuris visuomenės narys yra licencijos turėtojas ir yra kreipiamas kaip „jūs“. Sutinkate su licencija, jei kopijuojate, modifikuojate ar platinate kūrinį tokiu būdu, kuriam reikalingas leidimas pagal autorių teisių įstatymus.

„Pakeista dokumento versija“ reiškia bet kokį kūrinį, kuriame yra Dokumentas arba jo dalis, nukopijuotas pažodžiui arba su pakeitimais ir (arba) išverstas į kitą kalbą.

„Antrinė dalis“ yra pavadintas priedas arba priekinė dokumento dalis, kurioje išskirtinai nagrinėjami dokumento leidėjų ar autorių santykiai su visa dokumento tema (arba su susijusiais dalykais) ir nėra nieko, kas galėtų tiesiogiai priklausyti per tą bendrą temą. (Taigi, jei dokumentas iš dalies yra matematikos vadovėlis, antrinis skyrius gali nepaaiškinti jokios matematikos.) Ryšys gali būti istorinio ryšio su dalyku ar su juo susijusiais dalykais arba teisiniu, komerciniu, filosofiniu, etiniu dalyku. arba politinė pozicija jų atžvilgiu.

„Nekintamieji skyriai“ yra tam tikros antrinės sekcijos, kurių pavadinimai yra nurodyti kaip nekintamų skyrių pavadinimai pranešime, kuriame teigiama, kad dokumentas išleistas pagal šią Licenciją. Jei skyrius neatitinka pirmiau pateikto antrinio apibrėžimo, jis negali būti priskirtas kaip nekintantis. Dokumente gali būti nulis nekintamų skyrių. Jei dokumentas nenustato jokių nekintamų skyrių, tada jų nėra.

„Viršelio tekstai“ yra tam tikros trumpos teksto dalys, kurios yra nurodytos kaip priekinio viršelio tekstai arba galinio viršelio tekstai pranešime, kuriame teigiama, kad dokumentas išleistas pagal šią Licenciją. Priekinio viršelio tekstą gali sudaryti daugiausia 5 žodžiai, o galinio viršelio tekstą – 25 žodžius.

„Skaidri“ dokumento kopija – tai mašininiu būdu nuskaitoma kopija, pateikta plačiajai visuomenei prieinamu formatu, tinkama dokumento peržiūrai tiesiogiai naudojant bendruosius teksto redaktorius arba (vaizdams, sudarytiems iš pikselių) bendru dažymu. programos arba (brėžiniams) koks nors plačiai prieinamas piešinių redaktorius, tinkantis įvesti į teksto formatuotojus arba automatiniam vertimui į įvairius formatus, tinkamus įvesti į teksto formatuotojus. Kopija, padaryta kitaip permatoma file formatas, kurio žymėjimas arba žymėjimo nebuvimas buvo sutvarkytas taip, kad skaitytojai neleistų atlikti tolesnių modifikacijų arba neskatintų jų atlikti, nėra skaidrus. Vaizdo formatas nėra skaidrus, jei naudojamas dideliam teksto kiekiui. Kopija, kuri nėra „skaidri“, vadinama „nepermatoma“.

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. Exampmažiau skaidrių vaizdo formatų yra PNG, XCF ir JPG. Nepermatomieji formatai apima patentuotus formatus, kuriuos gali skaityti ir redaguoti tik patentuotos tekstų rengyklės, SGML arba XML, kurių DTD ir (arba) apdorojimo įrankiai paprastai nepasiekiami, ir mašininiu būdu sugeneruotą HTML, PostScript arba PDF, kurį sukuria kai kurios teksto rengyklės. tik išvesties tikslais.

„Pavadinimo puslapis“ reiškia spausdintoje knygoje patį titulinį puslapį ir kitus tolesnius puslapius, kurių reikia norint įskaitomai laikyti medžiagą, kurios reikalaujama pagal šią licenciją, kad ji būtų pateikta tituliniame puslapyje. Kūriniams, kurių formatai neturi titulinio puslapio, „Pavadinimo puslapis“ reiškia tekstą, esantį šalia ryškiausios kūrinio pavadinimo vietos, prieš pagrindinio teksto pradžią.

Skyrius „Pavadinimas XYZ“ reiškia pavadintą dokumento subvienetą, kurio pavadinimas yra tiksliai XYZ arba skliausteliuose yra XYZ po teksto, verčiančio XYZ į kitą kalbą. (Čia XYZ reiškia konkretų toliau paminėtą skyriaus pavadinimą, pvz., „Padėkos“, „Pašventimai“, „Patvirtinimai“ arba „Istorija“.) Tokio skyriaus pavadinimo „išsaugojimas“, kai keičiate dokumentą, reiškia, kad jis pagal šį apibrėžimą lieka skyrelis „Pavadinimas XYZ“.

Dokumente šalia pranešimo, kuriame teigiama, kad ši Licencija taikoma šiam dokumentui, gali būti pateikti garantijos atsisakymai. Laikoma, kad šie garantijos atsisakymai įtraukti į šią Licenciją kaip nuoroda, tačiau tik dėl garantijų atsisakymo: bet kokios kitos pasekmės, kurias gali turėti šie garantijos atsisakymai, negalioja ir neturi įtakos šios Licencijos reikšmei.

PAŽODINIS KOPIJAVIMAS

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.

Taip pat galite paskolinti kopijas tomis pačiomis anksčiau nurodytomis sąlygomis ir galite viešai rodyti kopijas.

KOPIJUOJAMA KIEKIS

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.

Jei bet kurio viršelio būtini tekstai yra per dideli, kad tilptų įskaitomai, pirmuosius išvardintus (tiek, kiek tinkama) turėtumėte įdėti į tikrąjį viršelį, o kitus tęsti gretimuose puslapiuose.

Jei publikuojate arba platinate nepermatomas dokumento kopijas, kurių skaičius viršija 100, kartu su kiekviena nepermatoma kopija turite įtraukti mašininiu būdu skaitomą skaidrią kopiją arba kiekvienoje nepermatomoje kopijoje nurodyti kompiuterių tinklo vietą, iš kurios bendras tinklas Naudodamasis viešas turi prieigą, naudojant viešo standarto tinklo protokolus, atsisiųsti visą skaidrią dokumento kopiją be papildomos medžiagos. Jei naudojate pastarąją parinktį, pradėdami platinti nepermatomų kopijų kiekį turite imtis pakankamai apdairių veiksmų, kad užtikrintumėte, jog ši skaidri kopija išliks pasiekiama nurodytoje vietoje mažiausiai vienerius metus nuo paskutinio platinimo. Nepermatoma to leidimo kopija (tiesiogiai arba per agentus ar mažmenininkus) visuomenei.

Prieš platinant didelį kopijų skaičių, prašome, bet neprivaloma, susisiekti su Dokumento autoriais, kad jie galėtų pateikti jums atnaujintą Dokumento versiją.

MODIFIKACIJOS

Galite kopijuoti ir platinti modifikuotą dokumento versiją pagal 2 ir 3 skyriuose nurodytas sąlygas, su sąlyga, kad modifikuotą versiją išleisite būtent pagal šią Licenciją, o modifikuota versija atliks dokumento vaidmenį, taip suteikiant licenciją platinti ir modifikuoti Modifikuota versija tiems, kurie turi jos kopiją. Be to, pakeistoje versijoje turite atlikti šiuos veiksmus:

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

Jei modifikuotoje versijoje yra naujų priekinių skyrių ar priedų, kurie yra antriniai skyriai ir joje nėra iš Dokumento nukopijuotos medžiagos, savo nuožiūra galite priskirti kai kurias arba visas šias dalis kaip nekintamas. Norėdami tai padaryti, pridėkite jų pavadinimus į nekintamų skyrių sąrašą modifikuotos versijos pranešime apie licenciją. Šie pavadinimai turi skirtis nuo visų kitų skyrių pavadinimų.

Galite pridėti skyrių, pavadintą „Patvirtinimai“, jei joje nėra nieko, išskyrus jūsų modifikuotos versijos patvirtinimus įvairių šalių, pvz.,ample, bendraamžių pareiškimai review arba kad tekstas buvo patvirtintas organizacijos kaip autoritetingas standarto apibrėžimas.

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.

Dokumento autorius (-ai) ir leidėjas (-ai) pagal šią Licenciją nesuteikia leidimo naudoti savo vardų viešinimui arba teigti ar numanyti, kad patvirtinama bet kokia modifikuota versija.

DOKUMENTŲ DERINIMAS

Galite sujungti dokumentą su kitais dokumentais, išleistais pagal šią Licenciją, vadovaudamiesi anksčiau 4 skyriuje nurodytomis modifikuotoms versijoms skirtomis sąlygomis, su sąlyga, kad į derinį įtrauksite visas nepakeistas visų originalių dokumentų nekeičiamas dalis ir išvardinsite juos visus. kaip Nekintamus jūsų bendro darbo skyrius savo pranešime apie licenciją ir kad išsaugotumėte visus jų garantijos atsisakymus.

Kombinuotame darbe turi būti tik viena šios Licencijos kopija, o keli identiški Nekintamieji skyriai gali būti pakeisti viena kopija. Jei yra kelios nekintamos skiltys su tuo pačiu pavadinimu, bet skirtingu turiniu, kiekvienos tokios sekcijos pavadinimą padarykite unikalų, skliausteliuose įtraukdami pirminio to skyriaus autoriaus arba leidėjo vardą, jei žinomas, arba unikalus numeris. Atlikite tą patį koregavimą nekintamų sekcijų sąrašo skyrių pavadinimams kombinuoto kūrinio licencijos pranešime.

Derinyje turite sujungti bet kokius įvairių originalių dokumentų skyrius, pavadintus „Istorija“, sudarydami vieną skyrių „Istorija“; taip pat sujunkite visas dalis, pavadintas „Padėka“, ir visas skiltis, pavadintas „Padėkos“. Turite ištrinti visus skyrius, pavadintus „Patvirtinimai“.

DOKUMENTŲ KOLEKCIJOS

Galite sudaryti rinkinį, sudarytą iš Dokumento ir kitų pagal šią Licenciją išleistų dokumentų, ir pakeisti atskiras šios Licencijos kopijas įvairiuose dokumentuose vienu egzemplioriumi, kuris yra rinkinyje, su sąlyga, kad laikysitės šios Licencijos taisyklių. pažodinis kiekvieno dokumento kopijavimas visais kitais atžvilgiais.

Galite išskirti vieną dokumentą iš tokio rinkinio ir platinti jį atskirai pagal šią Licenciją, jei į ištrauktą dokumentą įdedate šios Licencijos kopiją ir visais kitais atžvilgiais laikotės šios Licencijos, susijusios su pažodiniu to dokumento kopijavimu.

SUJUNGTI SU SAVARANKIŠKAIS DARBAIS

Dokumento ar jo išvestinių dokumentų rinkinys su kitais atskirais ir nepriklausomais dokumentais ar kūriniais, esantis saugojimo ar platinimo laikmenoje arba jos tome, vadinamas „agregatu“, jei sukūrus autorių teises nesinaudojama siekiant apriboti juridines teises. rinkinio naudotojų daugiau nei leidžia atskiri kūriniai. Kai Dokumentas yra įtrauktas į visumą, ši Licencija netaikoma kitiems kūriniams visumoje, kurie patys nėra dokumento išvestiniai kūriniai.

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.

VERTIMAS

Vertimas yra laikomas tam tikru modifikavimu, todėl galite platinti Dokumento vertimus pagal 4 skyriaus sąlygas. Keičiant nekintamus skyrius vertimais, reikalingas specialus jų autorių teisių turėtojų leidimas, tačiau galite įtraukti kai kurių arba visų nekintamų skyrių vertimus be originalios šių nekintamų skyrių versijos. Galite įtraukti šios Licencijos vertimą ir visus pranešimus apie licenciją į dokumentą bei bet kokius garantijos atsisakymus, jei taip pat įtrauksite originalią šios Licencijos versiją anglų kalba ir originalias tų pranešimų ir atsakomybės atsisakymų versijas. Kilus nesutarimui tarp vertimo ir originalios šios Licencijos versijos arba pranešimo ar atsakomybės atsisakymo atveju, pirmenybė bus teikiama pirminei versijai.

Jei dokumento skyrius pavadintas „Padėka“, „Pašventimai“ arba „Istorija“, reikalavimas (4 skirsnis) išsaugoti pavadinimą (1 skirsnis) paprastai reikalauja pakeisti tikrąjį pavadinimą.

NUTRAUKIMAS

Jūs negalite kopijuoti, modifikuoti, sublicencijuoti ar platinti Dokumento, išskyrus atvejus, kai tai aiškiai numatyta šioje Licencijoje. Bet koks kitas bandymas kopijuoti, modifikuoti, sublicencijuoti ar platinti Dokumentą yra negaliojantis ir automatiškai panaikins jūsų teises pagal šią Licenciją. Tačiau šalims, kurios gavo kopijas arba teises iš jūsų pagal šią Licenciją, licencijos nebus nutrauktos tol, kol tokios šalys visiškai laikysis.

BUSIMAS ŠIOS LICENCIJOS PATIKSLINIMAS

Laisvosios programinės įrangos fondas gali retkarčiais paskelbti naujas, peržiūrėtas GNU laisvosios dokumentacijos licencijos versijas. Tokios naujos versijos savo esme bus panašios į dabartinę versiją, tačiau gali skirtis, kad būtų išspręstos naujos problemos ar rūpesčiai. Matyti http://www.gnu.org/copyleft/.

Kiekvienai Licencijos versijai suteikiamas skiriamasis versijos numeris. Jei dokumente nurodyta, kad jai taikoma tam tikra sunumeruota šios Licencijos versija „arba bet kuri naujesnė versija“, turite galimybę laikytis nurodytos versijos arba bet kurios vėlesnės versijos, kuri buvo paskelbta (ne kaip juodraštis) pateikė Laisvosios programinės įrangos fondas. Jei dokumente nenurodomas šios Licencijos versijos numeris, galite pasirinkti bet kurią versiją (ne kaip juodraštį), kurią kada nors paskelbė Laisvosios programinės įrangos fondas.

PRIEDAS: Kaip naudoti šią licenciją savo dokumentams

Autorių teisės (c) METAI JŪSŲ VARDAS. Suteikiamas leidimas kopijuoti, platinti ir (arba) modifikuoti šį dokumentą pagal GNU Free Documentation License 1.2 versijos ar bet kurios vėlesnės versijos, paskelbtos Free Software Foundation, sąlygas; be nekintamų skyrių, be priekinio viršelio tekstų ir be galinio viršelio tekstų. Licencijos kopija yra skyriuje „GNU nemokama dokumentacijos licencija“.