UYUNI Common Workflows User Guide

UYUNI Common Workflows

Mukadimah

Bab 1

Aliran Kerja Biasa

Uyuni 2026.04

Panduan Aliran Kerja Biasa Uyuni menyediakan arahan langkah demi langkah untuk aliran kerja yang paling kerap digunakan untuk memasang, mengurus dan mengkonfigurasi klien dengan Uyuni.

Setiap aliran kerja dalam panduan ini mempunyai objektif yang jelas dan merangkumi langkah-langkah terperinci untuk membantu anda mencapainya dengan cekap.

Direka untuk tugasan rutin dan lanjutan, panduan ini bukan sahaja menerangkan tindakan yang anda ambil tetapi juga mengetengahkan pilihan yang tersedia pada setiaptage.

Sepanjang panduan ini, setiap tugas rutin dirujuk sebagai Alur Kerja.

Tarikh Penerbitan: 2026-04-29

Penyertaan Pelanggan

Bab 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

Aliran kerja ini menunjukkan kepada anda cara untuk memasukkan pelanggan ke Pelayan Uyuni anda.

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

Ini adalah salah satu tugas pertama yang perlu anda lakukan apabila anda menyediakan Uyuni buat kali pertama, dan anda mungkin perlu melakukannya lebih banyak kali semasa anda menggunakan produk tersebut.

Hasil

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. Anda kemudian boleh menggunakan Uyuni untuk menguruskan pelanggan.

Persediaan

Sebelum anda memulakan, anda sepatutnya sudah mempunyai:

• Uyuni Server dipasang, yang boleh anda akses menggunakan Web UI.
• Mesin pelanggan dengan sistem pengendalian dipasang, yang boleh anda akses merentasi rangkaian yang dihidupkan oleh Pelayan Uyuni anda, menggunakan SSH.
• Langganan yang sesuai daripada http://scc.suse.com untuk produk yang anda gunakan.

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.

Arahan Aliran Kerja Langkah demi langkah

Prosedur: Konfigurasikan Nama Domain Berkelayakan Penuh (FQDN) pada Pelanggan Anda

1. Pada klien, pada gesaan arahan, tunjukkan nama hos semasa:
   hostname -f
   Perintah ini mungkin akan mengembalikan ralat, atau menunjukkan sesuatu seperti localhost.
2. Tetapkan nama hos baharu. Nama hos baharu anda harus mempunyai nama subdomain dan oleh itu termasuk sekurang-kurangnya dua noktah. Dalam bekas iniample, we are using client1.MLM.example
   hostnamectl set-hostname client1.MLM.example
3. Semak sama ada perubahan anda berjaya:
   hostnamectl
4. Open YaST and navigate to Network Services › Hostnames. Edit the hostname to match the one you just
   set, and click [OKEY].
5. Dalam YaST, navigasi ke Sistem › Tetapan Rangkaian dan pergi ke tab Nama Hos/DNS. Dalam medan Nama hos Statik, taip nama hos baharu anda.
6. Semak sama ada perubahan itu berjaya:
   hostname -f
   This command should return your new FQDN

Prosedur: Sediakan Saluran Perisian pada Pelayan Uyuni

1. Di Uyuni Web UI, navigasi ke Admin › Setup Wizard.
2. Dalam tab Kredensial Organisasi, pastikan anda telah memasukkan bukti kelayakan Pusat Pelanggan SUSE anda dan disahkan dengan betul.
3. Dalam tab Produk, pastikan katalog produk dikemas kini sepenuhnya:
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 [Tambah produk ]:
5. Tunggu saluran produk disegerakkan sepenuhnya. Bergantung pada produk yang telah anda pilih, ini mungkin mengambil masa yang lama.

Procedure: Create an Activation Key

1. Di Uyuni Web UI, navigasi ke Sistem › Activation Keys, dan klik [Create Key].
2. Give your activation key a name, and select the base channel that matches the client you want to onboard.
   This should be the product you just enabled:
3. Check the child channels to include, and any add-on system types you want clients registered with this key to have. Click [Cipta Kunci Pengaktifan].

Prosedur: Bootstrap Pelanggan

1. Di Uyuni Web UI, navigasi ke Systems › Bootstrapping.
2. Taipkan nama hos dan berikan bukti kelayakan pengesahan untuk klien yang anda mahu sertai, dan pilih kekunci pengaktifan. klik [Bootstrap]:
3. Navigasi ke Systems › System List to manage your new client

Topik Berkaitan

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

Kemas Kini Pelanggan Menggunakan Tindakan Berulang

Bab 3

Aliran kerja ini menunjukkan cara untuk mengotomatisasi pengemaskinian pelanggan yang didaftarkan di Uyuni menggunakan tindakan berulang.

Use case / Situation

Kemas kini automatik pelanggan bermanfaat apabila:

• kemas kini sejumlah besar pelanggan dikehendaki
• aliran kerja tidak seharusnya dilakukan semula setiap pelaksanaan
• tetingkap penyelenggaraan khusus wujud.

Hasil / Resolusi

Penyiapan aliran kerja ini dengan jayanya menghasilkan keadaan yang konsisten dan boleh disokong.

Persediaan

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

Untuk mengemas kini pelanggan dua langkah diperlukan. Langkah ketiga adalah pilihan tetapi sangat disyorkan untuk memuktamadkan proses kemas kini.

Prosedur: Creating a recurring action to update Salt itself

1. Sebagai bekasampOleh itu, kami mencipta tindakan untuk mengemas kini Salt sendiri sebagai tindakan berulang untuk semua sistem dalam organisasi. Di Uyuni Web UI, navigasi ke Home › My Organization › Recurring Actions dan klik [Buat].
2. Select Action Type Adat negeri and enter a Schedule Name like update salt .
3. Pilih jadual. Untuk example, Weekly: Wednesday, 9:00 am .
4. Tetapkan keadaan garam kemas kini dengan memilih kotak semak.
5. klik [Save Changes ] to save the action.
6. You can edit the execution order of the states if needed. Click [Sahkan] to confirm the order.
7. klik [Create Schedule] to save the action.

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

1. Sebagai bekasample we create the action to apply all updates as a recurring action for a system group called infra-services. Di Uyuni Web UI go to Systems › System Groups and click on infra-services.
2. Now go to Recurring Actions and click [Buat].
3. Select Action Type Custom State and enter a Schedule Name like full system-update.
4. Pilih Jadual. Untuk example, 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 terkini by selecting the checkboxes. To perform a reboot afterwards you can also add reboot or reboot if needed.
6. Save the action by clicking [Simpan Perubahan ].
7. You can edit the execution order of the states. The order should be util. syn call, certs, channels, terkini and finally reboot or reboot if needed if chosen. Click [Sahkan] to store the order.
8. klik [Create Schedule] to save the action.

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

1. Sebagai bekasample, we create the action to apply the high state for the same group which was fully updated before. In the Uyuni Web UI, navigasi ke Systems › System Groups and click infra-services.
2. Go to Recurring Actions and click [Buat].
3. Select Action Type negeri tinggi and enter a Schedule Name like high state .
4. Pilih Jadual. Untuk example, Weekly: Wednesday, 10:30 am . Again, keep enough time between this action and the full-system-update action.
5. klik [Create Schedule] to save the action.

Background information on up-to-date state

1. The terkini state applies critical patches to the update components.
   • a. On SUSE-based systems, the state executes the command:
     zypper --non-interactive patch --updatestack-only
     Dan kemudian, negeri itu juga mengemas kini 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.
   Pengesanan but semula adalah khusus untuk sistem pengendalian klien.
   • Untuk Debian atau Ubuntu, lihat https://www.debian.org/doc/debian-policy/ch-opersys.html#signaling-that-a-reboot-is-required.
   • Bagi klien SUSE bukan transaksional, Uyuni akan but semula klien apabila zypper -x list-patches menunjukkan bahawa tampalan memerlukan but semula.
   • Untuk klien SUSE transaksional, Uyuni akan but semula klien jika terdapat transaksi yang belum selesai.
   • 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

Topik berkaitan

• Untuk maklumat lanjut tentang tindakan berulang, lihat Tindakan Berulang.
• For more information about custom info values, see Client-configuration › Custom-info.

Pengurusan Konfigurasi

Bab 4

Anda boleh menggunakan konfigurasi files dan saluran untuk mengurus konfigurasi untuk pelanggan anda, dan bukannya mengkonfigurasi setiap pelanggan secara manual. Aliran kerja ini menunjukkan kepada anda cara menggunakan Uyuni Web UI untuk mencipta konfigurasi yang diuruskan secara berpusat file, berikannya kepada pelanggan dan gunakan konfigurasi.

Use Case

Jika anda menguruskan banyak pelanggan, anda mungkin tidak mahu menggunakan tetapan konfigurasi secara manual pada setiap pelanggan secara bergilir-gilir. Saluran konfigurasi digunakan untuk mengatur konfigurasi files. Anda boleh melanggan pelanggan ke saluran konfigurasi dan menggunakan konfigurasi files seperti yang diperlukan.

Hasil

Apabila anda telah melengkapkan aliran kerja ini, anda akan mempunyai saluran konfigurasi yang mengandungi konfigurasi file, telah memberikan pelanggan kepada saluran dan menggunakan konfigurasi dengan jayanya.

Persediaan

Sebelum anda memulakan, anda sepatutnya sudah mempunyai:

• Uyuni Server dipasang, yang boleh anda akses menggunakan Web UI.
• Sekurang-kurangnya satu pelanggan mendaftar ke pelayan anda.
• Langganan yang sesuai daripada http://scc.suse.com untuk produk yang anda gunakan.

Aliran kerja ini menggunakan konfigurasi yang diuruskan secara berpusat file and a Salt state. For more information about the different ways to manage configuration, see Client-configuration › Configuration-management.

Arahan Aliran Kerja langkah demi langkah

Prosedur: Buat Saluran Konfigurasi Baharu dan File

1. Di Uyuni Web UI, navigasi ke Configuration › Channels dan klik [Create State Channel].
2. Taipkan nama, label dan perihalan untuk konfigurasi anda file, dan taip kandungan konfigurasi anda file. Seorang bekasample that you can copy is at the end of this section.

Prosedur: Tetapkan Pelanggan ke Saluran Konfigurasi

1. Di Uyuni Web UI, navigasi ke Systems › Systems List and select the client you want to assign to your configuration channel.
2. Navigasi ke tab Konfigurasi. Dalam guimenu: Configuration Overview bahagian, klik [Subscribe to channels ].
3. Check the configuration channel you created earlier, and click [Continue].
4. If you have more than one configuration channel, you can rank them in order of importance, or click [Update Channel Rankings ] untuk menamatkan.

Prosedur: Gunakan Konfigurasi kepada Pelanggan Anda

1. Di Uyuni Web UI, navigasi ke 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

Negeri SLS untuk Mengemaskinikan Pelanggan

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

Topik Berkaitan

• For more information about configuration management, see Client-configuration › Configuration management.
• Untuk maklumat lanjut tentang SLS files, lihat: https://docs.saltproject.io/en/latest/topics/tutorials/starting_states.html.

Pengurusan Kitaran Hayat Kandungan

Bab 5

Jika anda menguruskan banyak pelanggan dan anda perlu menggunakan pakej tersuai kepada mereka, anda boleh menggunakan pengurusan kitaran hayat kandungan (CLM) untuk mengurus pakej anda. CLM membolehkan anda menyesuaikan dan menguji pakej sebelum mengemas kini pelanggan pengeluaran. Ia juga berguna jika anda perlu menggunakan kemas kini semasa tetingkap penyelenggaraan terhad.

Use Case

Pengurusan kitaran hayat kandungan membolehkan anda memilih saluran perisian sebagai sumber, melaraskannya seperti yang diperlukan untuk persekitaran anda dan mengujinya dengan teliti sebelum memasang pada pelanggan pengeluaran anda. Anda boleh menggunakan CLM untuk mengurus saluran perisian anda daripada pembangunan, melalui ujian dan melancarkan perubahan kepada pelanggan anda.

Hasil

Apabila anda telah melengkapkan aliran kerja ini, anda akan menyediakan projek kitaran hayat kandungan. Anda telah mencipta projek CLM asas dan mempromosikannya melalui kitaran hayatnya.

Persediaan

Sebelum anda memulakan, anda sepatutnya sudah mempunyai:

• Pelayan Uyuni digunakan dan boleh diakses menggunakan Web UI.
• Mesin pelanggan dengan sistem pengendalian dipasang, yang boleh anda akses merentasi rangkaian yang dihidupkan oleh Pelayan Uyuni anda, menggunakan SSH.
• Langganan yang sesuai daripada http://scc.suse.com untuk produk yang anda gunakan.

Arahan Aliran Kerja Langkah demi langkah

Prosedur: Buat Projek CLM baharu

1. Di Uyuni Web UI, navigasi ke Content Lifecycle › Projects section, and click [Create Project].
   Type a name, label, and description for your project, and click [Buat].
2. In the Sources section, click [Attach/Detach Sources ].
   Pilih jenis sumber dan pilih saluran asas untuk projek anda.
   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 [Simpan] to return to the project page.
3. Biarkan bahagian Penapis kosong buat masa ini, kami tidak akan menggunakannya dalam bekas iniample. Anda boleh menambah penapis kemudian jika anda perlu.
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. klik [Bangun] to build version 1 of your project:

Prosedur: Tetapkan Klien

1. Navigasi ke Systems › System List, select the client to assign, and go to the Software › Software Channels tab.
2. Dalam bahagian Saluran Asas, pilih projek dan persekitaran CLM yang anda ingin tetapkan klien kepadanya.
   Untuk example, if you want this client to receive updates from your CLM only when packages are in the production environment, assign the base channel < CLM _ Project _ Name> – production-<Channel _ Name >
   Alternatively, you could use this client as a way to test if your CLM packages are working as expected before you promote them to development, so you assign the base channel < CLM _ Project _ Name> – testing – <Channel _ Name >.
3. klik [Seterusnya] to assign the client.

Prosedur: Galakkan Persekitaran

1. Di Uyuni Web UI, navigasi ke 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.

Topik Berkaitan

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

Customize Apache Configuration

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

Kes guna

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.

Hasil

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

Persediaan

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 (untuk example, custom_ tuning. conf) and add your required Apache directives.
5. Sebaik sahaja anda telah menyimpan file, exit the container with command:
   exit
6. Restart the Uyuni services to apply the changes:
   mgradm restart

Peningkatan Produk melalui Web UI

Bab 7

Jika anda ingin menaik taraf pek pelanggan SUSE Linux Enterprise berdaftar kepada versi produk yang lebih baharu, ia boleh dilakukan sama ada pada baris arahan atau melalui Web UI.

Dokumen ini menerangkan dan menggambarkan secara terperinci peningkatan produk menggunakan Web UI.

Versi produk yang digunakan tidak mencerminkan versi terkini sebenar yang tersedia. Ia digunakan untuk tujuan ilustrasi sahaja. Sebagai bekasampOleh itu, prosedur berikut menerangkan peningkatan kepada versi 15 SP5 dari dan versi 15 yang lebih lama. Jika anda menyasarkan versi lain, pilih saluran dan versi yang sepadan.

Prosedur: Menaik taraf Produk kepada Versi Lebih Baharu Menggunakan Web UI

1. Log masuk ke Uyuni Web UI dan navigasi ke Admin › Setup Wizard › Products and search for SUSE Linux Enterprise Server 15 SP5 x86_64.
2. Pilih saluran yang disyorkan.
3. klik [Add Products ].
4. Navigasi ke Systems › Registered client › Software › Product Migration. You will see the targets available for that registered client.
5. Pilih SUSE Linux Enterprise Server 15 SP5 x86_64. Ini akan berkembang lagi.
6. Pilih Saluran Pangkalan Sasaran sebagai SLE-Product-SLES15-SP5-Pool untuk x86_64. Pastikan Benarkan Penukaran Vendor tidak ditandai.
7. klik [Schedule Migration]. The message will be highlighted It is better to do a dry run first so continuing with dry run first.
8. Klik [Larian kering] and check the status of the simulation in Events › History. You should see a return code 0 indicating a successful dry run.
9. klik [Schedule Migration] to perform the actual product migration. The message will be highlighted on top of the screen indicating the scheduling of the action.
10. When the upgrade is complete, check the status in Events › History.
11. Pada Uyuni Web UI side, verify the successfully completed product upgrade by going to Systems › Registered client › Details.
12. Di sisi pelanggan, anda boleh mengesahkannya dengan menjalankan:
    cat /etc/os-release
13. Output akan kelihatan serupa dengan:

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

Lesen Dokumentasi Percuma GNU

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

MUKAMAH

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.

Kami telah mereka Lesen ini untuk menggunakannya untuk manual untuk perisian percuma, kerana perisian percuma memerlukan dokumentasi percuma: program percuma harus disertakan dengan manual yang memberikan kebebasan yang sama seperti yang perisian itu lakukan. Tetapi Lesen ini tidak terhad kepada manual perisian; ia boleh digunakan untuk sebarang karya teks, tanpa mengira perkara atau sama ada ia diterbitkan sebagai buku bercetak. Kami mengesyorkan Lesen ini terutamanya untuk kerja-kerja yang tujuannya adalah arahan atau rujukan.

KEBOLEHAKAIAN DAN DEFINISI

Lesen ini terpakai kepada mana-mana manual atau kerja lain, dalam mana-mana medium, yang mengandungi notis yang diletakkan oleh pemegang hak cipta yang menyatakan ia boleh diedarkan di bawah syarat Lesen ini. Notis sedemikian memberikan lesen bebas royalti di seluruh dunia, tanpa had dalam tempoh, untuk menggunakan kerja tersebut di bawah syarat yang dinyatakan di sini. "Dokumen", di bawah, merujuk kepada mana-mana manual atau kerja sedemikian. Mana-mana orang awam ialah pemegang lesen, dan dialamatkan sebagai "anda". Anda menerima lesen jika anda menyalin, mengubah suai atau mengedar karya dengan cara yang memerlukan kebenaran di bawah undang-undang hak cipta.

"Versi Diubah Suai" Dokumen bermaksud sebarang karya yang mengandungi Dokumen atau sebahagian daripadanya, sama ada disalin secara verbatim, atau dengan pengubahsuaian dan/atau diterjemahkan ke dalam bahasa lain.

"Bahagian Menengah" ialah lampiran bernama atau bahagian bahagian hadapan Dokumen yang memperkatakan secara eksklusif hubungan penerbit atau pengarang Dokumen dengan subjek keseluruhan Dokumen (atau perkara berkaitan) dan tidak mengandungi apa-apa yang boleh jatuh secara langsung dalam subjek keseluruhan itu. (Oleh itu, jika Dokumen itu sebahagiannya adalah buku teks matematik, Bahagian Menengah mungkin tidak menjelaskan sebarang matematik.) Hubungan itu boleh menjadi masalah hubungan sejarah dengan subjek atau dengan perkara yang berkaitan, atau undang-undang, komersial, falsafah, etika atau kedudukan politik mengenai mereka.

"Bahagian Invarian" ialah Bahagian Sekunder tertentu yang tajuknya ditetapkan, sebagai Bahagian Invarian, dalam notis yang mengatakan bahawa Dokumen dikeluarkan di bawah Lesen ini. Sekiranya bahagian tidak sesuai dengan takrifan Menengah di atas maka ia tidak dibenarkan untuk ditetapkan sebagai Invarian. Dokumen mungkin mengandungi sifar Bahagian Invarian. Jika Dokumen tidak mengenal pasti mana-mana Bahagian Invarian maka tiada.

"Teks Muka Depan" ialah petikan pendek tertentu teks yang disenaraikan, sebagai Teks Muka Depan atau Teks Muka Depan, dalam notis yang mengatakan bahawa Dokumen dikeluarkan di bawah Lesen ini. Teks Muka Depan mungkin paling banyak 5 patah perkataan, dan Teks Muka Belakang Belakang mungkin paling banyak 25 patah perkataan.

Salinan Dokumen "Telus" bermaksud salinan yang boleh dibaca mesin, diwakili dalam format yang spesifikasinya tersedia untuk orang awam, yang sesuai untuk menyemak dokumen secara terus dengan editor teks generik atau (untuk imej yang terdiri daripada piksel) cat generik atur cara atau (untuk lukisan) beberapa editor lukisan yang tersedia secara meluas, dan yang sesuai untuk input kepada pemformat teks atau untuk terjemahan automatik kepada pelbagai format yang sesuai untuk input kepada pemformat teks. Salinan yang dibuat dalam bentuk lain yang Telus file format yang markup, atau ketiadaan markup, telah diatur untuk menggagalkan atau tidak menggalakkan pengubahsuaian berikutnya oleh pembaca adalah tidak Telus. Format imej tidak Telus jika digunakan untuk sebarang jumlah teks yang banyak. Salinan yang tidak "Telus" dipanggil "Legap".

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. Exampformat imej telus termasuk PNG, XCF dan JPG. Format legap termasuk format proprietari yang boleh dibaca dan diedit hanya oleh pemproses perkataan proprietari, SGML atau XML yang DTD dan/atau alat pemprosesan tidak tersedia secara umum, dan HTML, PostScript atau PDF yang dihasilkan oleh mesin yang dihasilkan oleh beberapa pemproses perkataan untuk tujuan output sahaja.

"Halaman Tajuk" bermaksud, untuk buku bercetak, halaman tajuk itu sendiri, ditambah dengan halaman berikut yang diperlukan untuk menyimpan, dengan mudah dibaca, bahan yang diperlukan oleh Lesen ini untuk dipaparkan dalam halaman tajuk. Untuk karya dalam format yang tidak mempunyai sebarang halaman tajuk seperti itu, "Halaman Tajuk" bermaksud teks yang berhampiran dengan penampilan tajuk karya yang paling menonjol, sebelum permulaan kandungan teks.

Bahagian "Bertajuk XYZ" bermaksud subunit bernama Dokumen yang tajuknya sama ada tepat XYZ atau mengandungi XYZ dalam kurungan berikutan teks yang menterjemahkan XYZ dalam bahasa lain. (Di sini XYZ bermaksud nama bahagian tertentu yang disebut di bawah, seperti "Penghargaan", "Dedikasi", "Pengendorsan", atau "Sejarah".) Untuk "Kekalkan Tajuk" bahagian sedemikian apabila anda mengubah suai Dokumen bermakna ia kekal sebagai bahagian "Berhak XYZ" mengikut definisi ini.

Dokumen ini mungkin termasuk Penafian Waranti di sebelah notis yang menyatakan bahawa Lesen ini terpakai pada Dokumen. Penafian Waranti ini dianggap disertakan melalui rujukan dalam Lesen ini, tetapi hanya berkenaan dengan jaminan penafian: sebarang implikasi lain yang mungkin ada pada Penafian Waranti ini adalah tidak sah dan tidak mempunyai kesan ke atas maksud Lesen ini.

MENYALI VERBATIM

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.

Anda juga boleh meminjamkan salinan, di bawah syarat yang sama yang dinyatakan di atas, dan anda boleh memaparkan salinan secara terbuka.

MENYALIN DALAM KUANTITI

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.

Jika teks yang diperlukan untuk mana-mana muka depan terlalu besar untuk dimuatkan dengan jelas, anda harus meletakkan yang pertama disenaraikan (sebanyak yang sesuai dengan munasabah) pada kulit sebenar, dan meneruskan yang lain ke halaman bersebelahan.

Jika anda menerbitkan atau mengedarkan salinan Legap Dokumen bernombor lebih daripada 100, anda mesti sama ada menyertakan salinan Telus yang boleh dibaca mesin bersama-sama dengan setiap salinan Legap, atau nyatakan dalam atau dengan setiap salinan Legap lokasi rangkaian komputer dari mana rangkaian umum- menggunakan awam mempunyai akses untuk memuat turun menggunakan protokol rangkaian standard awam salinan Dokumen Telus yang lengkap, bebas daripada bahan tambahan. Jika anda menggunakan pilihan terakhir, anda mesti mengambil langkah yang munasabah berhemat, apabila anda memulakan pengedaran salinan Legap dalam kuantiti, untuk memastikan salinan Telus ini akan kekal dengan itu boleh diakses di lokasi yang dinyatakan sehingga sekurang-kurangnya satu tahun selepas kali terakhir anda mengedarkan Salinan legap (secara langsung atau melalui ejen atau peruncit anda) edisi itu kepada orang ramai.

Diminta, tetapi tidak diperlukan, anda menghubungi pengarang Dokumen dengan baik sebelum mengedarkan semula sebarang salinan yang banyak, untuk memberi mereka peluang untuk memberikan anda versi Dokumen yang dikemas kini.

PENGUBAHSUAIAN

Anda boleh menyalin dan mengedarkan Versi Terubah Suai Dokumen di bawah syarat bahagian 2 dan 3 di atas, dengan syarat anda mengeluarkan Versi Terubah Suai di bawah Lesen ini dengan tepat, dengan Versi Terubah Suai mengisi peranan Dokumen, dengan itu melesenkan pengedaran dan pengubahsuaian Versi Ubahsuai kepada sesiapa yang memiliki salinannya. Di samping itu, anda mesti melakukan perkara ini dalam Versi Diubah Suai:

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

Jika Versi Ubahsuai termasuk bahagian hadapan atau lampiran baharu yang layak sebagai Bahagian Sekunder dan tidak mengandungi bahan yang disalin daripada Dokumen, anda boleh mengikut pilihan anda menetapkan beberapa atau semua bahagian ini sebagai invarian. Untuk melakukan ini, tambahkan tajuknya pada senarai Bahagian Invarian dalam notis lesen Versi Ubahsuai. Tajuk ini mestilah berbeza daripada mana-mana tajuk bahagian lain.

Anda boleh menambah bahagian Bertajuk "Pengendorsan", dengan syarat ia mengandungi apa-apa selain pengesahan Versi Ubahsuai anda oleh pelbagai pihak—untuk bekasample, kenyataan rakan sebayaview atau bahawa teks itu telah diluluskan oleh organisasi sebagai definisi berwibawa bagi sesuatu standard.

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.

Pengarang dan penerbit Dokumen tidak dengan Lesen ini memberikan kebenaran untuk menggunakan nama mereka untuk publisiti atau untuk menegaskan atau membayangkan pengesahan mana-mana Versi Diubah Suai.

MENGGABUNGKAN DOKUMEN

Anda boleh menggabungkan Dokumen dengan dokumen lain yang dikeluarkan di bawah Lesen ini, di bawah terma yang ditakrifkan dalam bahagian 4 di atas untuk versi yang diubah suai, dengan syarat anda memasukkan dalam gabungan semua Bahagian Invarian semua dokumen asal, tidak diubah suai dan menyenaraikan semuanya. sebagai Bahagian Invarian kerja gabungan anda dalam notis lesennya, dan bahawa anda mengekalkan semua Penafian Waranti mereka.

Kerja gabungan hanya perlu mengandungi satu salinan Lesen ini dan berbilang Bahagian Invarian yang serupa boleh digantikan dengan satu salinan. Jika terdapat berbilang Bahagian Invarian dengan nama yang sama tetapi kandungan yang berbeza, jadikan tajuk bagi setiap bahagian tersebut unik dengan menambahkan pada penghujungnya, dalam kurungan, nama pengarang asal atau penerbit bahagian itu jika diketahui, atau sebaliknya a nombor unik. Buat pelarasan yang sama pada tajuk bahagian dalam senarai Bahagian Invarian dalam notis lesen kerja gabungan.

Dalam gabungan itu, anda mesti menggabungkan mana-mana bahagian Bertajuk "Sejarah" dalam pelbagai dokumen asal, membentuk satu bahagian Bertajuk "Sejarah"; begitu juga menggabungkan mana-mana bahagian Bertajuk "Penghargaan", dan mana-mana bahagian Bertajuk "Dedikasi". Anda mesti memadam semua bahagian Bertajuk "Pengendorsan".

KOLEKSI DOKUMEN

Anda boleh membuat koleksi yang terdiri daripada Dokumen dan dokumen lain yang dikeluarkan di bawah Lesen ini, dan menggantikan salinan individu Lesen ini dalam pelbagai dokumen dengan satu salinan yang disertakan dalam koleksi, dengan syarat anda mematuhi peraturan Lesen ini untuk penyalinan verbatim setiap dokumen dalam semua aspek lain.

Anda boleh mengeluarkan satu dokumen daripada koleksi sedemikian, dan mengedarkannya secara individu di bawah Lesen ini, dengan syarat anda memasukkan salinan Lesen ini ke dalam dokumen yang diekstrak, dan mengikuti Lesen ini dalam semua aspek lain berkenaan penyalinan verbatim dokumen itu.

PENGUMPULAN DENGAN KERJA BEBAS

Kompilasi Dokumen atau terbitannya dengan dokumen atau karya lain yang berasingan dan bebas, dalam atau pada volum media penyimpanan atau pengedaran, dipanggil "agregat" jika hak cipta yang terhasil daripada kompilasi itu tidak digunakan untuk mengehadkan hak undang-undang pengguna kompilasi melebihi apa yang dibenarkan oleh kerja individu. Apabila Dokumen disertakan dalam agregat, Lesen ini tidak terpakai kepada karya lain dalam agregat yang bukan hasil terbitan Dokumen tersebut.

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.

TERJEMAHAN

Terjemahan dianggap sebagai sejenis pengubahsuaian, jadi anda boleh mengedarkan terjemahan Dokumen di bawah syarat seksyen 4. Menggantikan Bahagian Invarian dengan terjemahan memerlukan kebenaran khas daripada pemegang hak cipta mereka, tetapi anda boleh memasukkan terjemahan beberapa atau semua Bahagian Invarian sebagai tambahan kepada versi asal Bahagian Invarian ini. Anda boleh memasukkan terjemahan Lesen ini, dan semua notis lesen dalam Dokumen, dan sebarang Penafian Waranti, dengan syarat anda juga menyertakan versi Bahasa Inggeris asal Lesen ini dan versi asal notis dan penafian tersebut. Sekiranya berlaku percanggahan antara terjemahan dan versi asal Lesen ini atau notis atau penafian, versi asal akan diguna pakai.

Jika bahagian dalam Dokumen Bertajuk "Penghargaan", "Dedikasi", atau "Sejarah", keperluan (bahagian 4) untuk Mengekalkan Tajuknya (bahagian 1) biasanya memerlukan penukaran tajuk sebenar.

PENAMATAN

Anda tidak boleh menyalin, mengubah suai, mensublesenkan atau mengedarkan Dokumen kecuali sebagaimana yang diperuntukkan secara nyata di bawah Lesen ini. Sebarang percubaan lain untuk menyalin, mengubah suai, mensublesenkan atau mengedarkan Dokumen adalah terbatal dan akan menamatkan hak anda secara automatik di bawah Lesen ini. Walau bagaimanapun, pihak yang telah menerima salinan, atau hak, daripada anda di bawah Lesen ini tidak akan ditamatkan lesen mereka selagi pihak tersebut kekal mematuhi sepenuhnya.

SEMAKAN MASA DEPAN LESEN INI

Yayasan Perisian Percuma boleh menerbitkan versi baharu yang disemak semula bagi Lesen Dokumentasi Percuma GNU dari semasa ke semasa. Versi baharu sedemikian akan mempunyai semangat yang serupa dengan versi sekarang, tetapi mungkin berbeza secara terperinci untuk menangani masalah atau kebimbangan baharu. Lihat http://www.gnu.org/copyleft/.

Setiap versi Lesen diberikan nombor versi yang membezakan. Jika Dokumen menyatakan bahawa versi bernombor tertentu Lesen ini "atau mana-mana versi kemudian" terpakai padanya, anda mempunyai pilihan untuk mengikut terma dan syarat sama ada versi yang dinyatakan itu atau mana-mana versi kemudian yang telah diterbitkan (bukan sebagai draf) oleh Yayasan Perisian Percuma. Jika Dokumen tidak menyatakan nombor versi Lesen ini, anda boleh memilih mana-mana versi yang pernah diterbitkan (bukan sebagai draf) oleh Yayasan Perisian Percuma.

ADDENDUM: Cara menggunakan Lesen ini untuk dokumen anda

Hak Cipta (c) TAHUN NAMA ANDA. Kebenaran diberikan untuk menyalin, mengedar dan/atau mengubah suai dokumen ini di bawah syarat-syarat Lesen Dokumentasi Percuma GNU, Versi 1.2 atau mana-mana versi terkemudian yang diterbitkan oleh Yayasan Perisian Percuma; tanpa Bahagian Invarian, tiada Teks Muka Depan dan tiada Teks Muka Belakang. Salinan lesen disertakan dalam bahagian bertajuk "Lesen Dokumentasi Percuma GNU".