Skip to content

[OSDOCS-20481]: CQA: Managing HCP on OpenStack (2 of 3) #114579

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

Open
lahinson wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[OSDOCS-20481]: CQA: Managing HCP on OpenStack (2 of 3) #114579

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
22 changes: 6 additions & 16 deletions hosted_control_planes/hcp-manage/hcp-manage-openstack.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,37 +1,27 @@
:_mod-docs-content-type: ASSEMBLY
[id="hcp-manage-openstack"]
include::_attributes/common-attributes.adoc[]
= Managing {hcp} on OpenStack
[id="hcp-manage-openstack"]
= Managing {hcp} on {rh-openstack}
:context: hcp-manage-openstack

toc::[]

After you deploy {hcp} on {rh-openstack-first} agent machines, you can manage a hosted cluster by completing the
following tasks.
[role="_abstract"]
After you deploy {hcp} on {rh-openstack-first} agent machines, you can manage a hosted cluster.

include::modules/hcp-openstack-accessing.adoc[leveloffset=+1]

include::modules/hcp-openstack-autoscale.adoc[leveloffset=+1]

include::modules/hcp-manage-openstack-az.adoc[leveloffset=+1]

[id="hosted-clusters-openstack-additional-ports"]
== Configuring additional ports for node pools

You can configure additional ports for node pools to support advanced networking scenarios, such as SR-IOV or multiple networks.

include::modules/hosted-clusters-openstack-addl-ports-cases.adoc[leveloffset=+2]
include::modules/hosted-clusters-openstack-addl-ports-cases.adoc[leveloffset=+1]

include::modules/hosted-clusters-openstack-addl-ports-options.adoc[leveloffset=+2]

include::modules/hosted-clusters-openstack-addl-ports-creating.adoc[leveloffset=+2]

[id="hosted-clusters-openstack-performance"]
== Configuring additional ports for node pools

You can tune hosted cluster node performance on {rh-openstack} for high-performance workloads, such as cloud-native network functions (CNFs). Performance tuning includes configuring {rh-openstack} resources, creating a performance profile, deploying a tuned `NodePool` resource, and enabling SR-IOV device support.

CNFs are designed to run in cloud-native environments. They can provide network services such as routing, firewalling, and load balancing. You can configure the node pool to use high-performance computing and networking devices to run CNFs.
// include::modules/hosted-clusters-openstack-performance.adoc[leveloffset=+1]

include::modules/hosted-clusters-openstack-performance-tuning.adoc[leveloffset=+2]

Expand Down
3 changes: 2 additions & 1 deletion modules/hosted-clusters-openstack-addl-ports-creating.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
[id="hosted-clusters-openstack-addl-ports_{context}"]
= Creating additional ports for node pools

[role="_abstract"]
You can configure additional ports for node pools for hosted clusters that run on {rh-openstack-first}.

.Prerequisites
Expand Down Expand Up @@ -37,7 +38,7 @@ where:

`<cluster_name>`:: Specifies the name of the hosted cluster.
`<nodepool_name>`:: Specifies the name of the node pool.
`<replica_count>`:: Specifies the desired number of replicas.
`<replica_count>`:: Specifies the number of replicas that you need.
`<flavor>`:: Specifies the {rh-openstack} flavor to use.
`<sriov_net_id>`:: Specifies a SR-IOV network ID.
`<lb_net_id>`:: Specifies a load balancer network ID.
Expand Down
5 changes: 3 additions & 2 deletions modules/hosted-clusters-openstack-addl-ports-options.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@
[id="hosted-clusters-openstack-addl-ports-options_{context}"]
= Options for additional ports for node pools

[role="_abstract"]
You can use the `--openstack-node-additional-port` flag to attach additional ports to nodes in a hosted cluster on OpenStack. The flag takes a list of comma-separated parameters. Parameters can be used multiple times to attach multiple additional ports to the nodes.

The parameters are:
The parameters are as follows:

|===
|Parameter|Description|Required|Default
Expand All @@ -19,7 +20,7 @@ The parameters are:
|N/A

|`vnic-type`
|The VNIC type to use for the port. If not specified, Neutron uses the default type `normal`.
|The vNIC type to use for the port. If not specified, Neutron uses the default type `normal`.
|No
|N/A

Expand Down
5 changes: 3 additions & 2 deletions modules/hosted-clusters-openstack-performance-enabling.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,8 @@
[id="hosted-clusters-openstack-performance-enabling_{context}"]
= Enabling the SR-IOV Network Operator in a hosted cluster

You can enable the SR-IOV Network Operator to manage SR-IOV-capable devices on nodes deployed by the `NodePool` resource. The operator runs in the hosted cluster and requires labeled worker nodes.
[role="_abstract"]
You can enable the SR-IOV Network Operator to manage SR-IOV-capable devices on nodes deployed by the `NodePool` resource. The Operator runs in the hosted cluster and requires labeled worker nodes.

.Procedure

Expand Down Expand Up @@ -39,4 +40,4 @@ where:

. Install the SR-IOV Network Operator in the hosted cluster by following the instructions in "Installing the SR-IOV Network Operator".

. After installation, configure SR-IOV workloads in the hosted cluster by using the same process as for a standalone cluster.
. After installation, configure SR-IOV workloads in the hosted cluster by using the same process as for a standalone cluster.
15 changes: 11 additions & 4 deletions modules/hosted-clusters-openstack-performance-tuning.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,8 @@
[id="hosted-clusters-openstack-performance-tuning_{context}"]
= Tuning performance for hosted cluster nodes

Create a performance profile and deploy a tuned `NodePool` resource to run high-performance workloads on {rh-openstack-first} {hcp}.
[role="_abstract"]
Create a performance profile and deploy a tuned `NodePool` resource to run high-performance workloads on {hcp} on {rh-openstack-first}.

.Prerequisites

Expand Down Expand Up @@ -63,7 +64,10 @@ data:
globallyDisableIrqLoadBalancing: true
----
+
IMPORTANT: If you do not already have environment variables set for the HyperShift Operator namespace, isolated and reserved CPUs, and huge pages count, create them before applying the performance profile.
[IMPORTANT]
====
If you do not already have environment variables set for the HyperShift Operator namespace, isolated and reserved CPUs, and huge pages count, create them before applying the performance profile.
====

. Apply the performance profile configuration by running the following command:
+
Expand Down Expand Up @@ -142,5 +146,8 @@ $ oc wait --for=condition=AllNodesHealthy nodepool \
-n ${HYPERSHIFT_NAMESPACE} ${CLUSTER_NAME} \
--timeout=5m
----

NOTE: You can make an SSH connection into the nodes or use the `oc debug` command to verify performance configurations.
+
[NOTE]
====
You can make an SSH connection into the nodes or use the `oc debug` command to verify performance configurations.
====