General management functions for salt, tools like seeing what hosts are up and what hosts are down
Bootstrap minions with salt-bootstrap
CLI Example:
salt-run manage.bootstrap hosts="host1,host2"
salt-run manage.bootstrap hosts="host1,host2" version="v0.17"
salt-run manage.bootstrap hosts="host1,host2" version="v0.17" script="https://raw.githubusercontent.com/saltstack/salt-bootstrap/develop/bootstrap-salt.sh"
Bootstrap Windows minions via PsExec.
CLI Example:
salt-run manage.bootstrap_psexec hosts='host1,host2'
salt-run manage.bootstrap_psexec hosts='host1,host2' version='0.17' username='DOMAIN\Administrator'
salt-run manage.bootstrap_psexec hosts='host1,host2' installer_url='http://exampledomain/salt-installer.exe'
Print a list of all the down or unresponsive salt minions Optionally remove keys of down minions
CLI Example:
salt-run manage.down
salt-run manage.down removekeys=True
This routine is used to regenerate all keys in an environment. This is invasive! ALL KEYS IN THE SALT ENVIRONMENT WILL BE REGENERATED!!
The key_regen routine sends a command out to minions to revoke the master key and remove all minion keys, it then removes all keys from the master and prompts the user to restart the master. The minions will all reconnect and keys will be placed in pending.
After the master is restarted and minion keys are in the pending directory execute a salt-key -A command to accept the regenerated minion keys.
The master must be restarted within 60 seconds of running this command or the minions will think there is something wrong with the keys and abort.
Only Execute this runner after upgrading minions and master to 0.15.1 or higher!
CLI Example:
salt-run manage.key_regen
Print a list of all minions that are up according to Salt's presence detection, no commands will be sent
CLI Example:
salt-run manage.present
Accept a minion's public key after checking the fingerprint over salt-ssh
CLI Example:
salt-run manage.safe_accept my_minion
salt-run manage.safe_accept minion1,minion2 expr_form=list
Print the status of all known salt minions
CLI Example:
salt-run manage.status
Print a list of all of the minions that are up
CLI Example:
salt-run manage.up
Check the version of active minions
CLI Example:
salt-run manage.versions
Current Salt release: 2014.1.6
Docs for previous releases on salt.rtfd.org.