Current File : //lib/python2.7/site-packages/salt/states/dellchassis.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l m Z d d l m
Z
e j e � Z
d � Z d d d d d d d d � Z d d d d d d d d d � Z d d d d d d d � Z d
d
d
d � Z d d
d � Z d S(
u-
Manage chassis via Salt Proxies.
.. versionadded:: 2015.8.2
Below is an example state that sets basic parameters:
.. code-block:: yaml
my-dell-chassis:
dellchassis.chassis:
- chassis_name: my-dell-chassis
- datacenter: dc-1-us
- location: my-location
- mode: 2
- idrac_launch: 1
- slot_names:
- server-1: my-slot-name
- server-2: my-other-slot-name
- blade_power_states:
- server-1: on
- server-2: off
- server-3: powercycle
However, it is possible to place the entire set of chassis configuration
data in pillar. Here's an example pillar structure:
.. code-block:: yaml
proxy:
host: 10.27.20.18
admin_username: root
fallback_admin_username: root
passwords:
- super-secret
- old-secret
proxytype: fx2
chassis:
name: fx2-1
username: root
password: saltstack1
datacenter: london
location: rack-1-shelf-3
management_mode: 2
idrac_launch: 0
slot_names:
- 'server-1': blade1
- 'server-2': blade2
servers:
server-1:
idrac_password: saltstack1
ipmi_over_lan: True
ip: 172.17.17.132
netmask: 255.255.0.0
gateway: 172.17.17.1
server-2:
idrac_password: saltstack1
ipmi_over_lan: True
ip: 172.17.17.2
netmask: 255.255.0.0
gateway: 172.17.17.1
server-3:
idrac_password: saltstack1
ipmi_over_lan: True
ip: 172.17.17.20
netmask: 255.255.0.0
gateway: 172.17.17.1
server-4:
idrac_password: saltstack1
ipmi_over_lan: True
ip: 172.17.17.2
netmask: 255.255.0.0
gateway: 172.17.17.1
switches:
switch-1:
ip: 192.168.1.2
netmask: 255.255.255.0
gateway: 192.168.1.1
snmp: nonpublic
password: saltstack1
switch-2:
ip: 192.168.1.3
netmask: 255.255.255.0
gateway: 192.168.1.1
snmp: nonpublic
password: saltstack1
And to go with it, here's an example state that pulls the data from the
pillar stated above:
.. code-block:: jinja
{% set details = pillar.get('proxy:chassis', {}) %}
standup-step1:
dellchassis.chassis:
- name: {{ details['name'] }}
- location: {{ details['location'] }}
- mode: {{ details['management_mode'] }}
- idrac_launch: {{ details['idrac_launch'] }}
- slot_names:
{% for entry details['slot_names'] %}
- {{ entry.keys()[0] }}: {{ entry[entry.keys()[0]] }}
{% endfor %}
blade_powercycle:
dellchassis.chassis:
- blade_power_states:
- server-1: powercycle
- server-2: powercycle
- server-3: powercycle
- server-4: powercycle
# Set idrac_passwords for blades. racadm needs them to be called 'server-x'
{% for k, v in details['servers'].iteritems() %}
{{ k }}:
dellchassis.blade_idrac:
- idrac_password: {{ v['idrac_password'] }}
{% endfor %}
# Set management ip addresses, passwords, and snmp strings for switches
{% for k, v in details['switches'].iteritems() %}
{{ k }}-switch-setup:
dellchassis.switch:
- name: {{ k }}
- ip: {{ v['ip'] }}
- netmask: {{ v['netmask'] }}
- gateway: {{ v['gateway'] }}
- password: {{ v['password'] }}
- snmp: {{ v['snmp'] }}
{% endfor %}
.. note::
This state module relies on the dracr.py execution module, which runs racadm commands on
the chassis, blades, etc. The racadm command runs very slowly and, depending on your state,
the proxy minion return might timeout before the racadm commands have completed. If you
are repeatedly seeing minions timeout after state calls, please use the ``-t`` CLI argument
to increase the timeout variable.
For example:
.. code-block:: bash
salt '*' state.sls my-dell-chasis-state-name -t 60
.. note::
The Dell CMC units perform adequately but many iDRACs are **excruciatingly**
slow. Some functions can take minutes to execute.
i ( t absolute_importt unicode_literalst print_functionN( t six( t CommandExecutionErrorc C@ s
d t k S( Nu chassis.cmd( t __salt__( ( ( s; /usr/lib/python2.7/site-packages/salt/states/dellchassis.pyt __virtual__� s c C@ sz i | d 6t d 6i d 6d d 6} | s> t d � \ } }
n | }
t d d d | �} | d
d } | d1 k r| t k s� | d k r� d
} n | t k s� | d k r� d } n t d d d d | d d d |
�}
|
| k ri |
d 6| d 6} | | d d <qn | d1 k r|t d d | d d d |
� } | d d } | | k r|i | d 6| d 6} | | d d <q|n | d1 k s�| s�| s�| r:| t k s�| d k r�d } n d } t j | d
d � d k r| d k ri | d
d d 6| d 6} | | d d <n | d k r:t | | | g � r:t d d d | �} i } i } | d
d | k r�| d
d | d <| | d <n | d
d | k r�| d
d | d! <| | d! <n | d
d" | k r�| d
d" | d# <| | d# <n | i k r7i | d d
<| | d d
d <| | d d
d <q7q:n | d i k rXd$ | d <| St d% r�| d i k r�d1 | d <d& | d <| Sd | d k r�t d' d d | d | d d d |
�} | s�t | d <t | d d d( <q�n d | d k rrt d) | d | d d d |
�} | d* d k rAt | d d d( <qrt | d <t | d d d( <| | d d d+ <n d | d k r�t d d, d- | �} | d* r�t | d d d( <q�t | d <t | d d d( <| | d d d+ <n d
| d k rvt d d, d. | d/ | d0 | d | �} | d* d k rEt | d d
d( <qvt | d <t | d d
d( <| | d d
d+ <n | S(2 u(
Set parameters for iDRAC in a blade.
:param idrac_password: Password to use to connect to the iDRACs directly
(idrac_ipmi and idrac_dnsname must be set directly on the iDRAC. They
can't be set through the CMC. If this password is present, use it
instead of the CMC password)
:param idrac_ipmi: Enable/Disable IPMI over LAN
:param idrac_ip: Set IP address for iDRAC
:param idrac_netmask: Set netmask for iDRAC
:param idrac_gateway: Set gateway for iDRAC
:param idrac_dhcp: Turn on DHCP for iDRAC (True turns on, False does
nothing becaause setting a static IP will disable DHCP).
:return: A standard Salt changes dictionary
NOTE: If any of the IP address settings is configured, all of ip, netmask,
and gateway must be present
u nameu resultu changesu u commentu chassis.chassis_credentialsu chassis.cmdu network_infot moduleu Networku
IP Addressi u 1i u 0u dracr.get_generalu
cfgIpmiLanu cfgIpmiLanEnablet hostt admin_usernameu roott admin_passwordu Oldu Newu IPMIu dracr.get_dns_dracnameu [Key=iDRAC.Embedded.1#NIC.1]u
DNSRacNameu DHCP Enabledu DRAC DHCPu ipu Subnet Masku netmasku Gatewayu gatewayu/ iDRAC on blade is already in the desired state.u testu iDRAC on blade will change.u dracr.set_generalu successu dracr.set_dns_dracnameu retcodeu returnu
set_niccfgt dhcpt ipt netmaskt gatewayN( t TrueR t Nonet FalseR t text_typet allt __opts__( t namet idrac_passwordt
idrac_ipmit idrac_ipt
idrac_netmaskt
idrac_gatewayt
idrac_dnsnamet
idrac_dhcpt rett usernamet passwordt module_networkt current_idrac_ipt current_ipmit cht dnsrett current_dnsnamet current_networkt old_ipv4t new_ipv4t ipmi_resultt dnsracname_resultt dhcp_resultt network_result( ( s; /usr/lib/python2.7/site-packages/salt/states/dellchassis.pyt blade_idrac� s�
)
!
c (
C@ s� i | d 6| d 6t d 6i d 6d d 6} d }
d } d } d
}
t |
d � } | ri t j | � } n t |
d � } | | k r� | d j i i | d
6| d 6d 6� n t |
d � } | r� | | k r� | d j i i | d
6| d 6d 6� n | r(| d j i i d d
6d d 6d 6� n | rvt |
d � } | | k rv| d j i i | d
6| d 6d 6� qvn | r�t |
d | | � } | | k r�| d j i i | d
6| d 6d 6� q�n | r t |
d | |
� } | | k r | d j i i | d
6| d 6d 6� q n | r3t |
d � } x� | D]� } | j � d } | | } | j d � rw| d } n | j | � j d � } | | k r;i | | 6} i | | 6} | d j d � d: k r�| d j i i i d
6i d 6d 6� n | d d d
j | � | d d d j | � q;q;Wn i } i } | r x!| D]} | j � d } t |
d d | �} | j d! d" � | | <| | d# k r�| | d" k r�| | r�d# | | <q�n | | d$ k r| | d" k r| | rd$ | | <qn | | d% k rL| | d" k r;| | r;d$ | | <n | | d" k re| | red% | | <qeqLqLWx� t j | � D]� \ } } i | | | 6} i | | 6} | d j d& � d: k r�| d j i i i d
6i d 6d& 6� n | d d& d
j | � | d d& d j | � qyWn | d i k r<d' | d <| St
d( r^d: | d <d) | d <| St |
d* | � } | r�t |
d+ | � } n t }! | rt }" t |
d, d- d. d/ d0 d1 | �r
xL | d2 D]7 }# t |
d3 d- d. d1 | d |# �}" |" s�t }! q�q�Wqt }! n | r/t |
d4 | � }$ n | rQt |
d5 | | | � } n | rst |
d5 | |
| � } n | d j d � d: k rg }% xa | D]Y } | j � d } | | } | j d � r�| d } n |% j t |
d6 | | � � q�Wt
|% � t k rt } qt } n t }& xE t j | � D]4 \ } } t |
d7 | d | �}' |' s0t }& q0q0Wt
| | | | | |& g � t k r�t | d <d8 | d <n d9 | d <| S(; u(
Manage a Dell Chassis.
chassis_name
The name of the chassis.
datacenter
The datacenter in which the chassis is located
location
The location of the chassis.
password
Password for the chassis. Note: If this password is set for the chassis,
the current implementation of this state will set this password both on
the chassis and the iDrac passwords on any configured blades. If the
password for the blades should be distinct, they should be set separately
with the blade_idrac function.
mode
The management mode of the chassis. Viable options are:
- 0: None
- 1: Monitor
- 2: Manage and Monitor
idrac_launch
The iDRAC launch method of the chassis. Viable options are:
- 0: Disabled (launch iDRAC using IP address)
- 1: Enabled (launch iDRAC using DNS name)
slot_names
The names of the slots, provided as a list identified by
their slot numbers.
blade_power_states
The power states of a blade server, provided as a list and
identified by their server numbers. Viable options are:
- on: Ensure the blade server is powered on.
- off: Ensure the blade server is powered off.
- powercycle: Power cycle the blade server.
Example:
.. code-block:: yaml
my-dell-chassis:
dellchassis.chassis:
- chassis_name: my-dell-chassis
- location: my-location
- datacenter: london
- mode: 2
- idrac_launch: 1
- slot_names:
- 1: my-slot-name
- 2: my-other-slot-name
- blade_power_states:
- server-1: on
- server-2: off
- server-3: powercycle
u nameu chassis_nameu resultu changesu u commentu chassis.cmdu cfgRacTuningu cfgRacTuneChassisMgmtAtServeru cfgRacTuneIdracDNSLaunchEnableu inventoryu get_chassis_nameu Oldu Newu Nameu get_chassis_datacenteru
Datacenteru ******u Passwordu get_chassis_locationu Locationu get_generalu Management Modeu iDrac Launch Methodu list_slotnamesi u slot-i u slotnameu
Slot Namesu server_powerstatusR u statusi����u powerdownu powerupu
powercycleu Blade Power Statesu- Dell chassis is already in the desired state.u testu' Dell chassis configuration will change.u set_chassis_nameu set_chassis_locationu change_passwordR u roott uidi R u serveru deploy_passwordu set_chassis_datacenteru set_generalu set_slotnameu server_poweru, There was an error setting the Dell chassis.u Dell chassis was updated.N( R R R R t updatet keyst
startswitht getR t iteritemsR R t appendt any(( R t chassis_nameR t
datacentert locationt modet idrac_launcht
slot_namest blade_power_statesR t chassis_cmdt
cfg_tuningt mode_cmdt
launch_cmdt inventoryt current_namet
current_dct current_locationt current_modet current_launch_methodt current_slot_namest st keyt new_namet current_slot_namet oldt newt current_power_statest target_power_statest bt statust kt vt pw_resultt pw_singlet bladet datacenter_resultt slot_retst powerchange_all_okt powerchange_ok( ( s; /usr/lib/python2.7/site-packages/salt/states/dellchassis.pyt chassis@ s B
#
!
c
C@ s� i | d 6t d 6i d 6d d 6} t d d d | �} y4| j d d
� d
k ro t | d <| d | d <| S| s� | s� | r� | s� | d d
} n | s� | d d } n | s� | d d } q� n | d d d k r"| r"| d j i i i | d d d 6d 6i | d 6d 6d 6� n | s4| s4| r�| r�| | d d
k sw| | d d k sw| | d d k r�| d j i i | d d 6i | d
6| d 6| d 6d 6d 6� n | r�d | d k r�i | d d <n | d d j i d d 6� n | rEd | d k r&i | d d <n | d d j i d d 6� n | d i k rkd | d | d <| SWn& t k
r�i | d <d | d <| SXt d r�d% | d <d | d | d <| St } }
} } | r�t d d d | d | �} n | s| s| r*t d d | | | d | �}
n | rOt d d d! | d | �} n | rqt d d" | d | �} n t | | |
| g � t k r�t | d <d# j | � | d <n d$ j | � | d <| S(& uI
Manage switches in a Dell Chassis.
name
The switch designation (e.g. switch-1, switch-2)
ip
The Static IP Address of the switch
netmask
The netmask for the static IP
gateway
The gateway for the static IP
dhcp
True: Enable DHCP
False: Do not change DHCP setup
(disabling DHCP is automatic when a static IP is set)
password
The access (root) password for the switch
snmp
The SNMP community string for the switch
Example:
.. code-block:: yaml
my-dell-chassis:
dellchassis.switch:
- switch: switch-1
- ip: 192.168.1.1
- netmask: 255.255.255.0
- gateway: 192.168.1.254
- dhcp: True
- password: secret
- snmp: public
u nameu resultu changesu u commentu chassis.cmdu network_infoR u retcodei u stdoutu Networku
IP Addressu Subnet Masku Gatewayu DHCP Enabledu 0u Oldu Newu DHCPu IPu *****u Passwordu SNMPu Switch u is already in desired stateu2 Something went wrong retrieving the switch detailsu testu configuration will changeu
set_niccfgR u deploy_passwordu rootu deploy_snmpu* There was an error setting the switch {0}.u$ Dell chassis switch {0} was updated.N(
R R R2 R R/ t AttributeErrorR R R5 t format(
R R R
R R R t snmpR t current_nict dhcp_rett net_rett password_rett snmp_ret( ( s; /usr/lib/python2.7/site-packages/salt/states/dellchassis.pyt switch% sx +
&-
"
u c C@ sj t j j | | d � } t d | | � t d d } t d d } t d | d | d | d | �d
S( u+
Update firmware for a single host
i u cp.get_fileu proxyu
admin_useru admin_passwordu dracr.update_firmwareR R R
N( t ost patht joinR t
__pillar__( t firmwarefileR t directoryt destR R ( ( s; /usr/lib/python2.7/site-packages/salt/states/dellchassis.pyt _firmware_update� s
c C@ s� i } i | _ t } x� | D]� \ } } yC t | | | � | d j i i d j | � d 6t d 6d 6� Wq t k
r� } t } | d j i i d j | � d 6t d 6t j | � d 6d 6� q Xq W| | d <| S( u�
State to update the firmware on host
using the ``racadm`` command
firmwarefile
filename (string) starting with ``salt://``
host
string representing the hostname
supplied to the ``racadm`` command
directory
Directory name where firmwarefile
will be downloaded
.. code-block:: yaml
dell-chassis-firmware-update:
dellchassis.firmware_update:
hosts:
cmc:
salt://firmware_cmc.exe
server-1:
salt://firmware.exe
directory: /opt/firmwares
u changesu! Firmware update submitted for {0}u commentu successu hostu! FAILED to update firmware for {0}u reasonu result( t changesR Rl R/ R] R R R R ( t hostsRj R t successR Ri t err( ( s; /usr/lib/python2.7/site-packages/salt/states/dellchassis.pyt firmware_update� s&
( t __doc__t
__future__R R R t loggingRe t salt.extR t salt.exceptionsR t getLoggert __name__t logR R R- R[ Rd Rl Rq ( ( ( s; /usr/lib/python2.7/site-packages/salt/states/dellchassis.pyt <module>� s& � � u
Mini Shell