Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
21 changes: 0 additions & 21 deletions modules/virt-about-cluster-checkup-framework.adoc

This file was deleted.

4 changes: 2 additions & 2 deletions modules/virt-checking-storage-configuration.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@
Use a predefined checkup to verify that the {product-title} cluster storage is configured optimally to run {VirtProductName} workloads.

.Prerequisites
* You have installed the OpenShift CLI (`oc`).

* You have installed the {oc-first}.
* The cluster administrator has created the required `cluster-reader` permissions for the storage checkup service account and namespace, such as in the following example:
+
[source,yaml]
Expand All @@ -29,7 +30,6 @@ subjects:
----
<1> The namespace where the checkup is to be run.


.Procedure

. Create a `ServiceAccount`, `Role`, and `RoleBinding` manifest file for the storage checkup:
Expand Down
4 changes: 3 additions & 1 deletion modules/virt-latency-checkup-web-console.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -25,4 +25,6 @@ Run a latency checkup to verify network connectivity and measure the latency bet
. Optional: Target specific nodes by enabling *Select nodes* and specifying the *Source node* and *Target node*.
. Click *Run*.

You can view the status of the latency checkup in the *Checkups* list on the *Latency checkup* tab. Click on the name of the checkup for more details.
.Verification

* To view the status of the latency checkup, go to the *Checkups* list on the *Latency checkup* tab. Click on the name of the checkup for more details.
6 changes: 2 additions & 4 deletions modules/virt-measuring-latency-vm-secondary-network.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,7 @@
[id="virt-measuring-latency-vm-secondary-network_{context}"]
= Running a latency checkup by using the CLI

You use a predefined checkup to verify network connectivity and measure latency between two virtual machines (VMs) that are attached to a secondary network interface. The latency checkup uses the ping utility.

You run a latency checkup by performing the following steps:
You run a latency checkup using the CLI by performing the following steps:

. Create a service account, roles, and rolebindings to provide cluster access permissions to the latency checkup.
. Create a config map to provide the input to run the checkup and to store the results.
Expand All @@ -19,7 +17,7 @@ You run a latency checkup by performing the following steps:

.Prerequisites

* You installed the OpenShift CLI (`oc`).
* You installed the {oc-first}.
* The cluster has at least two worker nodes.
* You configured a network attachment definition for a namespace.

Expand Down
19 changes: 19 additions & 0 deletions snippets/virt-about-running-checkups.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
// Text snippet included in the following modules:
//
// *
//
// Text snippet included in the following assemblies:
//
// * /virt/monitoring/virt-running-cluster-checkups.adoc

:_mod-docs-content-type: SNIPPET

Running a predefined checkup in an existing namespace involves setting up a service account for the checkup, creating the `Role` and `RoleBinding` objects for the service account, enabling permissions for the checkup, and creating the input config map and the checkup job. You can run a checkup multiple times.

[IMPORTANT]
====
You must always:

* Verify that the checkup image is from a trustworthy source before applying it.
* Review the checkup permissions before creating the `Role` and `RoleBinding` objects.
====
41 changes: 20 additions & 21 deletions virt/monitoring/virt-running-cluster-checkups.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -6,46 +6,45 @@ include::_attributes/common-attributes.adoc[]

toc::[]

{VirtProductName} includes the following predefined checkups that can be used for cluster maintenance and troubleshooting:
A _checkup_ is an automated test workload that allows you to verify if a specific cluster functionality works as expected. The cluster checkup framework uses native Kubernetes resources to configure and execute the checkup.

:FeatureName: The {VirtProductName} cluster checkup framework
include::snippets/technology-preview.adoc[]

As a developer or cluster administrator, you can use predefined checkups to improve cluster maintainability, troubleshoot unexpected behavior, minimize errors, and save time. You can review the results of the checkup and share them with experts for further analysis. Vendors can write and publish checkups for features or services that they provide and verify that their customer environments are configured correctly.

[id="virt-running-cluster-checkups-latency"]
== Running predefined latency checkups

You can use a latency checkup to verify network connectivity and measure latency between two virtual machines (VMs) that are attached to a secondary network interface. The predefined latency checkup uses the ping utility.

* Latency checkup, which verifies network connectivity and measures latency between two virtual machines (VMs) that are attached to a secondary network interface.
+
[IMPORTANT]
=====
Before you run a latency checkup, you must first xref:../../virt/vm_networking/virt-connecting-vm-to-linux-bridge.adoc#virt-connecting-vm-to-linux-bridge[create a bridge interface] on the cluster nodes to connect the VM's secondary interface to any interface on the node. If you do not create a bridge interface, the VMs do not start and the job fails.
=====

* Storage checkup, which verifies if the cluster storage is optimally configured for {VirtProductName}.
include::snippets/virt-about-running-checkups.adoc[]

:FeatureName: The {VirtProductName} cluster checkup framework
include::snippets/technology-preview.adoc[]
include::modules/virt-latency-checkup-web-console.adoc[leveloffset=+2]

include::modules/virt-about-cluster-checkup-framework.adoc[leveloffset=+1]
include::modules/virt-measuring-latency-vm-secondary-network.adoc[leveloffset=+2]

[id="virt-running-cluster-checkups-console_{context}"]
== Running checkups by using the web console
[id="virt-running-cluster-checkups-storage"]
== Running predefined storage checkups

Use the following procedures the first time you run checkups by using the web console. For additional checkups, click *Run checkup* on either checkup tab, and select the appropriate checkup from the drop down menu.
You can use a storage checkup to verify that the cluster storage is optimally configured for {VirtProductName}.

include::modules/virt-latency-checkup-web-console.adoc[leveloffset=+2]
include::snippets/virt-about-running-checkups.adoc[]

include::modules/virt-storage-checkup-web-console.adoc[leveloffset=+2]

[id="virt-running-cluster-checkups-cli_{context}"]
== Running checkups by using the CLI

Use the following procedures the first time you run checkups by using the command line.

include::modules/virt-measuring-latency-vm-secondary-network.adoc[leveloffset=+2]

include::modules/virt-checking-storage-configuration.adoc[leveloffset=+2]


ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
[role="_additional-resources"]
[id="additional-resources_running-cluster-checkups"]
== Additional resources
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
* xref:../../virt/vm_networking/virt-connecting-vm-to-linux-bridge.adoc#virt-connecting-vm-to-linux-bridge[Attaching a virtual machine to multiple networks]
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
* xref:../../virt/vm_networking/virt-connecting-vm-to-linux-bridge.adoc#virt-connecting-vm-to-linux-bridge[Connecting a virtual machine to a Linux bridge network]
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]