Current File : //lib/python2.7/site-packages/salt/proxy/cimc.pyc
�
���^c @@ s d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l m
Z d g Z i d d 6Z
i Z e j e � Z d Z d � Z d � Z d d e d
� Z d e d � Z d � Z d d
� Z d � Z d � Z d � Z d � Z d � Z d � Z d S( u�
Proxy Minion interface module for managing Cisco Integrated Management Controller devices
=========================================================================================
.. versionadded:: 2018.3.0
:codeauthor: ``Spencer Ervin <spencer_ervin@hotmail.com>``
:maturity: new
:depends: none
:platform: unix
This proxy minion enables Cisco Integrated Management Controller devices (hereafter referred to
as simply 'cimc' devices to be treated individually like a Salt Minion.
The cimc proxy leverages the XML API functionality on the Cisco Integrated Management Controller.
The Salt proxy must have access to the cimc on HTTPS (tcp/443).
More in-depth conceptual reading on Proxy Minions can be found in the
:ref:`Proxy Minion <proxy-minion>` section of Salt's
documentation.
Configuration
=============
To use this integration proxy module, please configure the following:
Pillar
------
Proxy minions get their configuration from Salt's Pillar. Every proxy must
have a stanza in Pillar and a reference in the Pillar top-file that matches
the ID.
.. code-block:: yaml
proxy:
proxytype: cimc
host: <ip or dns name of cimc host>
username: <cimc username>
password: <cimc password>
proxytype
^^^^^^^^^
The ``proxytype`` key and value pair is critical, as it tells Salt which
interface to load from the ``proxy`` directory in Salt's install hierarchy,
or from ``/srv/salt/_proxy`` on the Salt Master (if you have created your
own proxy module, for example). To use this cimc Proxy Module, set this to
``cimc``.
host
^^^^
The location, or ip/dns, of the cimc host. Required.
username
^^^^^^^^
The username used to login to the cimc host. Required.
password
^^^^^^^^
The password used to login to the cimc host. Required.
i ( t absolute_importt print_functiont unicode_literalsN( t ElementTreeu cimcu Ciscou vendorc C@ s t S( u7
Only return if all the modules are available.
( t __virtualname__( ( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyt __virtual__] s c C@ s d | d k r! t j d � t Sd | d k rB t j d � t Sd | d k rc t j d � t Sd j | d d � t d <i d
d 6d d
6d d 6t d <| d d t d <| d j d � t d <| d j d � t d <t j d � t d � t j d � t t d <d S( u=
This function gets called when the proxy starts up.
u hostu proxyu- No 'host' key found in pillar for this proxy.u usernameu1 No 'username' key found in pillar for this proxy.u passwordu2 No 'passwords' key found in pillar for this proxy.u https://{0}/nuovau urlu! application/x-www-form-urlencodedu Content-Typei> u Content-Lengthu lwp-request/2.06u
USER-Agentu headersu) Attempting to connect to cimc proxy host.u computeRackUnitu* Successfully connected to cimc proxy host.u initializedN( t logt criticalt Falset formatt DETAILSt gett debugt get_config_resolver_classt True( t opts( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyt initd s(
c C@ s� i } t � } d } | t k r* d } n d j | | | | � } t d t d d | d d d d
d t d t d
t d t d �} t j d | d � d } t j | � } t
| � x! | D] }
t |
� | |
j <q� W| S( up
The configConfMo method configures the specified managed object in a single subtree (for example, DN).
u falseu trueu` <configConfMo cookie="{0}" inHierarchical="{1}" dn="{2}"><inConfig>{3}</inConfig></configConfMo>u
http.queryu urlt datat methodu POSTt decode_typeu plaint decodet
verify_sslt raise_errort headersu headersu (<[\s\S.]*>)u texti (
t logonR R t __utils__R
R t ret findallt ETt
fromstringt logoutt prepare_returnt tag( t dnt inconfigt hierarchicalt rett cookiet ht payloadt rt answert itemst item( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyt set_config_modify� s*
c
C@ s� i } t � } d } | t k r* d } n d j | | | � } t d t d d | d d d d
d t d t d
t d t d �} t j d | d � d } t j | � } t
| � x! | D] } t | � | | j <q� W| S( uZ
The configResolveClass method returns requested managed object in a given class.
u falseu trueuE <configResolveClass cookie="{0}" inHierarchical="{1}" classId="{2}"/>u
http.queryu urlR R u POSTR u plainR R R R u headersu (<[\s\S.]*>)u texti (
R R R R R
R R R R R R R R (
t cidR# R$ R% R& R' R( R) R* R+ ( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyR
� s(
c C@ s� i } d j t d t d � } t d t d d | d d d d
d t d t d
t d t d �} t j d | d � d } t j | � } x" | j D] } | j | | | <q� Wd | k r� t
j j d � � n | d S( uC
Logs into the cimc device and returns the session cookie.
u3 <aaaLogin inName='{0}' inPassword='{1}'></aaaLogin>u usernameu passwordu
http.queryu urlR R u POSTR u plainR R R R u headersu (<[\s\S.]*>)u texti u outCookieu Unable to log into proxy device.(
R R
R R R R R R R t attribt saltt
exceptionst CommandExecutionError( t contentR' R( R) R* R+ ( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyR � s"
c C@ sS d j | � } t d t d d | d d d d d t d
t d t d t d
�d S( u-
Closes the session with the device.
u3 <aaaLogout cookie="{0}" inCookie="{0}"></aaaLogout>u
http.queryu urlR R u POSTR u plainR R R R u headersN( R R R
R R ( R% R' ( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyR � s c C@ s i } xM t | � D]? } | j | k r8 g | | j <n | | j j t | � � q Wx" | j D] } | j | | | <q` W| S( u$
Converts the etree to dict
( t listR t appendR R. ( t xR$ t a( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyR � s c C@ s t j d t � S( u�
Since grains are loaded in many different places and some of those
places occur before the proxy can be initialized, return whether
our init() function has been called
u initialized( R
R R ( ( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyt initialized� s c C@ so t j d i � sg t t d <y% t d t � } | d d t d <Wqg t k
rc } t j | � qg Xn t d S( u0
Get the grains from the proxied device
u grains_cacheu computeRackUnitu
outConfigs( R
R t GRAINS_CACHER
R t ExceptionR t error( t compute_rackt err( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyt grains s
c C@ s d t d <t � S( u4
Refresh the grains from the proxied device
u grains_cacheN( t NoneR
R= ( ( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyt grains_refresh s
c C@ s? y t � } t | � Wn! t k
r: } t j | � t SXt S( u>
Returns true if the device is reachable, else false.
( R R R9 R R R R ( R% R< ( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyt ping s
c C@ s t j d � d S( u_
Shutdown the connection to the proxy device. For this proxy,
shutdown is a no-op.
u CIMC proxy shutdown() called.N( R R ( ( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyt shutdown# s (! t __doc__t
__future__R R R t loggingR t salt.exceptionsR/ t salt._compatR R t __proxyenabled__R8 R
t getLoggert __file__R R R R R> R R, R
R R R R7 R= R? R@ RA ( ( ( s3 /usr/lib/python2.7/site-packages/salt/proxy/cimc.pyt <module>C s,
Mini Shell