Skip to content

Split Registering hosts into multiple assemblies #4793

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
aneta-petrova merged 22 commits into from
May 4, 2026
Merged

Split Registering hosts into multiple assemblies #4793

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
f1865bc
Point registering hosts docs to Puppet guide for OpenVox agent
aneta-petrova Apr 27, 2026
4ef02ae
Split registering hosts assembly by user story
aneta-petrova Apr 27, 2026
cbe00fb
Use leveloffset +1 for bootstrap script assembly includes
aneta-petrova Apr 27, 2026
c872f18
Split JWT invalidation into its own registering-hosts assembly
aneta-petrova Apr 27, 2026
a43d860
Include Ansible-during-registration procedure in global registration …
aneta-petrova Apr 27, 2026
fc1cbeb
Add assembly for setting up host integration after registration
aneta-petrova Apr 27, 2026
30d5261
Rename assembly
aneta-petrova Apr 27, 2026
ec65bde
Replace host registration methods reference with concept modules
aneta-petrova Apr 27, 2026
bbcae97
Additional tweaks
aneta-petrova Apr 27, 2026
22f608c
Adjust registration assembly IDs
aneta-petrova Apr 27, 2026
a86acc5
Apply suggestions from code review
aneta-petrova Apr 28, 2026
cbd1b33
Update registering hosts ID
aneta-petrova Apr 28, 2026
e091667
Update setting up host integration ID
aneta-petrova Apr 28, 2026
133a45c
Update assembly file name
aneta-petrova Apr 28, 2026
ee6001f
Flatten assemblies
aneta-petrova Apr 28, 2026
9c6eb11
Update host integration introduction
aneta-petrova Apr 28, 2026
09485c3
Apply suggestion from @Lennonka
aneta-petrova Apr 29, 2026
3a167bb
Fix build error
aneta-petrova May 4, 2026
f624968
Move host integration content to dedicated assemblies
aneta-petrova May 4, 2026
8a32d01
Fix leveloffset for host integration assemblies
aneta-petrova May 4, 2026
f42f4ea
Apply suggestions from code review
aneta-petrova May 4, 2026
31ff471
Remove unused module
aneta-petrova May 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
0 ...-self-signed-ca-certificate-on-hosts.adoc → ...-self-signed-ca-certificate-on-hosts.adoc
View file
Open in desktop
File renamed without changes.
72 changes: 28 additions & 44 deletions ...es/common/assembly_registering-hosts.adoc → ...ssembly_registering-hosts-to-project.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,14 +1,10 @@
:_mod-docs-content-type: ASSEMBLY

include::modules/con_registering-hosts-and-setting-up-host-integration.adoc[]
include::modules/con_registering-hosts-to-project.adoc[]

include::modules/ref_supported-clients-in-registration.adoc[leveloffset=+1]

ifdef::satellite,orcharhino[]
include::modules/ref_host-registration-methods.adoc[leveloffset=+1]
endif::[]

// Global registration
// Registering hosts by using global registration
include::modules/con_registering-hosts-by-using-global-registration.adoc[leveloffset=+1]

include::modules/ref_global-parameters-for-registration.adoc[leveloffset=+2]
Expand All @@ -27,68 +23,56 @@ include::modules/proc_running-custom-code-during-host-registration.adoc[leveloff

include::modules/proc_customizing-the-registration-templates.adoc[leveloffset=+2]

include::modules/con_invalidating-registration-tokens.adoc[leveloffset=+2]
include::modules/proc_running-ansible-roles-during-host-registration.adoc[leveloffset=+2]

//Invalidating registration tokens
include::modules/con_invalidating-registration-tokens.adoc[leveloffset=+1]

include::modules/proc_invalidating-your-own-jwts-by-using-web-ui.adoc[leveloffset=+3]
include::modules/proc_invalidating-your-own-jwts-by-using-web-ui.adoc[leveloffset=+2]

include::modules/proc_invalidating-your-own-jwts-by-using-cli.adoc[leveloffset=+3]
include::modules/proc_invalidating-your-own-jwts-by-using-cli.adoc[leveloffset=+2]

include::modules/proc_invalidating-your-own-jwts-by-using-api.adoc[leveloffset=+3]
include::modules/proc_invalidating-your-own-jwts-by-using-api.adoc[leveloffset=+2]

include::modules/proc_invalidating-jwts-of-other-users-by-using-web-ui.adoc[leveloffset=+3]
include::modules/proc_invalidating-jwts-of-other-users-by-using-web-ui.adoc[leveloffset=+2]

include::modules/proc_invalidating-jwts-of-other-users-by-using-cli.adoc[leveloffset=+3]
include::modules/proc_invalidating-jwts-of-other-users-by-using-cli.adoc[leveloffset=+2]

include::modules/proc_invalidating-jwts-of-other-users-by-using-api.adoc[leveloffset=+3]
include::modules/proc_invalidating-jwts-of-other-users-by-using-api.adoc[leveloffset=+2]

include::modules/proc_invalidating-jwts-of-all-users.adoc[leveloffset=+3]
include::modules/proc_invalidating-jwts-of-all-users.adoc[leveloffset=+2]

ifdef::satellite[]
// Bootstrap script
include::modules/proc_registering-hosts-by-using-the-bootstrap-script.adoc[leveloffset=+1]
// Registering hosts by using the bootstrap script
include::modules/con_registering-hosts-by-using-the-bootstrap-script.adoc[leveloffset=+1]

include::modules/proc_creating-a-puppet-environment-for-bootstrap-registration.adoc[leveloffset=+1]
include::modules/proc_registering-hosts-by-using-the-bootstrap-script.adoc[leveloffset=+2]

include::modules/proc_creating-a-puppet-environment-for-bootstrap-registration.adoc[leveloffset=+2]

include::modules/proc_setting-permissions-for-the-bootstrap-script-by-using-web-ui.adoc[leveloffset=+2]

include::modules/proc_setting-permissions-for-the-bootstrap-script-by-using-cli.adoc[leveloffset=+2]

include::modules/ref_advanced-bootstrap-script-configuration.adoc[leveloffset=+2]

include::modules/proc_migrating-a-host-from-one-server-to-another-server.adoc[leveloffset=+3]

include::modules/proc_migrating-a-host-from-red-hat-network.adoc[leveloffset=+3]
include::modules/proc_migrating-a-host-from-one-server-to-another-server.adoc[leveloffset=+2]

include::modules/proc_registering-a-host-without-puppet.adoc[leveloffset=+3]
include::modules/proc_migrating-a-host-from-red-hat-network.adoc[leveloffset=+2]

include::modules/proc_registering-a-host-for-content-management-only.adoc[leveloffset=+3]
include::modules/proc_registering-a-host-without-puppet.adoc[leveloffset=+2]

include::modules/proc_changing-the-method-the-bootstrap-script-uses-to-download-the-consumer-rpm.adoc[leveloffset=+3]

include::modules/proc_providing-the-hosts-ip-address.adoc[leveloffset=+3]

include::modules/proc_enabling-remote-execution-on-the-host.adoc[leveloffset=+3]

include::modules/proc_creating-a-domain-for-a-host-during-registration.adoc[leveloffset=+3]

include::modules/proc_providing-an-alternative-fqdn-for-the-host.adoc[leveloffset=+3]
endif::[]
include::modules/proc_registering-a-host-for-content-management-only.adoc[leveloffset=+2]

// Host tools
include::modules/proc_configuring-openvox-agent-on-a-host-during-registration.adoc[leveloffset=+1]
include::modules/proc_changing-the-method-the-bootstrap-script-uses-to-download-the-consumer-rpm.adoc[leveloffset=+2]

include::modules/proc_configuring-openvox-agent-on-a-host-manually.adoc[leveloffset=+1]
include::modules/proc_providing-the-hosts-ip-address.adoc[leveloffset=+2]

include::modules/proc_running-ansible-roles-during-host-registration.adoc[leveloffset=+1]
include::modules/proc_enabling-remote-execution-on-the-host.adoc[leveloffset=+2]

// the workflow is technically required for Foreman + OpenSCAP/REX Pull Mode
// but the current docs reference "FQDN/pub/" which is Katello-only
ifdef::katello,orcharhino,satellite[]
include::modules/con_using-custom-ssl-certificate-for-hosts.adoc[leveloffset=+1]
include::modules/proc_creating-a-domain-for-a-host-during-registration.adoc[leveloffset=+2]

:common-example-com: {foreman-example-com}
include::modules/proc_deploying-a-custom-ssl-certificate-to-hosts.adoc[leveloffset=+2]
:!common-example-com:
include::modules/proc_providing-an-alternative-fqdn-for-the-host.adoc[leveloffset=+2]

include::modules/ref_resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-hosts.adoc[leveloffset=+1]
include::modules/con_katello-ca-consumer-rpm-and-rhsm-consumer-script.adoc[leveloffset=+1]
endif::[]
2 changes: 1 addition & 1 deletion ...er-and-application-restarts-on-hosts.adoc → ...applications-on-hosts-through-tracer.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_mod-docs-content-type: ASSEMBLY

include::modules/con_configuring-tracer-and-application-restarts-on-hosts.adoc[]
include::modules/con_restarting-applications-on-hosts-through-tracer.adoc[]

include::modules/proc_configuring-tracer-on-a-host.adoc[leveloffset=+1]

Expand Down
9 changes: 9 additions & 0 deletions guides/common/assembly_using-custom-ssl-certificate-for-hosts.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
:_mod-docs-content-type: ASSEMBLY

Check warning on line 1 in guides/common/assembly_using-custom-ssl-certificate-for-hosts.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.

Raw Output:
{"message": "[AsciiDocDITA.DocumentTitle] The document title (a level 0 heading) is missing.", "location": {"path": "guides/common/assembly_using-custom-ssl-certificate-for-hosts.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

Check warning on line 1 in guides/common/assembly_using-custom-ssl-certificate-for-hosts.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ShortDescription] Assign [role="_abstract"] to a paragraph to use it as <shortdesc> in DITA.

Raw Output:
{"message": "[AsciiDocDITA.ShortDescription] Assign [role=\"_abstract\"] to a paragraph to use it as \u003cshortdesc\u003e in DITA.", "location": {"path": "guides/common/assembly_using-custom-ssl-certificate-for-hosts.adoc", "range": {"start": {"line": 1, "column": 1}}}, "severity": "WARNING"}

include::modules/con_using-custom-ssl-certificate-for-hosts.adoc[]

:common-example-com: {foreman-example-com}
include::modules/proc_deploying-a-custom-ssl-certificate-to-hosts.adoc[leveloffset=+1]
:!common-example-com:

include::modules/ref_resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-hosts.adoc[leveloffset=+1]
13 changes: 13 additions & 0 deletions guides/common/modules/con_katello-ca-consumer-rpm-and-rhsm-consumer-script.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
:_mod-docs-content-type: CONCEPT

[id="katello-ca-consumer-rpm-and-rhsm-consumer-script"]
= Katello CA consumer RPM and RHSM consumer script

[role="_abstract"]
The `katello-ca-consumer-rpm` package and `katello-rhsm-consumer` script were previously available to register hosts to {Project}.

:FeatureName: The `katello-ca-consumer-rpm` package and `katello-rhsm-consumer` script
:FeatureAlternative: xref:registering-hosts-by-using-global-registration[]

Check warning on line 10 in guides/common/modules/con_katello-ca-consumer-rpm-and-rhsm-consumer-script.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_katello-ca-consumer-rpm-and-rhsm-consumer-script.adoc", "range": {"start": {"line": 10, "column": 22}}}, "severity": "WARNING"}
include::snip_deprecated-feature.adoc[]

When using the Katello CA Consumer for host registration, you download and install the consumer RPM from `_{foreman-example-com}_/pub/katello-ca-consumer-latest.noarch.rpm` on the host and then run `subscription-manager`.
2 changes: 1 addition & 1 deletion guides/common/modules/con_prerequisites-for-applying-errata.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@

ifdef::satellite[]
* Synchronize {ProjectName} repositories with the latest errata available from Red{nbsp}Hat.
For more information, see xref:synchronizing-repositories-on-demand[].

Check warning on line 11 in guides/common/modules/con_prerequisites-for-applying-errata.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_prerequisites-for-applying-errata.adoc", "range": {"start": {"line": 11, "column": 27}}}, "severity": "WARNING"}
endif::[]
* Register the host to an environment and content view on {ProjectServer}.
For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
For more information, see {ManagingHostsDocURL}registering-hosts-by-using-global-registration[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
* Configure the host for remote execution.
For more information about running remote execution jobs, see {ManagingHostsDocURL}configuring-and-setting-up-remote-jobs[Configuring and setting up remote jobs] in _{ManagingHostsDocTitle}_.
2 changes: 1 addition & 1 deletion guides/common/modules/con_prerequisites-for-using-insights-in-rhcloud.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@
Your environment must meet certain requirements before you can use {Insights} in the {RHCloud}.

* Install and configure the Insights client on hosts during host registration or provisioning.
For more information, see xref:Registering_Hosts_by_Using_Global_Registration_managing-hosts[].
For more information, see xref:registering-hosts-by-using-global-registration[].

Check warning on line 10 in guides/common/modules/con_prerequisites-for-using-insights-in-rhcloud.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_prerequisites-for-using-insights-in-rhcloud.adoc", "range": {"start": {"line": 10, "column": 27}}}, "severity": "WARNING"}
* For hosts already registered to {Project}, install and configure the Insights client on your hosts by using an Ansible role.
For more information, see xref:deploying-insights-client-on-registered-hosts_{context}[].

Check warning on line 12 in guides/common/modules/con_prerequisites-for-using-insights-in-rhcloud.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_prerequisites-for-using-insights-in-rhcloud.adoc", "range": {"start": {"line": 12, "column": 27}}}, "severity": "WARNING"}
ifdef::satellite[]
* If you register your host to a new {ProjectServer}, reregister the host to {Insights} to avoid creating duplicate entries.
For more information, see {RHDocsBaseURL}red_hat_lightspeed/1-latest/html/client_configuration_guide_for_red_hat_lightspeed/assembly-client-configuring-insights-client#proc-reregistering-system-insights_insights-cg-configuring-client[Re-registering your system with Red{nbsp}Hat Lightspeed].
Expand Down
2 changes: 1 addition & 1 deletion guides/common/modules/con_prerequisites-for-using-insights-iop.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@
* You have installed {insights-iop} on your {ProjectServer}.
For more information, see {InstallingServerDisconnectedDocURL}installing-and-configuring-{insights-iop-id}[Installing and configuring {insights-iop}] in _{InstallingServerDisconnectedDocTitle}_.
* Install and configure the Insights client on hosts during host registration or provisioning.
For more information, see xref:Registering_Hosts_by_Using_Global_Registration_managing-hosts[].
For more information, see xref:registering-hosts-by-using-global-registration[].

Check warning on line 12 in guides/common/modules/con_prerequisites-for-using-insights-iop.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_prerequisites-for-using-insights-iop.adoc", "range": {"start": {"line": 12, "column": 27}}}, "severity": "WARNING"}
* For hosts already registered to {Project}, install and configure the Insights client on your hosts by using an Ansible role.
For more information, see xref:deploying-insights-client-on-registered-hosts_{context}[].

Check warning on line 14 in guides/common/modules/con_prerequisites-for-using-insights-iop.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_prerequisites-for-using-insights-iop.adoc", "range": {"start": {"line": 14, "column": 27}}}, "severity": "WARNING"}
* You can change the schedule for running the Insights client by configuring `insights-client.timer` on a host.
ifdef::satellite[]
For more information, see {RHDocsBaseURL}red_hat_lightspeed/1-latest/html/client_configuration_guide_for_red_hat_lightspeed/assembly-client-changing-schedule[Changing the insights-client schedule] in the _Client Configuration Guide for Red{nbsp}Hat Lightspeed_.
Expand Down
17 changes: 0 additions & 17 deletions guides/common/modules/con_registering-hosts-and-setting-up-host-integration.adoc
View file
Open in desktop

This file was deleted.

10 changes: 5 additions & 5 deletions guides/common/modules/con_registering-hosts-by-using-global-registration.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
:_mod-docs-content-type: CONCEPT

[id="Registering_Hosts_by_Using_Global_Registration_{context}"]
[id="registering-hosts-by-using-global-registration"]
= Registering hosts by using global registration

[role="_abstract"]
You can register a host to {Project} by generating a `curl` or `wget` command on {Project} and running this command on hosts.
You can register hosts to {Project} by generating a `curl` or `wget` registration command on {Project} and running this command on multiple hosts.

This method uses two provisioning templates: *Global Registration* template and *Linux host_init_config default* template.
Global registration uses two provisioning templates: *Global Registration* template and *Linux host_init_config default* template.
That gives you complete control over the host registration process.

You can also customize the default templates if you need greater flexibility.
For more information, see xref:Customizing_the_Registration_Templates_{context}[].
With this registration method, you can modify the initial configuration templates to enable additional features.
For example, you can deploy {Project} SSH keys to hosts to enable remote execution jobs, configure hosts with {Insights}, or install the OpenVox agent on hosts to enable configuration management with Puppet.
Copy link
Copy Markdown
Contributor

@maximiliankolb maximiliankolb Apr 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TODO for Maximilian: Ensure that Insights is only mentioned for RHEL Clients via follow-up PR.


ifndef::satellite[]
If you use the Resource Quota plugin, registered hosts are automatically assigned to the `Unassigned` resource quota.
Expand Down
28 changes: 28 additions & 0 deletions guides/common/modules/con_registering-hosts-by-using-the-bootstrap-script.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
:_mod-docs-content-type: CONCEPT

[id="registering-hosts-by-using-the-bootstrap-script"]
= Registering hosts by using the bootstrap script

[role="_abstract"]
You can use the bootstrap script to automate content registration and Puppet configuration.

:FeatureName: The bootstrap script
:FeatureAlternative: xref:registering-hosts-by-using-global-registration[]

Check warning on line 10 in guides/common/modules/con_registering-hosts-by-using-the-bootstrap-script.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_registering-hosts-by-using-the-bootstrap-script.adoc", "range": {"start": {"line": 10, "column": 22}}}, "severity": "WARNING"}
include::snip_deprecated-feature.adoc[]

You can use the bootstrap script to register new hosts, or to migrate existing hosts from RHN, SAM, RHSM, or another {ProjectName} instance.

The `katello-client-bootstrap` package is installed by default on {ProjectServer}'s base operating system.
The `bootstrap.py` script is installed in the `/var/www/html/pub/` directory to make it available to hosts at `_{foreman-example-com}_/pub/bootstrap.py`.
The script includes documentation in the `/usr/share/doc/katello-client-bootstrap-_version_/README.md` file.

To use the bootstrap script, you must install it on the host.
As the script is only required once, and only for the `root` user, you can place it in `/root` or `/usr/local/sbin` and remove it after use.
This procedure uses `/root`.

[IMPORTANT]
====
Reverse proxying on {SmartProxies} is disabled by default for security reasons.
Therefore, the bootstrap script does not work if you register hosts through {SmartProxy}.
{Team} recommends using xref:registering-hosts-by-using-global-registration[global registration] to register hosts instead.

Check warning on line 27 in guides/common/modules/con_registering-hosts-by-using-the-bootstrap-script.adoc

View workflow job for this annotation

GitHub Actions / lint DITA 

[vale] reported by reviewdog 🐶
[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.

Raw Output:
{"message": "[AsciiDocDITA.ConceptLink] Move all links and cross references to Additional resources.", "location": {"path": "guides/common/modules/con_registering-hosts-by-using-the-bootstrap-script.adoc", "range": {"start": {"line": 27, "column": 25}}}, "severity": "WARNING"}
====
8 changes: 8 additions & 0 deletions guides/common/modules/con_registering-hosts-to-project.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
:_mod-docs-content-type: CONCEPT

[id="registering-hosts-to-{project-context}"]
= Registering hosts to {Project}

[role="_abstract"]
Before you can use {Project} to manage hosts that have not been provisioned through {Project}, you must register them.
You can register hosts through {ProjectServer} or {SmartProxyServer}.
4 changes: 2 additions & 2 deletions ...er-and-application-restarts-on-hosts.adoc → ...applications-on-hosts-through-tracer.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
:_mod-docs-content-type: CONCEPT

[id="configuring-tracer-and-application-restarts-on-hosts"]
= Configuring Tracer and application restarts on hosts
[id="restarting-applications-on-hosts-through-tracer"]
= Restarting applications on hosts through Tracer

[role="_abstract"]
If Tracer is available for your hosts, you can see which services need restarts after package updates and restart them when you choose.
2 changes: 1 addition & 1 deletion guides/common/modules/proc_adding-a-host-to-a-host-collection-by-using-cli.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Note that if you add a host to a host collection, the {Project} auditing system

.Prerequisites
* A host must be registered to {ProjectName} to add it to a Host Collection.
For more information about registering hosts, see xref:Registering_Hosts_by_Using_Global_Registration_{context}[].
For more information about registering hosts, see xref:registering-hosts-by-using-global-registration[].

.Procedure
* Add a host to your host collection:
Expand Down
2 changes: 1 addition & 1 deletion guides/common/modules/proc_adding-a-host-to-a-host-collection-by-using-web-ui.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Note that if you add a host to a host collection, the {Project} auditing system

.Prerequisites
* A host must be registered to {ProjectName} to add it to a Host Collection.
For more information about registering hosts, see xref:Registering_Hosts_by_Using_Global_Registration_{context}[].
For more information about registering hosts, see xref:registering-hosts-by-using-global-registration[].

.Procedure
. In the {ProjectWebUI}, navigate to *Hosts* > *All Hosts*.
Expand Down
2 changes: 1 addition & 1 deletion ...common/modules/proc_adding-hosts-to-a-host-collection-in-bulk-by-using-cli.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Note that if you add a host to a host collection, the {Project} auditing system

.Prerequisites
* A host must be registered to {ProjectName} to add it to a host collection.
For more information about registering hosts, see xref:Registering_Hosts_by_Using_Global_Registration_{context}[].
For more information about registering hosts, see xref:registering-hosts-by-using-global-registration[].

.Procedure
* Add multiple hosts to a host collection:
Expand Down
2 changes: 1 addition & 1 deletion ...mon/modules/proc_adding-hosts-to-a-host-collection-in-bulk-by-using-web-ui.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Note that if you add a host to a host collection, the {Project} auditing system

.Prerequisites
* A host must be registered to {ProjectName} to add it to a host collection.
For more information about registering hosts, see xref:Registering_Hosts_by_Using_Global_Registration_{context}[].
For more information about registering hosts, see xref:registering-hosts-by-using-global-registration[].

.Procedure
. In the {ProjectWebUI}, navigate to *Hosts* > *Host Collections*.
Expand Down
2 changes: 1 addition & 1 deletion guides/common/modules/proc_applying-errata-to-hosts-by-using-web-ui.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@

.Prerequisites
* {ProjectName} repositories are synchronized with the latest errata available from Red{nbsp}Hat.
For more information, see {ContentManagementDocURL}synchronizing-repositories-on-demand[Synchronizing repositories on demand] in _{ContentManagementDocTitle}_.

Check failure on line 11 in guides/common/modules/proc_applying-errata-to-hosts-by-using-web-ui.adoc

View workflow job for this annotation

GitHub Actions / lint style 

[vale] reported by reviewdog 🐶
[RedHat.TermsErrors] Use 'on-demand' rather than 'on demand'.

Raw Output:
{"message": "[RedHat.TermsErrors] Use 'on-demand' rather than 'on demand'.", "location": {"path": "guides/common/modules/proc_applying-errata-to-hosts-by-using-web-ui.adoc", "range": {"start": {"line": 11, "column": 116}}}, "severity": "ERROR"}
* The hosts are registered to an environment and content view on {ProjectServer}.
For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
For more information, see {ManagingHostsDocURL}registering-hosts-by-using-global-registration[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
* The host is configured for remote execution.
For more information about running remote execution jobs, see {ManagingHostsDocURL}configuring-and-setting-up-remote-jobs[Configuring and setting up remote jobs] in _{ManagingHostsDocTitle}_.

Expand Down
4 changes: 2 additions & 2 deletions ...ommon/modules/proc_configuring-openvox-agent-on-a-host-during-registration.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,10 +55,10 @@ ifndef::katello,orcharhino,satellite[]
. Navigate to *Hosts* > *Register Host* and register your host.
endif::[]
ifeval::[{context} == "managing-hosts"]
For more information, see xref:Registering_Hosts_by_Using_Global_Registration_{context}[].
For more information, see xref:registering-hosts-by-using-global-registration[].
endif::[]
ifeval::[{context} != "managing-hosts"]
For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
For more information, see {ManagingHostsDocURL}registering-hosts-by-using-global-registration[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
endif::[]
. Navigate to *Infrastructure* > *{SmartProxies}*.
. From the list in the *Actions* column for the required {SmartProxyServer}, select *Certificates*.
Expand Down
4 changes: 2 additions & 2 deletions guides/common/modules/proc_converting-a-host-to-rhel.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,10 +35,10 @@ The role enables the `{RepoRHEL7Server}` repository with the *7Server* release a
Use the global registration template to register and subscribe your host before the conversion.
Select the host group that was generated for the conversion you intend, such as `CentOS 7 converting` if you convert the host from CentOS{nbsp}7.
ifdef::managing-hosts[]
For more information, see xref:Registering_Hosts_by_Using_Global_Registration_{context}[].
For more information, see xref:registering-hosts-by-using-global-registration[].
endif::[]
ifndef::managing-hosts[]
For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
For more information, see {ManagingHostsDocURL}registering-hosts-by-using-global-registration[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
endif::[]
. Run the pre-conversion analysis on the host group to verify if your hosts are ready for the conversion.
Execute a remote job with the following settings:
Expand Down
2 changes: 1 addition & 1 deletion guides/common/modules/proc_creating-a-content-view-by-using-web-ui.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,4 +28,4 @@ This can also cause errors when resolving dependencies for errata.
. Click *Finish*.

.Next steps
* To register a host to your content view, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
* To register a host to your content view, see {ManagingHostsDocURL}registering-hosts-by-using-global-registration[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
2 changes: 1 addition & 1 deletion guides/common/modules/proc_creating-a-rolling-content-view-by-using-cli.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,4 +39,4 @@ $ hammer content-view create \
* You cannot publish or promote your rolling content view.
Instead, continue by adding it to your activation key.
For more information, see xref:creating-an-activation-key-by-using-cli[].
* To register a host to your rolling content view, see {ManagingHostsDocURL}registering-hosts-and-setting-up-host-integration_managing-hosts[Registering hosts and setting up host integration] in _{ManagingHostsDocTitle}_.
* To register a host to your rolling content view, see {ManagingHostsDocURL}registering-hosts-to-{project-context}[Registering hosts to {Project}] in _{ManagingHostsDocTitle}_.
Loading
Loading