Change disconnected upgrade steps (#4164)

(cherry picked from commit 3155b0d)

Author: bangelic

guides/common/modules/proc_upgrading-a-disconnected-project-server.adoc

@@ -44,107 +44,77 @@ This prevents the upgrade process from overwriting your DNS and DHCP configurati
 ----
 # rm /etc/yum.repos.d/*
 ----
-. Obtain the latest ISO files by following the {InstallingServerDisconnectedDocURL}downloading-the-binary-dvd-images_satellite[Downloading the Binary DVD Images] procedure in _{InstallingServerDisconnectedDocTitle}_.
 
-. Create directories to serve as a mount point, mount the ISO images, and configure the `rhel8` repository by following the {InstallingServerDisconnectedDocURL}configuring-the-base-operating-system-with-offline-repositories_satellite[Configuring the base operating system with offline repositories] procedure in _{InstallingServerDisconnectedDocTitle}_.
+. Export the required repositories from your connected {ProjectServer} to your disconnected {ProjectServer}:
+.. Ensure that the following repositories are synchronized on your connected server:
 +
-Do not install or update any packages at this stage.
-
-. Configure the {Project} {ProjectVersion} repository from the ISO file.
-
-.. Copy the ISO file's repository data file for the {ProjectName} packages:
-+
-[options="nowrap"]
-----
-# cp /media/sat6/Satellite/media.repo /etc/yum.repos.d/satellite.repo
-----
-
-.. Edit the `/etc/yum.repos.d/satellite.repo` file:
-+
-----
-# vi /etc/yum.repos.d/satellite.repo
-----
-
-... Change the default `InstallMedia` repository name to `{Project}-{ProjectVersion}`:
+* {RepoRHEL9BaseOS}
+* {RepoRHEL9AppStream}
+* {RepoRHEL9ServerSatelliteServerProjectVersion}
+.. List the repositories to identify their IDs:
 +
-[options="nowrap" subs="+quotes,attributes"]
+[options="nowrap" subs="+quotes"]
 ----
-[{Project}-{ProjectVersion}]
+$ hammer repository list \
+--organization-label _My_Organization_Label_
 ----
-
-... Add the `baseurl` directive:
-+
-[options="nowrap"]
-----
-baseurl=file:///media/sat6/Satellite
-----
-
-. Configure the {ProjectName} Maintenance repository from the ISO file.
-
-.. Copy the ISO file's repository data file for {ProjectName} Maintenance packages:
 +
-[options="nowrap"]
-----
-# cp /media/sat6/Maintenance/media.repo /etc/yum.repos.d/satellite-maintenance.repo
-----
-
-.. Edit the `/etc/yum.repos.d/satellite-maintenance.repo` file:
+Run this command once for each of the three repositories listed above.
+.. Ensure that the repositories are synchronized on your connected server with the download policy set to `immediate`.
+.. Export each repository in a syncable format by using its repository ID:
 +
-[options="nowrap"]
-----
-# vi /etc/yum.repos.d/satellite-maintenance.repo
-----
-
-... Change the default `InstallMedia` repository name to `{Project}-Maintenance`:
-+
-[options="nowrap" subs="+quotes,attributes"]
-----
-[{Project}-Maintenance]
-----
-
-.. Add the `baseurl` directive:
-+
-[options="nowrap"]
+[options="nowrap" subs="+quotes,verbatim,attributes"]
 ----
-baseurl=file:///media/sat6/Maintenance/
+$ hammer content-export complete repository \
+--id=_Repo_ID_ --format=syncable
 ----
+.. Copy the exported directories to the disconnected {ProjectServer}.
 
-ifdef::katello,satellite,orcharhino[]
-. If you use {advisorengine} in your environment, update to the latest images:
-* To update using the {Project} installation ISO image, set up containers on your {ProjectServer}:
+. On the disconnected server, stop all {Project} services:
 +
-[options="nowrap", subs="+quotes,verbatim,attributes"]
-----
-# /media/sat6/containers/setup_containers
-----
-* Alternatively, to update by transferring the latest image from a connected system to a disconnected {ProjectServer}, follow these steps:
-... On the connected system, export the container image:
-+
-[options="nowrap", subs="+quotes,verbatim,attributes"]
-----
-# skopeo copy containers-storage:registry.redhat.io/satellite/iop-advisor-engine-rhel9:{ProjectVersion} \
-oci-archive:/tmp/iop-advisor-engine.tar
+[options="nowrap" subs="+quotes,verbatim,attributes"]
 ----
-... Transfer the `iop-advisor-engine.tar` file to the disconnected {ProjectServer}.
-... On the disconnected {ProjectServer}, import the container image:
-+
-[options="nowrap", subs="+quotes,verbatim,attributes"]
+# {foreman-maintain} service stop
 ----
-# skopeo copy oci-archive:/tmp/iop-advisor-engine.tar \
-containers-storage:registry.redhat.io/satellite/iop-advisor-engine-rhel9:{ProjectVersion}
+. On the disconnected server, enable access to the exported content by configuring a repository:
+.. Identify the location of the copied exported directories from the syncable export on the connected server.
+.. Create the `/etc/yum.repos.d/upgrade.repo` file and update the `baseurl` directive to point to that location:
++
+[source, none, options="nowrap" subs="attributes"]
+----
+[{RepoRHEL9BaseOS}]
+--name=Red Hat Enterprise Linux 9 for x86_64 - BaseOS (RPMs) \
+--metadata_expire=-1 \
+--gpgcheck=0 \
+--cost=500 \
+--baseurl=file:///_Export_Baseos_Location_/content/dist/rhel9/9/x86_64/baseos/os \
+[{RepoRHEL9AppStream}]
+--name=Red Hat Enterprise Linux 9 for x86_64 - AppStream (RPMs) \
+--mediaid=None \
+--metadata_expire=-1 \
+--gpgcheck=0 \
+--cost=500 \
+--baseurl=file:///_Export_Appstream_Location_/content/dist/rhel9/9/x86_64/appstream/os \
+[{Project}]
+--name={Project} \
+--mediaid=None \
+--metadata_expire=-1 \
+--gpgcheck=0 \
+--cost=500 \
+--baseurl=file:///_Export_Location_/content/dist/layered/rhel9/x86_64/{project-context}/{ProjectVersion}/os/
 ----
-endif::[]
 . Upgrade the {foreman-maintain} utility to its latest version:
 +
 [options="nowrap" subs="attributes"]
 ----
-# {foreman-maintain} self-upgrade --maintenance-repo-label {Project}-Maintenance
+# {foreman-maintain} self-upgrade --maintenance-repo-label={Project}
 ----
 . Determine whether your system is ready for {Project} upgrade:
 +
-[options="nowrap" subs="attributes"]
+[options="nowrap" subs="+quotes,verbatim,attributes"]
 ----
-# {foreman-maintain} upgrade check --whitelist="repositories-validate,repositories-setup"
+# {foreman-maintain} upgrade check --whitelist="repositories-validate,repositories-setup" \
+--target-version={ProjectVersion}
 ----
 +
 Review the results and address any highlighted error conditions before performing the upgrade.
@@ -158,9 +128,10 @@ These changes are applied to the `/etc/foreman-maintain/foreman-maintain-hammer.
 Because of the lengthy upgrade time, consider using a utility such as `tmux`.
 For more information, see xref:following_the_progress_of_the_upgrade_upgrading-disconnected[].
 +
-[options="nowrap" subs="attributes"]
+[options="nowrap" subs="+quotes,verbatim,attributes"]
 ----
-# {foreman-maintain} upgrade run --whitelist="repositories-validate,repositories-setup"
+# {foreman-maintain} upgrade run --whitelist="repositories-validate,repositories-setup" \
+--target-version={ProjectVersion}
 ----
 +
 If the script fails due to missing or outdated packages, you must download and install these separately.