golden hour

/opt/saltstack/salt/lib/python3.10/site-packages/salt/runners

File/Folder	Size	Actions
__init__.py	26 B
__pycache__	-
asam.py	11.2 KB
auth.py	1.69 KB
bgp.py	17.55 KB
cache.py	12.71 KB
cloud.py	4.18 KB
config.py	913 B
ddns.py	8.96 KB
digicertapi.py	21.63 KB
doc.py	1.39 KB
drac.py	5.29 KB
error.py	545 B
event.py	2.1 KB
f5.py	9.58 KB
fileserver.py	17.37 KB
git_pillar.py	3.98 KB
http.py	2.35 KB
jobs.py	17.45 KB
launchd.py	1.35 KB
lxc.py	18.14 KB
manage.py	25.6 KB
mattermost.py	4.68 KB
mine.py	1.63 KB
nacl.py	8.15 KB
net.py	39.05 KB
network.py	2.42 KB
pagerduty.py	4.5 KB
pillar.py	5.14 KB
pkg.py	1.35 KB
queue.py	8.84 KB
reactor.py	4.82 KB
salt.py	4.69 KB
saltutil.py	21.65 KB
sdb.py	2.14 KB
smartos_vmadm.py	11.67 KB
spacewalk.py	9.8 KB
ssh.py	771 B
state.py	9.2 KB
survey.py	5.84 KB
test.py	2.27 KB
thin.py	1.74 KB
vault.py	14.01 KB
venafiapi.py	6.68 KB
virt.py	17.59 KB
vistara.py	5.6 KB
winrepo.py	9.23 KB

Edit: drac.py

"""
Manage Dell DRAC from the Master

The login credentials need to be configured in the Salt master
configuration file.

.. code-block:: yaml

drac:
      username: admin
      password: secret

"""

import logging

try:
    import paramiko

HAS_PARAMIKO = True
except ImportError:
    HAS_PARAMIKO = False

log = logging.getLogger(__name__)

def __virtual__():
    if HAS_PARAMIKO:
        return True

return (
        False,
        "The drac runner module cannot be loaded: paramiko package is not installed.",
    )

def __connect(hostname, timeout=20, username=None, password=None):
    """
    Connect to the DRAC
    """
    drac_cred = __opts__.get("drac")
    err_msg = (
        "No drac login credentials found. Please add the 'username' and 'password' "
        "fields beneath a 'drac' key in the master configuration file. Or you can "
        "pass in a username and password as kwargs at the CLI."
    )

if not username:
        if drac_cred is None:
            log.error(err_msg)
            return False
        username = drac_cred.get("username", None)
    if not password:
        if drac_cred is None:
            log.error(err_msg)
            return False
        password = drac_cred.get("password", None)

client = paramiko.SSHClient()
    client.set_missing_host_key_policy(paramiko.AutoAddPolicy())

try:
        client.connect(hostname, username=username, password=password, timeout=timeout)
    except Exception as e:  # pylint: disable=broad-except
        log.error("Unable to connect to %s: %s", hostname, e)
        return False

return client

def __version(client):
    """
    Grab DRAC version
    """
    versions = {
        9: "CMC",
        8: "iDRAC6",
        10: "iDRAC6",
        11: "iDRAC6",
        16: "iDRAC7",
        17: "iDRAC7",
    }

if isinstance(client, paramiko.SSHClient):
        (stdin, stdout, stderr) = client.exec_command("racadm getconfig -g idRacInfo")

for i in stdout.readlines():
            if i[2:].startswith("idRacType"):
                return versions.get(int(i[2:].split("=")[1]), None)

return None

def pxe(hostname, timeout=20, username=None, password=None):
    """
    Connect to the Dell DRAC and have the boot order set to PXE
    and power cycle the system to PXE boot

CLI Example:

.. code-block:: bash

salt-run drac.pxe example.com
    """
    _cmds = [
        "racadm config -g cfgServerInfo -o cfgServerFirstBootDevice pxe",
        "racadm config -g cfgServerInfo -o cfgServerBootOnce 1",
        "racadm serveraction powercycle",
    ]

client = __connect(hostname, timeout, username, password)

if isinstance(client, paramiko.SSHClient):
        for i, cmd in enumerate(_cmds, 1):
            log.info("Executing command %s", i)

(stdin, stdout, stderr) = client.exec_command(cmd)

if "successful" in stdout.readline():
            log.info("Executing command: %s", cmd)
        else:
            log.error("Unable to execute: %s", cmd)
            return False

return True

def reboot(hostname, timeout=20, username=None, password=None):
    """
    Reboot a server using the Dell DRAC

CLI Example:

.. code-block:: bash

salt-run drac.reboot example.com
    """
    client = __connect(hostname, timeout, username, password)

if isinstance(client, paramiko.SSHClient):
        (stdin, stdout, stderr) = client.exec_command("racadm serveraction powercycle")

if "successful" in stdout.readline():
            log.info("powercycle successful")
        else:
            log.error("powercycle racadm command failed")
            return False
    else:
        log.error("client was not of type paramiko.SSHClient")
        return False

return True

def poweroff(hostname, timeout=20, username=None, password=None):
    """
    Power server off

CLI Example:

.. code-block:: bash

salt-run drac.poweroff example.com
    """
    client = __connect(hostname, timeout, username, password)

if isinstance(client, paramiko.SSHClient):
        (stdin, stdout, stderr) = client.exec_command("racadm serveraction powerdown")

if "successful" in stdout.readline():
            log.info("powerdown successful")
        else:
            log.error("powerdown racadm command failed")
            return False
    else:
        log.error("client was not of type paramiko.SSHClient")
        return False

return True

def poweron(hostname, timeout=20, username=None, password=None):
    """
    Power server on

CLI Example:

.. code-block:: bash

salt-run drac.poweron example.com
    """
    client = __connect(hostname, timeout, username, password)

if isinstance(client, paramiko.SSHClient):
        (stdin, stdout, stderr) = client.exec_command("racadm serveraction powerup")

if "successful" in stdout.readline():
            log.info("powerup successful")
        else:
            log.error("powerup racadm command failed")
            return False
    else:
        log.error("client was not of type paramiko.SSHClient")
        return False

return True

def version(hostname, timeout=20, username=None, password=None):
    """
    Display the version of DRAC

CLI Example:

.. code-block:: bash

salt-run drac.version example.com
    """
    return __version(__connect(hostname, timeout, username, password))