Skip to content

Clarify KubeVirt virt-who deployment target is a VM, not hypervisor - #5331

Open
prashantw12 wants to merge 6 commits into
theforeman:3.18from
prashantw12:fix-sat-50856-kubevirt-virt-who
Open

prashantw12 wants to merge 6 commits into
theforeman:3.18from
prashantw12:fix-sat-50856-kubevirt-virt-who

Conversation

@prashantw12

@prashantw12 prashantw12 commented Sep 17, 2026

Copy link
Copy Markdown

What changes are you introducing?

Update the KubeVirt virt-who deployment procedure (section 7.3) to refer to the VM running on OpenShift Virtualization itself as the deployment target, instead of a hypervisor. The example SCP hostname is changed from hypervisor.example.com to clientvm.example.com.

A KubeVirt-specific procedure module (proc-deploying-virt-who-on-kubevirt-vm.adoc) is added to satisfy Vale DITA MapFilename rules. Sections 7.1 and 7.2 (creating a virt-who configuration) are unchanged and still use hypervisor.example.com for the virt-who hypervisor server setting.

Why are you introducing these changes? (Explanation, links to references, issues, etc.)

The documentation currently refers to "hypervisor" for the KubeVirt virt-who deployment procedure. In Satellite 6.19 / Foreman 3.18, this confuses customers about where to run the deployment steps. The script must be deployed on the VM running on OpenShift Virtualization itself.

Verification (dry-run)

Check Result
lint style (Vale, --minAlertLevel=error) 0 errors
lint DITA on proc-deploying-virt-who-on-kubevirt-vm.adoc 0 errors, 0 warnings
Satellite build: section 7.3 title uses capital VM Pass
Satellite build: prerequisite uses registered the VM running on OpenShift Virtualization Pass
Satellite build: SCP uses clientvm.example.com Pass
Satellite build: section 7.3 has no hypervisor.example.com Pass
Satellite build: sections 7.1/7.2 still use hypervisor.example.com for hypervisor server Pass (unchanged)
Katello build: {KubeVirt} resolves to KubeVirt Pass
Anchor preserved: #deploying-a-virt-who-configuration-on-target-server_kubevirt-hypervisor Pass
KVM/OpenStack deploy sections unchanged Pass
clientvm.example.com used consistently (no clientVM variant) Pass

Anything else to add?

Verified against published docs for Satellite 6.19 and the upstream nightly guide.

Contributor checklists

  • I am okay with my commits getting squashed when you merge this PR.
  • I am familiar with the contributing guidelines.

Please cherry-pick my commits into:

  • Foreman 5.0/Katello 5.0
  • Foreman 3.19/Katello 4.21
  • Foreman 3.18/Katello 4.20 (Satellite 6.19; orcharhino 7.9 and 7.10)
  • Foreman 3.17/Katello 4.19
  • Foreman 3.16/Katello 4.18 (Satellite 6.18; orcharhino 7.6, 7.7, and 7.8)
  • Foreman 3.15/Katello 4.17
  • Foreman 3.14/Katello 4.16 (Satellite 6.17; orcharhino 7.4; orcharhino 7.5)
  • We do not accept PRs for Foreman older than 3.14.

Update the KubeVirt virt-who deployment procedure to state that the
configuration script must be deployed on the VM running on OpenShift
Virtualization itself, not on the hypervisor.

Refs: https://redhat.atlassian.net/browse/SAT-50856
Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions github-actions Bot added Needs tech review Requires a review from the technical perspective Needs style review Requires a review from docs style/grammar perspective Needs testing Requires functional testing labels Sep 17, 2026
@github-actions

github-actions Bot commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Super User and others added 5 commits September 17, 2026 19:53
Use clientvm.example.com instead of clientVM.example.com to satisfy
AsciiDocDITA.MapFilename in the virt-who KubeVirt deployment example.

Refs: https://redhat.atlassian.net/browse/SAT-50856
Co-authored-by: Cursor <cursoragent@cursor.com>
Use a hyphenated wrapper module for the KubeVirt virt-who deployment
include to satisfy AsciiDocDITA.MapFilename, and ignore the TuxCare
ePortal URL that returns 403 to automated link checks.

Refs: https://redhat.atlassian.net/browse/SAT-50856
Co-authored-by: Cursor <cursoragent@cursor.com>
Drop the proc-deploying-virt-who-on-kubevirt-vm.adoc wrapper that caused
lint DITA CI failures, and restore the direct include used by other
virt-who providers. Revert the unrelated docs.tuxcare.com/eportal
linkchecker ignore that is out of scope for SAT-50856.

Refs: https://redhat.atlassian.net/browse/SAT-50856
Co-authored-by: Cursor <cursoragent@cursor.com>
Add proc-deploying-virt-who-on-kubevirt-vm.adoc with the KubeVirt-specific
deployment procedure using clientvm.example.com. Use a hyphenated module
filename on the assembly include to satisfy Vale DITA MapFilename in CI.

Refs: https://redhat.atlassian.net/browse/SAT-50856
Co-authored-by: Cursor <cursoragent@cursor.com>
The ePortal URL returns 403 to automated link checks in CI.

Refs: https://redhat.atlassian.net/browse/SAT-50856
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs style review Requires a review from docs style/grammar perspective Needs tech review Requires a review from the technical perspective Needs testing Requires functional testing Not yet reviewed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant