Skip to content

Commit

Permalink
Add a Note about base os management and old bootstrap scripts (#3044)
Browse files Browse the repository at this point in the history
* Add a note about base os management and bootstrap scripts
* Only for suma
Co-authored-by: Karl Eichwalder <ke@suse.de>
  • Loading branch information
admd committed May 28, 2024
1 parent 8f1c4ee commit 12c7772
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 3 deletions.
12 changes: 12 additions & 0 deletions modules/client-configuration/pages/registration-bootstrap.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -20,12 +20,14 @@ For more information about creating a bootstrap repository, see xref:client-conf
====

ifeval::[{uyuni-content} == true]

[IMPORTANT]
.GPG Keys and Uyuni Client Tools
====
The GPG key used by Uyuni Client Tools is not trusted by default.
When you create your bootstrap script, add a path to the file containing the public key fingerprint with the [systemitem]``ORG_GPG_KEY`` parameter.
====

endif::[]

[NOTE]
Expand All @@ -35,6 +37,15 @@ Bootstrap scripts based on Python 2 must be re-created for openSUSE Leap 15 an
If you register openSUSE Leap 15 or SLE 15 systems using Python 2, the bootstrap script fails.
====

ifeval::[{suma-content} == true]

[IMPORTANT]
====
After migrating from an older version of {productname} to a newer version, we strongly recommend re-generating the bootstrap scripts before onboarding new systems to prevent any potential issues.
====

endif::[]



[[registering.clients.bootstrap.mgr-bootstrap]]
Expand Down Expand Up @@ -71,6 +82,7 @@ You can use the {productname} {webui} to create an editable bootstrap script.
. The bootstrap script is generated and stored on the server in the [path]``/srv/www/htdocs/pub/bootstrap`` directory.
Alternatively, you can access the bootstrap script over HTTPS.
Replace [literal]``<example.com>`` with the host name of your {productname} Server:
+
----
https://<example.com>/pub/bootstrap/bootstrap.sh
----
Expand Down
17 changes: 14 additions & 3 deletions modules/client-configuration/pages/registration-overview.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,18 @@ Before you begin, check that:

[IMPORTANT]
====
Do not register the {productname} Server to itself.
The {productname} Server must be managed individually or by using another separate {productname} Server.
For more information about using multiple servers, see xref:specialized-guides:large-deployments/hub-multi-server.adoc[].
Do not register the {productname} Server base OS to {productname} itself.
The {productname} Server base OS must be managed individually or by using another separate {productname} Server.
To manage {productname} Server Containers, use the [literal]``mgradm`` tool.
====

ifeval::[{suma-content} == true]

[IMPORTANT]
====
After migrating from an older version of {productname} to a newer version, we strongly recommend re-generating the bootstrap scripts before onboarding new systems to prevent any potential issues.
====

endif::[]

0 comments on commit 12c7772

Please sign in to comment.