TuneD Command Reference

5 TuneD Command Reference

The following table provides an overview of commands provided by the tune-adm commands utility.

Action	Command	Description
List the active profile.	`tuned-adm active`	Outputs the active TuneD profile. Note: There can be more than one profile active on a server.
List all available profiles.	`tuned-adm list`	Outputs a list of all available profiles, followed by the profile that's active.
Query TuneD for recommended profile.	`tuned-adm recommend`	Outputs the profile recommended for the system. By default, TuneD recommends profiles targeted to the best performance.
Set active profile.	`tuned-adm profile profile1 [profile2 profile3 ...]`	Switches to the specified profile. If more than one profile is specified, the profiles are merged and the resulting profile is applied. In case of conflicting settings, the setting from the last profile is used.
Verify that the system has been optimized to match the settings as defined in the active profile.	`tuned-adm verify`	Outputs information on whether system settings match current profile.
Unload the TuneD tunings.	`tuned-adm off`	Deactivates TuneD tunings and unloads active profiles.

Listing TuneD Profiles

Use the list and active commands provided by tuned-adm to review the TuneD profiles on a server.

To list all the profiles that are available for the system, run the following command:

tuned-adm list

The command output displays a list of all the available profiles. By default, the list is followed by the current active profile, as shown in the following sample output:

Available profiles:
- accelerator-performance     - Throughput performance based tuning with disabled higher latency STOP states
- balanced                    - General non-specialized tuned profile
- desktop                     - Optimize for the desktop use-case
...
- latency-performance         - Optimize for deterministic performance at the cost of increased power consumption
- network-latency             - Optimize for deterministic performance at the cost of increased power consumption, focused on low latency network performance
- network-throughput          - Optimize for streaming network throughput, generally only necessary on older CPUs or 40G+ networks
...
- throughput-performance      - Broadly applicable tuning that provides excellent performance across a variety of common server workloads
- virtual-guest               - Optimize for running inside a virtual guest
- virtual-host                - Optimize for running KVM guests
Current active profile: virtual-guest

The list of profiles that are displayed varies depending on whether you're running Oracle Linux on self-hosted physical infrastructure or as an instance in Oracle Cloud Infrastructure.

To show only the current active profile, use the active command as follows:

tuned-adm active

Querying TuneD for a Recommended Profile

Use the recommend command provided by tuned-adm to see the profile recommended by TuneD.

If the recommend parameter is enabled in the /etc/tuned/tuned-main.conf file, TuneD can recommend an optimization profile for the system.

To see the profile that TuneD recommends, run the following command:

tuned-adm recommend

The command outputs the recommended profile, balanced in this example:

balanced

Selecting an Active TuneD Profile

Use the profile command provided by tuned-adm to select the active profile.

When tuned is enabled on a system or an instance, a default TuneD profile becomes automatically active. However, you can select a different profile and activate it so that system optimization is performed based on that profile. Use the following syntax:

sudo tuned-adm profile profile1 [profile2 profile3 ...]

The following is a suggested method of changing an active profile:

Optionally, check the current active profile by running the following command:
```
tuned-adm active
```
The command outputs the current active profile, balanced in this example:
```
Current active profile: balanced
```
Use the profile command to activate a different profile. For example, to select powersave as the active profile, run the following command:
```
sudo tuned-adm profile powersave
```
Confirm the active profile has changed by running the following command:
```
tuned-adm active
```
The command outputs the profile selected in the previous step, powersave in this example:
```
Current active profile: powersave
```
Verify that the system has been optimized to match the settings as defined in the active profile you have set by running the following command:
```
tuned-adm verify
```
The command output states whether the verification has succeeded, as shown in the following sample output:
```
Verification succeeded, current system settings match the preset profile.
See TuneD log file ('/var/log/tuned/tuned.log') for details.
```

The active profile has been set and the system settings have been verified as matching the newly set profile.

Unloading the Current Active Profile

Use the off command provided by tuned-adm to unload active profiles and deactivate TuneD tunings.

To temporarily deactivate tunings without stopping the tuned.service, run the following steps:

To check the current active profile, run the following command:
```
tuned-adm active
```
The output shows the active profile, for example:
```
Current active profile: balanced
```
Unload the active profile and deactivate TuneD tunings by running the following command:
```
sudo tuned-adm off
```
Verify that no profile is now active by running the following command:
```
tuned-adm active
```
The command output shows that no profile is active:
```
No current active profile.
```

The active profile has been unloaded and TuneD tunings have been deactivated. To set an active profile again follow the steps outlined in Selecting an Active TuneD Profile.