Uyuni 2022.12
Gid Quick Start
19 desanm 2022
Quick Start
Mizajou: 2022-12-19
Gid sa a montre w kouman pou w itilize enstale ak konfigirasyon yon sèl sèvè Uyuni oswa Proxy.
Li gen enstriksyon pou yon seleksyon konfigirasyon senp, workflows ak kèk ka itilize komen.
Ou ka li Gid Quick Start pou:
- Enstale sèvè Uyuni
- Enstale Uyuni Proxy
Chapit 1. Enstale sèvè Uyuni ak openSUSE Leap
Ou ka enstale sèvè Uyuni sou openSUSE Leap.
- Pou enfòmasyon sou vèsyon ki estab nan Uyuni, gade https://www.uyuni-project.org/pages/stableversion.html.
- Pou enfòmasyon sou vèsyon devlopman Uyuni, gade https://www.uyuni-project.org/pages/devel-version.html.
- Pou jwenn enfòmasyon sou dènye vèsyon an ak mizajou nan openSUSE Leap, gade https://doc.opensuse.org/release-notes/.
1.1. Kondisyon pou lojisyèl ak pyès ki nan konpitè
Tablo sa a montre kondisyon lojisyèl ak pyès ki nan konpitè pou enstale yon sèvè Uyuni sou openSUSE Leap.
Tablo 1. Kondisyon pou lojisyèl ak pyès ki nan konpitè
| Lojisyèl ak Materyèl | Rekòmande |
| Sistèm operasyon: | openSUSE Leap 15.4: Enstalasyon pwòp, ajou |
| CPU: | Minimòm 4 dedye 64-bit x86-64CPU nwayo |
| RAM: | Sèvè tès Minimòm 8 GB |
| Enstalasyon baz Minimòm 16 GB | |
| Sèvè Pwodiksyon Minimòm 32 GB | |
| Espas Disk: | Espas disk depann sou kondisyon chanèl ou a, omwen 100 GB |
| 50 GB pou chak pwodwi SUSE oswa openSUSE ak 360 GB pou chak pwodwi Red Hat | |
| Boukante espas: | 3 GB |
1.2. Enstale sèvè Uyuni sou openSUSE Leap
Ou ka itilize yon machin fizik oswa vityèl ki kouri openSUSE Leap pou enstale sèvè Uyuni la. Konfigure yon non domèn ki ka rezoud konplètman kalifye sou sèvè a anvan ou kòmanse, pou asire ke sèvè a aksesib atravè rezo a.
Lojisyèl sèvè Uyuni a disponib sou download.opensuse.org, epi ou ka itilize zypper pou rekipere lojisyèl an epi enstale li.
Pwosedi: Enstale openSUSE Leap ak Uyuni
- Enstale openSUSE Leap kòm sistèm de baz, epi asire tout pake sèvis ki disponib ak mizajou pake yo te aplike.
- Konfigure yon non domèn ki ka rezoud konplètman kalifye (FQDN) ak YaST pa navige nan Sistèm › Anviwònman Rezo › Non Host/DNS.
- Nan èd memwa lòd la, kòm rasin, ajoute repozitwa a pou enstale lojisyèl sèvè Uyuni: repo=repositories/systemmanagement:/ repo=${repo}Uyuni:/Stable/images/repo/Uyuni-Server-POOL-x86_64-Media1/ zypper ar https://download.opensuse.org/$repouyuni-server-stable
- Rafrechi metadata ki soti nan depo yo:
zypper ref - Enstale modèl la pou sèvè Uyuni:
zypper nan modèl-uyuni_server - Rdemare sèvè a.
Lè enstalasyon an fini, ou ka kontinye ak konfigirasyon Uyuni. Pou plis enfòmasyon, gade Enstalasyon-ak-mizajou › Uyuni-server-setup.
1.3. Mete kanpe sèvè Uyuni ak YaST
Pwosedi konfigirasyon inisyal la okipe pa YaST.
Pwosedi: Enstalasyon Uyuni
- Konekte sou sèvè Uyuni a epi kòmanse YaST.
- Nan YaST, ale nan Sèvis Rezo › Konfigirasyon Uyuni pou kòmanse konfigirasyon an.
- Soti nan ekran entwodiksyon an, chwazi Uyuni Setup › Set up Uyuni from scratch and click [Next] pou kontinye.
- Antre yon adrès imel pou resevwa notifikasyon sou sitiyasyon epi klike sou [Next] pou kontinye. Uyuni ka pafwa voye yon gwo volim nan imèl notifikasyon. Ou ka enfim notifikasyon imel nan la Web UI apre konfigirasyon, si ou bezwen.
- Antre enfòmasyon sètifika ou ak yon modpas. Modpas yo dwe gen omwen sèt karaktè nan longè, epi yo pa dwe genyen espas, siy senp oswa doub (' oswa "), mak esklamasyon (!), oswa siy dola ($). Toujou sere modpas ou yo nan yon kote ki an sekirite.
Si ou bezwen tou mete yon sèvè proxy Uyuni, asire w ke ou te pran yon nòt sou modpas sètifika a. - Klike sou [Next] pou kontinye.
- Soti nan ekran Uyuni Setup › Database Settings, antre yon itilizatè baz done ak modpas epi klike sou [Next] pou kontinye. Modpas yo dwe gen omwen sèt karaktè nan longè, epi yo pa dwe genyen espas, siy senp oswa doub (' oswa "), mak esklamasyon (!), oswa siy dola ($). Toujou sere modpas ou yo nan yon kote ki an sekirite.
- Klike sou [Next] pou kontinye.
- Klike sou [Wi] pou kouri konfigirasyon lè yo mande.
- Lè konfigirasyon fini, klike sou [Next] pou kontinye. Ou pral wè adrès Uyuni la Web UI.
- Klike sou [Fini] pou konplete konfigirasyon Uyuni.
1.4. Kreye Kont Administrasyon Prensipal la
Anvan ou kapab konekte nan sèvè a pou jere kliyan ou yo, ou bezwen kreye yon kont administrasyon. Kont administrasyon prensipal la gen pi gwo otorite nan Uyuni. Asire ou kenbe enfòmasyon aksè pou kont sa a an sekirite. Nou rekòmande pou ou kreye kont administrasyon nivo pi ba pou òganizasyon ak gwoup. Pa pataje detay aksè prensipal administrasyon an.
Pwosedi: Mete kanpe Kont Administrasyon Prensipal la
- Nan ou web navigatè, antre adrès la pou Uyuni la Web UI. Yo te bay adrès sa a apre ou fin fè konfigirasyon an.
- Enskri nan Web UI, ale nan jaden Kreye Òganizasyon › Non òganizasyon an, epi antre non òganizasyon w lan.
- Nan jaden Kreye Òganizasyon › Konekte ou vle ak Kreye Òganizasyon › Modpas ou vle, antre non itilizatè w ak modpas ou.
- Ranpli jaden enfòmasyon kont yo, ki gen ladan yon imèl pou notifikasyon sistèm.
- Klike sou [Kreye Òganizasyon] pou w fini kreye kont administrasyon w lan.
Lè ou fin ranpli Uyuni la Web Konfigirasyon UI, yo mennen w nan Kay › Plis paseview paj.
1.5. Si ou vle: Senkronize pwodwi ki soti nan Sant Kliyan SUSE
Sant Kliyan SUSE (SCC) kenbe yon koleksyon depo ki genyen pakè, lojisyèl ak mizajou pou tout sistèm kliyan antrepriz ki sipòte yo. Depo sa yo òganize an chanèl chak nan yo ki bay lojisyèl espesifik pou distribisyon, lage, ak achitekti. Apre senkronize ak SCC, kliyan yo ka resevwa mizajou, yo ka òganize an gwoup, epi yo ka plase nan chanèl lojisyèl pwodwi espesifik.
Seksyon sa a kouvri senkronizasyon ak SCC soti nan Web UI epi ajoute premye chanèl kliyan ou a.
Pou Uyuni, senkronize pwodwi ki soti nan Sant Kliyan SUSE se opsyonèl.
Anvan ou ka senkronize depo lojisyèl ak SCC, w ap bezwen antre nan òganizasyon an
kalifikasyon nan Uyuni. Kalifikasyon òganizasyon yo ba ou aksè nan telechaje pwodwi SUSE yo. W ap jwenn kalifikasyon òganizasyon w nan https://scc.suse.com/organizations.
Antre kalifikasyon òganizasyon w nan Uyuni la Web UI:
Pwosedi si ou vle: Antre nan kalifikasyon òganizasyon an
- 1Nan Uyuni Web UI, ale nan Admin › Setup Wizard.
- Nan paj Sòsye Enstalasyon an, ale nan tab la [Kidyans òganizasyon].
- Klike sou [Ajoute yon nouvo kalifikasyon].
- Antre yon non itilizatè ak modpas, epi klike sou [Save].
Yo montre yon ikòn mak chèk lè yo konfime kalifikasyon yo. Lè ou te byen antre nan nouvo kalifikasyon yo, ou ka senkronize ak SUSE Customer Center.
Pwosedi si ou vle: Senkronize ak Sant Kliyan SUSE
- Nan Uyuni la Web UI, ale nan Admin › Setup Wizard.
- Soti nan paj Sòsye Enstalasyon an, chwazi tab la [Pwodwi SUSE]. Tann yon ti moman pou lis pwodwi yo peple. Si ou te deja anrejistre ak SUSE Customer Center yon lis pwodwi yo pral peple tablo a. Tablo sa a bay lis achitekti, chanèl, ak enfòmasyon sou sitiyasyon.
- Si kliyan SUSE Linux Enterprise ou a baze sou achitekti x86_64, desann paj la epi chwazi kaz pou kanal sa a kounye a.
- Ajoute chanèl nan Uyuni lè w chwazi kaz ki sou bò gòch chak chanèl. Klike sou senbòl flèch ki agoch deskripsyon an pou w ap dewoule yon pwodwi ak lis modil ki disponib yo.
- Klike sou [Ajoute pwodwi] pou kòmanse senkronizasyon pwodwi.
Lè yo ajoute yon kanal, Uyuni pral pwograme kanal la pou senkronizasyon. Tou depan de kantite ak gwosè chanèl sa yo, sa ka pran anpil tan. Ou ka kontwole pwogrè senkronizasyon nan la Web UI.
Pou plis enfòmasyon sou itilizasyon sòsye konfigirasyon an, gade Referans › Admin.
Lè pwosesis senkronizasyon chanèl la fini, ou ka anrejistre ak konfigirasyon kliyan yo. Pou plis enstriksyon, gade Kliyan-konfigirasyon › Enskripsyon-souview.
Chapit 2. Enstale Uyuni Proxy ak openSUSE Leap
Uyuni Proxy ka enstale kòm yon ekstansyon sèvè sou openSUSE Leap. Proxy a enstale menm jan ak yon kliyan, men li deziyen kòm yon sèvè proxy pandan enstalasyon. Sa a se reyalize lè w ajoute modèl Uyuni Proxy, epi egzekite script konfigirasyon prokurasyon an.
- Pou plis enfòmasyon sou vèsyon ki estab nan Uyuni, gade https://www.uyuni-project.org/pages/stable-version.html.
- Pou plis enfòmasyon sou vèsyon devlopman Uyuni, gade https://www.uyuni-project.org/pages/devel-version.html.
2.1. Mirror Uyuni Proxy lojisyèl
Lojisyèl Proxy Uyuni a disponib nan https://download.opensuse.org. Ou ka senkronize lojisyèl prokurasyon an nan sèvè Uyuni ou a. Pwosesis sa a konnen tou kòm mirwar.
Pwosedi: Mirroring lojisyèl Proxy Uyuni
- Sou sèvè Uyuni a, kreye chanèl openSUSE Leap ak Uyuni Proxy ak lòd spacewalkcommon-channels. spacewalk-common-channels fè pati pake spacewalkutils:
spacewalk-common-channels \
opensuse_leap15_4 \
opensuse_leap15_4-non-oss \
opensuse_leap15_4-non-oss-dates\
opensuse_leap15_4-mizajou \
opensuse_leap15_4-backports-updates \
opensuse_leap15_4-sle-updates \
opensuse_leap15_4-uyuni-client \
uyuni-proxy-stable-leap-154
Olye de vèsyon uyuni-proxy-stable-leap-154 ou ka eseye tou dènye vèsyon devlopman, ki rele uyuni-proxy-devel-leap. Pou plis enfòmasyon, gade Kliyan- configuration › Clients-opensuseleap.
2.2. Anrejistre sistèm openSUSE Leap la
Kòmanse pa enstale openSUSE Leap sou yon machin fizik oswa vityèl. Pou asire ke proxy a aksesib atravè rezo a, ou dwe gen yon non domèn ki ka rezoud konplètman kalifye (FQDN) sou sistèm openSUSE Leap la anvan ou kòmanse enstalasyon an. Ou ka configured yon FQDN ak YaST lè w ap navige nan Sistèm › Anviwònman Rezo › Non Host/DNS.
Lè ou enstale openSUSE Leap sou proxy a epi konfigirasyon FQDN la, ou ka prepare sèvè Uyuni a, epi anrejistre sistèm openSUSE Leap la kòm yon kliyan.
Pwosedi: Anrejistre sistèm openSUSE Leap la
- Sou sèvè Uyuni a, kreye yon kle deklanchman ak openSUSE Leap kòm yon kanal de baz ak proxy a ak lòt chanèl yo kòm chanèl timoun. Pou plis enfòmasyon sou kle deklanchman, gade Konfigirasyon Kliyan › Aktivasyon-kle.
- Modifye yon script bootstrap pou prokurasyon an. Asire w ou ajoute kle GPG pou Uyuni nan paramèt ORG_GPG_KEY=. Pou egzanpample:
ORG_GPG_KEY=uyuni-gpg-pubkey-0d20833e.key
Pou plis enfòmasyon, gade xref:client-configuration:clients-opensuse.adoc[]. - Bootstrap kliyan an lè l sèvi avèk script la. Pou plis enfòmasyon, gade Kliyan-konfigirasyon › Enskripsyon-bootstrap.
- Navige nan Salt › Keys epi aksepte kle a. Lè yo aksepte kle a, nouvo prokurasyon an ap parèt nan Systems › Overview nan seksyon Sistèm ki fèk anrejistre.
- Navige nan Detay Sistèm › Lojisyèl › Chanèl Lojisyèl, epi tcheke si chanèl prokurasyon an chwazi.
2.3. Enstale Uyuni Proxy sou openSUSE Leap
Sou kliyan an, sèvi ak zouti liy kòmand zypper la oswa sou sèvè Uyuni la Web UI pou enstale lojisyèl proxy sou openSUSE Leap.
Pwosedi: Enstale Uyuni Proxy sou openSUSE Leap
- Enstale modèl la pou Uyuni Proxy la. Ou ka fè sa swa sou kliyan an oswa sou sèvè a.
◦ Pou kliyan an, sèvi ak zypper zypper nan patterns-uyuni_proxy
- Altènativman, sou sèvè Uyuni a, sèvi ak la Web UI. Navige nan onglet detay kliyan an, klike sou Lojisyèl › Pakè › Enstale, epi pwograme patterns-uyuni_proxy pou enstalasyon.
1. Rdemare kliyan an.
2.4. Prepare prokurasyon an
Anvan ou kòmanse, asire w ke modèl proxy a enstale kòrèkteman. Pou verifye yon enstalasyon siksè, sou sèvè Uyuni a, chwazi pake pattern_uyuni_proxy pou enstalasyon an.
Se sèvis koutye sèl la otomatikman kòmanse apre enstalasyon an fini. Sèvis sa a voye entèraksyon Salt yo bay sèvè Uyuni la.
Li posib pou fè aranjman pou Sèl proxy nan yon chèn. Nan ka sa a, proxy en a rele paran.
Asire w ke pò TCP 4505 ak 4506 yo louvri sou proxy la. Pwokurasyon an dwe kapab rive jwenn sèvè Uyuni a oswa yon proxy paran sou pò sa yo.
Prokurasyon an pataje kèk enfòmasyon SSL ak sèvè Uyuni la. Ou bezwen kopye sètifika a ak kle li soti nan sèvè Uyuni oswa prokurasyon paran an nan prokurasyon w ap mete sou pye a.
Pwosedi: Kopi Sètifika ak kle sèvè a
- Sou prokurasyon w ap mete sou pye a, nan èd memwa lòd la, kòm rasin, kreye yon anyè pou sètifika a ak kle:
mkdir -m 700 /root/ssl-buildcd /root/ssl-build - Kopi sètifika a ak kle ki soti nan sous la nan nouvo anyè a. Nan ansyen sa aample, kote sous la rele PARAN. Ranplase sa a ak chemen ki kòrèk la:
scp rasin@ :/root/ssl-build/RHN-ORG-PRIVATE-SSL-KEY .
scp rasin@ :/root/ssl-build/RHN-ORG-TRUSTED-SSL-CERT .
scp rasin@ :/root/ssl-build/rhn-ca-openssl.cnf .
Pou kenbe chèn sekirite a entak, fonksyonalite Uyuni Proxy mande pou sètifika SSL la siyen pa menm CA ak sètifika sèvè Uyuni. Sèvi ak sètifika ki siyen pa CA diferan pou proxy ak sèvè pa sipòte. Pou plis enfòmasyon sou fason Uyuni okipe sètifika yo, gade Administrasyon › Sslcerts.
2.5. Mete kanpe proxy a
Lè w fin prepare proxy a, sèvi ak script entèaktif configure-proxy.sh ki bay pou konplete konfigirasyon proxy la.
Pwosedi: Mete kanpe Proxy la
- Sou prokurasyon w ap mete sou pye a, nan èd memwa lòd la, kòm rasin, egzekite script konfigirasyon an:
configure-proxy.sh - Swiv envit yo pou mete sou pye prokurasyon an. Kite yon jaden vid epi tape Enter pou itilize valè default yo montre ant parantèz kare.
Plis enfòmasyon sou anviwònman yo mete nan script la:
Uyuni Paran
paran Uyuni a ka swa yon lòt prokurasyon oswa yon sèvè.
HTTP Proxy
Yon proxy HTTP pèmèt Proxy Uyuni ou a jwenn aksè nan Web. Sa a se nesesè si aksè dirèk nan la Web se entèdi pa yon firewall.
Traceback Imèl
Yon adrès imel kote pou rapòte pwoblèm.
Èske ou vle enpòte Sètifika ki deja egziste?
Repons N. Sa asire w itilize nouvo sètifika yo te kopye deja nan sèvè Uyuni la.
Òganizasyon
Pwochen kesyon yo se sou karakteristik yo pou itilize pou sètifika SSL prokurasyon an. Òganizasyon an ta ka menm òganizasyon an ki te itilize sou sèvè a, sof si nan kou proxy ou a pa nan menm òganizasyon an ak sèvè prensipal ou a.
Inite Organizationganizasyon an
Valè default isit la se non host proxy a.
Vil
Plis enfòmasyon tache ak sètifika prokurasyon an.
Eta
Plis enfòmasyon tache ak sètifika prokurasyon an.
Kòd Peyi
Nan jaden kòd peyi a, antre kòd peyi a mete pandan enstalasyon Uyuni. Pou egzanpample, si proxy ou a nan peyi Etazini ak Uyuni ou a nan DE, antre DE pou proxy a.
Kòd peyi a dwe gen de lèt majiskil. Pou yon lis konplè kòd peyi yo, gade https://www.iso.org/obp/ui/#search.
Cname alyas (separe pa espas)
Sèvi ak sa a si ou ka jwenn aksè nan proxy ou atravè plizyè alyas DNS CNAME. Sinon li ka rete vid.
CA Modpas
Antre modpas ki te itilize pou sètifika sèvè Uyuni ou a.
Èske ou vle sèvi ak yon kle SSH ki egziste deja pou proxy SSH-Push Salt Minion?
Sèvi ak opsyon sa a si ou vle reitilize yon kle SSH ki te itilize pou kliyan SSH-Push Salt sou sèvè a.
Kreye ak peple chanèl konfigirasyon rhn_proxy_config_1000010001?
Aksepte default Y.
Non itilizatè SUSE Manadjè
Sèvi ak non itilizatè ak modpas menm jan ak sou sèvè Uyuni la.
Si pati ki manke, tankou kle CA ak sètifika piblik, script la enprime kòmandman ou dwe egzekite pou entegre bezwen an. files. Lè obligatwa a fileyo kopye, kouri configure-proxy.sh ankò. Si ou resevwa yon erè HTTP pandan ekzekisyon script, kouri script la ankò.
configure-proxy.sh aktive sèvis Uyuni Proxy mande yo, tankou kalma, apache2, saltbroker, ak jabberd.
Pou tcheke estati sistèm prokurasyon an ak kliyan li yo, klike sou paj detay sistèm prokurasyon an sou la
Web UI (Sistèm › Lis Sistèm › Proxy, Lè sa a, non sistèm lan). Soutabs Koneksyon ak Proxy yo montre divès enfòmasyon sou sitiyasyon.
Si ou vle PXE demare kliyan ou yo nan Uyuni Proxy ou a, ou bezwen tou senkronize done TFTP ki soti nan sèvè Uyuni la. Pou plis enfòmasyon sou senkronizasyon sa a, gade Kliyan-konfigirasyon › Autoinst-pxeboot.
Pwosedi: Senkronize Profiles ak Enfòmasyon sou Sistèm
- Sou prokurasyon an, nan èd memwa lòd la, kòm rasin, enstale pake a susemanager-tftpsync-recv:
zypper nan susemanager-tftpsync-recv - Sou prokurasyon an, kouri konfigirasyon script configure-tftpsync.sh epi antre enfòmasyon yo mande yo:
configure-tftpsync.sh
Ou bezwen bay non host la ak adrès IP sèvè Uyuni ak prokurasyon an. Ou bezwen tou antre nan chemen an nan anyè tftpboot sou proxy la. - Sou sèvè a, nan èd memwa lòd la, kòm rasin, enstale susemanager-tftpsync:
zypper nan susemanager-tftpsync - Sou sèvè a, kouri configure-tftpsync.sh script konfigirasyon epi antre enfòmasyon yo mande yo:
configure-tftpsync.sh - Kouri script la ankò ak non domèn totalman kalifye proxy w ap mete kanpe a. Sa a kreye konfigirasyon an, epi telechaje li nan Uyuni Proxy:
configure-tftpsync.sh FQDN_of_Proxy - Sou sèvè a, kòmanse yon premye senkronizasyon:
senkronizasyon kòdonye
Ou kapab tou senkronize apre yon chanjman nan Cobbler ki bezwen senkronize imedyatman. Sinon senkronizasyon Cobbler ap kouri otomatikman lè sa nesesè. Pou plis enfòmasyon sou demaraj PXE, gade Konfigirasyon Kliyan › Autoinst-pxeboot.
2.6. Konfigure DHCP pou PXE atravè Proxy
Uyuni sèvi ak Cobbler pou pwovizyon kliyan. PXE (tftp) enstale ak aktive pa default. Kliyan yo dwe kapab jwenn bòt PXE sou Uyuni Proxy lè l sèvi avèk DHCP. Sèvi ak konfigirasyon DHCP sa a pou zòn ki gen kliyan yo dwe pwovizyon:
pwochen sèvè:
filenon: "pxelinux.0"
2.7. Réinstallation yon proxy
Yon proxy pa genyen okenn enfòmasyon sou kliyan ki konekte ak li. Se poutèt sa, yon prokurasyon ka ranplase pa yon nouvo nenpòt ki lè. Prokurasyon ranplasman an dwe gen menm non ak adrès IP kòm predesesè li a.
Pou plis enfòmasyon sou reenstale yon proxy, gade Enstalasyon-ak-mizajou › Konfigirasyon proxy.
Sistèm proxy yo anrejistre kòm kliyan Salt lè l sèvi avèk yon script bootstrap.
Pwosedi sa a dekri konfigirasyon chanèl lojisyèl ak anrejistreman proxy enstale a ak yon kle deklanchman kòm kliyan Uyuni.
Anvan ou ka chwazi chanèl timoun ki kòrèk yo pandan w ap kreye kle deklanchman an, asire w ke ou te byen senkronize chanèl openSUSE Leap la ak tout chanèl timoun ki nesesè yo ak chanèl Uyuni Proxy.
2.8. Plis Enfòmasyon
Pou plis enfòmasyon sou pwojè Uyuni, ak telechaje sous la, gade https://www.uyuniproject.org/.
Pou plis dokiman sou pwodwi Uyuni, gade https://www.uyuni-project.org/uyuni-docs/uyuni/index.html.
Pou poze yon pwoblèm oswa pwopoze yon chanjman nan dokiman an, sèvi ak lyen ki anba meni Resous yo sou sit dokimantasyon an.
Chapit 3. Lisans pou dokimantasyon gratis GNU
Copyright © 2000, 2001, 2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. Tout moun gen dwa kopye epi distribye kopi dokiman lisans sa a mo pou mo, men chanje li pa pèmèt.
0. PREANBÒL
Objektif Lisans sa a se fè yon manyèl, liv, oswa lòt dokiman fonksyonèl ak itil "gratis" nan sans libète: asire tout moun libète efikas pou kopye ak redistribiye li, avèk oswa san modifye li, swa komèsyal oswa pa komèsyal. . Dezyèmman, Lisans sa a konsève pou otè a ak piblikatè yon fason pou jwenn kredi pou travay yo, pandan y ap pa konsidere kòm responsab pou modifikasyon lòt moun fè.
Lisans sa a se yon kalite "copyleft", ki vle di ke travay derive nan dokiman an dwe tèt yo gratis nan menm sans. Li konplete GNU General Public License, ki se yon lisans copyleft ki fèt pou lojisyèl gratis.
Nou te fèt Lisans sa a pou nou itilize li pou manyèl pou lojisyèl gratis, paske lojisyèl gratis bezwen dokiman gratis: yon pwogram gratis ta dwe vini ak manyèl ki bay menm libète ke lojisyèl an genyen. Men, Lisans sa a pa limite a manyèl lojisyèl; li ka itilize pou nenpòt travay tèks, kèlkeswa sijè oswa si li pibliye kòm yon liv enprime. Nou rekòmande Lisans sa a sitou pou travay ki gen objektif enstriksyon oswa referans.
1. APLIKABILITE AK DEFINISYON
Lisans sa a aplike a nenpòt manyèl oswa lòt travay, nan nenpòt mwayen, ki gen yon avi ki te mete pa moun ki gen dwadotè ki di li kapab distribye dapre kondisyon ki nan Lisans sa a. Yon avi konsa akòde yon lisans atravè lemond, san redevances, san limit nan dire, pou itilize travay sa a nan kondisyon ki endike nan la a. "Dokiman", pi ba a, refere a nenpòt manyèl oswa travay sa yo. Nenpòt manm nan piblik la se yon lisansye, epi yo adrese kòm "ou". Ou aksepte lisans lan si w kopye, modifye oswa distribye travay la nan yon fason ki mande pèmisyon dapre lalwa copyright.
Yon "Vèsyon Modifye" Dokiman an vle di nenpòt travay ki genyen Dokiman an oswa yon pati nan li, swa kopye mo mo, oswa avèk modifikasyon ak/oswa tradui nan yon lòt lang.
Yon "Seksyon Segondè" se yon apendis ki nonmen oswa yon seksyon devan Dokiman an ki trete sèlman relasyon piblikatè yo oswa otè Dokiman an ak sijè jeneral Dokiman an (oswa ak zafè ki gen rapò) epi ki pa gen anyen ki ka tonbe dirèkteman. nan sijè sa a an jeneral. (Kidonk, si Dokiman an se an pati yon liv matematik, yon Seksyon Segondè ka pa eksplike okenn matematik.) Relasyon an ta ka yon kesyon de koneksyon istorik ak sijè a oswa ak zafè ki gen rapò, oswa nan legal, komèsyal, filozofik, etik. oswa pozisyon politik konsènan yo.
"Seksyon Invariant" yo se sèten Seksyon Segondè ki gen tit yo deziyen, kòm seksyon Seksyon Invariant, nan avi ki di ke Dokiman an pibliye anba Lisans sa a. Si yon seksyon pa anfòm definisyon ki anwo a nan Segondè, lè sa a pa gen dwa deziyen li kòm Invariant. Dokiman an ka genyen zewo Seksyon Invariant. Si Dokiman an pa idantifye okenn Seksyon Invariant, pa genyen okenn.
"Tèks Kouvèti" yo se sèten pasaj kout nan tèks ki nan lis, kòm Tèks Kouvèti Devan oswa Tèks Kouvèti Deyè, nan avi ki di ke Dokiman an pibliye anba Lisans sa a. Yon Tèks Kouvèti Devan ka gen 5 mo pou pi plis, epi yon Tèks Kouvèti Deyè a gendwa genyen 25 mo pou pi plis.
Yon kopi "Transparan" nan Dokiman an vle di yon kopi machin lizib, reprezante nan yon fòma ki gen spesifikasyon disponib pou piblik la an jeneral, ki apwopriye pou revize dokiman an tou dwat ak editè tèks jenerik oswa (pou imaj ki konpoze de piksèl) penti jenerik. pwogram oswa (pou desen) kèk editè desen lajman disponib, epi ki apwopriye pou antre nan fòmatè tèks oswa pou tradiksyon otomatik nan yon varyete fòma apwopriye pou antre nan fòmatè tèks. Yon kopi ki fèt nan yon lòt fason transparan file fòma ki gen maketing, oswa absans nan maketing, te ranje pou anpeche oswa dekouraje modifikasyon ki vin apre pa lektè yo pa Transparan. Yon fòma imaj pa transparan si yo itilize pou nenpòt ki kantite tèks. Yon kopi ki pa "Transparan" yo rele "Opaque".
Exampfòma apwopriye pou kopi transparan yo enkli ASCII senp san mak, fòma antre Texinfo, fòma antre LaTeX, SGML oswa XML lè l sèvi avèk yon DTD ki disponib pou piblik la, ak HTML senp, PostScript oswa PDF ki konfòm estanda ki fèt pou modifikasyon imen. Egzampfòma imaj transparan yo enkli PNG, XCF ak JPG. Fòma opak yo gen ladan fòma propriétaires ki kapab li ak modifye sèlman pa pwosedetè tèks, SGML oswa XML pou ki DTD ak/oswa zouti pwosesis yo pa disponib jeneralman, ak HTML, PostScript oswa PDF pwodwi pa machin nan kèk processeur tèks pou rezon pwodiksyon sèlman.
“Paj Tit” la vle di, pou yon liv enprime, paj tit li menm, plis paj sa yo ki nesesè pou kenbe, lizib, materyèl Lisans sa a mande pou parèt nan paj tit la. Pou travay nan fòma ki pa gen okenn paj tit kòm sa yo, "Paj Tit" vle di tèks ki toupre aparans ki pi enpòtan nan tit travay la, anvan kòmansman kò tèks la.
Yon seksyon "XYZ ki gen dwa" vle di yon sou-inite non nan Dokiman an ki gen tit jisteman XYZ oswa ki gen XYZ nan parantèz apre tèks ki tradui XYZ nan yon lòt lang. (Isit la XYZ vle di yon non seksyon espesifik ki mansyone pi ba a, tankou "Rekonesans", "Dedikasyon", "Andòsman", oswa "Istwa".) Pou "Prezève Tit" nan yon seksyon konsa lè ou modifye Dokiman an vle di ke li. rete yon seksyon "XYZ gen dwa" dapre definisyon sa a.
Dokiman an ka gen ladann Deklarasyon Garanti akote avi a ki di ke Lisans sa a aplike a Dokiman an. Yo konsidere ke Deklarasyon Garanti Garanti sa yo dwe enkli pa referans nan Lisans sa a, men se sèlman konsènan egzijans garanti: nenpòt lòt enplikasyon ke Limit Responsabilite Garanti sa yo ka genyen an anile epi pa gen okenn efè sou siyifikasyon Lisans sa a.
2. KOPI VÈBATIM
Ou ka kopye epi distribye Dokiman an nan nenpòt mwayen, swa komèsyal oswa non komèsyal, depi lisans sa a, avi sou copyright yo ak avi lisans ki di Lisans sa a aplike pou Dokiman an repwodui nan tout kopi, epi ou pa ajoute okenn lòt kondisyon. pou moun ki gen Lisans sa a. Ou pa gen dwa sèvi ak mezi teknik pou anpeche oswa kontwole lekti oswa plis kopi kopi ou fè oswa distribye yo. Sepandan, ou ka aksepte konpansasyon an echanj pou kopi. Si ou distribye yon kantite ase gwo kopi ou dwe swiv tou kondisyon ki nan seksyon 3. Ou ka prete kopi tou, nan menm kondisyon ki endike anwo a, epi ou ka montre kopi piblikman.
3. KOPI AN KANTITE
Si w pibliye kopi dokiman an enprime (oswa kopi sou medya ki souvan gen kouvèti enprime) Dokiman an, ki nimewote plis pase 100, epi avi lisans Dokiman an mande pou Tèks Kouvèti, ou dwe mete kopi yo nan kouvèti ki pote tout bagay sa yo klè e lizib. Tèks Kouvèti: Tèks Kouvèti Devan sou kouvèti devan an, ak Tèks Kouvèti Deyè yo sou kouvèti dèyè a. Tou de kouvèti yo dwe idantifye w klèman ak lizib tou kòm piblikatè kopi sa yo. Kouvèti devan an dwe prezante tit la konplè ak tout mo nan tit la egalman enpòtan ak vizib. Ou ka ajoute lòt materyèl sou kouvèti yo anplis. Kopi ak chanjman ki limite a kouvèti yo, osi lontan ke yo prezève tit Dokiman an epi satisfè kondisyon sa yo, yo ka trete kòm kopi mo pou mo nan lòt sans.
Si tèks yo mande pou nenpòt kouvèti yo twò volumineux pou yo anfòm byen lizib, ou ta dwe mete premye sa yo ki nan lis (tankou yo anfòm rezonab) sou kouvèti aktyèl la, epi kontinye rès la sou paj adjasan yo.
Si w pibliye oswa distribye kopi Opak nan Dokiman an ki nimero plis pase 100, ou dwe swa enkli yon kopi Transparan lizib nan machin ansanm ak chak kopi Opak, oswa endike nan oswa avèk chak kopi Opak yon kote rezo òdinatè ki soti nan rezo jeneral la. lè l sèvi avèk piblik gen aksè a telechaje lè l sèvi avèk pwotokòl rezo piblik estanda yon kopi Transparan konplè nan Dokiman an, san yo pa ajoute materyèl. Si w itilize dènye opsyon sa a, ou dwe pran dispozisyon rezonab ki pridan, lè w kòmanse distribye kopi Opak an kantite, pou asire w kopi Transparan sa a ap rete konsa aksesib nan kote ki endike a jiska omwen yon ane apre dènye fwa ou distribye yon kopi Opak. Kopi opak (dirèkteman oswa atravè ajan ou oswa détaillants) edisyon sa a bay piblik la.
Li mande, men se pa obligatwa, pou w kontakte otè Dokiman an byen anvan ou redistribiye nenpòt gwo kantite kopi, pou ba yo chans pou yo ba w yon vèsyon ki ajou Dokiman an.
4. MODIFIKASYON
Ou ka kopye epi distribye yon Vèsyon Modifye nan Dokiman an nan kondisyon ki nan seksyon 2 ak 3 pi wo a, depi ou pibliye Vèsyon Modifye a jis sou Lisans sa a, ak Vèsyon Modifye a ranpli wòl nan Dokiman an, kidonk lisans distribisyon ak modifikasyon nan Vèsyon modifye a bay nenpòt moun ki posede yon kopi li. Anplis de sa, ou dwe fè bagay sa yo nan vèsyon an modifye:
A. Sèvi ak nan paj Tit la (ak sou kouvèti yo, si genyen) yon tit ki diferan de sa ki nan Dokiman an, ak de sa yo ki nan vèsyon anvan yo (ki ta dwe, si te genyen, nan seksyon Istwa Dokiman an) . Ou ka itilize menm tit ak yon vèsyon anvan an si piblikatè orijinal vèsyon sa a bay pèmisyon.
B. Lis sou Paj Tit la, kòm otè, youn oswa plizyè moun oswa antite ki responsab pou patènite modifikasyon yo nan Vèsyon Modifye a, ansanm ak omwen senk nan otè prensipal Dokiman an (tout otè prensipal li yo, si li gen mwens pase senk), sof si yo libere ou anba kondisyon sa a.
C. Endike sou paj Tit la non Piblikatè Vèsyon Modifye a, kòm Piblikatè a.
D. Konsève tout avi sou copyright Dokiman an.
E. Ajoute yon avi copyright ki apwopriye pou modifikasyon ou yo toupre lòt avi copyright yo.
F. Mete, imedyatman apre avi copyright yo, yon avi lisans ki bay piblik la pèmisyon pou itilize vèsyon ki modifye a dapre kondisyon Lisans sa a, nan fòm ki montre nan Addendum ki anba a.
G. Konsève nan avi lisans sa a lis konplè Seksyon Invarian ak Tèks Kouvèti obligatwa yo bay nan avi lisans Dokiman an.
H. Mete yon kopi Lisans sa a ki pa chanje.
I. Konsève seksyon ki gen Tit “Istwa”, Prezève Tit li a, epi ajoute sou li yon atik ki endike omwen tit la, ane, nouvo otè, ak piblikatè Vèsyon Modifye a jan yo bay sou Paj Tit la. Si pa gen okenn seksyon ki gen Tit “Istwa” nan Dokiman an, kreye youn ki endike tit la, ane, otè, ak Piblikatè Dokiman an jan yo bay sou Paj Tit li a, epi ajoute yon atik ki dekri Vèsyon Modifye a jan sa endike nan fraz anvan an.
J. Konsève kote rezo a, si genyen, yo bay nan Dokiman an pou aksè piblik la nan yon kopi Transparan Dokiman an, ak menm jan an tou kote rezo yo bay nan Dokiman an pou vèsyon anvan li te baze sou yo. Yo ka mete sa yo nan seksyon "Istwa". Ou ka omisyon yon kote rezo pou yon travay ki te pibliye omwen kat ane anvan Dokiman an li menm, oswa si Piblikatè orijinal vèsyon an li refere a bay pèmisyon.
K. Pou nenpòt seksyon ki gen tit “Rekonesans” oswa “Dedikasyon”, Prezève Tit seksyon an, epi konsève nan seksyon an tout sibstans ak ton chak nan rekonesans ak/oswa dedikasyon kontribitè yo bay ladan l.
L. Konsève tout Seksyon Invarian nan Dokiman an, san okenn chanjman nan tèks yo ak nan tit yo. Nimewo seksyon yo oswa ekivalan yo pa konsidere kòm yon pati nan tit seksyon yo.
M. Efase nenpòt seksyon ki gen dwa "Apwobasyon". Yon seksyon konsa pa ka enkli nan vèsyon modifye a.
N. Pa retitre okenn seksyon ki egziste deja pou yo gen dwa "Akòz" oswa pou yo antre nan yon konfli nan tit ak nenpòt seksyon ki pa chanje.
O. Konsève nenpòt ki Deklarasyon Garanti.
Si Vèsyon Modifye a gen ladan nouvo seksyon oswa apendis ki kalifye kòm Seksyon Segondè epi ki pa gen okenn materyèl kopye nan Dokiman an, ou ka chwazi kèk oswa tout seksyon sa yo kòm envaryab. Pou fè sa, ajoute tit yo nan lis Seksyon Invariant nan avi lisans vèsyon an modifye. Tit sa yo dwe diferan de nenpòt lòt tit seksyon.
Ou gendwa ajoute yon seksyon ki gen dwa "Apwobasyon", depi li pa gen anyen men andòsman vèsyon modifye w la pa plizyè pati—pa egzanp.ample, deklarasyon parèy review oswa ke tèks la te apwouve pa yon òganizasyon kòm definisyon an otorite nan yon estanda.
Ou ka ajoute yon pasaj ki genyen jiska senk mo kòm yon Tèks Kouvèti Devan, ak yon pasaj ki gen jiska 25 mo kòm yon Tèks Kouvèti Deyè, nan fen lis Tèks Kouvèti yo nan Vèsyon Modifye a. Sèlman yon sèl pasaj nan Tèks Kouvèti Devan ak youn nan Tèks Kouvèti Deyè yo ka ajoute pa (oswa nan dispozisyon ki fèt pa) nenpòt antite. Si Dokiman an deja gen ladann yon tèks kouvèti pou menm kouvèti a, ou te ajoute anvan oswa pa aranjman menm antite w ap aji nan non an, ou pa gendwa ajoute yon lòt; men ou menm
ka ranplase ansyen an, sou pèmisyon klè nan piblikatè anvan an ki te ajoute ansyen an.
Otè a (yo) ak Piblikatè a (yo) nan Dokiman an pa bay pèmisyon pou itilize non yo pou fè piblisite pou oswa pou reklame oswa vle di andòsman nenpòt vèsyon modifye.
5. KONBINE DOKIMAN
Ou ka konbine Dokiman an ak lòt dokiman ki pibliye anba Lisans sa a, dapre kondisyon ki defini nan seksyon 4 pi wo a pou vèsyon modifye, depi ou mete nan konbinezon an tout Seksyon Invariant nan tout dokiman orijinal yo, san modifye, epi lis yo tout. kòm Seksyon Invariant nan travay konbine ou nan avi lisans li yo, epi ke ou prezève tout Deklarasyon Garanti yo.
Travay konbine a dwe genyen sèlman yon kopi Lisans sa a, epi plizyè Seksyon Invariant ki idantik ka ranplase ak yon sèl kopi. Si gen plizyè Seksyon Invariant ki gen menm non men ki gen diferan kontni, fè tit chak seksyon sa yo inik lè w ajoute nan fen li, an parantèz, non otè orijinal la oswa piblikatè seksyon sa a si yo konnen, oswa yon lòt bagay. nimewo inik. Fè menm ajisteman nan tit seksyon yo nan lis Seksyon Invariant nan avi lisans travay konbine a.
Nan konbinezon an, ou dwe konbine nenpòt seksyon ki gen dwa "Istwa" nan divès dokiman orijinal yo, ki fòme yon seksyon ki gen dwa "Istwa"; menm jan an tou konbine nenpòt seksyon ki gen dwa "Rekonesans", ak nenpòt seksyon ki gen dwa "dedikasyon". Ou dwe efase tout seksyon ki gen dwa "Apwobasyon".
6. KOLEKSYON DOKIMAN
Ou gendwa fè yon koleksyon ki gen ladann Dokiman an ak lòt dokiman ki pibliye anba Lisans sa a, epi ranplase kopi endividyèl Lisans sa a nan divès dokiman yo ak yon sèl kopi ki enkli nan koleksyon an, depi ou swiv règ Lisans sa a pou kopi mo pou chak dokiman yo nan tout lòt respè.
Ou ka ekstrè yon sèl dokiman nan yon koleksyon sa a, epi distribye li endividyèlman anba Lisans sa a, depi ou mete yon kopi Lisans sa a nan dokiman ki ekstrè a, epi swiv Lisans sa a nan tout lòt respè konsènan kopi mo pou mo dokiman sa a.
7. AGREGASYON AK TRAVAY ENDEPANDAN
Yon konpilasyon Dokiman an oswa dérivés li yo ak lòt dokiman oswa travay separe ak endepandan, nan oswa sou yon volim nan yon mwayen depo oswa distribisyon, yo rele yon "total" si copyright ki soti nan konpilasyon an pa itilize pou limite dwa legal yo. itilizatè konpilasyon an pi lwen pase sa travay endividyèl la pèmèt. Lè Dokiman an enkli nan yon total, Lisans sa a pa aplike nan lòt travay yo nan total ki pa tèt yo travay derive nan Dokiman an.
Si egzijans Tèks Kouvèti seksyon 3 a aplikab pou kopi Dokiman sa yo, Lè sa a, si Dokiman an se mwens pase mwatye nan total la, yo ka mete Tèks Kouvèti Dokiman an sou kouvèti ki mete Dokiman an nan total la, oswa ekivalan elektwonik kouvèti si Dokiman an se sou fòm elektwonik. Sinon yo dwe parèt sou kouvèti enprime ki bracket total la.
8. TRADUCTION
Tradiksyon konsidere kòm yon kalite modifikasyon, kidonk ou ka distribye tradiksyon Dokiman an dapre kondisyon ki nan seksyon 4. Ranplase Seksyon Invariant ak tradiksyon mande pou yon pèmisyon espesyal nan men moun ki gen copyright yo, men ou ka mete tradiksyon kèk oswa tout Seksyon Invariant anplis de. vèsyon orijinal yo nan Seksyon Invariant sa yo. Ou gendwa mete yon tradiksyon Lisans sa a, ak tout avi lisans ki nan Dokiman an, ak nenpòt ki Limit responsabilite nou sou Garanti, depi ou genyen tou vèsyon orijinal angle Lisans sa a ak vèsyon orijinal avi sa yo ak egzijans responsabilite yo. Nan ka ta gen yon dezakò ant tradiksyon an ak vèsyon orijinal la nan Lisans sa a oswa yon avi oswa yon eksklizyon responsablite, vèsyon orijinal la ap genyen.
Si yon seksyon nan Dokiman an gen dwa "Rekonesans", "Dedikas", oswa "Istwa", egzijans (seksyon 4) pou Prezève Tit li (seksyon 1) anjeneral mande pou chanje tit aktyèl la.
9. TERMINATION
Ou pa gen dwa kopye, modifye, sou-lisans, oswa distribye Dokiman an eksepte jan lisans sa a prevwa ekspreseman. Nenpòt lòt tantativ pou kopye, modifye, sou-lisans oswa distribye Dokiman an se anile, epi yo pral otomatikman sispann dwa ou anba Lisans sa a. Sepandan, pati ki te resevwa kopi, oswa dwa, nan men ou anba Lisans sa a p ap gen lisans yo sispann toutotan pati sa yo rete an konfòmite total.
10. REVIZISYON LISANS SA A AVENIR
Free Software Foundation gendwa pibliye nouvo vèsyon revize Lisans Dokimantasyon Gratis GNU detanzantan. Nouvo vèsyon sa yo pral sanble ak vèsyon aktyèl la, men yo ka diferan an detay pou adrese nouvo pwoblèm oswa enkyetid. Gade http://www.gnu.org/copyleft/.
Yo bay chak vèsyon Lisans lan yon nimewo vèsyon diferan. Si Dokiman an espesifye ke yon vèsyon nimero patikilye nan Lisans sa a "oswa nenpòt vèsyon pita" aplike a li, ou gen opsyon pou swiv tèm ak kondisyon swa nan vèsyon espesifye sa a oswa nan nenpòt vèsyon pita ki te pibliye (pa kòm yon bouyon) pa Free Software Foundation. Si Dokiman an pa presize yon nimewo vèsyon Lisans sa a, ou ka chwazi nenpòt vèsyon ki te janm pibliye (pa kòm yon bouyon) pa Free Software Foundation.
ADDANDUM: Kouman pou itilize Lisans sa a pou dokiman ou yo
Copyright (c) ANE NON OU.
Yo bay pèmisyon pou kopye, distribye ak/oswa modifye dokiman sa a dapre kondisyon GNU Free Documentation License, Vèsyon 1.2 oswa nenpòt vèsyon pita pibliye pa Free Software Foundation; ki pa gen okenn Seksyon Invariant, pa gen okenn Tèks Devan-Kouvri, epi pa gen okenn Tèks Deyè-Kouvri.
Gen yon kopi lisans lan nan seksyon ki rele {ldquo}GNU Free Documentation License{rdquo}.
Si w genyen Seksyon ki pa varye, Tèks devan kouvèti ak Tèks sou kouvèti dèyè, ranplase "ak... Tèks." liy ak sa a:
ak Seksyon Invariant yo se LIS TIT YO, ak Tèks Devan yo se LIS, epi ak Tèks Deyè yo se LIS.
Si ou gen Seksyon Invariant san Tèks Kouvèti, oswa kèk lòt konbinezon twa yo, rantre de altènativ sa yo pou adapte sitiyasyon an.
Si dokiman ou genyen ki pa trivial examples nan kòd pwogram, nou rekòmande lage sa yo ansyenampan paralèl dapre lisans lojisyèl lib ou chwazi, tankou Lisans Piblik Jeneral GNU, pou pèmèt yo sèvi ak lojisyèl gratis.
Chapit 3. Lisans pou dokimantasyon gratis GNU | Uyuni 2022.12
Dokiman / Resous
 |
Sèvè UYUNI 2022.12 oswa Konfigirasyon Kliyan Proxy [pdfGid Itilizatè 2022.12, Sèvè oswa Konfigirasyon Kliyan Proxy, Sèvè 2022.12 oswa Konfigirasyon Kliyan Proxy |
