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
2023-05-23 16:58:30 -04:00

90 lines
2.8 KiB
Plaintext

// Module included in the following assemblies:
//
// * rosa_cluster_admin/rosa_nodes/rosa-managing-worker-nodes.adoc
:_content-type: PROCEDURE
[id="rosa-adding-tuning_{context}"]
= Adding node tuning to a machine pool
You can add tunings for compute (also known as worker) nodes in a machine pool to control their configuration.
.Prerequisites
ifdef::openshift-rosa[]
* You installed and configured the latest AWS (`aws`), ROSA (`rosa`), and OpenShift (`oc`) CLIs on your workstation.
* You logged in to your Red Hat account by using the ROSA CLI.
* You created a {product-title} (ROSA) cluster.
endif::openshift-rosa[]
ifndef::openshift-rosa[]
* You created an {product-title} cluster.
endif::[]
* You have an existing machine pool.
* You have an existing tuning configuration.
.Procedure
ifdef::openshift-rosa[]
. List the machine pools in the cluster:
+
[source,terminal]
----
$ rosa list machinepools --cluster=<cluster_name>
----
+
.Example output
+
[source,terminal]
----
ID AUTOSCALING REPLICAS INSTANCE TYPE LABELS TAINTS AVAILABILITY ZONES SUBNET VERSION AUTOREPAIR TUNING CONFIGS MESSAGE
Default 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 LABELS TAINTS AVAILABILITY ZONES SUBNET VERSION AUTOREPAIR TUNING CONFIGS MESSAGE
Default 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.