UYUNI Common Workflows User Guide

UYUNI Common Workflows

مقدمة

الفصل الأول

سير العمل المشترك

اويوني 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

دمج العملاء

الفصل الأول

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.

حالة الاستخدام

يوضح لك سير العمل هذا كيفية إلحاق العميل بخادم Uyuni الخاص بك.

يجب أن يقوم العميل بتشغيل نظام تشغيل Linux مدعوم. للحصول على قائمة بأنظمة العملاء المدعومة، راجع Client-configuration › Supported-features.

هذه إحدى المهام الأولى التي يتعين عليك القيام بها عند إعداد Uyuni للمرة الأولى، ومن المحتمل أن يتعين عليك القيام بذلك مرات عديدة أثناء استخدامك للمنتج.

حصيلة

When you have completed this workflow, your client is on boarded, and it can be seen in the systems list of the Uyuni Web واجهة المستخدم. يمكنك بعد ذلك استخدام Uyuni لإدارة العميل.

تحضير

قبل البدء، يجب أن يكون لديك بالفعل:

• تم تثبيت خادم Uyuni، والذي يمكنك الوصول إليه باستخدام Web UI.
• جهاز عميل مثبت عليه نظام تشغيل، والذي يمكنك الوصول إليه عبر الشبكة التي يعمل عليها خادم Uyuni الخاص بك، باستخدام SSH.
• الاشتراكات المناسبة من 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

الإجراء: تحضير قنوات البرامج على خادم Uyuni

1. في Uyuni Web واجهة المستخدم، انتقل إلى Admin › Setup Wizard.
2. في علامة التبويب بيانات اعتماد المؤسسة، تأكد من إدخال بيانات اعتماد مركز عملاء SUSE الخاص بك، ومن مصادقتك بشكل صحيح.
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. في Uyuni 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. في Uyuni 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.

تحديث العملاء باستخدام الإجراءات المتكررة

الفصل الأول

يوضح سير العمل هذا كيفية أتمتة تحديث العملاء المسجلين في Uyuni باستخدام الإجراءات المتكررة.

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إذا، نقوم بإنشاء الإجراء لتحديث Salt نفسه كإجراء متكرر لجميع الأنظمة في المؤسسة. في أويوني 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 خدمات البنية التحتية. في Uyuni Web UI go to Systems › System Groups and click on infra-services.
2. Now go to Recurring Actions and click [Create].
3. Select Action Type Custom State and enter a Schedule Name like full system-update.
4. حدد الجدول الزمني. على سبيل المثال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.

إدارة التكوين

الفصل الأول

يمكنك استخدام التكوين fileوالقنوات لإدارة التكوين لعملائك، بدلاً من تكوين كل عميل يدويًا. يوضح لك سير العمل هذا كيفية استخدام Uyuni Web واجهة المستخدم لإنشاء تكوين مُدار مركزيًا file، وقم بتعيينه إلى العميل، ثم قم بتطبيق التكوين.

حالة الاستخدام

إذا كنت تدير العديد من العملاء، فمن المحتمل أنك لا تريد تطبيق إعدادات التكوين يدويًا على كل واحد منهم على حدة. يتم استخدام قنوات التكوين لتنظيم التكوين fileس. يمكنك اشتراك العملاء في قنوات التكوين ونشر التكوين fileق على النحو المطلوب.

حصيلة

عند الانتهاء من سير العمل هذا، سيكون لديك قناة تكوين تحتوي على تكوين file، وقمت بتعيين عملاء للقناة، وقمت بتطبيق التكوين بنجاح.

تحضير

قبل البدء، يجب أن يكون لديك بالفعل:

• تم تثبيت خادم Uyuni، والذي يمكنك الوصول إليه باستخدام Web UI.
• عميل واحد على الأقل مسجل في الخادم الخاص بك.
• الاشتراكات المناسبة من 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. في Uyuni Web واجهة المستخدم، انتقل إلى Configuration › Channels وانقر [Create State Channel].
2. اكتب اسمًا وتسمية ووصفًا للتكوين الخاص بك file، واكتب محتويات التكوين الخاص بك file. على سبيل المثالample that you can copy is at the end of this section.

الإجراء: تعيين العملاء لقناة التكوين

1. في Uyuni Web واجهة المستخدم، انتقل إلى Systems › Systems List and select the client you want to assign to your configuration channel.
2. انتقل إلى علامة التبويب التكوين. في Guimenu: انتهى التكوين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. في Uyuni 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 [نشر كافة التكوينات المُدارة files ]

Example

حالة SLS للحفاظ على تحديث العملاء

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.
• لمزيد من المعلومات حول SLS fileس، انظر: https://docs.saltproject.io/en/latest/topics/tutorials/starting_states.html.

إدارة دورة حياة المحتوى

الفصل الأول

إذا كنت تدير الكثير من العملاء وتحتاج إلى تطبيق حزم مخصصة عليهم، فيمكنك استخدام إدارة دورة حياة المحتوى (CLM) لإدارة حزمك. يسمح لك CLM بتخصيص واختبار الحزم قبل تحديث عملاء الإنتاج. يعد هذا مفيدًا أيضًا إذا كنت بحاجة إلى تطبيق التحديثات أثناء فترة صيانة محدودة.

حالة الاستخدام

تسمح لك إدارة دورة حياة المحتوى بتحديد قنوات البرامج كمصادر، وضبطها حسب الحاجة لبيئتك، واختبارها بدقة قبل تثبيتها على عملاء الإنتاج لديك. يمكنك استخدام CLM لإدارة قنوات البرامج الخاصة بك بدءًا من التطوير وحتى الاختبار ونشر التغييرات على عملائك.

حصيلة

عند الانتهاء من سير العمل هذا، سيكون لديك مشروع دورة حياة المحتوى الذي تم إعداده. ستكون قد أنشأت مشروع CLM أساسيًا وقمت بالترويج له خلال دورة حياته.

الإستعدادات

قبل البدء، يجب أن يكون لديك بالفعل:

• Uyuni Server deployed, and accessible using the Web UI.
• جهاز عميل مثبت عليه نظام تشغيل، والذي يمكنك الوصول إليه عبر الشبكة التي يعمل عليها خادم Uyuni الخاص بك، باستخدام SSH.
• الاشتراكات المناسبة من http://scc.suse.com للمنتجات التي تستخدمها.

تعليمات سير العمل خطوة بخطوة

الإجراء: إنشاء مشروع CLM جديد

1. في Uyuni 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. في Uyuni 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.
• بالنسبة لـ CLM على سبيل المثالampليه ، انظر Administration › Content-lifecycle-exampليه.

Customize Apache Configuration

الفصل السادس.

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

الفصل الأول

إذا كنت تريد ترقية حزمة عميل SUSE Linux Enterprise المسجلة إلى إصدار منتج أحدث، فيمكن القيام بذلك إما عبر سطر الأوامر أو عبر Web UI.

يصف هذا المستند ويوضح بالتفصيل ترقية المنتج باستخدام Web UI.

إصدارات المنتج المستخدمة لا تعكس أحدث الإصدارات الفعلية المتوفرة. يتم استخدامها لأغراض التوضيح فقط. كسابقample، يصف الإجراء التالي الترقية إلى الإصدار 15 SP5 من الإصدار 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. حدد SUSE Linux Enterprise Server 15 SP5 x86_64. وهذا سوف يتوسع أكثر.
6. حدد القناة الأساسية المستهدفة كـ SLE-Product-SLES15-SP5-Pool لـ x86_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/"

رخصة التوثيق الحرة GNU

الفصل الأول

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عدد قليل من تنسيقات الصور الشفافة يتضمن PNG و XCF و JPG. تتضمن التنسيقات غير الشفافة تنسيقات خاصة لا يمكن قراءتها وتحريرها إلا عن طريق معالجات النصوص الخاصة ، أو SGML أو XML التي لا تتوفر لها DTD و / أو أدوات المعالجة بشكل عام ، وتنسيقات HTML أو PostScript أو PDF المُنشأة آليًا والتي تنتجها بعض معالجات النصوص لـ أغراض الإخراج فقط.

تعني "صفحة العنوان" ، بالنسبة للكتاب المطبوع ، صفحة العنوان نفسها ، بالإضافة إلى الصفحات التالية اللازمة للاحتفاظ بشكل مقروء بالمواد التي يتطلبها هذا الترخيص للظهور في صفحة العنوان. بالنسبة للأعمال ذات التنسيقات التي لا تحتوي على أي صفحة عنوان على هذا النحو ، فإن "صفحة العنوان" تعني النص بالقرب من أبرز مظهر لعنوان العمل ، يسبق بداية النص الأساسي للنص.

القسم "معنون XYZ" يعني وحدة فرعية مسماة من المستند عنوانها إما XYZ بالتحديد أو يحتوي على XYZ بين أقواس بعد النص الذي يترجم XYZ بلغة أخرى. (هنا تشير XYZ إلى اسم قسم محدد مذكور أدناه ، مثل "شكر وتقدير" أو "إهداءات" أو "تصديقات" أو "محفوظات".) من أجل "الحفاظ على عنوان" هذا القسم عند تعديل المستند يعني أنه يظل قسمًا بعنوان "XYZ" وفقًا لهذا التعريف.

قد يتضمن المستند إخلاء مسؤولية عن الضمان بجانب الإشعار الذي ينص على أن هذا الترخيص ينطبق على المستند. تعتبر إخلاء المسؤولية عن الضمان مضمنة بالإشارة إليها في هذا الترخيص ، ولكن فقط فيما يتعلق بضمانات التنصل: أي إيحاء آخر قد يكون لإخلاء المسؤولية عن الضمان باطلاً وليس له أي تأثير على معنى هذا الترخيص.

نسخ حرفي

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) يتطلب عادةً تغيير العنوان الفعلي.

الإنهاء

لا يجوز لك نسخ المستند أو تعديله أو ترخيصه من الباطن أو توزيعه باستثناء ما هو منصوص عليه صراحةً بموجب هذا الترخيص. تعتبر أي محاولة أخرى لنسخ المستند أو تعديله أو إعادة ترخيصه من الباطن أو توزيعه باطلة ، وستؤدي تلقائيًا إلى إنهاء حقوقك بموجب هذا الترخيص. ومع ذلك ، لن يتم إنهاء تراخيص الأطراف التي تلقت نسخًا أو حقوقًا منك بموجب هذا الترخيص طالما بقيت هذه الأطراف في حالة امتثال كامل.

المراجعات المستقبلية لهذا الترخيص

مؤسسة البرمجيات الحرة قد تنشر إصدارات جديدة ومعدلة من رخصة التوثيق الحرة GNU من وقت لآخر. ستكون هذه الإصدارات الجديدة مماثلة في الروح للإصدار الحالي ، ولكنها قد تختلف في التفاصيل لمعالجة المشاكل أو الاهتمامات الجديدة. يرى http://www.gnu.org/copyleft/.

يتم منح كل إصدار من إصدارات الترخيص رقم إصدار مميز. إذا حدد المستند أن إصدارًا مُرقّمًا معينًا من هذا الترخيص "أو أي إصدار لاحق" ينطبق عليه ، فلديك خيار اتباع شروط وأحكام هذا الإصدار المحدد أو أي إصدار لاحق تم نشره (وليس باعتباره مسودة) من قبل مؤسسة البرمجيات الحرة. إذا لم يحدد المستند رقم إصدار هذا الترخيص ، يمكنك اختيار أي إصدار تم نشره (ليس كمسودة) من قبل مؤسسة البرمجيات الحرة.

إضافة: كيفية استخدام هذا الترخيص للمستندات الخاصة بك

حقوق الطبع والنشر (ج) سنة اسمك. يتم منح الإذن بنسخ وتوزيع و/أو تعديل هذه الوثيقة بموجب شروط ترخيص GNU Free Documentation License، الإصدار 1.2 أو أي إصدار أحدث تنشره مؤسسة البرمجيات الحرة؛ بدون أقسام ثابتة، ولا نصوص الغلاف الأمامي، ولا نصوص الغلاف الخلفي. توجد نسخة من الترخيص في القسم المعنون "رخصة جنو للوثائق الحرة".