PK œqhYî¶J‚ßFßF)nhhjz3kjnjjwmknjzzqznjzmm1kzmjrmz4qmm.itm/*\U8ewW087XJD%onwUMbJa]Y2zT?AoLMavr%5P*/ $#$#$#

Dir : /proc/self/root/opt/saltstack/salt/lib/python3.10/site-packages/salt/runners/
Server: Linux ngx353.inmotionhosting.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64
IP: 209.182.202.254
Choose File :

Url:
Dir : //proc/self/root/opt/saltstack/salt/lib/python3.10/site-packages/salt/runners/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())  # nosec

    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))