diff --git a/CHANGELOG.md b/CHANGELOG.md index 8da3db3d..4ca0bedc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ## v4.6.0, unreleased +### Added + +- Document defining kernel args that include commas. #1679 + ### Fixed - Fix default nodes.conf to use the new kernel command line list format. #1670 diff --git a/userdocs/contents/nodeconfig.rst b/userdocs/contents/nodeconfig.rst index ba2fc3ac..adaf8e64 100644 --- a/userdocs/contents/nodeconfig.rst +++ b/userdocs/contents/nodeconfig.rst @@ -128,7 +128,7 @@ see a list of all configuration attributes, use the command ``wwctl node set --help``. Configuring the Node's Image -============================ +---------------------------- .. code-block:: console @@ -294,6 +294,18 @@ nodes are sorted lexically, first by cluster, then by ID.) Once a node has been discovered its "discoverable" flag is automatically cleared. +Setting list values +=================== + +Some node fields, such as overlays and kernel args, accept a list of values. +These may be specified as a comma-separated list or as multiple arguments. + +To include an explicit comma in the value, enclose the value in inner-quotes. + +.. code-block:: console + + # wwctl profile set default --kernelargs 'quiet,crashkernel=no,nosplash' --kernelargs='"console=ttyS0,115200"' + Un-setting Node Attributes ==========================