Skip to content

Commit d71a543

Browse files
Lennonkavsedmik
Lennonka
and
vsedmik
authored
Use ISS export for disconnected Updating (#4438)
Co-authored-by: Vladimir Sedmik <[email protected]>
1 parent 7eac206 commit d71a543

7 files changed

+120
-167
lines changed

‎guides/common/assembly_updating-satellite.adoc‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,10 @@ include::modules/proc_updating-server.adoc[]
44

55
include::modules/proc_updating-disconnected-server.adoc[]
66

7-
include::modules/proc_preparing-the-repositories-for-export.adoc[leveloffset=+1]
7+
include::modules/proc_exporting-repositories-from-the-connected-project-server.adoc[leveloffset=+1]
88

9-
include::modules/proc_updating-the-disconnected-project.adoc[leveloffset=+1]
9+
include::modules/proc_preparing-repositories-on-the-disconnected-project-server.adoc[leveloffset=+1]
10+
11+
include::modules/proc_performing-the-update-of-the-disconnected-project-server.adoc[leveloffset=+1]
1012

1113
include::modules/proc_updating-smart-proxy.adoc[]

‎guides/common/modules/proc_exporting-repositories-from-the-connected-project-server.adoc‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
:_mod-docs-content-type: PROCEDURE
2+
3+
[id="exporting-repositories-from-the-connected-{project-context}-server"]
4+
= Exporting repositories from the connected {ProjectServer}
5+
6+
[role="_abstract"]
7+
Export the required repositories on the connected {ProjectServer} to transfer to the disconnected {ProjectServer}.
8+
9+
.Procedure
10+
. Synchronize the following repositories on your connected {ProjectServer}:
11+
+
12+
* `{RepoRHEL9BaseOS}`
13+
* `{RepoRHEL9AppStream}`
14+
* `{RepoRHEL9ServerSatelliteServerProjectVersion}`
15+
* `{RepoRHEL9ServerSatelliteMaintenanceProjectVersion}`
16+
17+
+
18+
Ensure to set the download policy to *Immediate* for each repository.
19+
. List the repositories to identify their IDs:
20+
+
21+
[options="nowrap" subs="+quotes,verbatim,attributes"]
22+
----
23+
$ hammer repository list \
24+
--organization-label _My_Organization_Label_
25+
----
26+
. Export each repository in the syncable format:
27+
+
28+
[options="nowrap" subs="+quotes,verbatim,attributes"]
29+
----
30+
$ hammer content-export complete repository \
31+
--format syncable \
32+
--id _My_Repository_ID_
33+
----
34+
. Transfer the exported directories to your disconnected {ProjectServer}.

‎guides/common/modules/proc_performing-the-update-of-the-disconnected-project-server.adoc‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
:_mod-docs-content-type: PROCEDURE
2+
3+
[id="performing-the-update-of-the-disconnected-{project-context}-server"]
4+
= Performing the update of the disconnected {ProjectServer}
5+
6+
[role="_abstract"]
7+
Evaluate that the system is ready for update and perform the update of the disconnected {ProjectServer}.
8+
Your {ProjectServer} does not require internet access to perform the update.
9+
10+
.Prerequisites
11+
* You have prepared the required repositories on the disconnected {ProjectServer}.
12+
13+
.Procedure
14+
. Evaluate that the system is ready for update:
15+
+
16+
[options="nowrap" subs="+quotes,verbatim,attributes"]
17+
----
18+
# {foreman-maintain} update check --whitelist="repositories-validate,repositories-setup"
19+
----
20+
+
21+
The first time you run this command, `{foreman-maintain}` prompts you to enter the Hammer admin user credentials and saves them to `/etc/foreman-maintain/foreman-maintain-hammer.yml`.
22+
. Review the results and resolve any errors before proceeding with the update.
23+
. Due to the lengthy update time, use a utility such as `tmux` to suspend and resume the session as needed.
24+
By using such utility, you can monitor progress without maintaining a continuous connection to the command shell.
25+
+
26+
If you lose connection to the command shell where the update command is running, check the `{installer-log-file}` file to confirm whether the process completed successfully.
27+
. Perform the update:
28+
+
29+
[options="nowrap" subs="+quotes,verbatim,attributes"]
30+
----
31+
# {foreman-maintain} update run --whitelist="repositories-validate,repositories-setup"
32+
----
33+
include::snip_steps-needs-reboot.adoc[]
34+
35+
.Additional resources
36+
* {AdministeringDocURL}Restoring_from_a_Full_Backup_admin[Restoring {ProjectServer} or {SmartProxyServer} from a backup]

‎guides/common/modules/proc_preparing-repositories-on-the-disconnected-project-server.adoc‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
:_mod-docs-content-type: PROCEDURE
2+
3+
[id="preparing-repositories-on-the-disconnected-{project-context}-server"]
4+
= Preparing repositories on the disconnected {ProjectServer}
5+
6+
[role="_abstract"]
7+
Create local repositories on your disconnected {ProjectServer}.
8+
9+
.Prerequisites
10+
* You have transferred the exported directories to your disconnected {ProjectServer}.
11+
12+
.Procedure
13+
. Locate the transferred exported directories.
14+
. Create the `/etc/yum.repos.d/update.repo` file and update the `baseurl` values to point to the local file system:
15+
+
16+
[source, ini, options="nowrap" subs="+quotes,verbatim,attributes"]
17+
----
18+
[{RepoRHEL9BaseOS}]
19+
name=Red Hat Enterprise Linux 9 for x86_64 - BaseOS (RPMs)
20+
enabled=1
21+
metadata_expire=-1
22+
gpgcheck=0
23+
baseurl=file:///_BaseOS_Export_Location_/content/dist/rhel9/9/x86_64/baseos/os
24+
25+
[{RepoRHEL9AppStream}]
26+
name=Red Hat Enterprise Linux 9 for x86_64 - AppStream (RPMs)
27+
enabled=1
28+
metadata_expire=-1
29+
gpgcheck=0
30+
baseurl=file:///_AppStream_Export_Location_/content/dist/rhel9/9/x86_64/appstream/os
31+
32+
[{RepoRHEL9ServerSatelliteServerProjectVersion}]
33+
name={ProjectName} {ProjectVersion} for RHEL 9 Server RPMs x86_64
34+
enabled=1
35+
metadata_expire=-1
36+
gpgcheck=0
37+
baseurl=file:///_{Project}_Export_Location_/content/dist/layered/rhel9/x86_64/satellite/{ProjectVersion}/os/
38+
39+
[{RepoRHEL9ServerSatelliteMaintenanceProjectVersion}]
40+
name={ProjectName} Maintenance {ProjectVersion} for RHEL 9 Server RPMs x86_64
41+
enabled=1
42+
metadata_expire=-1
43+
gpgcheck=0
44+
baseurl=file:///_{Project}_Maintenance_Export_Location_/content/dist/layered/rhel9/x86_64/sat-maintenance/{ProjectVersion}/os/
45+
----

‎guides/common/modules/proc_preparing-the-repositories-for-export.adoc‎

Lines changed: 0 additions & 91 deletions
This file was deleted.

‎guides/common/modules/proc_updating-disconnected-server.adoc‎

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,5 @@ Update your air-gapped {Project} setup where the connected {ProjectServer}, whic
88
You can follow this process to update the underlying operating system between minor release versions.
99

1010
.Prerequisites
11-
* Back up your {ProjectServer}.
11+
* Back up your disconnected {ProjectServer}.
1212
For more information, see {AdministeringDocURL}backing-up-{project-context}-server-and-{smart-proxy-context}_admin[Backing Up {ProjectServer} and {SmartProxyServer}] in _{AdministeringDocTitle}_.
13-
* Install `reposync` that is required for the updating procedure:
14-
+
15-
[options="nowrap" subs="attributes"]
16-
----
17-
# dnf install 'dnf-command(reposync)'
18-
----

‎guides/common/modules/proc_updating-the-disconnected-project.adoc‎

Lines changed: 0 additions & 67 deletions
This file was deleted.

0 commit comments

Comments
 (0)