Skip to content

Commit

Permalink
Add docs for Oracle ULN content (#3639)
Browse files Browse the repository at this point in the history
Refs 33250 in Redmine
Refs b781e6af48499137ccf74b57f1b70fbe079673c5 in katello
  • Loading branch information
maximiliankolb authored Feb 4, 2025
1 parent 12a72d6 commit 0bf57ce
Show file tree
Hide file tree
Showing 5 changed files with 55 additions and 0 deletions.
6 changes: 6 additions & 0 deletions guides/common/assembly_importing-content.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
19 changes: 19 additions & 0 deletions guides/common/modules/proc_creating-uln-repositories.adoc
Original file line number Diff line number Diff line change
@@ -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[]
Original file line number Diff line number Diff line change
@@ -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`
Original file line number Diff line number Diff line change
@@ -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`
Original file line number Diff line number Diff line change
@@ -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}.
====

0 comments on commit 0bf57ce

Please sign in to comment.