Current File : //lib/python2.7/site-packages/salt/states/dvs.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 Z d d l Z d d l
m Z d d l m
Z
y d d l m Z e Z Wn e k
r� e Z n Xe j e � Z d � Z d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z d � Z d S( ui
Manage VMware distributed virtual switches (DVSs) and their distributed virtual
portgroups (DVportgroups).
:codeauthor: :email:`Alexandru Bleotu <alexandru.bleotu@morganstaley.com>`
Examples
========
Several settings can be changed for DVSs and DVporgroups. Here are two examples
covering all of the settings. Fewer settings can be used
DVS
---
.. code-block:: python
'name': 'dvs1',
'max_mtu': 1000,
'uplink_names': [
'dvUplink1',
'dvUplink2',
'dvUplink3'
],
'capability': {
'portgroup_operation_supported': false,
'operation_supported': true,
'port_operation_supported': false
},
'lacp_api_version': 'multipleLag',
'contact_email': 'foo@email.com',
'product_info': {
'version':
'6.0.0',
'vendor':
'VMware,
Inc.',
'name':
'DVS'
},
'network_resource_management_enabled': true,
'contact_name': 'me@email.com',
'infrastructure_traffic_resource_pools': [
{
'reservation': 0,
'limit': 1000,
'share_level': 'high',
'key': 'management',
'num_shares': 100
},
{
'reservation': 0,
'limit': -1,
'share_level': 'normal',
'key': 'faultTolerance',
'num_shares': 50
},
{
'reservation': 0,
'limit': 32000,
'share_level': 'normal',
'key': 'vmotion',
'num_shares': 50
},
{
'reservation': 10000,
'limit': -1,
'share_level': 'normal',
'key': 'virtualMachine',
'num_shares': 50
},
{
'reservation': 0,
'limit': -1,
'share_level': 'custom',
'key': 'iSCSI',
'num_shares': 75
},
{
'reservation': 0,
'limit': -1,
'share_level': 'normal',
'key': 'nfs',
'num_shares': 50
},
{
'reservation': 0,
'limit': -1,
'share_level': 'normal',
'key': 'hbr',
'num_shares': 50
},
{
'reservation': 8750,
'limit': 15000,
'share_level': 'high',
'key': 'vsan',
'num_shares': 100
},
{
'reservation': 0,
'limit': -1,
'share_level': 'normal',
'key': 'vdp',
'num_shares': 50
}
],
'link_discovery_protocol': {
'operation':
'listen',
'protocol':
'cdp'
},
'network_resource_control_version': 'version3',
'description': 'Managed by Salt. Random settings.'
Note: The mandatory attribute is: ``name``.
Portgroup
---------
.. code-block:: python
'security_policy': {
'allow_promiscuous': true,
'mac_changes': false,
'forged_transmits': true
},
'name': 'vmotion-v702',
'out_shaping': {
'enabled': true,
'average_bandwidth': 1500,
'burst_size': 4096,
'peak_bandwidth': 1500
},
'num_ports': 128,
'teaming': {
'port_order': {
'active': [
'dvUplink2'
],
'standby': [
'dvUplink1'
]
},
'notify_switches': false,
'reverse_policy': true,
'rolling_order': false,
'policy': 'failover_explicit',
'failure_criteria': {
'check_error_percent': true,
'full_duplex': false,
'check_duplex': false,
'percentage': 50,
'check_speed': 'minimum',
'speed': 20,
'check_beacon': true
}
},
'type': 'earlyBinding',
'vlan_id': 100,
'description': 'Managed by Salt. Random settings.'
Note: The mandatory attributes are: ``name``, ``type``.
Dependencies
============
- pyVmomi Python Module
pyVmomi
-------
PyVmomi can be installed via pip:
.. code-block:: bash
pip install pyVmomi
.. note::
Version 6.0 of pyVmomi has some problems with SSL error handling on certain
versions of Python. If using version 6.0 of pyVmomi, Python 2.7.9,
or newer must be present. This is due to an upstream dependency
in pyVmomi 6.0 that is not supported in Python versions 2.7 to 2.7.8. If the
version of Python is not in the supported range, you will need to install an
earlier version of pyVmomi. See `Issue #29537`_ for more information.
.. _Issue #29537: https://github.com/saltstack/salt/issues/29537
Based on the note above, to install an earlier version of pyVmomi than the
version currently listed in PyPi, run the following:
.. code-block:: bash
pip install pyVmomi==5.5.0.2014.1.1
The 5.5.0.2014.1.1 is a known stable version that this original ESXi State
Module was developed against.
i ( t absolute_importt print_functiont unicode_literalsN( t six( t range( t VmomiSupportc C@ sK t s t d f Sd t j k rG t j d k rG t j d k rG t d f Sd S(
Nu, State module did not load: pyVmomi not foundu vim25/6.0i i i ua State module did not load: Incompatible versions of Python and pyVmomi present. See Issue #29537.u dvs( i i ( i i i ( t HAS_PYVMOMIt FalseR t
versionMapt syst version_info( ( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyt __virtual__� s
c C@ s t S( u
Init function
( t True( t low( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyt mod_init� s c C@ sw t d � } d } | d k r/ t d � } n | d k rK t d � } n | so t j j d j | � � � n | d S( uo
Returns the datacenter name configured on the proxy
Supported proxies: esxcluster, esxdatacenter
u vsphere.get_proxy_typeu
esxclusteru esxcluster.get_detailsu
esxdatacenteru esxdatacenter.get_detailsu' details for proxy type '{0}' not loadedu
datacenterN( t __salt__t Nonet saltt
exceptionst CommandExecutionErrort format( t
proxy_typet details( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyt _get_datacenter_name� s
c C@ s� t � } | j d � r" | d n | } t j d j | | | � � t } i | d 6i d 6d/ d 6d/ d 6} g } i } t } y
t d � } t d d | g d | � } | s_t } t d
r� | j
d j | | | � � t j | d � q|| | d <t d
d | d | d | � | j
d j | | � � t j | d � | j i i | d 6d 6� n d d d d d d d d g }
t j d j | | |
� � i } i } | d }
xW |
D]O } | | k r�| | |
j | � k r�|
j | � | | <| | | | <q�q�Wd } g } g } | | k r|
j | � sC| | } qx� t
t | | � � D]� } d | | | k r�|
| | d d k r�d |
| | k r�|
| | d =n | | | |
| | k rZ| j
|
| | � | j
t | | | � � qZqZWn | r%| | d <| | d <n | r|t d
rd! } x� | D]� } | d k r�| d" 7} x{ t
t | | � � D]? } | | | } | | | } | d# j | d$ | | � 7} quWqB| d% j | | | | | � 7} qBW| j
d& j | | | � � t j | d � nG t d' d | d( | d | � | j
d) j | | � � t j | d � | j i i | d 6| d* 6d 6� n t d+ | � Wn� t j j k
r(} t j d, j | t j � � � | r�t d+ | � n t d
s�t | d <n | j i t j | � d 6t d
st n d/ d 6� | SX| sY| j i d- j | | � d 6t d 6� n; | j i d. j | � d 6| d 6t d
r�d/ n t d 6� | S(0 u�
Configures a DVS.
Creates a new DVS, if it doesn't exist in the provided datacenter or
reconfigures it if configured differently.
dvs
DVS dict representations (see module sysdocs)
u nameu3 Running state {0} for DVS '{1}' in datacenter '{2}'u changesu resultu commentu& vsphere.get_service_instance_via_proxyu vsphere.list_dvsst dvs_namest service_instanceu testu9 State {0} will create a new DVS '{1}' in datacenter '{2}'i����u vsphere.create_dvst dvs_dictt dvs_nameu+ Created a new DVS '{0}' in datacenter '{1}'u newu dvsu descriptionu
contact_emailu contact_nameu lacp_api_versionu link_discovery_protocolu max_mtuu network_resource_control_versionu# network_resource_management_enableduD DVS '{0}' found in datacenter '{1}'. Checking for any updates in {2}i u% infrastructure_traffic_resource_poolsu
num_sharesu share_levelu customu u( infrastructure_traffic_resource_pools:
u {0} from '{1}' to '{2}'
u keyu {0} from '{1}' to '{2}'
uC State dvs_configured will update DVS '{0}' in datacenter '{1}':
{2}u vsphere.update_dvst dvsu% Updated DVS '{0}' in datacenter '{1}'u oldu vsphere.disconnectu Error: {0}
{1}uJ DVS '{0}' in datacenter '{1}' is correctly configured. Nothing to be done.u
N( R t gett logt infoR R R R R t __opts__t appendt updatet traceR t lent dictR R R t errort tracebackt
format_excR t text_typet join( t nameR t datacenter_nameR t changes_requiredt rett commentst changest sit dvsst propst props_to_original_valuest props_to_updated_valuest current_dvst propt
infra_propt original_infra_res_poolst updated_infra_res_poolst idxt changes_stringt pt dt st exc( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyt dvs_configured s�
"
%
c C@ s� i } x� | j � D]� } | | k rN | j i i d d 6| | d 6| 6� q | | | | k r t | | t � r� t | | t � r� t | | | | � } | r� | j i | | 6� q� q� | j i i | | d 6| | d 6| 6� q q W| S( u~
Returns a dictionary with the diffs between two dictionaries
It will ignore any key that doesn't exist in dict2
u val1u val2N( t keysR" R t
isinstanceR% t _get_diff_dict( t dict1t dict2t ret_dictR= t
sub_diff_dict( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyRD � s )&1c C@ s� i } x� | j � D]� } t | | t � sD t d j | � � � n d | | j � k ry | j i | | d | 6� q | j i t | | � | 6� q W| S( uO
Returns a dictionaries with the values stored in val2 of a diff dict.
u Unexpected diff difct '{0}'u val2( RB RC R% t
ValueErrorR R" t _get_val2_dict_from_diff_dict( t diff_dictRG R= ( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyRJ � s c C@ s� i } x� | j � D]� } t | | t � sD t d j | � � � n d | | j � k ry | j i | | d | 6� q | j i t | | � | 6� q W| S( uO
Returns a dictionaries with the values stored in val1 of a diff dict.
u Unexpected diff difct '{0}'u val1( RB RC R% RI R R" t _get_val1_dict_from_diff_dict( RK RG R= ( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyRL � s c C@ s� g } x�| j � D]�} t | | t � sD t d j | � � � n t | | j � � d d g k r}| | d } t | | d t j � r� d j | | d � } n: t | | d t � r� d j d j | | d � � } n | | d } t | | d t j � r$d j | | d � } n: t | | d t � r^d j d j | | d � � } n | j
d j | | | � � q t | | � } | r | j
d j | � � | j g | D] } d j | � ^ q�� q q W| S( u�
Returns a list of string message of the differences in a diff dict.
Each inner message is tabulated one tab deeper
u Unexpected diff difct '{0}'u val1u val2u '{0}'u , u {0} from {1} to {2}u {0}:u {0}(
RB RC R% RI R t sortedR t string_typest listR* R! t _get_changes_from_diff_dictt extend( RK t changes_stringsR= t from_strt to_strt sub_changest c( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyRP � s. "## 'c C@ s� t � } t j d j | | | � � t } i | d 6i d 6d$ d 6d$ d 6} g } i } t } y�t d � } t d d | d | � } g }
xN| D]F} | d } |
j | � | d =t j d
j | � � g | D]! }
|
j d � | k r� |
^ q� } | s�t } t
d r5| j d j | | | | � � n? t d
d | d | d | d | � | j d j | | | � � t j | d � | j i i | d 6| 6� q� t j d j | | | � � | d } t
| | � } | r� t } t
d rZt | � } t j d j | � � | j d j | | | | d j g | D] } d j | � ^ q5� � � n? t d d | d | d | d | � | j d j | | | � � t j | d � | j i i t | � d 6t | � d 6| 6� q� q� Wt d d | d | � } |
j | d � x� | D]� } | d |
k rt } t
d r\| j d j | | d | | � � nA t d d | d d | d | � | j d j | d | | � � t j | d � | j i i | d 6| d 6� qqWt d! | � Wn� t j j k
rz} t j d" j | t j � � � | r1t d! | � n t
d sHt | d <n | j i | j d 6t
d skt n d$ d 6� | SX| s�| j i d# j | | � d 6t d 6� n; | j i d j | � d 6| d 6t
d r�d$ n t d 6� | S(% u�
Configures portgroups on a DVS.
Creates/updates/removes portgroups in a provided DVS
dvs
Name of the DVS
portgroups
Portgroup dict representations (see module sysdocs)
u0 Running state {0} on DVS '{1}', datacenter '{2}'u nameu changesu resultu commentu& vsphere.get_service_instance_via_proxyu vsphere.list_dvportgroupsR R u Checking pg '{0}'u testuJ State {0} will create a new portgroup '{1}' in DVS '{2}', datacenter '{3}'u vsphere.create_dvportgroupt portgroup_dictt portgroup_nameu< Created a new portgroup '{0}' in DVS '{1}', datacenter '{2}'i����u newuO Portgroup '{0}' found in DVS '{1}', datacenter '{2}'. Checking for any updates.i u changes_strings = {0}uI State {0} will update portgroup '{1}' in DVS '{2}', datacenter '{3}':
{4}u
u {0}u vsphere.update_dvportgroupt portgroupu6 Updated portgroup '{0}' in DVS '{1}', datacenter '{2}'u oldu vsphere.list_uplink_dvportgroupuJ State {0} will remove the portgroup '{1}' from DVS '{2}', datacenter '{3}'u vsphere.remove_dvportgroupu< Removed the portgroup '{0}' from DVS '{1}', datacenter '{2}'u vsphere.disconnectu Error: {0}
{1}ue All portgroups in DVS '{0}', datacenter '{1}' exist and are correctly configured. Nothing to be done.N( R R R R R R R R! R R R R" R# RD RP R* RJ RL R R R R& R' R( t strerror( R+ R t
portgroupst
datacenterR- R. R/ R0 R1 t current_pgst expected_pg_namest pgt pg_nameR= t filtered_current_pgst
current_pgRK RR RV t uplink_pgR@ ( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyt portgroups_configured� s�
.
)
c
C@ s� t � } t j d j | | | � � t } i | d 6i d 6d d 6d d 6} g } i } t } y^t d � } t d d | d | � } t j d
j | � � t | | � }
|
r�t } t
d r,t |
� } t j d j | � � | j d
j | | | d j
g | D] } d j | � ^ q� � � n@ t d d | d | d d | d | � | j d j | | � � t j | d � | j i i t |
� d 6t |
� d 6d 6� n t d | � Wn� t j j k
rT}
t j d j |
t j � � � | r t d | � n t
d s"t | d <n | j i |
j d 6t
d sEt n d d 6� | SX| s�| j i d j | | � d 6t d 6� n; | j i d j
| � d 6| d 6t
d r�d n t d 6� | S( u�
Configures the uplink portgroup on a DVS. The state assumes there is only
one uplink portgroup.
dvs
Name of the DVS
upling_portgroup
Uplink portgroup dict representations (see module sysdocs)
u* Running {0} on DVS '{1}', datacenter '{2}'u nameu changesu resultu commentu& vsphere.get_service_instance_via_proxyu vsphere.list_uplink_dvportgroupR R u current_uplink_portgroup = {0}u testu changes_strings = {0}uN State {0} will update the uplink portgroup in DVS '{1}', datacenter '{2}':
{3}u
u {0}u vsphere.update_dvportgroupRW RY u; Updated the uplink portgroup in DVS '{0}', datacenter '{1}'i����u newu oldu uplink_portgroupu vsphere.disconnectu Error: {0}
{1}u\ Uplink portgroup in DVS '{0}', datacenter '{1}' is correctly configured. Nothing to be done.N( R R R R R R R R# RD R R RP R! R* R" RJ RL R R R R& R' R( RZ ( R+ R t uplink_portgroupR\ R- R. R/ R0 R1 t current_uplink_portgroupRK RR RV R@ ( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyt uplink_portgroup_configuredz sx
)
(! t __doc__t
__future__R R R t loggingR' R t salt.exceptionsR t salt.extR t salt.ext.six.movesR t pyVmomiR R R t ImportErrorR t getLoggert __name__R R R R RA RD RJ RL RP Rd Rg ( ( ( s3 /usr/lib/python2.7/site-packages/salt/states/dvs.pyt <module>� s.
� ! �
Mini Shell