openstack/tripleo-docs
Code Issues Proposed changes
a8151e9563
tripleo-docs/deploy-guide/source/features/tuned.rst
Alex Schultz c6918e5da6 Migrate install to deploy-guide 
The deployment guide is currently pointed at triplo-docs but it has been
requested that we actually publish a deployment guide. This change
extracts many of the installation doc pages and moves them into the
deploy-guide source tree.  Once the deploy-guide is published, we will
follow up to reference the deployment guide from tripleo-docs.

Change-Id: I0ebd26f014180a92c6cf4ab0929d99b2d860796f
2019-08-16 15:42:17 -06:00

2.0 KiB
Raw Blame History

Deploying custom tuned profiles

TripleO can be used to deploy Overcloud nodes with different tuned profiles in addition to custom tuned profiles.

Deploying with existing tuned profiles

Create an environment file, e.g. ~/tuned.yaml, with the following content:

parameter_defaults:
  TunedProfileName: throughput-performance

Deploy the Overcloud as usual using the CLI <../deployment/install_overcloud> and pass the environment file using the -e option:

openstack overcloud deploy --templates -e ~/tuned.yaml

In the above example, the throughput-performance tuned profile will be applied to the overcloud nodes. The TunedProfileName parameter may be set to any tuned profile already on the node.

Deploying with custom tuned profiles

If the tuned profile you wish to apply is not already on the overcloud node being deployed, then TripleO can create the tuned profile for you and will set the name of the new profile to whatever TunedProfileName parameter you supply.

The following example creates a custom tuned profile called my_profile which inherits from the existing throughput-performance tuned profile and then adds a few extra tunings:

parameter_defaults:
  TunedCustomProfile: |
    [main]
    summary=my profile
    include=throughput-performance
    [sysctl]
    vm.dirty_ratio = 10
    vm.dirty_background_ratio = 3
    [sysfs]
    /sys/kernel/mm/ksm/run=0
  TunedProfileName: my_profile

The above will create the file /etc/tuned/my_profile/tuned.conf on the overcloud nodes and tuned.conf will contain the tuned directives defined by the TunedCustomProfile parameter. The TunedCustomProfile parameter should be set to a multiline string using YAML's literal block scalar (i.e. the pipe '|') and that string should contain valid tuned directives in INI format.