Current File : //lib/python2.7/site-packages/salt/states/cimc.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z e j e � Z d � Z d � Z
d d � Z d d d � Z
d � Z d d d d � Z d d d
� Z d d d d d d
� Z d S( u�
A state module to manage Cisco UCS chassis devices.
:codeauthor: ``Spencer Ervin <spencer_ervin@hotmail.com>``
:maturity: new
:depends: none
:platform: unix
About
=====
This state module was designed to handle connections to a Cisco Unified Computing System (UCS) chassis. This module
relies on the CIMC proxy module to interface with the device.
.. seealso::
:py:mod:`CIMC Proxy Module <salt.proxy.cimc>`
i ( t absolute_importt print_functiont unicode_literalsNc C@ s
d t k S( Nu cimc.get_system_info( t __salt__( ( ( s4 /usr/lib/python2.7/site-packages/salt/states/cimc.pyt __virtual__ s c C@ s& i | d 6i d 6t d 6d d 6} | S( u+
Set the default response values.
u nameu changesu resultu u comment( t False( t namet ret( ( s4 /usr/lib/python2.7/site-packages/salt/states/cimc.pyt _default_ret s
c C@ s� t | � } t d � } t } y� | | k r7 t } n | r� t d | � } | sk t | d <d | d <| S| | d d <| | d d <d | d <n
d
| d <Wn5 t k
r� } t | d <d | d <t j | � | SXt | d <| S( uA
Ensures that the hostname is set to the specified value.
.. versionadded:: 2019.2.0
name: The name of the module function to execute.
hostname(str): The hostname of the server.
SLS Example:
.. code-block:: yaml
set_name:
cimc.hostname:
- hostname: foobar
u cimc.get_hostnameu cimc.set_hostnameu resultu Error setting hostname.u commentu changesu beforeu afteru Hostname modified.u1 Hostname already configured. No changes required.u Error occurred setting hostname.( R R R t Truet Exceptiont logt error( R t hostnameR t current_namet
req_changet updatet err( ( s4 /usr/lib/python2.7/site-packages/salt/states/cimc.pyR
. s.
c C@ s@ t | � } t d � } t } y� | d d d } | rS | d | k rS t } n | rr | d | k rr t } n | r� t d | | � } | d d d d d
k r� t | d <d | d
<| S| | d d <t d � | d d <d | d
<n
d | d
<Wn5 t k
r1} t | d <d | d
<t j | � | SXt | d <| S( u1
Ensures that the logging levels are set on the device. The logging levels
must match the following options: emergency, alert, critical, error, warning,
notice, informational, debug.
.. versionadded:: 2019.2.0
name: The name of the module function to execute.
remote(str): The logging level for SYSLOG logs.
local(str): The logging level for the local device.
SLS Example:
.. code-block:: yaml
logging_levels:
cimc.logging_levels:
- remote: informational
- local: notice
u cimc.get_syslog_settingsu
outConfigsu
commSyslogi u remoteSeverityu
localSeverityu cimc.set_logging_levelsu outConfigu statusu modifiedu resultu Error setting logging levels.u commentu changesu beforeu afteru Logging level settings modified.u6 Logging level already configured. No changes required.u. Error occurred setting logging level settings.( R R R R R
R R ( R t remotet localR t syslog_confR t syslog_dictR R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/cimc.pyt logging_levelsg s4
c
C@ s@ t | � } d d d d g } t | t � r[ d } x/ | D] } | | | <| d 7} q: Wn
| | d <t d � } t } y� | d d d d d k s| d | d d d d k s| d | d d d d
k s| d | d d d d k s| d
| d d d d k r t } n Wn5 t k
rX} t | d <d | d <t j | � | SX| r(ya t d | d | d | d | d
� } | d d d d d k r�t | d <d | d <| SWn5 t k
r�} t | d <d | d <t j | � | SX| | d d <t d � | d d <d | d <n
d | d <t | d <| S( uI
Ensures that the NTP servers are configured. Servers are provided as an individual string or list format. Only four
NTP servers will be reviewed. Any entries past four will be ignored.
name: The name of the module function to execute.
servers(str, list): The IP address or FQDN of the NTP servers.
SLS Example:
.. code-block:: yaml
ntp_configuration_list:
cimc.ntp:
- servers:
- foo.bar.com
- 10.10.10.10
ntp_configuration_str:
cimc.ntp:
- servers: foo.bar.com
u i i u cimc.get_ntpu
outConfigsu commNtpProvideru ntpEnableu yesu
ntpServer1u
ntpServer2i u
ntpServer3i u
ntpServer4u resultu' Unable to confirm current NTP settings.u commentu cimc.set_ntp_serveru outConfigu statusu modifiedu Error setting NTP configuration.u changesu beforeu afteru NTP settings modified.u, NTP already configured. No changes required.(
R t
isinstancet listR R R t KeyErrorR R R
(
R t serversR t ntp_serverst it xt confR R R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/cimc.pyt ntp� sV
c
C@ s� t | � } t d � } t } y7| d d d } | rS | d | k rS t } nx | d k r� | d | k rx t } q� | d d k r� t | d � t | � k r� t } q� q� n t | d
<d | d <| S| rKt d
| | | � } | d d d d d k rt | d
<d | d <| S| | d d <t d � | d d <d | d <n
d | d <Wn5 t k
r�} t | d
<d | d <t j | � | SXt | d
<| S( u
Ensures that the power configuration is configured on the system. This is
only available on some C-Series servers.
.. versionadded:: 2019.2.0
name: The name of the module function to execute.
policy(str): The action to be taken when chassis power is restored after
an unexpected power loss. This can be one of the following:
reset: The server is allowed to boot up normally when power is
restored. The server can restart immediately or, optionally, after a
fixed or random delay.
stay-off: The server remains off until it is manually restarted.
last-state: The server restarts and the system attempts to restore
any processes that were running before power was lost.
delayType(str): If the selected policy is reset, the restart can be
delayed with this option. This can be one of the following:
fixed: The server restarts after a fixed delay.
random: The server restarts after a random delay.
delayValue(int): If a fixed delay is selected, once chassis power is
restored and the Cisco IMC has finished rebooting, the system waits for
the specified number of seconds before restarting the server. Enter an
integer between 0 and 240.
SLS Example:
.. code-block:: yaml
reset_power:
cimc.power_configuration:
- policy: reset
- delayType: fixed
- delayValue: 0
power_off:
cimc.power_configuration:
- policy: stay-off
u cimc.get_power_configurationu
outConfigsu biosVfResumeOnACPowerLossi u vpResumeOnACPowerLossu resetu delayTypeu fixedu delayu resultu# The power policy must be specified.u commentu cimc.set_power_configurationu outConfigu statusu modifiedu" Error setting power configuration.u changesu beforeu afteru Power settings modified.u7 Power settings already configured. No changes required.u& Error occurred setting power settings.( R R R R t strR
R R (
R t policyt delayTypet
delayValueR t
power_confR t
power_dictR R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/cimc.pyt power_configuration� sF 3
c C@ s� t | � } t d � } t } | r:t } d | k r� d | d k r� xX | d d D]E } | d d k rr qV n | d d k rV | d | k rV t } qV qV Wn | r:yT t d | d � } | d
d d d d
k r� t } n t | d <d | d <| SWq7t k
r3} t | d <d | d <t j | � | SXq:n | rUt }
d
| k r�d | d
k r�xX | d
d D]E } | d d k r�qqn | d d k rq| d | k rqt }
qqqqWn |
rUyT t d | d � } | d
d d d d
k r�t } n t | d <d | d <| SWqRt k
rN} t | d <d | d <t j | � | SXqUn | r�| | d d <t d � | d d <d | d <n
d | d <t | d <| S( u�
Ensures that the syslog servers are set to the specified values. A value of None will be ignored.
name: The name of the module function to execute.
primary(str): The IP address or FQDN of the primary syslog server.
secondary(str): The IP address or FQDN of the secondary syslog server.
SLS Example:
.. code-block:: yaml
syslog_configuration:
cimc.syslog:
- primary: 10.10.10.10
- secondary: foo.bar.com
u cimc.get_syslogu
outConfigsu commSyslogClientu nameu primaryu
adminStateu enabledu hostnameu cimc.set_syslog_serveru outConfigi u statusu modifiedu resultu$ Error setting primary SYSLOG server.u commentu secondaryu& Error setting secondary SYSLOG server.u changesu beforeu afteru SYSLOG settings modified.u/ SYSLOG already configured. No changes required.( R R R R R
R R ( R t primaryt secondaryR R R t prim_changet entryR R t
sec_change( ( s4 /usr/lib/python2.7/site-packages/salt/states/cimc.pyt syslog_ sh
u u activec C@ s0 t | � } t d � } y� x5 | d d D]% } | d t | � k r+ | } q+ q+ W| sr t | d <d | d <| St d t | � | | | | � }
d |
k r� | | d
d <|
d d | d
d <d
| d <n t | d <d | d <| SWn5 t k
r!} t | d <d | d <t j | � | SXt | d <| S( u�
Ensures that a user is configured on the device. Due to being unable to
verify the user password. This is a forced operation.
.. versionadded:: 2019.2.0
name: The name of the module function to execute.
id(int): The user ID slot on the device.
user(str): The username of the user.
priv(str): The privilege level of the user.
password(str): The password of the user.
status(str): The status of the user. Can be either active or inactive.
SLS Example:
.. code-block:: yaml
user_configuration:
cimc.user:
- id: 11
- user: foo
- priv: admin
- password: mypassword
- status: active
u cimc.get_usersu
outConfigsu aaaUseru idu resultuF Unable to find requested user id on device. Please verify id is valid.u commentu
cimc.set_useru outConfigu changesu beforeu afteru User settings modified.u! Error setting user configuration.( R R R R R
R R R ( R t idt usert privt passwordt statusR t user_confR* R t updatesR ( ( s4 /usr/lib/python2.7/site-packages/salt/states/cimc.pyR. � s2 !
"
( t __doc__t
__future__R R R t loggingt getLoggert __name__R R R t NoneR
R R R& R, R. ( ( ( s4 /usr/lib/python2.7/site-packages/salt/states/cimc.pyt <module> s 9A ReV
Mini Shell