// Module included in the following assemblies:
//
// * nodes/nodes/nodes-node-tuning-operator.adoc

:_mod-docs-content-type: PROCEDURE
[id="rosa-modifying-node-tuning_{context}"]
= Modify node tuning configurations

[role="_abstract"]
View and update node tuning configurations to adjust performance settings for your cluster by using the {rosa-cli-first}.

.Prerequisites

* You have downloaded the latest version of the {rosa-cli}.
* You have a cluster on the latest version.
* Your cluster has a node tuning configuration added to it.

.Procedure

. View the tuning configurations with the `rosa describe` command:
+
[source,terminal]
----
$ rosa describe tuning-config -c <cluster_id> \
       --name <name_of_tuning> \
       [-o json]
----
+
where:
+
--
`<cluster_id>`:: Specifies the cluster ID for the cluster that you own that you want to apply a node tuning configuration.
`<name_of_tuning>`:: Specifies the name of your tuning configuration.
`-o json`:: Specifies the output type. This parameter is optional. If you do not specify any outputs, you see only the ID and name of the tuning configuration.
--
+
*Example output without specifying output type*
+
[source,terminal]
----
Name:    sample-tuning
ID:      20468b8e-edc7-11ed-b0e4-0a580a800298
Spec:    {
            "profile": [
              {
                "data": "[main]\nsummary=Custom OpenShift profile\ninclude=openshift-node\n\n[sysctl]\nvm.dirty_ratio=\"55\"\n",
                "name": "tuned-1-profile"
              }
            ],
            "recommend": [
              {
                 "priority": 20,
                 "profile": "tuned-1-profile"
              }
            ]
         }

----
+
*Example output specifying JSON output*
+
[source,terminal]
----
{
  "kind": "TuningConfig",
  "id": "20468b8e-edc7-11ed-b0e4-0a580a800298",
  "href": "/api/clusters_mgmt/v1/clusters/23jbsevqb22l0m58ps39ua4trff9179e/tuning_configs/20468b8e-edc7-11ed-b0e4-0a580a800298",
  "name": "sample-tuning",
  "spec": {
    "profile": [
      {
        "data": "[main]\nsummary=Custom OpenShift profile\ninclude=openshift-node\n\n[sysctl]\nvm.dirty_ratio=\"55\"\n",
        "name": "tuned-1-profile"
      }
    ],
    "recommend": [
      {
        "priority": 20,
        "profile": "tuned-1-profile"
      }
    ]
  }
}
----

. After verifying the tuning configuration, edit the existing configuration with the `rosa edit` command:
+
[source,terminal]
----
$ rosa edit tuning-config -c <cluster_id> --name <name_of_tuning> --spec-path <path_to_spec_file>
----
+
In this command, you use the `spec.json` file to edit your configurations.

.Verification

* Run the `rosa describe` command again to see that the changes you made to the `spec.json` file are updated in the tuning configurations:
+
[source,terminal]
----
$ rosa describe tuning-config -c <cluster_id> --name <name_of_tuning>
----
+
*Example output*
+
[source,terminal]
----
Name:  sample-tuning
ID:    20468b8e-edc7-11ed-b0e4-0a580a800298
Spec:  {
           "profile": [
             {
              "data": "[main]\nsummary=Custom OpenShift profile\ninclude=openshift-node\n\n[sysctl]\nvm.dirty_ratio=\"55\"\n",
              "name": "tuned-2-profile"
             }
           ],
           "recommend": [
             {
              "priority": 10,
              "profile": "tuned-2-profile"
             }
           ]
       }
----
