diff --git a/guides/common/assembly_importing-content.adoc b/guides/common/assembly_importing-content.adoc index 211613877e3..9a7d85ec15e 100644 --- a/guides/common/assembly_importing-content.adoc +++ b/guides/common/assembly_importing-content.adoc @@ -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] diff --git a/guides/common/modules/con_oracle-linux-content.adoc b/guides/common/modules/con_oracle-linux-content.adoc new file mode 100644 index 00000000000..fcc997f82df --- /dev/null +++ b/guides/common/modules/con_oracle-linux-content.adoc @@ -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[] diff --git a/guides/common/modules/con_uln-repositories.adoc b/guides/common/modules/con_uln-repositories.adoc index fe7c61b6eee..0b5a4e4688a 100644 --- a/guides/common/modules/con_uln-repositories.adoc +++ b/guides/common/modules/con_uln-repositories.adoc @@ -22,4 +22,5 @@ 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]. -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[]. diff --git a/guides/common/modules/proc_limiting-growth-of-synchronized-content-by-using-cli.adoc b/guides/common/modules/proc_limiting-growth-of-synchronized-content-by-using-cli.adoc new file mode 100644 index 00000000000..57feb8c1367 --- /dev/null +++ b/guides/common/modules/proc_limiting-growth-of-synchronized-content-by-using-cli.adoc @@ -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}[] diff --git a/guides/common/modules/proc_limiting-growth-of-synchronized-content-by-using-web-ui.adoc b/guides/common/modules/proc_limiting-growth-of-synchronized-content-by-using-web-ui.adoc new file mode 100644 index 00000000000..c702d705f73 --- /dev/null +++ b/guides/common/modules/proc_limiting-growth-of-synchronized-content-by-using-web-ui.adoc @@ -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}[] diff --git a/guides/common/modules/snip_set-retain-package-versions-for-uln-content.adoc b/guides/common/modules/snip_set-retain-package-versions-for-uln-content.adoc deleted file mode 100644 index c4d3bcb6c1e..00000000000 --- a/guides/common/modules/snip_set-retain-package-versions-for-uln-content.adoc +++ /dev/null @@ -1,18 +0,0 @@ -:_mod-docs-content-type: SNIPPET - -[IMPORTANT] -==== -{Team} recommends that you set the `retain_package_versions` to `1` for ULN content to avoid synchronization failures. -For this setting to appear in the {ProjectWebUI}, you also need to set the mirroring policy to `additive`. - -Alternatively, you can use Hammer CLI to configure your ULN repository on {Project}: - -[options="nowrap", subs="+quotes,verbatim,attributes"] ----- -$ hammer repository update \ ---id _My_ULN_Repository_ID_ \ ---mirroring-policy additive \ ---retain-package-versions-count 1 ----- - -====