diff --git a/guides/common/assembly_importing-content.adoc b/guides/common/assembly_importing-content.adoc index db399482b5..fc909f362b 100644 --- a/guides/common/assembly_importing-content.adoc +++ b/guides/common/assembly_importing-content.adoc @@ -71,6 +71,12 @@ include::modules/proc_adding-custom-rpm-repositories-el.adoc[leveloffset=+1] :yum_repo_extras_url: https://yum.oracle.com/repo/OracleLinux/OL{os_major}/addons/x86_64/ include::modules/proc_adding-custom-rpm-repositories-el.adoc[leveloffset=+1] +include::modules/proc_creating-uln-repositories.adoc[leveloffset=+1] + +include::modules/ref_uln-repositories-for-oracle-linux-9.adoc[leveloffset=+2] + +include::modules/ref_uln-repositories-for-oracle-linux-8.adoc[leveloffset=+2] + :gpg_url: https://dl.rockylinux.org/pub/rocky/RPM-GPG-KEY-rockyofficial :os_major: 9 :os_name: Rocky Linux diff --git a/guides/common/modules/proc_creating-uln-repositories.adoc b/guides/common/modules/proc_creating-uln-repositories.adoc new file mode 100644 index 0000000000..0b048af147 --- /dev/null +++ b/guides/common/modules/proc_creating-uln-repositories.adoc @@ -0,0 +1,19 @@ +[id="creating-uln-repositories"] += Creating ULN repositories + +You can synchronize content from Oracle Unbreakable Linux Network (ULN) to {Project}. +There are two main differences compared to generic Yum content: + +* The *Upstream URL* field consists of a protocol prefix `uln://` and an `ULN Channel Label`, for example, `ol7_x86_64_MySQL80_community`. +Combined, `uln://ol7_x86_64_MySQL80_community` is a valid upstream URL for a Yum repository. +* Authentication against the repository through an *Upstream Username* and *Upstream Password* is mandatory. +This requires your single sign-on user name and password of your Oracle account to be saved on your {Project}. + +To obtain a list of available ULN channel labels, log in to https://linux.oracle.com/[Oracle Unbreakable Linux Network]. +Navigate to the *channels* tab and select an operating system release version and architecture. +Copy the required *ULN Channel Label* from the list of available content. + +Adding ULN repositories is different compared to Yum repositories for {client-os}, for example, `\https://yum.oracle.com/oracle-linux-9.html`, which you can add as Yum-type content. +For more information, see xref:Adding_Custom_RPM_Repositories_{context}[Adding RPM repositories]. + +include::snip_limit-download-concurrency-for-uln-content.adoc[] diff --git a/guides/common/modules/ref_uln-repositories-for-oracle-linux-8.adoc b/guides/common/modules/ref_uln-repositories-for-oracle-linux-8.adoc new file mode 100644 index 0000000000..ce7382eeb2 --- /dev/null +++ b/guides/common/modules/ref_uln-repositories-for-oracle-linux-8.adoc @@ -0,0 +1,8 @@ +[id="uln-repositories-for-oracle-linux-8"] += ULN repositories for Oracle Linux 8 + +* Addons ULN: `uln://ol8_x86_64_addons` +* AppStream ULN: `uln://ol8_x86_64_appstream` +* BaseOS latest ULN: `uln://ol8_x86_64_baseos_latest` +* Unbreakable Enterprise Kernel Release 6: `uln://ol8_x86_64_UEKR6` +* kSplice: `uln://ol8_x86_64_ksplice` diff --git a/guides/common/modules/ref_uln-repositories-for-oracle-linux-9.adoc b/guides/common/modules/ref_uln-repositories-for-oracle-linux-9.adoc new file mode 100644 index 0000000000..14b0054fc9 --- /dev/null +++ b/guides/common/modules/ref_uln-repositories-for-oracle-linux-9.adoc @@ -0,0 +1,8 @@ +[id="uln-repositories-for-oracle-linux-9"] += ULN repositories for Oracle Linux 9 + +* Addons ULN: `uln://ol9_x86_64_addons` +* AppStream ULN: `uln://ol9_x86_64_appstream` +* BaseOS latest ULN: `uln://ol9_x86_64_baseos_latest` +* Unbreakable Enterprise Kernel Release 7: `uln://ol9_x86_64_UEKR7` +* kSplice: `uln://ol9_x86_64_ksplice` diff --git a/guides/common/modules/snip_limit-download-concurrency-for-uln-content.adoc b/guides/common/modules/snip_limit-download-concurrency-for-uln-content.adoc new file mode 100644 index 0000000000..9a49f74e02 --- /dev/null +++ b/guides/common/modules/snip_limit-download-concurrency-for-uln-content.adoc @@ -0,0 +1,14 @@ +[IMPORTANT] +==== +{Team} recommends that you limit the download concurrency to `1` for ULN content to avoid synchronization failures. +You can use Hammer CLI to configure your ULN repository on {Project}: + +[options="nowrap", subs="+quotes,verbatim,attributes"] +---- +$ hammer repository update \ +--download-concurrency 1 \ +--id _My_ULN_Repository_ID_ +---- + +Note that this setting is not exposed in the {ProjectWebUI}. +====