# salt.runners.manage

General management functions for salt, tools like seeing what hosts are up and what hosts are down

salt.runners.manage.alived(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are up according to Salt's presence detection (no commands will be sent to minions)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.alived

salt.runners.manage.allowed(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are up according to Salt's presence detection (no commands will be sent to minions)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.allowed

salt.runners.manage.bootstrap(version='develop', script='https://github.com/saltstack/salt-bootstrap/releases/latest/download/bootstrap-salt.sh', hosts='', script_args='', roster='flat', ssh_user=None, ssh_password=None, ssh_priv_key=None, tmp_dir='/tmp/.bootstrap', http_backend='tornado')

  Bootstrap minions with salt-bootstrap

  versiondevelop

    Git tag of version to install

  scripthttps://github.com/saltstack/salt-bootstrap/releases/latest/download/bootstrap-salt.sh

    URL containing the script to execute

  hosts

    Comma-separated hosts [example: hosts='host1.local,host2.local']. These hosts need to exist in the specified roster.

  script_args

    Any additional arguments that you want to pass to the script.

    Added in version 2016.11.0.

  rosterflat

    The roster to use for Salt SSH. More information about roster files can be found in Salt's Roster Documentation.

    A full list of roster types, see the builtin roster modules documentation.

    Added in version 2016.11.0.

  ssh_user

    If `user` isn't found in the `roster`, a default SSH user can be set here. Keep in mind that `ssh_user` will not override the roster `user` value if it is already defined.

    Added in version 2016.11.0.

  ssh_password

    If `passwd` isn't found in the `roster`, a default SSH password can be set here. Keep in mind that `ssh_password` will not override the roster `passwd` value if it is already defined.

    Added in version 2016.11.0.

  ssh_privkey

    If `priv` isn't found in the `roster`, a default SSH private key can be set here. Keep in mind that `ssh_password` will not override the roster `passwd` value if it is already defined.

    Added in version 2016.11.0.

  tmp_dir/tmp/.bootstrap

    The temporary directory to download the bootstrap script in. This directory will have `-<uuid4>` appended to it. For example: `/tmp/.bootstrap-a19a728e-d40a-4801-aba9-d00655c143a7/`

    Added in version 2016.11.0.

  http_backendtornado

    The backend library to use to download the script. If you need to use a `file:///` URL, then you should set this to `urllib2`.

    Added in version 2016.11.0.

  CLI Example:

      salt-run manage.bootstrap hosts='host1,host2'
      salt-run manage.bootstrap hosts='host1,host2' version='v3006.2'
      salt-run manage.bootstrap hosts='host1,host2' version='v3006.2' script='https://github.com/saltstack/salt-bootstrap/develop'

salt.runners.manage.bootstrap_psexec(hosts='', master=None, version=None, arch='win32', installer_url=None, username=None, password=None)

  Bootstrap Windows minions via PsExec.

  hosts

    Comma separated list of hosts to deploy the Windows Salt minion.

  master

    Address of the Salt master passed as an argument to the installer.

  version

    Point release of installer to download. Defaults to the most recent.

  arch

    Architecture of installer to download. Defaults to win32.

  installer_url

    URL of minion installer executable. Defaults to the latest version from https://packages.broadcom.com/artifactory/saltproject-generic/windows/

  username

    Optional user name for login on remote computer.

  password

    Password for optional username. If omitted, PsExec will prompt for one to be entered for each host.

  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'

salt.runners.manage.down(removekeys=False, tgt='*', tgt_type='glob', timeout=None, gather_job_timeout=None)

  Changed in version 2017.7.0: The `expr_form` argument has been renamed to `tgt_type`, earlier releases must use `expr_form`.

  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
      salt-run manage.down tgt="webservers" tgt_type="nodegroup"

salt.runners.manage.joined(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are up according to Salt's presence detection (no commands will be sent to minions)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.joined

salt.runners.manage.key_regen()

  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

salt.runners.manage.list_not_state(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are NOT up according to Salt's presence detection (no commands will be sent to minions)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.list_not_state

salt.runners.manage.list_state(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are up according to Salt's presence detection (no commands will be sent to minions)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.list_state

salt.runners.manage.not_alived(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are NOT up according to Salt's presence detection (no commands will be sent)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.not_alived

salt.runners.manage.not_allowed(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are NOT up according to Salt's presence detection (no commands will be sent)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.not_allowed

salt.runners.manage.not_joined(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are NOT up according to Salt's presence detection (no commands will be sent)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.not_joined

salt.runners.manage.not_present(subset=None, show_ip=False)

  Added in version 2015.5.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are NOT up according to Salt's presence detection (no commands will be sent)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.not_present

salt.runners.manage.not_reaped(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are NOT up according to Salt's presence detection (no commands will be sent)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.not_reaped

salt.runners.manage.present(subset=None, show_ip=False)

  Changed in version 2019.2.0.

  Print a list of all minions that are up according to Salt's presence detection (no commands will be sent to minions)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.present

salt.runners.manage.reaped(subset=None, show_ip=False)

  Added in version 2015.8.0.

  Changed in version 2019.2.0.

  Print a list of all minions that are up according to Salt's presence detection (no commands will be sent to minions)

  subsetNone

    Pass in a list of minion ids.

  show_ipFalse

    Also show the IP address each minion is connecting from.

  CLI Example:

      salt-run manage.reaped

salt.runners.manage.safe_accept(target, tgt_type='glob')

  Changed in version 2017.7.0: The `expr_form` argument has been renamed to `tgt_type`, earlier releases must use `expr_form`.

  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 tgt_type=list

salt.runners.manage.status(output=True, tgt='*', tgt_type='glob', timeout=None, gather_job_timeout=None)

  Changed in version 2017.7.0: The `expr_form` argument has been renamed to `tgt_type`, earlier releases must use `expr_form`.

  Print the status of all known salt minions

  CLI Example:

      salt-run manage.status
      salt-run manage.status tgt="webservers" tgt_type="nodegroup"
      salt-run manage.status timeout=5 gather_job_timeout=10

salt.runners.manage.up(tgt='*', tgt_type='glob', timeout=None, gather_job_timeout=None)

  Changed in version 2017.7.0: The `expr_form` argument has been renamed to `tgt_type`, earlier releases must use `expr_form`.

  Print a list of all of the minions that are up

  CLI Example:

      salt-run manage.up
      salt-run manage.up tgt="webservers" tgt_type="nodegroup"
      salt-run manage.up timeout=5 gather_job_timeout=10

salt.runners.manage.versions()

  Check the version of active minions

  CLI Example:

      salt-run manage.versions