Extending proxy conversion instructions #4174

0rnela · 2025-07-15T15:55:22Z

Description

Additional clarifications for the proxy conversion from client process which covers new sub-tab Configuration.

Target branches

master

Links

This PR tracks https://bugzilla.suse.com/show_bug.cgi?id=1246352

0rnela · 2025-07-16T15:10:42Z

The file can be checked here:
Proxy conversion from client __ SUSE Multi-Linux Manager 5.1 Documentation.pdf

modules/installation-and-upgrade/pages/container-deployment/proxy-conversion-from-client.adoc

…oxy-conversion-from-client.adoc Co-authored-by: Karl Eichwalder <ke@suse.de>

0rnela · 2025-07-17T14:01:32Z

Following the feedback, this is the final version:

ProxyConfig.pdf

modules/installation-and-upgrade/pages/container-deployment/proxy-conversion-from-client.adoc

alichiel · 2025-07-17T14:37:49Z

Following the feedback, this is the final version:

ProxyConfig.pdf

I have a couple of additional comments that as being an admin using the doc, I'd like to be more clear about. Feel free to consider/not to consider them :)

"Configure the Proxy" section:
"2. In the Parent FQDN field type fully qualified domain name for the parent." - What is the "parent" or why it's there? For more info, FQDN should be the machine's "name" address that is mentioned in the server certificate as well. So something like the "fully qualified domain name of the proxy host" should work.
"4. In the Max Squid cache size [MB] field type maximal allowed size for Squid cache." - Also here documenting what is written there but how this would help admin to understand more? Should there be a link for Squid cache use or 1 more sentence to explain or recommend the value?
"5. In the Proxy admin email field type the admin’s email." - Stating what's in the field. If it needs explanation, should be the admin of MLM, or proxy, or admin general?

modules/installation-and-upgrade/pages/container-deployment/proxy-conversion-from-client.adoc

rjpmestre · 2025-07-23T17:58:09Z

modules/installation-and-upgrade/pages/container-deployment/proxy-conversion-from-client.adoc

+** For more information about certificate creation, see xref:administration:ssl-certs.adoc[].
+. In the section [literal]``Source`` select one of two options: [literal]``RPM`` or [literal]``Registry``.
+
+. Option [literal]``RPM`` is recommended for air-gapped or restricted environments.


That should be already covered in the requisites to convert to a proxy actually, bc they'd also required to have access to mgrpxy and podman

rjpmestre · 2025-07-23T21:21:46Z

modules/installation-and-upgrade/pages/container-deployment/proxy-conversion-from-client.adoc

+** For more information about certificate creation, see xref:administration:ssl-certs.adoc[].
+. In the section [literal]``Source`` select one of two options: [literal]``RPM`` or [literal]``Registry``.
+
+. Option [literal]``RPM`` is recommended for air-gapped or restricted environments.


Well, just noticed that the alternative install methods do explicitly mention the bootstrapping and channel setup. In that case suggest reviewing then what I documented @ https://confluence.suse.com/display/~RMestre/Proxy+Onboarding

Overview

Currently, setting up a proxy involves the following steps:

Onboard minion;

Configure channels;

Generate proxy configuration file;

Transfer proxy configuration file into the minion;

Install software into minion (podman and mgrpxy);

Execute mgrpxy install;

For this initial feature iteration, our goal is to streamline the process defined by steps 3, 4, 5 & 6. We will archive this by extending the existing web UI functionality (Systems > Proxy Configuration). Once the user fills in the necessary information in a form, the system will automatically set up (or update) the minion as a proxy with minimal manual intervention.

bearing in mind that step 2 "Configure channels" could be read as "add and sync the proxy extension child channel." and after this you would be able to install the packages as well.

Bischoff

Introduction might be made clearer, see suggestion.

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc

...llation-and-upgrade/pages/container-deployment/uyuni/proxy-conversion-from-client-uyuni.adoc

keichwa

cosmetic suggestion

...llation-and-upgrade/pages/container-deployment/uyuni/proxy-conversion-from-client-uyuni.adoc

…uni/proxy-conversion-from-client-uyuni.adoc Co-authored-by: Karl Eichwalder <ke@suse.de>

Bischoff

thanks for the changes @0rnela

rjmateus

I didn't fully review yet, but why do we have 2 sepparated pages for uyuni and MLM? The content really similar, with just a few deviations.
Can that be handled with the ifeval::[{mlm-content} == true]

0rnela · 2025-07-24T11:29:47Z

I didn't fully review yet, but why do we have 2 sepparated pages for uyuni and MLM? The content really similar, with just a few deviations. Can that be handled with the ifeval::[{mlm-content} == true]

All other pages in this section are separated for MLM and Uyuni.
But, they are very similar, you are correct.

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc

...llation-and-upgrade/pages/container-deployment/uyuni/proxy-conversion-from-client-uyuni.adoc

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc

...llation-and-upgrade/pages/container-deployment/uyuni/proxy-conversion-from-client-uyuni.adoc

…m/proxy-conversion-from-client-mlm.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

…uni/proxy-conversion-from-client-uyuni.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

…m/proxy-conversion-from-client-mlm.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

…uni/proxy-conversion-from-client-uyuni.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

…m/proxy-conversion-from-client-mlm.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc

0rnela · 2025-07-24T16:40:39Z

I have incorporated all comments.
These are the the current (final) versions:

nodeg

I left some suggestions and nit-picks.

nodeg · 2025-07-25T12:58:06Z

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc

+. In the [guimenu]``Max Squid cache size [MB]`` field type maximal allowed size for Squid cache.
+. In the [guimenu]``Proxy admin email`` field type the administrator's email.
+. In the section [literal]``Certificates`` select one of two options: [literal]``Keep`` or [literal]``Replace``.
+* Select [literal]``Keep`` if an existing certificates should be used. 


Suggested change

* Select [literal]``Keep`` if an existing certificates should be used.

* Select [literal]``Keep`` if an existing certificate should be used.

nodeg · 2025-07-25T12:58:51Z

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc

+
+The certificate can be replaced by one of the two options:
+
+** an existing certificate, provided by the third-party authority


Suggested change

** an existing certificate, provided by the third-party authority

** an existing certificate, provided by a third-party authority

nodeg · 2025-07-25T12:59:03Z

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc

+The certificate can be replaced by one of the two options:
+
+** an existing certificate, provided by the third-party authority
+** a brand new certificate generated from the existing {productname} CA certificate for the proxy, by using command [command]``rhn-ssl-tool``


Suggested change

** a brand new certificate generated from the existing {productname} CA certificate for the proxy, by using command [command]``rhn-ssl-tool``

** a brand new certificate generated from the existing {productname} CA certificate for the proxy, by using the command [command]``rhn-ssl-tool``

nodeg · 2025-07-25T13:00:12Z

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc

+
+. Option [literal]``Registry`` can be used if connectivity is available.
+
+For more information about deployment in air-gapped environment, see  xref:installation-and-upgrade:container-deployment/mlm/proxy-air-gapped-deployment-mlm.adoc[].


Suggested change

For more information about deployment in air-gapped environment, see xref:installation-and-upgrade:container-deployment/mlm/proxy-air-gapped-deployment-mlm.adoc[].

For more information about deployment in air-gapped environment, see xref:installation-and-upgrade:container-deployment/mlm/proxy-air-gapped-deployment-mlm.adoc[].

Once space too much.

nodeg · 2025-07-25T13:00:59Z

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc

+* For [literal]``Registry URL`` use [literal]``registry.suse.com/suse/multi-linux-manager/5.1/x86_64``.
+* Select the tag from the drop-down list.
+
+. If the option selected is [literal]``Advanced`` additional section of the form opens.


Suggested change

. If the option selected is [literal]``Advanced`` additional section of the form opens.

. If the option selected is [literal]``Advanced``, an additional section of the form opens.

0rnela added 8 commits July 15, 2025 17:52

Extending proxy conversion instructions.

4d3f90d

Cont.

948ffbe

Cont.

2e0496c

Cont.

338e59c

Link added.

c2ec4bb

Further changes.

5888e22

Added procedure header.

12f0f42

Further changes and clarifications following the feedback.

6fe9b30

0rnela requested a review from keichwa July 16, 2025 15:08

0rnela assigned jcayouette Jul 16, 2025

0rnela requested review from rjpmestre, cbosdo and srbarrios July 16, 2025 15:08

0rnela assigned 0rnela and unassigned jcayouette Jul 16, 2025

0rnela marked this pull request as ready for review July 16, 2025 15:11

0rnela requested a review from jcayouette July 16, 2025 15:11

srbarrios reviewed Jul 17, 2025

View reviewed changes

modules/installation-and-upgrade/pages/container-deployment/proxy-conversion-from-client.adoc Outdated Show resolved Hide resolved

keichwa requested changes Jul 17, 2025

View reviewed changes

0rnela and others added 2 commits July 17, 2025 15:44

Changed list type.

8cf97a8

Update modules/installation-and-upgrade/pages/container-deployment/pr…

d6a5fc2

…oxy-conversion-from-client.adoc Co-authored-by: Karl Eichwalder <ke@suse.de>

0rnela requested review from keichwa, Pablogoliva and srbarrios July 17, 2025 13:55

Cont.

7be1adb

Pablogoliva reviewed Jul 17, 2025

View reviewed changes

modules/installation-and-upgrade/pages/container-deployment/proxy-conversion-from-client.adoc Outdated Show resolved Hide resolved

Pablogoliva reviewed Jul 17, 2025

View reviewed changes

modules/installation-and-upgrade/pages/container-deployment/proxy-conversion-from-client.adoc Outdated Show resolved Hide resolved

0rnela requested a review from Pablogoliva July 24, 2025 07:03

0rnela marked this pull request as ready for review July 24, 2025 07:05

Pablogoliva approved these changes Jul 24, 2025

View reviewed changes

rjpmestre approved these changes Jul 24, 2025

View reviewed changes

Bischoff suggested changes Jul 24, 2025

View reviewed changes

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc Outdated Show resolved Hide resolved

...llation-and-upgrade/pages/container-deployment/uyuni/proxy-conversion-from-client-uyuni.adoc Outdated Show resolved Hide resolved

Cont.

9821a67

keichwa approved these changes Jul 24, 2025

View reviewed changes

...llation-and-upgrade/pages/container-deployment/uyuni/proxy-conversion-from-client-uyuni.adoc Outdated Show resolved Hide resolved

0rnela requested a review from aaannz July 24, 2025 10:51

Update modules/installation-and-upgrade/pages/container-deployment/uy…

9c04bef

…uni/proxy-conversion-from-client-uyuni.adoc Co-authored-by: Karl Eichwalder <ke@suse.de>

Bischoff approved these changes Jul 24, 2025

View reviewed changes

rjmateus reviewed Jul 24, 2025

View reviewed changes

cbosdo requested changes Jul 24, 2025

View reviewed changes

cbosdo reviewed Jul 24, 2025

View reviewed changes

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc Outdated Show resolved Hide resolved

...llation-and-upgrade/pages/container-deployment/uyuni/proxy-conversion-from-client-uyuni.adoc Outdated Show resolved Hide resolved

0rnela and others added 7 commits July 24, 2025 15:29

Update modules/installation-and-upgrade/pages/container-deployment/ml…

cdd796c

…m/proxy-conversion-from-client-mlm.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

Update modules/installation-and-upgrade/pages/container-deployment/uy…

faaff15

…uni/proxy-conversion-from-client-uyuni.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

Update modules/installation-and-upgrade/pages/container-deployment/uy…

d6029ee

…uni/proxy-conversion-from-client-uyuni.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

Update modules/installation-and-upgrade/pages/container-deployment/ml…

bb2591c

…m/proxy-conversion-from-client-mlm.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

Update modules/installation-and-upgrade/pages/container-deployment/uy…

89c8b00

…uni/proxy-conversion-from-client-uyuni.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

Update modules/installation-and-upgrade/pages/container-deployment/ml…

29201ba

…m/proxy-conversion-from-client-mlm.adoc Co-authored-by: Cedric Bosdonnat <cbosdonnat@suse.com>

Further fixes following the feedback.

7a8e869

0rnela requested a review from cbosdo July 24, 2025 13:44

rjmateus suggested changes Jul 24, 2025

View reviewed changes

0rnela added 2 commits July 24, 2025 15:48

Cont.

4980c18

Cont.

8629eba

cbosdo reviewed Jul 24, 2025

View reviewed changes

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc Outdated Show resolved Hide resolved

...nstallation-and-upgrade/pages/container-deployment/mlm/proxy-conversion-from-client-mlm.adoc Show resolved Hide resolved

More changes following the review.

819b59c

0rnela requested a review from cbosdo July 24, 2025 16:37

nodeg reviewed Jul 25, 2025

View reviewed changes

	* Select [literal]``Keep`` if an existing certificates should be used.
	* Select [literal]``Keep`` if an existing certificate should be used.

	** an existing certificate, provided by the third-party authority
	** an existing certificate, provided by a third-party authority

	** a brand new certificate generated from the existing {productname} CA certificate for the proxy, by using command [command]``rhn-ssl-tool``
	** a brand new certificate generated from the existing {productname} CA certificate for the proxy, by using the command [command]``rhn-ssl-tool``

	For more information about deployment in air-gapped environment, see xref:installation-and-upgrade:container-deployment/mlm/proxy-air-gapped-deployment-mlm.adoc[].
	For more information about deployment in air-gapped environment, see xref:installation-and-upgrade:container-deployment/mlm/proxy-air-gapped-deployment-mlm.adoc[].

	. If the option selected is [literal]``Advanced`` additional section of the form opens.
	. If the option selected is [literal]``Advanced``, an additional section of the form opens.

Extending proxy conversion instructions #4174

Are you sure you want to change the base?

Extending proxy conversion instructions #4174

Uh oh!

Conversation

0rnela commented Jul 15, 2025

Description

Target branches

Links

Uh oh!

0rnela commented Jul 16, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

0rnela commented Jul 17, 2025

Uh oh!

Uh oh!

Uh oh!

alichiel commented Jul 17, 2025

Uh oh!

Uh oh!

rjpmestre Jul 23, 2025

Choose a reason for hiding this comment

Uh oh!

rjpmestre Jul 23, 2025

Choose a reason for hiding this comment

Overview

Uh oh!

Bischoff left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

keichwa left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Bischoff left a comment

Choose a reason for hiding this comment

Uh oh!

rjmateus left a comment

Choose a reason for hiding this comment

Uh oh!

0rnela commented Jul 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

0rnela commented Jul 24, 2025

Uh oh!

nodeg left a comment

Choose a reason for hiding this comment

Uh oh!

nodeg Jul 25, 2025

Choose a reason for hiding this comment

Uh oh!

nodeg Jul 25, 2025

Choose a reason for hiding this comment

Uh oh!

nodeg Jul 25, 2025

Choose a reason for hiding this comment

Uh oh!

nodeg Jul 25, 2025

0rnela commented Jul 24, 2025 •

edited

Loading