1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-07 09:46:53 +01:00
Files
openshift-docs/modules/rosa-adding-tuning.adoc
2024-09-10 13:25:25 -06:00

89 lines
2.6 KiB
Plaintext

// Module included in the following assemblies:
//
// * rosa_cluster_admin/rosa_nodes/rosa-managing-worker-nodes.adoc
:_mod-docs-content-type: PROCEDURE
[id="rosa-adding-tuning_{context}"]
= Adding node tuning to a machine pool
You can add tunings for compute, also called worker, nodes in a machine pool to control their configuration on {hcp-title-first} clusters.
[NOTE]
====
This feature is only supported on {hcp-title-first} clusters.
====
.Prerequisites
* You installed and configured the latest {product-title} (ROSA) CLI, `rosa`, on your workstation.
* You logged in to your Red{nbsp}Hat account by using the ROSA CLI.
* You created a {hcp-title-first} cluster.
* You have an existing machine pool.
* You have an existing tuning configuration.
.Procedure
. List all of the machine pools in the cluster:
+
[source,terminal]
----
$ rosa list machinepools --cluster=<cluster_name>
----
+
.Example output
+
[source,terminal]
----
ID AUTOSCALING REPLICAS INSTANCE TYPE [...] AVAILABILITY ZONES SUBNET VERSION AUTOREPAIR TUNING CONFIGS
workers No 2 m5.xlarge [...] us-east-1a N/A 4.12.14 Yes
db-nodes-mp No 2 m5.xlarge [...] us-east-1a No 4.12.14 Yes
----
. You can add tuning configurations to an existing or new machine pool.
.. Add tunings when creating a machine pool:
+
[source,terminal]
----
$ rosa create machinepool -c <cluster-name> <machinepoolname> --tuning-configs <tuning_config_name>
----
+
.Example output
[source,terminal]
----
? Tuning configs: sample-tuning
I: Machine pool 'db-nodes-mp' created successfully on hosted cluster 'sample-cluster'
I: To view all machine pools, run 'rosa list machinepools -c sample-cluster'
----
.. Add or update the tunings for a machine pool:
+
[source,terminal]
----
$ rosa edit machinepool -c <cluster-name> <machinepoolname> --tuning-configs <tuningconfigname>
----
+
.Example output
[source,terminal]
----
I: Updated machine pool 'db-nodes-mp' on cluster 'mycluster'
----
.Verification
. List the available machine pools in your cluster:
+
[source,terminal]
----
$ rosa list machinepools --cluster=<cluster_name>
----
+
.Example output
[source,terminal]
----
ID AUTOSCALING REPLICAS INSTANCE TYPE [...] AVAILABILITY ZONES SUBNET VERSION AUTOREPAIR TUNING CONFIGS
workers No 2 m5.xlarge [...] us-east-1a N/A 4.12.14 Yes
db-nodes-mp No 2 m5.xlarge [...] us-east-1a No 4.12.14 Yes sample-tuning
----
. Verify that the tuning config is included for your machine pool in the output.