Skip to content

Rework additive mirroring policy for Oracle Linux #4732

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
maximiliankolb merged 1 commit into from
Apr 9, 2026
Merged

Rework additive mirroring policy for Oracle Linux #4732

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions guides/common/assembly_importing-content.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,15 @@ include::modules/proc_adding-custom-rpm-repositories-by-using-web-ui.adoc[levelo

include::modules/proc_adding-custom-rpm-repositories-by-using-cli.adoc[leveloffset=+1]

include::modules/proc_limiting-growth-of-synchronized-content-by-using-web-ui.adoc[leveloffset=+1]

include::modules/proc_limiting-growth-of-synchronized-content-by-using-cli.adoc[leveloffset=+1]

ifndef::satellite[]
include::modules/ref_default-operating-system-repositories.adoc[leveloffset=+1]

include::modules/con_oracle-linux-content.adoc[leveloffset=+1]

include::modules/con_uln-repositories.adoc[leveloffset=+1]

include::modules/ref_uln-repositories-for-oracle-linux-10.adoc[leveloffset=+2]
Expand Down
21 changes: 21 additions & 0 deletions guides/common/modules/con_oracle-linux-content.adoc
View file
Open in desktop
Copy link
Copy Markdown
Contributor

@Lennonka Lennonka Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about moving the core of this to Best practices as a new list item? 🤔

Copy link
Copy Markdown
Contributor Author

@maximiliankolb maximiliankolb Apr 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did not think about this before but I wish to keep it as is: the OOM problem has been specifically reported for Yum content from Oracle for Oracle Linux because Oracle only adds packages to repos instead of replacing them. This means that you might end up with dozens of package versions of large packages, such as golang-bin.

Copy link
Copy Markdown
Contributor

@Lennonka Lennonka Apr 9, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I understand that the problem is specific to Oracle Linux, but I'm not entirely happy with adding a new heading for it.

Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
:_mod-docs-content-type: CONCEPT

[id="oracle-linux-content"]
= Oracle Linux content

[role="_abstract"]
You can synchronize content for Oracle Linux to {Project}.

Oracle adds packages to repositories for Oracle Linux and ULN without removing old versions.
Content synchronization with the *Content only* mirroring policy might lead to out-of-memory issues on {ProjectServer}.
You can mitigate this by setting the mirroring policy to *Additive* and the *Retain package versions* to either one or two.
This means that each time {Project} synchronizes content from Oracle, new packages are added and old packages are removed.
Note that this does not affect any published content views.

.Additional resources
* xref:adding-custom-rpm-repositories-by-using-web-ui[]
* xref:limiting-growth-of-synchronized-content-by-using-web-ui[]
* xref:uln-repositories[]
* xref:oracle-linux-10[]
* xref:oracle-linux-9[]
* xref:oracle-linux-8[]
3 changes: 2 additions & 1 deletion guides/common/modules/con_uln-repositories.adoc
View file
Open in desktop
Copy link
Copy Markdown
Contributor Author

@maximiliankolb maximiliankolb Mar 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this a real issue for concept modules? Until now, I thought this rule only applies to procedures.

Copy link
Copy Markdown
Member

@aneta-petrova aneta-petrova Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AFAIK it is an issue now for concept modules. I raised jhradilek/asciidoctor-dita-vale#177 to clarify.

Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@
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-by-using-web-ui[Adding RPM repositories].

Check warning on line 23 in guides/common/modules/con_uln-repositories.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_uln-repositories.adoc", "range": {"start": {"line": 23, "column": 27}}}, "severity": "WARNING"}

include::snip_set-retain-package-versions-for-uln-content.adoc[]
{Team} recommends that you limit the number of retained packages on {Project}.
For more information, see xref:limiting-growth-of-synchronized-content-by-using-web-ui[].

Check warning on line 26 in guides/common/modules/con_uln-repositories.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_uln-repositories.adoc", "range": {"start": {"line": 26, "column": 27}}}, "severity": "WARNING"}
24 changes: 24 additions & 0 deletions ...s/common/modules/proc_limiting-growth-of-synchronized-content-by-using-cli.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
:_mod-docs-content-type: PROCEDURE

[id="limiting-growth-of-synchronized-content-by-using-cli"]
= Limiting growth of synchronized content by using Hammer CLI

[role="_abstract"]
You can limit the growth of content in the Library lifecycle environment on {ProjectServer} by restraining the number of package versions in synchronized repositories.

.Procedure
* Configure your repository to retain a limited number of package versions in {Project}:
+
[options="nowrap", subs="+quotes,verbatim,attributes"]
----
$ hammer repository update \
--id _My_Repository_ID_ \
--mirroring-policy additive \
--retain-package-versions-count _My_Package_Versions_Count_
----
+
** Set _My_Package_Versions_Count_ to `1` to only keep the latest synchronized package version on {Project}.
** Set _My_Package_Versions_Count_ to `2` or higher to keep multiple package versions on {Project}.

.Additional resources
* xref:Mirroring_Policies_Overview_{context}[]
19 changes: 19 additions & 0 deletions ...ommon/modules/proc_limiting-growth-of-synchronized-content-by-using-web-ui.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
:_mod-docs-content-type: PROCEDURE

[id="limiting-growth-of-synchronized-content-by-using-web-ui"]
= Limiting growth of synchronized content by using {ProjectWebUI}

[role="_abstract"]
You can limit the growth of content in the Library lifecycle environment on {ProjectServer} by restraining the number of package versions in synchronized repositories.

.Procedure
. In the {ProjectWebUI}, navigate to *Content* > *Products*.
. Select your product.
. On the *Repository* tab, select your repository.
. Set the *Mirroring Policy* to `Additive`.
. Define the number of retained package versions:
* Set *Retain package versions* to `1` to only keep the latest synchronized package version on {Project}.
* Set *Retain package versions* to `2` or higher to keep multiple package versions on {Project}.

.Additional resources
* xref:Mirroring_Policies_Overview_{context}[]
18 changes: 0 additions & 18 deletions guides/common/modules/snip_set-retain-package-versions-for-uln-content.adoc
View file
Open in desktop

This file was deleted.

Loading