ksconf minimize¶
See also
See the Minimizing files for background on why this is important.
Example usage¶
cd Splunk_TA_nix
cp default/inputs.conf local/inputs.conf
# Edit 'disabled' and 'interval' settings in-place
vi local/inputs.conf
# Remove all the extra (unmodified) bits
ksconf minimize --target=local/inputs.conf default/inputs.conf
Undoing a minimize¶
You can use ksconf merge to reverse the effect of minimize by running a command like so:
ksconf merge default/inputs.conf local/inputs.conf
Additional capabilities¶
For special cases, the --explode-default
mode reduces duplication between entries in normal stanzas (as normal) and
then additionally reduces duplication between individual stanzas and default entries.
Typically you only need this mode if your dealing with a conf file that’s been fully expanded to include all the layers,
which doesn’t happen under normal circumstances.
This does happen anytime you download a stanza from a REST endpoint or munged together output from btool list
.
If you’ve ever done this with savedsearches.conf
stanzas, you’ll be painfully aware of how massive they are!
This is the exact use case that --explode-default
was written for.
In such a case, it may be helpful to minimize against the full definition of default, which effectively requires looking at all the layers of default. This includes all global app settings, and system-level settings.
There are limitations to this approach.
- You have to manually list out all the layers. (Sometimes just pointing to the system-level defaults is good enough)
- Minimize doesn’t take namespace into account. This means ownership, sharing, and ACLs are ignored.
In many ways minimize
mimics what Splunk does every time it updates a conf file, as discussed in How Splunk writes to conf files.
If you find yourself frequently needing the power of --explode-default
,
at some point a potentially better approach may be to simply post stanzas to the REST endpoint.
However, this typically does a good enough job, especially for offline scenarios.
Additionally, this command doesn’t strictly require a bloated file.
For example, if disabled = 0
is both a global default, and set on a per-stanza basis, that could be reduced too.
However, typically this isn’t super helpful.