Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added the guidlines to enable 'start_event_grains' config #88

Merged
merged 1 commit into from
Mar 9, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions modules/client-configuration/pages/tshoot-clients.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,39 @@ Therefore you must not mount [filename]``/tmp`` with the [option]``noexec`` opti



== Passing Grains to a Start Event

Every time a Salt client starts, it passes the ``machine_id`` grain to {productname}. {productname} uses this grain to determine if the client is registered.
This process requires a synchronous Salt call. Synchronous Salt calls block other processes, so if you have a lot of clients start at the same time, the process could create significant delays.

To overcome this problem, a new feature has been introduced in Salt to avoid making a separate synchronous Salt call.

To use this feature, you can add a configuration parameter to the client configuration, on clients that support it.

To make this process easier, you can use the ``mgr_start_event_grains.sls`` helper Salt state.

[NOTE]
====
This only applies to already registered clients.
If you registered your Salt client recently, this config parameter is added by default.
====


On the {productname} Server, at the command prompt, use this command to enable the ``start_event_grains`` configuration helper:

----
salt '*' state.sls util.mgr_start_event_grains
----

This command adds the required configuration into the client's configuration file, and applies it when the client is restarted.
If you have a large number of clients, you can execute the command in batch mode instead:

----
salt --batch-size 50 '*' state.sls mgr_start_event_grains
----



== SSL errors

On SLES{nbsp}11 systems, clients can sometimes have SSL errors which make some operations unusable, including package management and bootstrapping.
Expand Down