Uyuni proxy #10177 ke

modules/installation/nav-installation-guide.adoc

@@ -38,6 +38,7 @@ ifeval::[{suma-content} == true]
 endif::[]
 ifeval::[{uyuni-content} == true]
 *** xref:install-uyuni.adoc[Install Uyuni Server with openSUSE]
+*** xref:install-proxy-uyuni.adoc[Install Uyuni Proxy with openSUSE]
 endif::[]
 // better disabling for now; needs a complete overhaul
 // 2019-06-04, ke :
@@ -51,9 +52,16 @@ ifeval::[{suma-content} == true]
 *** xref:server-setup.adoc[Server Setup]
 endif::[]
 ifeval::[{uyuni-content} == true]
-*** xref:uyuni-server-setup.adoc[Server Setup]
+*** xref:uyuni-server-setup.adoc[Uyuni Server Setup]
 endif::[]
+ifeval::[{suma-content} == true]
 *** xref:proxy-registration.adoc[Proxy Registration]
 *** xref:proxy-setup.adoc[Proxy Setup]
+endif::[]
+ifeval::[{uyuni-content} == true]
+*** xref:uyuni-proxy-registration.adoc[Uyuni Proxy Registration]
+*** xref:uyuni-proxy-setup.adoc[Uyuni Proxy Setup]
+endif::[]
+
 *** xref:pubcloud-setup.adoc[Public Cloud Setup]
 *** xref:setup-wizard.adoc[Setup Wizard]

modules/installation/pages/install-proxy-uyuni.adoc

@@ -0,0 +1,51 @@
+[[install-proxy-uyuni]]
+= Install {productname} Proxy with {opensuse}
+
+{productname} Proxy can be installed on {opensuse}.
+
+
+
+== Install {productname} Proxy on {opensuse} Leap 15.1
+
+.Procedure: Installing {opensuse} Leap 15.1 with Uyuni
+
+. Install {opensuse} Leap 15.1 and apply all package updates available.
+
+. Configure a resolvable fully qualified domain name (FQDN) with menu:yast[System > Network Settings > Hostname/DNS].
+
+. Add the repository with the {productname} Proxy software.
+As [systemitem]``root`` enter:
++
+
+// variable assignment to avoid overlong lines
+// https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Proxy-4.0-POOL-x86_64-Media1/
++
+----
+repo=repositories/systemsmanagement:/
+repo=${repo}Uyuni:/Stable/images/repo/Uyuni-Proxy-4.0-POOL-x86_64-Media1/
+zypper ar https://download.opensuse.org/$repo uyuni-proxy-stable
+----
+
+. Refresh metadata from the repositories.
+As [systemitem]``root`` enter:
++
+
+----
+zypper ref
+----
+
+. Install the pattern for the {productname} Proxy:
+As [systemitem]``root`` enter:
++
+
+----
+zypper in patterns-uyuni_proxy
+----
+
+. Reboot the {productname} Proxy.
+
+* For more information about the stable version of {productname}, see https://www.uyuni-project.org/pages/stable-version.html.
+* For more information about the development version of {productname}, see https://www.uyuni-project.org/pages/devel-version.html.
+
+When the installation is complete, you can continue with {productname} setup.
+For more information, see xref:installation:uyuni-proxy-registration.adoc[].

modules/installation/pages/proxy-setup.adoc

@@ -208,6 +208,7 @@ filename: "pxelinux.0"
 
 
 // REMARK: 2019-08-23, ke: this needs closer checking
+// see https://github.com/SUSE/spacewalk/issues/10521
 [[replacing.a.susemgrproxy]]
 == Replace a {susemgrproxy}
 

modules/installation/pages/uyuni-proxy-registration.adoc

@@ -0,0 +1,66 @@
+[[proxy-register]]
+= Proxy Registration
+
+Proxy systems are registered as Salt clients using a bootstrap script.
+
+This procedure describes software channel setup and registering the installed proxy with an activation key as a {productname} client.
+
+[IMPORTANT]
+====
+Before you can select the correct child channels while creating the activation key, ensure you have created an {productname} Proxy 4 channel with all needed repositories properly synchronized.
+====
+
+[[proxy-register-procedure]]
+.Procedure: Registering the Proxy
+
+. Create an activation key based on your {productname} Proxy 4 channel.
+For more information about activation keys, see xref:client-configuration:clients-and-activation-keys.adoc[Creating Activation Key].
++
+
+// .Proxy Activation Key
+// image::proxy-key.png[]
++
+////
+. From the [guimenu]``Child Channels`` listing select the recommended
+channels by clicking the ``include recommended`` icon:
++
+* SLE-Module-Basesystem15-SP1-Pool
+* SLE-Module-Basesystem15-SP1-Updates
+* SLE-Module-Server-Applications15-SP1-Pool
+* SLE-Module-Server-Applications15-SP1-Updates
+* SLE-Module-SUSE-Manager-Proxy-4.0-Pool
+* SLE-Module-SUSE-Manager-Proxy-4.0-Updates
++
+The [systemitem]``SLE-Product-SUSE-Manager-Proxy-4.0-Updates`` channel is mandatory.
++
+
+// .Base and Child Proxy Channel
+// image::proxy-child.png[]
+////
+
+. OPTIONAL: Modify a bootstrap script for the proxy.
+If you want to run the proxy on a traditional client (system type ``Management``) uncheck [guimenu]``Bootstrap using Salt``.
+Using Salt is the default.
+// What's up with:
+// Enable Remote Configuration
+// Enable Remote Commands
+For more information about bootstrap scripts, see
+xref:client-configuration:registration-bootstrap.adoc[].
++
+
+// .Modifying Bootstrap Script
+// image::proxy-bootstrap.png[]
+
+. Create the SUSE Manager Tools Repository for bootstrapping, see xref:client-configuration:creating-a-tools-repository.adoc[Create Tools Repository].
+. Bootstrap the client using the script.
+For more information, see xref:client-configuration:registration-bootstrap.adoc[].
+. For Salt clients, navigate to menu:Salt[Keys] and accept the key.
+When the key is accepted, it will show in menu:Systems[Overview].
+. Navigate to menu:System Details[Software > Software Channels], and check that your proxy channel is selected.
+// [systemitem]``SLE-PRODUCT-Pool`` must be the base channel and the others are child channels.
++
+
+// .Proxy Channels
+// image::sles15-proxy-channels.png[]
+
+For more on setting up a registered {productname} Proxy, see xref:uyuni-proxy-setup.adoc[].