Current File : //lib/python2.7/site-packages/salt/modules/vsphere.pyc
�
���^c @@ s= d Z d d l 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
d d l m Z d d l m
Z
d d l Z d d l j j Z d d l 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 d d
l m Z m Z m Z m Z m! Z! m" Z" m# Z# m$ Z$ d d l% m& Z& m' Z' d d l( m) Z) m* Z* d d
l+ m, Z, d d l- m. Z. m/ Z/ m0 Z0 d d l1 m2 Z2 m3 Z3 e j4 e5 � Z6 y d d l7 Z7 e8 Z9 Wn e: k
r�e; Z9 n Xy� d d l< m= Z= m> Z> m? Z? m@ Z@ d e@ jA k oEe jB d d f k oEe jB d d d f k rae6 jC d � e: � � n e8 ZD Wn e: k
r�e; ZD n Xe j jE jF d � ZG eG r�e8 ZH n e; ZH d ZI d d d d d g ZJ d � ZK d � ZL d � ZM d � ZN d! � ZO e& eD � eN d d d d d � eP d" � � � ZQ e& eD � eN d d d d d � d# � � � ZR e& eH � eP eP eP eP eP eP eP d$ � � ZS e& eH � eP eP eP eP d% � � ZT e& eH � eP eP eP eP d& � � ZU e& eH � eP eP d' d( eP eP d) � � ZV e& eH � eP eP eP eP d* � � ZW e& eH � eP eP eP eP d+ � � ZX e& eH � eP eP eP eP d, � � ZY e& eH � eP eP e8 e8 eP eP d- � � ZZ e& eH � eP eP eP eP d. � � Z[ e& eH � eP eP eP eP eP d/ � � Z\ e' d0 � eP eP eP eP e; d1 � � Z] e' d0 � eP eP e; d2 � � Z^ e& eD � e' d0 � eP eP eP d3 � � � Z_ e& eD � e' d0 � eP eP eP d4 � � � Z` e& eD � e' d0 � eP eP eP d5 � � � Za e& eD � e' d0 � eP eP eP d6 � � � Zb e& eD � e' d0 � eP eP eP d7 � � � Zc e& eD � e' d0 � eP eP eP d8 � � � Zd e& eD � e' d0 � eP eP eP d9 � � � Ze e& eD � eN d d d d d � eO eP d: � � � � Zf e& eD � e' d0 � eP eP d; � � � Zg e& eD � e' d0 � eP eP d< � � � Zh e& eD � e' d0 � eP eP d= � � � Zi e& eD � e' d0 � eP eP d> � � � Zj e& eD � e' d0 � eP eP d? � � � Zk e& eD � e' d0 � eP eP d@ � � � Zl e& eD � e' d0 � eP eP dA � � � Zm e& eD � e' d0 � eP eP dB � � � Zn e& eD � e' d0 � eP eP dC � � � Zo e& eD � e' d0 � eP eP dD � � � Zp e& eD � e' d0 � eP eP dE � � � Zq e& eD � e' d0 � eP eP dF � � � Zr e& eD � e' d0 � eP eP eP dG � � � Zs e& eD � e' d0 � eP eP eP dH � � � Zt e& eD � e' d0 � eP eP eP dI � � � Zu e& eD � e' d0 � eP eP eP dJ � � � Zv e& eD � e' d0 � eP eP eP dK � � � Zw e& eD � e' d0 � eP eP eP dL � � � Zx e& eD � e' d0 � eP eP eP dM � � � Zy e& eD � e' d0 � eP eP eP dN � � � Zz e& eD � e' d0 � eP eP dO � � � Z{ e& eD � e' d0 � eP eP eP dP � � � Z| e& eD � e' d0 � eP eP eP d' dQ � � � Z} e& eD � e' d0 � eP eP eP dR � � � Z~ e& eD � e' d0 � eP eP eP dS � � � Z e& eD � e' d0 � eP eP eP dT � � � Z� dU � Z� dV � Z� dW � Z� dX � Z� dY � Z� e& eD � eN d d � eO eP eP eP dZ � � � � Z� d[ � Z� d\ � Z� d] � Z� d^ � Z� d_ � Z� d` � Z� e& eD � eN d d � eO eP da � � � � Z� e& eD � eN d d � eO eP db � � � � Z� dc � Z� dd � Z� de � Z� df � Z� e& eD � eN d d � eO eP eP eP dg � � � � Z� e& eD � eN d d � eO eP dh � � � � Z� di � Z� dj � Z� dk � Z� dl � Z� e& eD � eN d d � eO eP dm � � � � Z� e& eD � eN d d � eO e8 dn � � � � Z� e& eD � eN d d � eO eP do � � � � Z� dp � Z� e& eD � eN d d � eO eP eP dq � � � � Z� e& eD � eN d d � eO eP dr � � � � Z� ds � Z� e& eD � eN d d � eO eP dt � � � � Z� du � Z� e& eD � eN d d � eO eP dv � � � � Z� e& eD � eN d d � eO eP dw � � � � Z� e& eD � eN d d d � eO eP dx � � � � Z� e& eD � eN d d d � eO eP dy � � � � Z� e& eD � eN d d d d � eO eP eP dz � � � � Z� e& eD � eN d d � eO eP d{ � � � � Z� d| � Z� e& eD � eN d d � eO eP eP eP d} � � � � Z� eP e8 d~ � Z� e& eD � e& e9 � eN d d � eO eP eP eP d � � � � � Z� e& eD � e& e9 � eN d d � eO eP eP eP d� � � � � � Z� e& eD � eN d d d � eO eP eP eP eP d� � � � � Z� e& eD � e& e9 � eN d � eO e8 eP d� � � � � � Z� e& eD � eN d d d � eO eP d� � � � � Z� e& eD � eN d d d � eO eP d� � � � � Z� e& eD � eN d d � eO eP d� � � � � Z� e& eD � eN d d � eO e8 eP d� � � � � Z� d� � Z� d� � Z� e& eD � e& e9 � eN d d � eO eP eP d� � � � � � Z� e& eD � e& e9 � eN d d � eO e8 eP d� � � � � � Z� e& eD � eN d d d d � eO eP eP eP eP d� � � � � Z� e& eD � eN d � eO eP eP eP d� � � � � Z� e& eD � eN d � eO eP eP eP d� � � � � Z� e& eD � eN d � eO eP eP eP d� � � � � Z� e& eD � eN d � eO eP eP d� � � � � Z� e& eD � e& e9 � eN d � eO e8 eP d� � � � � � Z� e& eD � e& e9 � eN d � eO e8 eP d� � � � � � Z� e& eD � e& e9 � eN d � eO e8 e8 eP d� � � � � � Z� e& eD � e& e9 � eN d � eO e8 eP d� � � � � � Z� e& eD � eN d � eO eP d� � � � � Z� e& eD � e& e9 � eN d � eO eP eP eP d� � � � � � Z� d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� eP d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� eP eP eP eP d� � Z� eP eP eP eP eP d� � Z� e& eD � e' d0 � eP eP eP d� � � � Z� e& eD � eN d d d d � d� � � � Z� d� � Z� d� � Z� d� � Z� e& eD � eO eP eP eP eP eP d� � � � Z� e& eD � eO eP d� � � � Z� d� d� � Z� d� � Z� d� � Z� e& eD � eN d d d � eO eP d� � � � � Z� eP d� � Z� e& eD � eN d d d � eO eP d� � � � � Z� d� � Z� e& eD � eN d d d � eO eP d� � � � � Z� d� � Z� eP eP d� eP eP eP eP eP d� � Z� d� d� � Z� d� � Z� eP d� eP eP eP d� � Z� d� � Z� d� � Z� d d� � Z� d� � Z� d d� � Z� eP eP eP d� eP d� � Z� d� � Z� d� d� � Z� eP eP d� � Z� d� � Z� eP d� � Z� d� � Z� eP eP d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� eO eP e8 eP d� � � Z� d� � Z� d� � Z� d� � Z� d� � Z� eP eP d� � Z� d� � Z� e& eD � eN d d d � eO eP eP eP eP eP eP d� � � � � Z� e& eD � eN d d d � eO eP eP eP eP eP eP eP eP eP eP eP eP eP eP d� � � � � Z� e& eD � eN d d d � eO eP d� � � � � Z� e& eD � eN d d d � eO eP eP d� � � � � Z� e& eD � eN d d d � eO eP eP d� � � � � Z� eP eP d� � Z e& eD � eN d d d � eO eP e; eP d� � � � � Ze& eD � eN d d d � eO eP e; eP d� � � � � Zd S(� s&
Manage VMware vCenter servers and ESXi hosts.
.. versionadded:: 2015.8.4
:codeauthor: Alexandru Bleotu <alexandru.bleotu@morganstaley.com>
Dependencies
============
- pyVmomi Python Module
- ESXCLI
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 vSphere Execution
Module was developed against.
ESXCLI
------
Currently, about a third of the functions used in the vSphere Execution Module require
the ESXCLI package be installed on the machine running the Proxy Minion process.
The ESXCLI package is also referred to as the VMware vSphere CLI, or vCLI. VMware
provides vCLI package installation instructions for `vSphere 5.5`_ and
`vSphere 6.0`_.
.. _vSphere 5.5: http://pubs.vmware.com/vsphere-55/index.jsp#com.vmware.vcli.getstart.doc/cli_install.4.2.html
.. _vSphere 6.0: http://pubs.vmware.com/vsphere-60/index.jsp#com.vmware.vcli.getstart.doc/cli_install.4.2.html
Once all of the required dependencies are in place and the vCLI package is
installed, you can check to see if you can connect to your ESXi host or vCenter
server by running the following command:
.. code-block:: bash
esxcli -s <host-location> -u <username> -p <password> system syslog config get
If the connection was successful, ESXCLI was successfully installed on your system.
You should see output related to the ESXi host's syslog configuration.
.. note::
Be aware that some functionality in this execution module may depend on the
type of license attached to a vCenter Server or ESXi host(s).
For example, certain services are only available to manipulate service state
or policies with a VMware vSphere Enterprise or Enterprise Plus license, while
others are available with a Standard license. The ``ntpd`` service is restricted
to an Enterprise Plus license, while ``ssh`` is available via the Standard
license.
Please see the `vSphere Comparison`_ page for more information.
.. _vSphere Comparison: https://www.vmware.com/products/vsphere/compare
About
=====
This execution module was designed to be able to handle connections both to a
vCenter Server, as well as to an ESXi host. It utilizes the pyVmomi Python
library and the ESXCLI package to run remote execution functions against either
the defined vCenter server or the ESXi host.
Whether or not the function runs against a vCenter Server or an ESXi host depends
entirely upon the arguments passed into the function. Each function requires a
``host`` location, ``username``, and ``password``. If the credentials provided
apply to a vCenter Server, then the function will be run against the vCenter
Server. For example, when listing hosts using vCenter credentials, you'll get a
list of hosts associated with that vCenter Server:
.. code-block:: bash
# salt my-minion vsphere.list_hosts <vcenter-ip> <vcenter-user> <vcenter-password>
my-minion:
- esxi-1.example.com
- esxi-2.example.com
However, some functions should be used against ESXi hosts, not vCenter Servers.
Functionality such as getting a host's coredump network configuration should be
performed against a host and not a vCenter server. If the authentication
information you're using is against a vCenter server and not an ESXi host, you
can provide the host name that is associated with the vCenter server in the
command, as a list, using the ``host_names`` or ``esxi_host`` kwarg. For
example:
.. code-block:: bash
# salt my-minion vsphere.get_coredump_network_config <vcenter-ip> <vcenter-user> <vcenter-password> esxi_hosts='[esxi-1.example.com, esxi-2.example.com]'
my-minion:
----------
esxi-1.example.com:
----------
Coredump Config:
----------
enabled:
False
esxi-2.example.com:
----------
Coredump Config:
----------
enabled:
True
host_vnic:
vmk0
ip:
coredump-location.example.com
port:
6500
You can also use these functions against an ESXi host directly by establishing a
connection to an ESXi host using the host's location, username, and password. If ESXi
connection credentials are used instead of vCenter credentials, the ``host_names`` and
``esxi_hosts`` arguments are not needed.
.. code-block:: bash
# salt my-minion vsphere.get_coredump_network_config esxi-1.example.com root <host-password>
local:
----------
10.4.28.150:
----------
Coredump Config:
----------
enabled:
True
host_vnic:
vmk0
ip:
coredump-location.example.com
port:
6500
i ( t absolute_importN( t wraps( t six( t range( t zip( t list_diff( t recursive_diff( t CommandExecutionErrort VMwareSaltErrort ArgumentValueErrort InvalidConfigErrort VMwareObjectRetrievalErrort VMwareApiErrort InvalidEntityErrort VMwareObjectExistsError( t dependst ignores_kwargs( t ESXClusterConfigSchemat ESXClusterEntitySchema( t VCenterEntitySchema( t DiskGroupsDiskIdSchemat VmfsDatastoreSchemat SimpleHostCacheSchema( t ESXVirtualMachineDeleteSchemat! ESXVirtualMachineUnregisterSchema( t vimt vmodlt pbmt VmomiSupports vim25/6.0i i i sF pyVmomi not loaded: Incompatible versions of Python. See Issue #29537.t esxclit vspheret esxit
esxclustert
esxdatacentert vcentert esxvmc C@ s t S( N( t __virtualname__( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt __virtual__� s c C@ sR t j d i � j d � r' t d d St j d i � j d � rN t d d Sd S( s�
Returns the proxy type retrieved either from the pillar of from the proxy
minion's config. Returns ``<undefined>`` otherwise.
CLI Example:
.. code-block:: bash
salt '*' vsphere.get_proxy_type
t proxyt proxytypes <undefined>( t
__pillar__t gett __opts__( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_proxy_type� s
c C@ s) t � } | d k r% t d � } n� | d k rA t d � } ni | d k r] t d � } nM | d k ry t d � } n1 | d k r� t d
� } n t d j | � � � d | k r� | j d � n | j d � | j d
� | j d � | j d � | j d � | j d � | j d � | j d � f S( sG
Returns the connection details of the following proxies: esxi
R s esxi.get_detailsR s esxcluster.get_detailsR! s esxdatacenter.get_detailsR" s vcenter.get_detailsR# s esxvm.get_detailss '{0}' proxy is not supportedt hostt usernamet passwordt protocolt portt mechanismt principalt domain( R+ t __salt__R t formatR) ( R' t details( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_proxy_connection_details� s& c @ s � f d � } | S( s�
Decorator to specify which proxy types are supported by a function
proxy_types:
Arbitrary list of strings with the supported types of proxies
c @ s" t � � � � f d � � } | S( Nc @ sO t � } | � k r3 t d j | � j � � � n � | t j j j | � � S( Ns, '{0}' proxy is not supported by function {1}( R+ R R5 t __name__t saltt utilst argst clean_kwargs( R; t kwargst
proxy_type( t fnt proxy_types( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt __supports_proxies s ( R ( R? RA ( R@ ( R? s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _supports_proxies s ( ( R@ RB ( ( R@ s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt supports_proxies s
c @ s� � j � y( t j � � \ � } � � } } } Wn, t k
r_ t j � � \ � } � � n X� d k rr � n g � t � � � � � � � f d � � } | S( s�
Decorator that connects to a target system (vCenter or ESXi host) using the
proxy details and passes the connection (vim.ServiceInstance) to
the decorated function.
Supported proxies: esxi, esxcluster, esxdatacenter.
Notes:
1. The decorated function must have a ``service_instance`` parameter
or a ``**kwarg`` type argument (name of argument is not important);
2. If the ``service_instance`` parameter is already defined, the value
is passed through to the decorated function;
3. If the ``service_instance`` parameter in not defined, the
connection is created using the proxy details and the service instance
is returned.
CLI Example:
None, this is a decorator
c @ s� d � k r+ � r+ t d j � � � � n t � } d } d � k r� � j d � } | t � � t � � k r&t | � | k r� | | s� t j j j | � } t
| � } | | | <q� q� | j d � s� t j j j | � } | | d <q� q&n1 | j d � s&t j j j | � } | | d <n yB � | t j j j
| � � } | rct j j j | � n | SWnB t k
r�} | r�t j j j | � n t j t j � � n Xd S( Nt service_instancesR Function {0} must have either a 'service_instance', or a '**kwargs' type parameter( R R5 R7 t Nonet indext lenR9 R: t vmwaret get_service_instancet listR) R; R< t
disconnectt ExceptionR t reraiset syst exc_info( R; R= t connection_detailst local_service_instancet idxt rett e( t arg_namest default_valuesR? t fn_namet kwargs_name( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _gets_service_instance_via_proxyJ s@
N( R8 t inspectt getfullargspect AttributeErrort
getargspecRE R ( R? t args_namet _RY ( ( RU RV R? RW RX s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt gets_service_instance_via_proxy, s (
'>c C@ s t � } t j j j | � S( s3
Returns a service instance to the proxied endpoint (vCenter/ESXi host).
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
Note:
Should be used by state functions not invoked directly.
CLI Example:
See note above
( R7 R9 R: RH RI ( RD RP ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_service_instance_via_proxy� s c C@ s t j j j | � t S( s�
Disconnects from a vCenter or ESXi host
Note:
Should be used by state functions, not invoked directly.
service_instance
Service instance (vim.ServiceInstance)
CLI Example:
See note above.
( R9 R: RH RK t True( RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRK � s c C@ s> i } | r� t | t � s* t d � � n x
| D]� } t j j j | | | | d | d | d | d | �}
|
d d k r� | j i i |
j d � d 6| 6� q1 | j i |
| 6� q1 Wn{ t j j j | | | | d | d | d | �}
|
d d k r&| j i i |
j d � d 6| 6� n | j i |
| 6� | S(
s�
Run an ESXCLI command directly on the host or list of hosts.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
cmd_str
The ESXCLI command to run. Note: This should not include the ``-s``, ``-u``,
``-p``, ``-h``, ``--protocol``, or ``--portnumber`` arguments that are
frequently passed when using a bare ESXCLI command from the command line.
Those arguments are handled by this function via the other args and kwargs.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
credstore
Optionally set to path to the credential store file.
CLI Example:
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.esxcli_cmd my.esxi.host root bad-password 'system coredump network get'
# Used for connecting to a vCenter Server
salt '*' vsphere.esxcli_cmd my.vcenter.location root bad-password 'system coredump network get' esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
s 'esxi_hosts' must be a list.R/ R0 t esxi_hostt credstoret retcodei t stdoutt Error( t
isinstanceRJ R R9 R: RH R t updateR) ( t cmd_strR, R- R. R/ R0 t
esxi_hostsRd RS Rc t response( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt
esxcli_cmd� s$ /
' 'c C@ sd d } i } | r� t | t � s0 t d � � n x-| D]� } t j j j | | | | d | d | d | d | �}
|
d d k r� | j i i |
j d � d
6| 6� q7 | j i i t |
� d 6| 6� q7 Wn� t j j j | | | | d | d | d | �}
|
d d k r9| j i i |
j d � d
6| 6� n' t |
� } | j i i | d 6| 6� | S( sh
Retrieve information on ESXi or vCenter network dump collection and
format it into a dictionary.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
credstore
Optionally set to path to the credential store file.
:return: A dictionary with the network configuration, or, if getting
the network config failed, a an error message retrieved from the
standard cmd.run_all dictionary, per host.
CLI Example:
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.get_coredump_network_config my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.get_coredump_network_config my.vcenter.location root bad-password esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
s system coredump network gets 'esxi_hosts' must be a list.R/ R0 Rc Rd Re i Rf Rg s Coredump Config(
Rh RJ R R9 R: RH R Ri R) t _format_coredump_stdout( R, R- R. R/ R0 Rk Rd t cmdRS Rc Rl Rf ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_coredump_network_config� s( .
'( ' c
C@ sp | r d } n d } d j | � } i }
| r� t | t � sN t d � � n x| D]� } t j j j | | | | d | d | d | d | �} | d d k r� |
j i i | j d
� d 6| 6� qU |
j i i | d 6| 6� qU Wn� t j j j | | | | d | d | d | �} | d d k rQ|
j i i | j d
� d 6| 6� n |
j i i | d 6| 6� |
S(
s}
Enable or disable ESXi core dump collection. Returns ``True`` if coredump is enabled
and returns ``False`` if core dump is not enabled. If there was an error, the error
will be the value printed in the ``Error`` key dictionary for the given host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
enabled
Python True or False to enable or disable coredumps.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
credstore
Optionally set to path to the credential store file.
CLI Example:
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.coredump_network_enable my.esxi.host root bad-password True
# Used for connecting to a vCenter Server
salt '*' vsphere.coredump_network_enable my.vcenter.location root bad-password True esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
i i s" system coredump network set -e {0}s 'esxi_hosts' must be a list.R/ R0 Rc Rd Re Rf Rg s Coredump Enabled(
R5 Rh RJ R R9 R: RH R Ri R) (
R, R- R. t enabledR/ R0 Rk Rd t enable_itRo RS Rc Rl ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt coredump_network_enableH s, -
'" 't vmk0id c
C@ s3 d j | | | � }
i } | r� t | t � s? t d � � n x� | D]w } t j j j | | | |
d | d | d | d | �}
|
d d k r� t |
d <n
t |
d <| j
i |
| 6� qF Wnk t j j j | | | |
d | d | d | �}
|
d d k rt |
d <n
t |
d <| j
i |
| 6� | S(
s�
Set the network parameters for a network coredump collection.
Note that ESXi requires that the dumps first be enabled (see
`coredump_network_enable`) before these parameters may be set.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
dump_ip
IP address of host that will accept the dump.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
host_vnic
Host VNic port through which to communicate. Defaults to ``vmk0``.
dump_port
TCP port to use for the dump, defaults to ``6500``.
credstore
Optionally set to path to the credential store file.
:return: A standard cmd.run_all dictionary with a `success` key added, per host.
`success` will be True if the set succeeded, False otherwise.
CLI Example:
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.set_coredump_network_config my.esxi.host root bad-password 'dump_ip.host.com'
# Used for connecting to a vCenter Server
salt '*' vsphere.set_coredump_network_config my.vcenter.location root bad-password 'dump_ip.host.com' esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
s0 system coredump network set -v {0} -i {1} -o {2}s 'esxi_hosts' must be a list.R/ R0 Rc Rd Re i t success( R5 Rh RJ R R9 R: RH R t FalseRb Ri ( R, R- R. t dump_ipR/ R0 t host_vnict dump_portRk Rd Ro RS Rc Rl ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt set_coredump_network_config� s. @
c C@ sb d } i } | r� t | t � s0 t d � � n x+| D]� } t j j j | | | | d | d | d | d | �}
|
d d k r� | j i i |
d d
6t d 6d
d 6| 6� q7 | j i t
|
� | 6� q7 Wn� t j j j | | | | d | d | d | �}
|
d d k rD| j i i |
d d
6t d 6d
d 6| 6� n | j i t
|
� | 6� | S( s[
Show status of all firewall rule sets.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
credstore
Optionally set to path to the credential store file.
:return: Nested dictionary with two toplevel keys ``rulesets`` and ``success``
``success`` will be True or False depending on query success
``rulesets`` will list the rulesets and their statuses if ``success``
was true, per host.
CLI Example:
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.get_firewall_status my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.get_firewall_status my.vcenter.location root bad-password esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
s network firewall ruleset lists 'esxi_hosts' must be a list.R/ R0 Rc Rd Re i Rf Rg Ru t rulesetsN( Rh RJ R R9 R: RH R Ri Rv RE t _format_firewall_stdout( R, R- R. R/ R0 Rk Rd Ro RS Rc Rl ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_firewall_status� s. -
! c
C@ s� d j | | � } i }
| r� t | t � s< t d � � n x� | D]P } t j j j | | | | d | d | d | d | �} |
j i | | 6� qC WnD t j j j | | | | d | d | d | �} |
j i | | 6� |
S( s-
Enable or disable an ESXi firewall rule set.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
ruleset_enable
True to enable the ruleset, false to disable.
ruleset_name
Name of ruleset to target.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
credstore
Optionally set to path to the credential store file.
:return: A standard cmd.run_all dictionary, per host.
CLI Example:
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.enable_firewall_ruleset my.esxi.host root bad-password True 'syslog'
# Used for connecting to a vCenter Server
salt '*' vsphere.enable_firewall_ruleset my.vcenter.location root bad-password True 'syslog' esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
s; network firewall ruleset set --enabled {0} --ruleset-id={1}s 'esxi_hosts' must be a list.R/ R0 Rc Rd ( R5 Rh RJ R R9 R: RH R Ri (
R, R- R. t ruleset_enablet ruleset_nameR/ R0 Rk Rd Ro RS Rc Rl ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt enable_firewall_rulesetF s 8
c C@ s� d } i } | r� t | t � s0 t d � � n x� | D]P } t j j j | | | | d | d | d | d | �}
| j i |
| 6� q7 WnD t j j j | | | | d | d | d | �}
| j i |
| 6� | S( s
Reload the syslog service so it will pick up any changes.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
credstore
Optionally set to path to the credential store file.
:return: A standard cmd.run_all dictionary. This dictionary will at least
have a `retcode` key. If `retcode` is 0 the command was successful.
CLI Example:
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.syslog_service_reload my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.syslog_service_reload my.vcenter.location root bad-password esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
s system syslog reloads 'esxi_hosts' must be a list.R/ R0 Rc Rd ( Rh RJ R R9 R: RH R Ri ( R, R- R. R/ R0 Rk Rd Ro RS Rc Rl ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt syslog_service_reload� s +
c C@ s� i } | r�| d k r�| r� t | t � s< t d � � n xP| D]� } t | | | d t d d d | d | d | g d |
�j | � }
|
d
d k r� | j i i i |
d d
6t d 6d 6| 6� qC | j i i i t d 6d 6| 6� qC Wq�t | | | d t d d d | d | d |
�j | � }
|
d
d k rm| j i i i |
d d
6t d 6d 6| 6� q�| j i i i t d 6d 6| 6� n | r=t | t � s�t d � � n x� | D]y } t | | | | | d | d | d | d | d |
�}
| j | � d k r%| j i i | 6� n | | j |
� q�Wnm t | | | | | d | d | d | d |
�}
| j | � d k r�| j i i | 6� n | | j |
� | S( s6
Set the specified syslog configuration parameter. By default, this function will
reset the syslog service after the configuration is set.
host
ESXi or vCenter host to connect to.
username
User to connect as, usually root.
password
Password to connect with.
syslog_config
Name of parameter to set (corresponds to the command line switch for
esxcli without the double dashes (--))
Valid syslog_config values are ``logdir``, ``loghost``, ``default-rotate`,
``default-size``, ``default-timeout``, and ``logdir-unique``.
config_value
Value for the above parameter. For ``loghost``, URLs or IP addresses to
use for logging. Multiple log servers can be specified by listing them,
comma-separated, but without spaces before or after commas.
(reference: https://blogs.vmware.com/vsphere/2012/04/configuring-multiple-syslog-servers-for-esxi-5.html)
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
firewall
Enable the firewall rule set for syslog. Defaults to ``True``.
reset_service
After a successful parameter set, reset the service. Defaults to ``True``.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
credstore
Optionally set to path to the credential store file.
:return: Dictionary with a top-level key of 'success' which indicates
if all the parameters were reset, and individual keys
for each parameter indicating which succeeded or failed, per host.
CLI Example:
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.set_syslog_config my.esxi.host root bad-password loghost ssl://localhost:5432,tcp://10.1.0.1:1514
# Used for connecting to a vCenter Server
salt '*' vsphere.set_syslog_config my.vcenter.location root bad-password loghost ssl://localhost:5432,tcp://10.1.0.1:1514 esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
t loghosts 'esxi_hosts' must be a list.R~ R t syslogR/ R0 Rk Rd Re i Rf t messageRu t enable_firewallt
reset_serviceRc N(
Rh RJ R R� Rb R) Ri Rv t _set_syslog_config_helperRE ( R, R- R. t
syslog_configt config_valueR/ R0 t firewallR� Rk Rd RS Rc Rl ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt set_syslog_config� sP N
) %
c C@ s� d } i } | r� t | t � s0 t d � � n x� | D]V } t j j j | | | | d | d | d | d | �}
| j i t |
� | 6� q7 WnJ t j j j | | | | d | d | d | �}
| j i t |
� | 6� | S( s�
Retrieve the syslog configuration.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
credstore
Optionally set to path to the credential store file.
:return: Dictionary with keys and values corresponding to the
syslog configuration, per host.
CLI Example:
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.get_syslog_config my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.get_syslog_config my.vcenter.location root bad-password esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
s system syslog config gets 'esxi_hosts' must be a list.R/ R0 Rc Rd ( Rh RJ R R9 R: RH R Ri t _format_syslog_config( R, R- R. R/ R0 Rk Rd Ro RS Rc Rl ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_syslog_configa s +
! c C@ sR | s t d � � n d d d d d d g } d } d | k rj g | j d � D] }
|
j � ^ qO } n | d
k r | } n | g } i } | r
t | t � s� t d � � n x� | D]M }
t | | | | | | d | d
| d |
d | �} | j i | |
6� q� WnA t | | | | | | d | d
| d | �} | j i | | 6� | S( s"
Reset the syslog service to its default settings.
Valid syslog_config values are ``logdir``, ``loghost``, ``logdir-unique``,
``default-rotate``, ``default-size``, ``default-timeout``,
or ``all`` for all of these.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
syslog_config
List of parameters to reset, provided as a comma-delimited string, or 'all' to
reset all syslog configuration parameters. Required.
esxi_hosts
If ``host`` is a vCenter host, then use esxi_hosts to execute this function
on a list of one or more ESXi machines.
credstore
Optionally set to path to the credential store file.
:return: Dictionary with a top-level key of 'success' which indicates
if all the parameters were reset, and individual keys
for each parameter indicating which succeeded or failed, per host.
CLI Example:
``syslog_config`` can be passed as a quoted, comma-separated string, e.g.
.. code-block:: bash
# Used for ESXi host connection information
salt '*' vsphere.reset_syslog_config my.esxi.host root bad-password syslog_config='logdir,loghost'
# Used for connecting to a vCenter Server
salt '*' vsphere.reset_syslog_config my.vcenter.location root bad-password syslog_config='logdir,loghost' esxi_hosts='[esxi-1.host.com, esxi-2.host.com]'
sF The 'reset_syslog_config' function requires a 'syslog_config' setting.t logdirR� s default-rotates default-sizes default-timeouts
logdir-uniques! system syslog config set --reset=t ,t alls 'esxi_hosts' must be a list.R/ R0 Rc Rd ( R t splitt stripRh RJ t _reset_syslog_config_paramsRi ( R, R- R. R/ R0 R� Rk Rd t valid_resetsRo t ind_resett resetsRS Rc t
response_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt reset_syslog_config� s4 > +
Rd c C@ sM | d k r d } n | d k r* d } n d j | | | � } i } d }
y� | r� t j j j | d t d t d d d | d | d
| d | �}
nN | r� t j j j | d t d t d d d | d | d | d
t d | �}
n |
j d � d k rt | d <n t | d <|
d | d <Wn' t k
rH} t | d <| | d <n X| S( s�
Upload an ssh key for root to an ESXi host via http PUT.
This function only works for ESXi, not vCenter.
Only one ssh key can be uploaded for root. Uploading a second key will
replace any existing key.
:param host: The location of the ESXi Host
:param username: Username to connect as
:param password: Password for the ESXi web endpoint
:param ssh_key: Public SSH key, will be added to authorized_keys on ESXi
:param ssh_key_file: File containing the SSH key. Use 'ssh_key' or
ssh_key_file, but not both.
:param protocol: defaults to https, can be http if ssl is disabled on ESXi
:param port: defaults to 443 for https
:param certificate_verify: If true require that the SSL connection present
a valid certificate
:return: Dictionary with a 'status' key, True if upload is successful.
If upload is unsuccessful, 'status' key will be False and
an 'Error' key will have an informative message.
CLI Example:
.. code-block:: bash
salt '*' vsphere.upload_ssh_key my.esxi.host root bad-password ssh_key_file='/etc/salt/my_keys/my_key.pub'
t httpsi� s+ {0}://{1}:{2}/host/ssh_root_authorized_keyst statust textt methodt PUTR- R. t datat
verify_sslt data_filet data_renderi� t errorRg N(
RE R5 R9 R: t httpt queryRb Rv R) RL ( R, R- R. t ssh_keyt ssh_key_fileR/ R0 t certificate_verifyt urlRS t resultt msg( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt upload_ssh_key sJ
c
C@ s� | d k r d } n | d k r* d } n d j | | | � } i } y� t j j j | d t d t d d d | d | d
| �} | j d � d k r� t | d <| d | d <n t | d <| d
| d <Wn' t k
r� } t | d <| | d <n X| S( s�
Retrieve the authorized_keys entry for root.
This function only works for ESXi, not vCenter.
:param host: The location of the ESXi Host
:param username: Username to connect as
:param password: Password for the ESXi web endpoint
:param protocol: defaults to https, can be http if ssl is disabled on ESXi
:param port: defaults to 443 for https
:param certificate_verify: If true require that the SSL connection present
a valid certificate
:return: True if upload is successful
CLI Example:
.. code-block:: bash
salt '*' vsphere.get_ssh_key my.esxi.host root bad-password certificate_verify=True
R� i� s+ {0}://{1}:{2}/host/ssh_root_authorized_keysR� R� R� t GETR- R. R� i� t keyR� Rg N(
RE R5 R9 R: R� R� Rb R) Rv RL (
R, R- R. R/ R0 R� R� RS R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_ssh_keyN s2
c C@ s� t j j j d | d | d | d | d | � } t | | | � } i } xO | D]G } t | | d | �} t | � }
|
j � } | j i | | 6� qO W| S( sj
Get the date/time information for a given host or list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to tell
vCenter the hosts for which to get date/time information.
If host_names is not provided, the date/time information will be retrieved for the
``host`` location instead. This is useful for when service instance connection
information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.get_host_datetime my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.get_host_datetime my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 t host_name( R9 R: RH RI t _check_hostst
_get_host_reft _get_date_time_mgrt
QueryDateTimeRi ( R, R- R. R/ R0 t
host_namesRD RS R� t host_reft date_time_managert date_time( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_host_datetime� s +
c C@ s� t j j j d | d | d | d | d | � } t | | | � } i } xL | D]D } t | | d | �} | j j j j j
}
| j i |
| 6� qO W| S( sp
Get the NTP configuration information for a given host or list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to tell
vCenter the hosts for which to get ntp configuration information.
If host_names is not provided, the NTP configuration will be retrieved for the
``host`` location instead. This is useful for when service instance connection
information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.get_ntp_config my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.get_ntp_config my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� ( R9 R: RH RI R� R� t
configManagert dateTimeSystemt dateTimeInfot ntpConfigt serverRi ( R, R- R. R/ R0 R� RD RS R� R� t
ntp_config( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_ntp_config� s +
c C@ s� t j j j d | d | d | d | d | � } d d d d d
d d d
d d d d d d g } t | | | � } i } xN| D]F}
| | k r� | j i i d j | � d 6|
6� | St | | d |
�} | j j j
j } | d k s� | d k rd }
n | }
xl | D]d } | j |
k rE| j i i | j
| 6|
6� Pqd j | |
� } | j i i | d 6|
6� qW| j |
� d k r d j |
� } t j | � | j i i | d 6|
6� q q W| S( s�
Get the service name's policy for a given host or list of hosts.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
service_name
The name of the service for which to retrieve the policy. Supported service names are:
- DCUI
- TSM
- SSH
- lbtd
- lsassd
- lwiod
- netlogond
- ntpd
- sfcbd-watchdog
- snmpd
- vprobed
- vpxa
- xorg
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to tell
vCenter the hosts for which to get service policy information.
If host_names is not provided, the service policy information will be retrieved
for the ``host`` location instead. This is useful for when service instance
connection information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.get_service_policy my.esxi.host root bad-password 'ssh'
# Used for connecting to a vCenter Server
salt '*' vsphere.get_service_policy my.vcenter.location root bad-password 'ntpd' host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 t DCUIt TSMt SSHt ssht lbtdt lsassdt lwiodt netlogondt ntpds sfcbd-watchdogt snmpdt vprobedt vpxat xorgs {0} is not a valid service name.Rg R� s TSM-SSHs, Could not find service '{0}' for host '{1}'.s1 'vsphere.get_service_policy' failed for host {0}.N( R9 R: RH RI R� Ri R5 R� R� t
serviceSystemt serviceInfot serviceR� t policyR) RE t logt debug( R, R- R. t service_nameR/ R0 R� RD t valid_servicesRS R� R� t servicest temp_service_nameR� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_service_policy� s> ;
$
"c C@ s� t j j j d | d | d | d | d | � } d d d d d
d d d
d d d d d d g } t | | | � } i } xN| D]F}
| | k r� | j i i d j | � d 6|
6� | St | | d |
�} | j j j
j } | d k s� | d k rd }
n | }
xl | D]d } | j |
k rE| j i i | j
| 6|
6� Pqd j | |
� } | j i i | d 6|
6� qW| j |
� d k r d j |
� } t j | � | j i i | d 6|
6� q q W| S( s�
Get the service name's running state for a given host or list of hosts.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
service_name
The name of the service for which to retrieve the policy. Supported service names are:
- DCUI
- TSM
- SSH
- lbtd
- lsassd
- lwiod
- netlogond
- ntpd
- sfcbd-watchdog
- snmpd
- vprobed
- vpxa
- xorg
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to tell
vCenter the hosts for which to get the service's running state.
If host_names is not provided, the service's running state will be retrieved
for the ``host`` location instead. This is useful for when service instance
connection information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.get_service_running my.esxi.host root bad-password 'ssh'
# Used for connecting to a vCenter Server
salt '*' vsphere.get_service_running my.vcenter.location root bad-password 'ntpd' host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� R� R� R� R� R� R� R� R� s sfcbd-watchdogR� R� R� R� s {0} is not a valid service name.Rg R� s TSM-SSHs, Could not find service '{0}' for host '{1}'.s2 'vsphere.get_service_running' failed for host {0}.N( R9 R: RH RI R� Ri R5 R� R� R� R� R� R� t runningR) RE R� R� ( R, R- R. R� R/ R0 R� RD R� RS R� R� R� R� R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_service_runningg s> ;
$
"c C@ s� t j j j d | d | d | d | d | � } t | | | � } i } xt | D]l } t | | d | �} | j j j j }
|
r� | j
i i t d 6| 6� qO | j
i i t d 6| 6� qO W| S( s�
Get the VMotion enabled status for a given host or a list of host_names. Returns ``True``
if VMotion is enabled, ``False`` if it is not enabled.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter which hosts to check if VMotion is enabled.
If host_names is not provided, the VMotion status will be retrieved for the
``host`` location instead. This is useful for when service instance
connection information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.get_vmotion_enabled my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.get_vmotion_enabled my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� s VMotion Enabled(
R9 R: RH RI R� R� R� t
vmotionSystemt netConfigt selectedVnicRi Rb Rv ( R, R- R. R/ R0 R� RD RS R� R� t vmotion_vnic( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_vmotion_enabled� s ,
c C@ s� t j j j d | d | d | d | d | � } t | | | � } i } x� | D]� } t | | d | �} | j j }
|
d
k r� d j | � } t
j | � | j i i | d 6| 6� qO | j i i |
j
d 6| 6� qO W| S( s�
Get the VSAN enabled status for a given host or a list of host_names. Returns ``True``
if VSAN is enabled, ``False`` if it is not enabled, and ``None`` if a VSAN Host Config
is unset, per host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter which hosts to check if VSAN enabled.
If host_names is not provided, the VSAN status will be retrieved for the
``host`` location instead. This is useful for when service instance
connection information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.get_vsan_enabled my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.get_vsan_enabled my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� s3 VSAN System Config Manager is unset for host '{0}'.Rg s VSAN EnabledN( R9 R: RH RI R� R� t configt vsanHostConfigRE R5 R� R� Ri Rq ( R, R- R. R/ R0 R� RD RS R� R� t vsan_configR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_vsan_enabled s -
"c C@ s8 t j j j d | d | d | d | d | � } t | | | � } t | | | � } i } x� t j | � D]� \ } }
|
j d � } | r� | j i i | d 6| 6� qj n |
j d � } | rt
| t � rg }
x | D] } |
j | j
� q� W| j i i |
d 6| 6� qj | j i i | d 6| 6� qj W| S( s�
Returns a list of VSAN-eligible disks for a given host or list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter which hosts to check if any VSAN-eligible disks are available.
If host_names is not provided, the VSAN-eligible disks will be retrieved
for the ``host`` location instead. This is useful for when service instance
connection information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.get_vsan_eligible_disks my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.get_vsan_eligible_disks my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 Rg t Eligible( R9 R: RH RI R� t _get_vsan_eligible_disksR t iteritemsR) Ri Rh RJ t appendt
canonicalName( R, R- R. R/ R0 R� RD Rl RS R� t valueR� t diskst
disk_namest disk( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_vsan_eligible_disksS s* +
c C@ s6 y t j j j | � r t SWn t k
r1 t SXt S( s�
Checks if a connection is to a vCenter
CLI Example:
.. code-block:: bash
salt '*' vsphere.test_vcenter_connection
( R9 R: RH t is_connection_to_a_vcenterRb R Rv ( RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt test_vcenter_connection� s
c C@ s� t j j j d | d | d | d | d | � } t j j j | � j j } d | k r� | d d k r� t j | t j j j | � � } q� n | S( su
Return system information about a VMware environment.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.system_info 1.2.3.4 root bad-password
R, R- R. R/ R0 t apiTypet HostAgent(
R9 R: RH RI t
get_inventoryt aboutt __dict__t
dictupdateRi t get_hardware_grains( R, R- R. R/ R0 RD RS ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt system_info� s 'c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( s
Returns a list of datacenters for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_datacenters 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t list_datacenters( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( sy
Returns a list of clusters for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_clusters 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t
list_clusters( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( s�
Returns a list of datastore clusters for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_datastore_clusters 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t list_datastore_clusters( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� ( s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( s|
Returns a list of datastores for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_datastores 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t list_datastores( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� M s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( s�
Returns a list of hosts for the the specified VMware environment.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_hosts 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t
list_hosts( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� r s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( s�
Returns a list of resource pools for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_resourcepools 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t list_resourcepools( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( sx
Returns a list of networks for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_networks 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t
list_networks( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( sn
Returns a list of VMs for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_vms 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t list_vms( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( sv
Returns a list of folders for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_folders 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t list_folders( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( s�
Returns a list of distributed virtual switches for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_dvs 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t list_dvs( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR + s c C@ sC t j j j d | d | d | d | d | � } t j j j | � S( s�
Returns a list of vApps for the the specified host.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
# List vapps from all minions
salt '*' vsphere.list_vapps 1.2.3.4 root bad-password
R, R- R. R/ R0 ( R9 R: RH RI t
list_vapps( R, R- R. R/ R0 RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR P s c
C@ s� t j j j d | d | d | d | d | � } t | | | � } i } g } xd | D]\ } t | | d | �}
t |
� } x | D] } | j | j � q� W| j i | | 6� qU W| S( s4
Returns a list of SSDs for the given host or list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter the hosts for which to retrieve SSDs.
If host_names is not provided, SSDs will be retrieved for the
``host`` location instead. This is useful for when service instance
connection information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.list_ssds my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.list_ssds my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� (
R9 R: RH RI R� R� t _get_host_ssdsR� R� Ri (
R, R- R. R/ R0 R� RD RS t namesR� R� R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_ssdsv s +
c
C@ s� t j j j d | d | d | d | d | � } t | | | � } i } g } xd | D]\ } t | | d | �}
t |
� } x | D] } | j | j � q� W| j i | | 6� qU W| S( s�
Returns a list of Non-SSD disks for the given host or list of host_names.
.. note::
In the pyVmomi StorageSystem, ScsiDisks may, or may not have an ``ssd`` attribute.
This attribute indicates if the ScsiDisk is SSD backed. As this option is optional,
if a relevant disk in the StorageSystem does not have ``ssd = true``, it will end
up in the ``non_ssds`` list here.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter the hosts for which to retrieve Non-SSD disks.
If host_names is not provided, Non-SSD disks will be retrieved for the
``host`` location instead. This is useful for when service instance
connection information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.list_non_ssds my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.list_non_ssds my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� (
R9 R: RH RI R� R� t _get_host_non_ssdsR� R� Ri (
R, R- R. R/ R0 R� RD RS R R� R� R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt
list_non_ssds� s 2
c C@ s^ t j j j d | d | d | d | d | � } t | t � sN t d � � n t j d | � } t j d | � } t
| | | � } i }
x� | D]� } t | | d | �} t | � }
t
j d
j | | � � y |
j d | � WnS t j j k
r:} d j | � } t
j | � |
j i i | d
6| 6� q� n X|
j i i | d 6| 6� q� W|
S( s
Set NTP configuration for a given host of list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
ntp_servers
A list of servers that should be added to and configured for the specified
host's NTP configuration.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to tell
vCenter which hosts to configure ntp servers.
If host_names is not provided, the NTP servers will be configured for the
``host`` location instead. This is useful for when service instance connection
information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.ntp_configure my.esxi.host root bad-password '[192.174.1.100, 192.174.1.200]'
# Used for connecting to a vCenter Server
salt '*' vsphere.ntp_configure my.vcenter.location root bad-password '[192.174.1.100, 192.174.1.200]' host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 s 'ntp_servers' must be a list.R� R� R� s- Configuring NTP Servers '{0}' for host '{1}'.R� s) vsphere.ntp_configure_servers failed: {0}Rg s NTP Servers( R9 R: RH RI Rh RJ R R t
HostNtpConfigt HostDateTimeConfigR� R� R� R� R� R5 t UpdateDateTimeConfigt faultt HostConfigFaultRi ( R, R- R. t ntp_serversR/ R0 R� RD R� t date_configRS R� R� R� t errR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt set_ntp_config� s0 /
c C@ s� t j j j d | d | d | d | d | � } t | | | � } d d d d d
d d d
d d d d d d g } i } | d k s� | d k r� d }
n | }
xG| D]?} | | k r� | j i i d j | � d 6| 6� | St | | d | �} t | � }
t j
d j | | � � y |
j d |
� Wn� t j
j k
r�} d j | | � } t j
| � | j i i | d 6| 6� q� nD t j
j k
r�} t j
| � | j i i | d 6| 6� q� n X| j i i t d 6| 6� q� W| S( s�
Start the named service for the given host or list of hosts.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
service_name
The name of the service for which to set the policy. Supported service names are:
- DCUI
- TSM
- SSH
- lbtd
- lsassd
- lwiod
- netlogond
- ntpd
- sfcbd-watchdog
- snmpd
- vprobed
- vpxa
- xorg
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to tell
vCenter the hosts for which to start the service.
If host_names is not provided, the service will be started for the ``host``
location instead. This is useful for when service instance connection information
is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.service_start my.esxi.host root bad-password 'ntpd'
# Used for connecting to a vCenter Server
salt '*' vsphere.service_start my.vcenter.location root bad-password 'ntpd' host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� R� R� R� R� R� R� R� R� s sfcbd-watchdogR� R� R� R� s TSM-SSHs {0} is not a valid service name.Rg R� s" Starting the '{0}' service on {1}.t ids0 'vsphere.service_start' failed for host {0}: {1}s Service Started( R9 R: RH RI R� Ri R5 R� t _get_service_managerR� R� t StartServiceR R
R t RestrictedVersionRb ( R, R- R. R� R/ R0 R� RD R� RS R� R� R� t service_managerR R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt
service_startG
s@ A
$
c C@ s� t j j j d | d | d | d | d | � } t | | | � } d d d d d
d d d
d d d d d d g } i } | d k s� | d k r� d }
n | }
xG| D]?} | | k r� | j i i d j | � d 6| 6� | St | | d | �} t | � }
t j
d j | | � � y |
j d |
� Wn� t j
j k
r�} d j | | � } t j
| � | j i i | d 6| 6� q� nD t j
j k
r�} t j
| � | j i i | d 6| 6� q� n X| j i i t d 6| 6� q� W| S( s�
Stop the named service for the given host or list of hosts.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
service_name
The name of the service for which to set the policy. Supported service names are:
- DCUI
- TSM
- SSH
- lbtd
- lsassd
- lwiod
- netlogond
- ntpd
- sfcbd-watchdog
- snmpd
- vprobed
- vpxa
- xorg
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to tell
vCenter the hosts for which to stop the service.
If host_names is not provided, the service will be stopped for the ``host``
location instead. This is useful for when service instance connection information
is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.service_stop my.esxi.host root bad-password 'ssh'
# Used for connecting to a vCenter Server
salt '*' vsphere.service_stop my.vcenter.location root bad-password 'ssh' host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� R� R� R� R� R� R� R� R� s sfcbd-watchdogR� R� R� R� s TSM-SSHs {0} is not a valid service name.Rg R� s" Stopping the '{0}' service on {1}.R s/ 'vsphere.service_stop' failed for host {0}: {1}s Service Stopped( R9 R: RH RI R� Ri R5 R� R R� R� t StopServiceR R
R R Rb ( R, R- R. R� R/ R0 R� RD R� RS R� R� R� R R R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt service_stop�
s@ A
$
c C@ s� t j j j d | d | d | d | d | � } t | | | � } d d d d d
d d d
d d d d d d g } i } | d k s� | d k r� d }
n | }
xG| D]?} | | k r� | j i i d j | � d 6| 6� | St | | d | �} t | � }
t j
d j | | � � y |
j d |
� Wn� t j
j k
r�} d j | | � } t j
| � | j i i | d 6| 6� q� nD t j
j k
r�} t j
| � | j i i | d 6| 6� q� n X| j i i t d 6| 6� q� W| S( s�
Restart the named service for the given host or list of hosts.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
service_name
The name of the service for which to set the policy. Supported service names are:
- DCUI
- TSM
- SSH
- lbtd
- lsassd
- lwiod
- netlogond
- ntpd
- sfcbd-watchdog
- snmpd
- vprobed
- vpxa
- xorg
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to tell
vCenter the hosts for which to restart the service.
If host_names is not provided, the service will be restarted for the ``host``
location instead. This is useful for when service instance connection information
is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.service_restart my.esxi.host root bad-password 'ntpd'
# Used for connecting to a vCenter Server
salt '*' vsphere.service_restart my.vcenter.location root bad-password 'ntpd' host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� R� R� R� R� R� R� R� R� s sfcbd-watchdogR� R� R� R� s TSM-SSHs {0} is not a valid service name.Rg R� s$ Restarting the '{0}' service on {1}.R s2 'vsphere.service_restart' failed for host {0}: {1}s Service Restarted( R9 R: RH RI R� Ri R5 R� R R� R� t RestartServiceR R
R R Rb ( R, R- R. R� R/ R0 R� RD R� RS R� R� R� R R R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt service_restart% s@ A
$
c C@ s� t j j j d | d | d | d | d | � } t | | | � } d d d d d
d d d
d d d d d d g } i }
x | D]} | | k r� |
j i i d j | � d 6| 6� |
St | | d | �} t | � }
| j j
j j } x�| D]�} d } | j | k r| j } n3 | d k s2| d k rM| j d k rMd } qMn | r-y |
j d | d | � Wn� t j j k
r�d j | � } t j | � |
j i i | d 6| 6� q� nV t j j k
r} d j | | � } t j | � |
j i i | d 6| 6� q� n X|
j i t | 6� n |
j | � d k r� d j | | � } t j | � |
j i i | d 6| 6� q� q� Wq W|
S( sE
Set the service name's policy for a given host or list of hosts.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
service_name
The name of the service for which to set the policy. Supported service names are:
- DCUI
- TSM
- SSH
- lbtd
- lsassd
- lwiod
- netlogond
- ntpd
- sfcbd-watchdog
- snmpd
- vprobed
- vpxa
- xorg
service_policy
The policy to set for the service. For example, 'automatic'.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to tell
vCenter the hosts for which to set the service policy.
If host_names is not provided, the service policy information will be retrieved
for the ``host`` location instead. This is useful for when service instance
connection information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.set_service_policy my.esxi.host root bad-password 'ntpd' 'automatic'
# Used for connecting to a vCenter Server
salt '*' vsphere.set_service_policy my.vcenter.location root bad-password 'ntpd' 'automatic' host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� R� R� R� R� R� R� R� R� s sfcbd-watchdogR� R� R� R� s {0} is not a valid service name.Rg R� s TSM-SSHR R� s% The service name '{0}' was not found.s5 'vsphere.set_service_policy' failed for host {0}: {1}s, Could not find service '{0}' for host '{1}'.N( R9 R: RH RI R� Ri R5 R� R R� R� R� R� RE R� t UpdateServicePolicyR R
t NotFoundR� R� R Rb R) ( R, R- R. R� t service_policyR/ R0 R� RD R� RS R� R� R R� R� t service_keyR� R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt set_service_policy� sT E
$
&c
C@ s t j j j d | d | d | d | d | � } t | | | � } i } x� | D]� } t | | d | �} t | � }
y |
j t j j � � WnV t
j j k
r� } d j
| | � } t j | � | j i i | d 6| 6� qO n X| j i i t d 6| 6� qO W| S(
s�
Update the date/time on the given host or list of host_names. This function should be
used with caution since network delays and execution delays can result in time skews.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter which hosts should update their date/time.
If host_names is not provided, the date/time will be updated for the ``host``
location instead. This is useful for when service instance connection
information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.update_date_time my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.update_date_time my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� s3 'vsphere.update_date_time' failed for host {0}: {1}Rg s Datetime Updated( R9 R: RH RI R� R� R� t UpdateDateTimet datetimet utcnowR R
R R5 R� R� Ri Rb (
R, R- R. R/ R0 R� RD RS R� R� R� R R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt update_host_datetime s& ,
c
C@ s� t j j j d | d | d | d | d | � } t j j j | � j } t j j j � } | | _
| | _ y | j | � Wni t
j j k
r� } t | j � � nB t j j k
r� t d j | � � � n t j j k
r� n Xt S( sq
Update the password for a given host.
.. note:: Currently only works with connections to ESXi hosts. Does not work with vCenter servers.
host
The location of the ESXi host.
username
The username used to login to the ESXi host, such as ``root``.
password
The password used to login to the ESXi host.
new_password
The new password that will be updated for the provided username on the ESXi host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
CLI Example:
.. code-block:: bash
salt '*' vsphere.update_host_password my.esxi.host root original-bad-password new-bad-password
R, R- R. R/ R0 sG 'vsphere.update_host_password' failed for host {0}: User was not found.( R9 R: RH RI R� t accountManagerR R, t LocalAccountManagert AccountSpecificationR R. t
UpdateUserR R
t SystemErrorR R� t UserNotFoundR5 t
AlreadyExistsRb (
R, R- R. t new_passwordR/ R0 RD t account_managert user_accountR ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt update_host_passwordX s& # c
C@ s t j j j d | d | d | d | d | � } t | | | � } i } x� | D]� } t | | d | �} | j j }
y |
j � WnZ t j
j k
r� } d j | � } t
j | � | j i i | d 6t d 6| 6� qO n X| j i i t d 6| 6� qO W| S(
s7
Disable vMotion for a given host or list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter which hosts should disable VMotion.
If host_names is not provided, VMotion will be disabled for the ``host``
location instead. This is useful for when service instance connection
information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.vmotion_disable my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.vmotion_disable my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� s# vsphere.vmotion_disable failed: {0}Rg s VMotion Disabled( R9 R: RH RI R� R� R� R� t DeselectVnicR R
R R5 R� R� Ri Rv Rb (
R, R- R. R/ R0 R� RD RS R� R� t vmotion_systemR R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt vmotion_disable� s( +
c C@ s t j j j d | d | d | d | d | � } t | | | � } i } x� | D]� } t | | d | �}
|
j j } y | j | � WnZ t j
j k
r� } d j | � }
t
j |
� | j i i |
d 6t d 6| 6� qO n X| j i i t d 6| 6� qO W| S(
s�
Enable vMotion for a given host or list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter which hosts should enable VMotion.
If host_names is not provided, VMotion will be enabled for the ``host``
location instead. This is useful for when service instance connection
information is used for a single ESXi host.
device
The device that uniquely identifies the VirtualNic that will be used for
VMotion for each host. Defaults to ``vmk0``.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.vmotion_enable my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.vmotion_enable my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� s# vsphere.vmotion_disable failed: {0}Rg s VMotion Enabled( R9 R: RH RI R� R� R� R� t
SelectVnicR R
R R5 R� R� Ri Rv Rb ( R, R- R. R/ R0 R� t deviceRD RS R� R� R/ R R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt vmotion_enable� s( /
c C@ s� t j j j d | d | d | d | d | � } t | | | � } t | | | � } i } xUt j | � D]D\ } }
t | | d | �} | j j
} | d k r� d j | � }
t
j |
� | j i i |
d 6| 6� qj |
j d � } |
j d � } | r9t | t � r9y2 | j | � } t j j j | | d
d d �Wn� t j j k
r�} t
j | j � | j i i | j d 6| 6� qj nP t k
r�} d
j | | � }
t
j |
� | j i i |
d 6| 6� qj n Xt
j d j | � � g } x | D] } | j | j � qW| j i i | d 6| 6� qj | rot | t j � ro| j i i | d 6| 6� qj | r�| j i i | d 6| 6� qj | j i i d d 6| 6� qj W| S( s�
Add any VSAN-eligible disks to the VSAN System for the given host or list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter which hosts need to add any VSAN-eligible disks to the host's
VSAN system.
If host_names is not provided, VSAN-eligible disks will be added to the hosts's
VSAN system for the ``host`` location instead. This is useful for when service
instance connection information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.vsan_add_disks my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.vsan_add_disks my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� sz VSAN System Config Manager is unset for host '{0}'. VSAN configuration cannot be changed without a configured VSAN System.Rg R� s Adding disks to VSANt
sleep_secondsi s1 'vsphere.vsan_add_disks' failed for host {0}: {1}s; Successfully added disks to the VSAN system for host '{0}'.s Disks Addeds- No new VSAN-eligible disks were found to add.N( R9 R: RH RI R� R� R R� R� R� t
vsanSystemRE R5 R� R� Ri R) Rh RJ t AddDiskst
wait_for_taskR R
t InsufficientDisksR� RL R� R� t string_types( R, R- R. R/ R0 R� RD Rl RS R� R� R� t vsan_systemR� t eligibleR� t taskR R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt vsan_add_disks%
sT ,
#
c C@ s� t j j j d | d | d | d | d | � } t j j j � } t | _ t
| | | � } i } x^| D]V} t | | d | �}
|
j j
} | d k r� d j | � } t j | � | j i i | d 6| 6� qj y2 | j | � }
t j j j |
| d d
d �Wn� t j j k
rU} t j | j � | j i i | j d 6| 6� qj nP t k
r�} d j | | � } t j | � | j i i | d 6| 6� qj n X| j i i t d
6| 6� qj W| S( s(
Disable VSAN for a given host or list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter which hosts should disable VSAN.
If host_names is not provided, VSAN will be disabled for the ``host``
location instead. This is useful for when service instance connection
information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.vsan_disable my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.vsan_disable my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� sz VSAN System Config Manager is unset for host '{0}'. VSAN configuration cannot be changed without a configured VSAN System.Rg s Disabling VSANR4 i s/ 'vsphere.vsan_disable' failed for host {0}: {1}s
VSAN DisabledN( R9 R: RH RI R t vsanR, t
ConfigInfoRv Rq R� R� R� R5 RE R5 R� R� Ri t UpdateVsan_TaskR7 R R
R' R� RL Rb ( R, R- R. R/ R0 R� RD R� RS R� R� R: R� R< R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt vsan_disable�
s> +
#
c C@ s� t j j j d | d | d | d | d | � } t j j j � } t | _ t
| | | � } i } xd| D]\} t | | d | �}
|
j j
} | d k r� d j | � } t j | � | j i i | d 6| 6� qj y2 | j | � }
t j j j |
| d d
d �Wn� t j j k
rU} t j | j � | j i i | j d 6| 6� qj nV t j j k
r�} d j | | � } t j | � | j i i | d 6| 6� qj n X| j i i t d
6| 6� qj W| S( s#
Enable VSAN for a given host or list of host_names.
host
The location of the host.
username
The username used to login to the host, such as ``root``.
password
The password used to login to the host.
protocol
Optionally set to alternate protocol if the host is not using the default
protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the host is not using the default
port. Default port is ``443``.
host_names
List of ESXi host names. When the host, username, and password credentials
are provided for a vCenter Server, the host_names argument is required to
tell vCenter which hosts should enable VSAN.
If host_names is not provided, VSAN will be enabled for the ``host``
location instead. This is useful for when service instance connection
information is used for a single ESXi host.
CLI Example:
.. code-block:: bash
# Used for single ESXi host connection information
salt '*' vsphere.vsan_enable my.esxi.host root bad-password
# Used for connecting to a vCenter Server
salt '*' vsphere.vsan_enable my.vcenter.location root bad-password host_names='[esxi-1.host.com, esxi-2.host.com]'
R, R- R. R/ R0 R� sz VSAN System Config Manager is unset for host '{0}'. VSAN configuration cannot be changed without a configured VSAN System.Rg s
Enabling VSANR4 i s. 'vsphere.vsan_enable' failed for host {0}: {1}s VSAN EnabledN( R9 R: RH RI R R> R, R? Rb Rq R� R� R� R5 RE R5 R� R� Ri R@ R7 R R
R' R� t VsanFault( R, R- R. R/ R0 R� RD R� RS R� R� R: R� R< R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt vsan_enable�
s> +
#
c C@ s� t j d j | � � i | d 6| j j d 6| j j d 6| j d 6| j d 6| j d 6| j d 6| j d 6} t
| j t j
� r� | j i | j j d
6� n | S( s�
Returns the dict representation of the DVS config
dvs_name
The name of the DVS
dvs_config
The DVS config
s) Building the dict of the DVS '{0}' configt namet
contact_emailt contact_namet descriptiont lacp_api_versiont network_resource_control_versiont# network_resource_management_enabledt max_mtut uplink_names( R� t traceR5 t contactRD RG t lacpApiVersiont networkResourceControlVersiont networkResourceManagementEnabledt maxMtuRh t uplinkPortPolicyR t DVSNameArrayUplinkPortPolicyRi t uplinkPortName( t dvs_namet
dvs_configt conf_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_dvs_config_dict7 s
c C@ s. t j d j | � � i | j d 6| j d 6S( s�
Returns the dict representation of the DVS link discovery protocol
dvs_name
The name of the DVS
dvs_link_disc_protocl
The DVS link discovery protocol
s: Building the dict of the DVS '{0}' link discovery protocolt operationR/ ( R� RM R5 RZ R/ ( RV t dvs_link_disc_protocol( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_dvs_link_discovery_protocolS s
c C@ s8 t j d j | � � i | j d 6| j d 6| j d 6S( s�
Returns the dict representation of the DVS product_info
dvs_name
The name of the DVS
dvs_product_info
The DVS product info
s/ Building the dict of the DVS '{0}' product infoRD t vendort version( R� RM R5 RD R] R^ ( RV t dvs_product_info( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_dvs_product_infoc s
c C@ s8 t j d j | � � i | j d 6| j d 6| j d 6S( s�
Returns the dict representation of the DVS product_info
dvs_name
The name of the DVS
dvs_capability
The DVS capability
s- Building the dict of the DVS '{0}' capabilityt operation_supportedt portgroup_operation_supportedt port_operation_supported( R� RM R5 t dvsOperationSupportedt dvPortGroupOperationSupportedt dvPortOperationSupported( RV t dvs_capability( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_dvs_capabilityt s
c C@ s� t j d j | � � g } x� | D]y } i | j d 6| j j d 6| j j d 6} | j j r� | j i | j j j d 6| j j j d 6� n | j
| � q# W| S( s�
Returns a list of dict representations of the DVS infrastructure traffic
resource
dvs_name
The name of the DVS
dvs_infra_traffic_ress
The DVS infrastructure traffic resources
sD Building the dicts of the DVS '{0}' infrastructure traffic resourcesR� t limitt reservationt
num_sharest share_level( R� RM R5 R� t allocationInfoRi Rj t sharesRi t levelR� ( RV t dvs_infra_traffic_resst res_dictst rest res_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt) _get_dvs_infrastructure_traffic_resources� s
c C@ s� g } t � } | d k r; t d � d } t | � } n8 | d k rs t d � d } t j j j | | � } n x5t j j j | | | � D]} i } t j j j | d d d d g � } t | d | d � } | j
i t | d | d j � d
6� | d j
r7| j
i t | d | d j
� d 6� n | j
i t | d | d � d 6� t | d d � r�| j
i t | d | d j � d
6� n | j | � q� W| S( s�
Returns a list of distributed virtual switches (DVSs).
The list can be filtered by the datacenter or DVS names.
datacenter
The datacenter to look for DVSs in.
Default value is None.
dvs_names
List of DVS names to look for. If None, all DVSs are returned.
Default value is None.
.. code-block:: bash
salt '*' vsphere.list_dvss
salt '*' vsphere.list_dvss dvs_names=[dvs1,dvs2]
R! s esxdatacenter.get_detailst
datacenterR s esxcluster.get_detailsRD R� t
capabilityt networkResourcePoolt product_infot link_discovery_protocolt# infrastructureTrafficResourceConfigt% infrastructure_traffic_resource_pools( R+ R4 t _get_proxy_targetR9 R: RH t get_datacentert get_dvsst get_properties_of_managed_objectRY Ri R` t productInfot linkDiscoveryProtocolConfigR\ Rh t hasattrRt Rz R� ( Ru t dvs_namesRD t ret_listR> t dc_reft dvst dvs_dictt props( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_dvss� sB #
c C@ sm | j d � r | d | _ n | j d � s= | j d � r� | j sX t j � | _ n | j d � | j _ | j d � | j _ n | j d � r� | j d � | _ n | j d � r� | j d � | _ n | j d � r� | j d � | _ n | j d � r| j d � | _ n | j d � ri| j sDt
| j t j � rVt j � | _ n | d | j _ n d S(
si
Applies the values of the config dict dictionary to a config spec
(vim.VMwareDVSConfigSpec)
RD RE RF RG RK RH RI RL N(
R) RD RN R t DVSContactInfoRG RR RO RP RS Rh RT RU ( t config_spect config_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_dvs_config� s*
c C@ s | d | _ | d | _ d S( s�
Applies the values of the disc_prot_dict dictionary to a link discovery
protocol config object (vim.LinkDiscoveryProtocolConfig)
RZ R/ N( RZ R/ ( t disc_prot_configt disc_prot_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt" _apply_dvs_link_discovery_protocol s
c C@ sa | j d � r | d | _ n | j d � r> | d | _ n | j d � r] | d | _ n d S( s�
Applies the values of the product_info_dict dictionary to a product info
spec (vim.DistributedVirtualSwitchProductSpec)
RD R] R^ N( R) RD R] R^ ( t product_info_spect product_info_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_dvs_product_info s c C@ sX d | k r | d | _ n d | k r8 | d | _ n d | k rT | d | _ n d S( su
Applies the values of the capability_dict dictionary to a DVS capability
object (vim.vim.DVSCapability)
Ra Rc Rb N( Rd Rf Re ( t capability_spect capability_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_dvs_capability s c C@ sb x[| D]S} g | D] } | j | d k r | ^ q } | rL | d } n5 t j � } | d | _ t j � | _ | j | � | j d � r� | d | j _ n | j d � r� | d | j _ n | j d � s� | j d � r| j j st j
� | j _ qn | j d � r5t j | d � | j j _ n | j d � r | d | j j _ q q Wd S( s�
Applies the values of the resource dictionaries to infra traffic resources,
creating the infra traffic resource if required
(vim.DistributedVirtualSwitchProductSpec)
R� i Ri Rj Rk Rl N(
R� R t$ DvsHostInfrastructureTrafficResourcet. DvsHostInfrastructureTrafficResourceAllocationRm R� R) Ri Rj Rn t
SharesInfot SharesLevelRo ( t infra_traffic_resourcest resource_dictsRs t rt filtered_traffic_resourcest traffic_res( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt+ _apply_dvs_infrastructure_traffic_resources( s&
,
c C@ s x| D]
} g | D] } | j | d k r | ^ q } | rL | d } n5 t j � } | d | _ t j � | _ | j | � | j d � r� | d | j _ n | j d � r | j d � r | j j s� t j � | j _ n | d | j j _ t j
| d � | j j _ q q Wd S( s�
Applies the values of the resource dictionaries to network resource pools,
creating the resource pools if required
(vim.DVSNetworkResourcePoolConfigSpec)
R� i Ri Rk Rl N( R� R t DVSNetworkResourcePoolConfigSpect$ DVSNetworkResourcePoolAllocationInfoRm R� R) Ri Rn R� R� Ro ( t network_resource_poolsR� Rs R� t ressRr ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt! _apply_dvs_network_resource_poolsJ s
,
c C@ s: t j d j | | � � t � } | d k rN t d � d } t | � } n8 | d k r� t d � d } t j j j | | � } n | | d <t
j � } t
j � | _
t | j
| � | j d � r� t
j � | _ t | j | d � n | j d � r%t
j � | _ t | j | d � n | j d
� r`t
j � | j
_ t | j
j | d
� n | j d � r�g | j
_ t | j
j | d � n t j d j | � � t j j j | | | � d
| k r6t j j j | d | g �} | st d j | | � � � n | d } t j j j | | d
� n t S( s�
Creates a distributed virtual switch (DVS).
Note: The ``dvs_name`` param will override any name set in ``dvs_dict``.
dvs_dict
Dict representation of the new DVS (example in salt.states.dvs)
dvs_name
Name of the DVS to be created.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.create_dvs dvs dict=$dvs_dict dvs_name=dvs_name
s" Creating dvs '{0}' with dict = {1}R! s esxdatacenter.get_detailsRu R s esxcluster.get_detailsRD Rx Rv Ry R{ s dvs_create_spec = {}RJ R� s* DVS '{0}' wasn't found in datacenter '{1}'i ( R� RM R5 R+ R4 R| R9 R: RH R} R t
DVSCreateSpect VMwareDVSConfigSpect
configSpecR� R) t# DistributedVirtualSwitchProductSpecR� R� t
DVSCapabilityRv R� t LinkDiscoveryProtocolConfigR� R� Rz R� t
create_dvsR~ R t+ set_dvs_network_resource_management_enabledRb ( R� RV RD R> Ru R� t dvs_create_spect dvs_refst dvs_ref( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� d sX
c C@ sy t j d j | | � � x0 d d d d g D] } | | k r, | | =q, q, Wt � } | d k r� t d � d } t | � } n8 | d k r� t d
� d } t j j j | | � } n t j j j
| d | g �} | s� t d j | | � � � n | d
} t j j j | d d g � } t
j � }
d g } x\ |
j j � D]K } | | k r]qEn t | d | � rEt |
| t | d | � � qEqEWt |
| � | j d � r�|
j s�t
j � |
_ n t |
j | d � n | j d � r |
j sg |
_ n t |
j | d � n t j d j |
� � t j j j | d |
�d | k rut j j j | | d � n t S( sH
Updates a distributed virtual switch (DVS).
Note: Updating the product info, capability, uplinks of a DVS is not
supported so the corresponding entries in ``dvs_dict`` will be
ignored.
dvs_dict
Dictionary with the values the DVS should be update with
(example in salt.states.dvs)
dvs
Name of the DVS to be updated.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.update_dvs dvs_dict=$dvs_dict dvs=dvs1
s" Updating dvs '{0}' with dict = {1}Rx Rv RL RD R! s esxdatacenter.get_detailsRu R s esxcluster.get_detailsR� s* DVS '{0}' wasn't found in datacenter '{1}'i R� R, Ry R{ s dvs_config= {}t dvs_config_specRJ ( R� RM R5 R+ R4 R| R9 R: RH R} R~ R R R R� R� t keysR� t setattrt getattrR� R) R� R� R� Rz R� t
update_dvsR� Rb ( R� R� RD t propR> Ru R� R� R� t dvs_propsRW t skipped_properties( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � sX
$
c C@ sa t j d j | � � | j } | s) i Si | j j d 6| j j d 6| j j d 6| j j d 6S( s�
Returns the out shaping policy of a distributed virtual portgroup
pg_name
The name of the portgroup
pg_default_port_config
The dafault port config of the portgroup
s/ Retrieving portgroup's '{0}' out shaping configt average_bandwidtht
burst_sizeRq t peak_bandwidth( R� RM R5 t outShapingPolicyt averageBandwidthR� t burstSizeRq t
peakBandwidth( t pg_namet pg_default_port_configt out_shaping_policy( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_dvportgroup_out_shaping� s
c C@ sT t j d j | � � | j } | s) i Si | j j d 6| j j d 6| j j d 6S( s�
Returns the security policy of a distributed virtual portgroup
pg_name
The name of the portgroup
pg_default_port_config
The dafault port config of the portgroup
s3 Retrieving portgroup's '{0}' security policy configt allow_promiscuoust forged_transmitst mac_changes( R� RM R5 t securityPolicyt allowPromiscuousR� t forgedTransmitst
macChanges( R� R� t
sec_policy( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_dvportgroup_security_policy s
c C@ s( t j d j | � � | j } | s) i Si | j j d 6| j j d 6| j j d 6| j j d 6} | j r� | j } | j
i i | j j d 6| j j d 6| j
j d 6| j j d 6| j j d
6| j j d 6| j j d 6d
6� n | j r$| j } | j
i i | j d 6| j d 6d 6� n | S( s�
Returns the teaming of a distributed virtual portgroup
pg_name
The name of the portgroup
pg_default_port_config
The dafault port config of the portgroup
s* Retrieving portgroup's '{0}' teamingconfigt notify_switchesR� t reverse_policyt
rolling_ordert check_beacont check_duplext check_error_percentt check_speedt full_duplext
percentaget speedt failure_criteriat activet standbyt
port_order( R� RM R5 t uplinkTeamingPolicyt notifySwitchesR� R� t
reversePolicyt rollingOrdert failureCriteriaRi t checkBeacont checkDuplext checkErrorPercentt
checkSpeedt
fullDuplexR� R� t uplinkPortOrdert activeUplinkPortt standbyUplinkPort( R� R� t teaming_policyt ret_dictR� t uplink_order( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_dvportgroup_teaming# s2
c C@ s# t j j j | d d d d d g � } i | d d 6| j d � d 6| d d 6| d d 6} | d r | d } | j r� t | j t j � r� | j i | j j
d 6� n | j i t | d | d � d
6� | j i t | d | d � d 6� | j i t
| d | d � d 6� n | S(
sq
Returns a dictionary with a distributed virutal portgroup data
pg_ref
Portgroup reference
RD s config.descriptions config.numPortss config.types config.defaultPortConfigRG t num_portst typet vlan_idt out_shapingt security_policyt teaming( R9 R: RH R R) t vlanRh R t( VmwareDistributedVirtualSwitchVlanIdSpecRi t vlanIdR� R� R� ( t pg_refR� t pg_dictt dpg( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_dvportgroup_dictH s4
c C@ s& g } t � } | d k r; t d � d } t | � } n8 | d k rs t d � d } t j j j | | � } n | r� t j j j | d | g �} | s� t d j | � � � n | d } n | s� t
n t } xK t j j j d | r� | n | d
| d | � D] }
| j
t |
� � qW| S( s�
Returns a list of distributed virtual switch portgroups.
The list can be filtered by the portgroup names or by the DVS.
dvs
Name of the DVS containing the portgroups.
Default value is None.
portgroup_names
List of portgroup names to look for. If None, all portgroups are
returned.
Default value is None
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_dvporgroups
salt '*' vsphere.list_dvportgroups dvs=dvs1
salt '*' vsphere.list_dvportgroups portgroup_names=[pg1]
salt '*' vsphere.list_dvportgroups dvs=dvs1 portgroup_names=[pg1]
R! s esxdatacenter.get_detailsRu R s esxcluster.get_detailsR� s DVS '{0}' was not retrievedi t
parent_reft portgroup_namest get_all_portgroups( R+ R4 R| R9 R: RH R} R~ R R5 Rb Rv t get_dvportgroupsR� R� ( R� R� RD R� R> Ru R� R� R� R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_dvportgroupsm s*
c C@ s� t � } | d k r5 t d � d } t | � } n8 | d k rm t d � d } t j j j | | � } n t j j j | d | g �} | s� t d j | � � � n t j j j
| d � } t | � S( sI
Returns the uplink portgroup of a distributed virtual switch.
dvs
Name of the DVS containing the portgroup.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_uplink_dvportgroup dvs=dvs_name
R! s esxdatacenter.get_detailsRu R s esxcluster.get_detailsR� s DVS '{0}' was not retrievedi ( R+ R4 R| R9 R: RH R} R~ R R5 t get_uplink_dvportgroupR� ( R� RD R> Ru R� R� t
uplink_pg_ref( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_uplink_dvportgroup� s c C@ s� t j d j | � � | j d � rG t j � | _ | d | j _ n | j d � rx t j � | _ | d | j _ n d | k r� t j � | _
| d | j
_ n | j d � r� t j � | _ | d | j _ n d S( s�
Applies the values in out_shaping_conf to an out_shaping object
pg_name
The name of the portgroup
out_shaping
The vim.DVSTrafficShapingPolicy to apply the config to
out_shaping_conf
The out shaping config
s- Building portgroup's '{0}' out shaping policyR� R� Rq R� N( R� RM R5 R) R t
LongPolicyR� R� R� t
BoolPolicyRq R� ( R� R� t out_shaping_conf( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_dvportgroup_out_shaping� s
c C@ s� t j d j | � � d | k rD t j � | _ | d | j _ n d | k rr t j � | _ | d | j _ n d | k r� t j � | _ | d | j _ n d S( s�
Applies the values in sec_policy_conf to a security policy object
pg_name
The name of the portgroup
sec_policy
The vim.DVSTrafficShapingPolicy to apply the config to
sec_policy_conf
The out shaping config
s+ Building portgroup's '{0}' security policy R� R� R� N( R� RM R5 R R R� R� R� R� ( R� R� t sec_policy_conf( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt" _apply_dvportgroup_security_policy� s
c C@ s� t j d j | � � d | k rD t j � | _ | d | j _ n d | k rr t j � | _ | d | j _ n d | k r� t j � | _ | d | j _ n d | k r� t j � | _
| d | j
_ n d | k rn| j s� t j � | _ n | d } d | k r3t j � | j _
| d | j j
_ n d | k rgt j � | j _ | d | j j _ n d | k r�t j � | j _ | d | j j _ n d
| k r�t j � | j _ | d
| j j _ n d | k rt j � | j _ | d | j j _ n d | k r7t j � | j _ | d | j j _ n d
| k rnt j � | j _ | d
| j j _ qnn d | k r�| j s�t j � | _ n d | d k r�| d d | j _ n d | d k r�| d d | j _ q�n d S( s�
Applies the values in teaming_conf to a teaming policy object
pg_name
The name of the portgroup
teaming
The vim.VmwareUplinkPortTeamingPolicy to apply the config to
teaming_conf
The teaming config
s" Building portgroup's '{0}' teamingR� R� R� R� R� R� R� R� R� R� R� R� R� R� R� N( R� RM R5 R R R� R� t StringPolicyR� R� R� R� t DVSFailureCriteriaR� R� R� R� R� t IntPolicyR� R� R� t VMwareUplinkPortOrderPolicyR� R� ( R� R� t teaming_conft failure_criteria_conf( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_dvportgroup_teaming� sZ
c C@ s� t j d j | � � d | k r2 | d | _ n d | k rN | d | _ n d | k rj | d | _ n d | k r� | d | _ n | j s� x; d d d d g D]$ } | | k r� t j � | _ q� q� Wn d | k rt j
� | j _ | d | j j _ n d | k rK| j j
s.t j � | j _
n t | | j j
| d � n d | k r�| j j sxt j � | j _ n t | | j j | d � n d | k r�| j j s�t j � | j _ n t | | j j | d � n d
S( s�
Applies the values in conf to a distributed portgroup spec
pg_name
The name of the portgroup
pg_spec
The vim.DVPortgroupConfigSpec to apply the config to
pg_conf
The portgroup config
s Building portgroup's '{0}' specRD RG R� R� R� R� R� R� N( R� RM R5 RD RG t numPortsR� t defaultPortConfigR t VMwareDVSPortSettingR� R� R� R� t DVSTrafficShapingPolicyR R� t DVSSecurityPolicyR R� t VmwareUplinkPortTeamingPolicyR
( R� t pg_spect pg_confR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_dvportgroup_configB sD
c C@ s t j d j | | | � � t � } | d k rQ t d � d } t | � } n8 | d k r� t d � d } t j j j | | � } n t j j j
| d | g �} | s� t d j | � � � n | | d <t j
� } t | | | � t j j j | d
| � t S( s�
Creates a distributed virtual portgroup.
Note: The ``portgroup_name`` param will override any name already set
in ``portgroup_dict``.
portgroup_dict
Dictionary with the config values the portgroup should be created with
(example in salt.states.dvs).
portgroup_name
Name of the portgroup to be created.
dvs
Name of the DVS that will contain the portgroup.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.create_dvportgroup portgroup_dict=<dict>
portgroup_name=pg1 dvs=dvs1
s4 Creating portgroup'{0}' in dvs '{1}' with dict = {2}R! s esxdatacenter.get_detailsRu R s esxcluster.get_detailsR� s DVS '{0}' was not retrievedRD i ( R� RM R5 R+ R4 R| R9 R: RH R} R~ R R t DVPortgroupConfigSpecR t create_dvportgroupRb ( t portgroup_dictt portgroup_nameR� RD R> Ru R� R� t spec( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR x s$
c C@ s� t j d j | | | � � t � } | d k rQ t d � d } t | � } n8 | d k r� t d � d } t j j j | | � } n t j j j
| d | g �} | s� t d j | � � � n t j j j | d d
| g �} | st d j | � � � n t j j j
| d d g � } t j � }
xL d
d d d d d d d d d d g D]# } t |
| t | d | � � qXWt | |
| � t j j j | d |
� t S( sv
Updates a distributed virtual portgroup.
portgroup_dict
Dictionary with the values the portgroup should be update with
(example in salt.states.dvs).
portgroup
Name of the portgroup to be updated.
dvs
Name of the DVS containing the portgroups.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.update_dvportgroup portgroup_dict=<dict>
portgroup=pg1
salt '*' vsphere.update_dvportgroup portgroup_dict=<dict>
portgroup=pg1 dvs=dvs1
s4 Updating portgroup'{0}' in dvs '{1}' with dict = {2}R! s esxdatacenter.get_detailsRu R s esxcluster.get_detailsR� s DVS '{0}' was not retrievedi R� s! Portgroup '{0}' was not retrievedR� t
autoExpandt
configVersionR RG RD R R� t portNameFormatt scopeR� t vendorSpecificConfig( R� RM R5 R+ R4 R| R9 R: RH R} R~ R R� R R R R� R� R t update_dvportgroupRb ( R t portgroupR� RD R> Ru R� R� t pg_refst pg_propsR R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR! � s8 !c C@ s t j d j | | � � t � } | d k rN t d � d } t | � } n8 | d k r� t d � d } t j j j | | � } n t j j j
| d | g �} | s� t d j | � � � n t j j j | d d
| g �} | st d j | � � � n t j j j
| d � t S( sv
Removes a distributed virtual portgroup.
portgroup
Name of the portgroup to be removed.
dvs
Name of the DVS containing the portgroups.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.remove_dvportgroup portgroup=pg1 dvs=dvs1
s% Removing portgroup'{0}' in dvs '{1}' R! s esxdatacenter.get_detailsRu R s esxcluster.get_detailsR� s DVS '{0}' was not retrievedi R� s! Portgroup '{0}' was not retrieved( R� RM R5 R+ R4 R| R9 R: RH R} R~ R R� t remove_dvportgroupRb ( R" R� RD R> Ru R� R� R# ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR% � s(
c
C@ s� i | j d 6| j d 6| j j d 6} g } t | t j j � r�t | j t j j � r�x2| j j D]!} i | j d 6| j
d 6} g } x� | j D]� } i | j j
d 6| j j d 6} | j d j d j } t | t j j j � ri d d 6| j d
6| j d 6} nF t | t j j j � rBi d d 6| j d
6} n i d d 6| d 6} | | d <| j | � q� W| | d <| j | � qg Wn | | d <| S( s/ Returns a dictionary representation of a policyRD RG t
resource_typet force_provisiont namespaceR i R R� t mint maxt sett valuest scalarR� t settingt capabilitiest subprofiles( RD RG t resourceTypeRh R t profilet CapabilityBasedProfilet constraintst SubProfileCapabilityConstraintst subProfilest forceProvisionRv R R( t
constraintt propertyInstanceR� t typest RangeR) R* t DiscreteSetR, R� (
R� t profile_dictt subprofile_dictst
subprofilet subprofile_dictt cap_dictst capt cap_dictt valt val_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_policy_dict s<
c C@ sn t j j j | � } | s9 t j j j | d t �} n t j j j | | � } g | D] } t | � ^ qX S( s�
Returns a list of storage policies.
policy_names
Names of policies to list. If None, all policies are listed.
Default is None.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_storage_policies
salt '*' vsphere.list_storage_policy policy_names=[policy_name]
t get_all_policies( R9 R: R t get_profile_managert get_storage_policiesRb RF ( t policy_namesRD t profile_managert policiest p( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_storage_policies7 s c C@ s{ t j j j | � } t j j j | d t �} g | D] } | j d k r7 | ^ q7 } | sm t d � � n t | d � S( s3
Returns the default vsan storage policy.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_storage_policies
salt '*' vsphere.list_storage_policy policy_names=[policy_name]
RG t VsanDefaultProfiles% Default VSAN policy was not retrievedi ( R9 R: R RH RI Rb t systemCreatedProfileTypeR RF ( RD RK RL RM t def_policies( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_default_vsan_policyV s
c C@ sI i | j j d 6| j j d 6| j d 6| j j d 6| j d j j d 6S( NR( R t mandatoryRG i R� ( R R( RS t summaryt propertyMetadataR� t typeName( t cap_metadata( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_capability_definition_dictr s
c C@ sG t j j j | � } g t j j j | � D] } t | � ^ q+ } | S( s
Returns a list of the metadata of all capabilities in the vCenter.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_capabilities
( R9 R: R RH t get_capability_definitionsRX ( RD RK t cR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_capability_definitions} s +c
C@ sM t j d j | � � | j d � r5 | d | _ n | j d � rT | d | _ n | j d � r3t j j � | _ g } x�| d D]�} t j j j
d | d � } g } | j d � r� | d | _ n x:| d D].} t j j
d | d � } | d d } | d
k r=t j j j � | _ | d d | j _ nl | d k r�t j j j � | _ | d d
| j _ | d d | j _ n | d k r�| d d | _ n t j j d t j j j d | d d | d � d t j j d | g � g � } | j | � q� W| | _ | j | � q� W| | j _ n t j d j | � � | S( s, Applies a policy dictionary to a policy specs policy_dict = {0}RD RG R0 R' R/ R R. R� R+ R, R R* R) R- R� R( R8 R9 s updated policy_spec = {0}( R� RM R5 R) RD RG R R2 R5 R4 t
SubProfileR7 Rv t PropertyInstanceR: R< R� R, R; R* R) t CapabilityInstancet CapabilityMetadatat UniqueIdt ConstraintInstanceR� R6 (
t policy_spect policy_dictR0 R@ t subprofile_spect cap_specsRC t prop_inst_spect setting_typet cap_spec( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_policy_config� sN
c C@ s� t j d j | | � � t j j j | � } t j j � } t j j d t j j
j � | _ | | d <t j d � t
| | � t j j j | | � i t d 6S( s^
Creates a storage policy.
Supported capability types: scalar, set, range.
policy_name
Name of the policy to create.
The value of the argument will override any existing name in
``policy_dict``.
policy_dict
Dictionary containing the changes to apply to the policy.
(example in salt.states.pbm)
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.create_storage_policy policy_name='policy name'
policy_dict="$policy_dict"
s' create storage policy '{0}', dict = {1}R1 RD s+ Setting policy values in policy_update_spect create_storage_policy( R� RM R5 R9 R: R RH R2 t CapabilityBasedProfileCreateSpect ResourceTypet ResourceTypeEnumt STORAGER1 Ri Rj Rb ( t policy_nameRc RD RK t policy_create_spec( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRj � s
c C@ s� t j d j | � � t j j j | � } t j j j | | g � } | sd t d j | � � � n | d } t j j
� } t j d � x- d d g D] } t | | t | | � � q� Wt
| | � t j j j | | | � i t d 6S( s�
Updates a storage policy.
Supported capability types: scalar, set, range.
policy
Name of the policy to update.
policy_dict
Dictionary containing the changes to apply to the policy.
(example in salt.states.pbm)
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.update_storage_policy policy='policy name'
policy_dict="$policy_dict"
s# updating storage policy, dict = {0}s Policy '{0}' was not foundi s+ Setting policy values in policy_update_specRG R4 t update_storage_policy( R� RM R5 R9 R: R RH RI R R2 t CapabilityBasedProfileUpdateSpecR� R� Ri Rq Rb ( R� Rc RD RK RL t
policy_reft policy_update_specR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRq � s
c C@ s� t j d j | � � t | � } t j j j | | d | g �} | sa t d j | � � � n t j j j
| � } t j j j | | d � } t | � S( s�
Returns a list of datastores assign the the storage policies.
datastore
Name of the datastore to assign.
The datastore needs to be visible to the VMware entity the proxy
points to.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_default_storage_policy_of_datastore datastore=ds1
s5 Listing the default storage policy of datastore '{0}'t datastore_namess Datastore '{0}' was not foundi (
R� RM R5 R| R9 R: RH t get_datastoresR R RH t' get_default_storage_policy_of_datastoreRF ( t datastoreRD t
target_reft ds_refsRK R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt( list_default_storage_policy_of_datastore s
c C@ s� t j d j | | � � t j j j | � } t j j j | | g � } | sg t d j | � � � n | d } t | � } t j j
j | | d | g �} | s� t d j | � � � n | d } t j j j | | | � t
S( s
Assigns a storage policy as the default policy to a datastore.
policy
Name of the policy to assign.
datastore
Name of the datastore to assign.
The datastore needs to be visible to the VMware entity the proxy
points to.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.assign_storage_policy_to_datastore
policy='policy name' datastore=ds1
s% Assigning policy {0} to datastore {1}s Policy '{0}' was not foundi Ru s Datastore '{0}' was not found( R� RM R5 R9 R: R RH RI R R| RH Rv t* assign_default_storage_policy_to_datastoreRb ( R� Rx RD RK RL Rs Ry Rz t ds_ref( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR| : s$
c C@ si | s$ t j j j | d t �} n t j j j | | � } g | D]" } i t j j j | � d 6^ qC S( sp
Returns a list of dict representations of VMware datacenters.
Connection is done via the proxy details.
Supported proxies: esxdatacenter
datacenter_names
List of datacenter names.
Default is None.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_datacenters_via_proxy
salt '*' vsphere.list_datacenters_via_proxy dc1
salt '*' vsphere.list_datacenters_via_proxy dc1,dc2
salt '*' vsphere.list_datacenters_via_proxy datacenter_names=[dc1, dc2]
t get_all_datacentersRD ( R9 R: RH t get_datacentersRb t get_managed_object_name( t datacenter_namesRD t dc_refsR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_datacenters_via_proxyi s c C@ s! t j j j | | � i t d 6S( s.
Creates a datacenter.
Supported proxies: esxdatacenter
datacenter_name
The datacenter name
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.create_datacenter dc1
t create_datacenter( R9 R: RH R� Rb ( t datacenter_nameRD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � s c C@ s- t j d j | � � t j j j | d d g �} i i | d j j d 6d 6i | d j j d 6d 6} | d j } t j d j | � � | j
| d d <| j r� t | j t
j � r� | j } i | j d 6| j d
6| d d <n | j r!| j } i | j d 6| j d
6| d d <n | j | d d <| j rO| j | d d <n | j r�g | j D] } i | j d 6| j d 6^ qb| d d <n | j | d d <| d j } t j d j | � � d | j | d d <| j | d d <| d j | d <t j j j | � } t j j j | � r)t j j j | � }
t! |
j" � d k r�t j j j# | � } t j d j | � � i | j d 6| j$ j% d 6| d <| j& r&| j& } | d j' i | j( p�t) d 6| j* d 6� q&q)| d j+ r)| d j+ j$ }
i | d j+ j d 6|
j% d 6| d <q)n | S( s�
Returns a cluster dict representation from
a vim.ClusterComputeResource object.
cluster_name
Name of the cluster
cluster_ref
Reference to the cluster
s5 Building a dictionary representation of cluster '{0}'t
propertiest configurationExRq t hat drss
ha_conf = {0}t admission_control_enabledt cpu_failover_percentt memory_failover_percentt admission_control_policyt isolation_responset restart_priorityt default_vm_settingst hb_ds_candidate_policyt host_monitoringR� R� t optionst
vm_monitorings drs_conf = {0}i t vmotion_ratet default_vm_behaviort vm_swap_placementijv7 s vsan_conf = {0}t auto_claim_storageR> t compression_enabledt
dedup_enabled(, R� RM R5 R9 R: RH R t dasConfigRq t drsConfigt admissionControlEnabledt admissionControlPolicyRh R t. ClusterFailoverResourcesAdmissionControlPolicyt cpuFailoverResourcesPercentt memoryFailoverResourcesPercentt defaultVmSettingst isolationResponset restartPriorityt hBDatastoreCandidatePolicyt hostMonitoringt optionR� R� t vmMonitoringt vmotionRatet defaultVmBehaviort vmSwapPlacementt( get_service_instance_from_managed_objectR> t vsan_supportedt get_service_infot intt buildt get_cluster_vsan_infot
defaultConfigt autoClaimStoraget dataEfficiencyConfigRi t compressionEnabledRv t dedupEnabledt vsanConfigInfo( t cluster_namet cluster_refR� Rr t ha_conft polt
def_vm_sett ot drs_conft sit vcenter_infot vsan_conft data_efft default_config( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_cluster_dict� sh
8
c C@ s� t � } | d k rQ t | � } | s6 t d � � n t j j j | | � } n, | d k r} t | � } t d � d } n t j d j
| | � � t | | � S( s�
Returns a dict representation of an ESX cluster.
datacenter
Name of datacenter containing the cluster.
Ignored if already contained by proxy details.
Default value is None.
cluster
Name of cluster.
Ignored if already contained by proxy details.
Default value is None.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
# vcenter proxy
salt '*' vsphere.list_cluster datacenter=dc1 cluster=cl1
# esxdatacenter proxy
salt '*' vsphere.list_cluster cluster=cl1
# esxcluster proxy
salt '*' vsphere.list_cluster
R! s 'cluster' needs to be specifiedR s esxcluster.get_detailst clusters9 Retrieving representation of cluster '{0}' in a {1} proxy( R+ R| R R9 R: RH t get_clusterR4 R� RM R5 R� ( Ru R� RD R> R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_cluster� s
c
C@ s t j d j | � � | j d � rB| d } | j sJ t j � | _ n | j } d | k r� | d | _ | d r� d | _ q� n d | k r� | d | _ n d | k r | d } | j
s� t | j
t j � r t j d | d d | d
� | _
q n d | k rr| d } | j
s1t j � | _
n d | k rP| d | j
_ n d
| k rr| d
| j
_ qrn d | k r�| d | _ n d | k r�| d | _ n d | k rg | _ xX | d D]I } | j j t j d | d � � d | k r�| d | j d _ q�q�Wn d | k r6| d | _ n | | _ n | j d � r�| d } t j � }
d | k r�| d |
_ n d | k r�d | d |
_ n d | k r�t j | d � |
_ n |
| _ n | j d � r�| d | _ n | j d � r�| d } | sTd | k rR| j s?t j j j! � | _ n | d | j _ n d | k r�| j st j j j! � | _ n | j j" s�t j# � | j _" n! | j j" j$ r�d | j j" _$ n | d | j j" _& n d | k r| j' st j j( � | _' n | d | j' _) n d | k rT| j' s>t j j( � | _' n | d | j' _* qTn | j+ sot j, � | _+ n | j+ } d | k r�| d | _ n d | k r�| j" s�t j# � | _" n | j" j$ r�d | j" _$ n | d | j" _& q�n t j d j | � � d S( s�
Applies the values of cluster_dict dictionary to a cluster spec
(vim.ClusterConfigSpecEx).
All vsan values (cluster_dict['vsan']) will be applied to
vsan_spec (vim.vsan.cluster.ConfigInfoEx). Can be not omitted
if not required.
VSAN 6.1 config needs to be applied differently than the post VSAN 6.1 way.
The type of configuration desired is dictated by the flag vsan_61.
s Applying cluster dict {0}R� Rq i R� R� R� R� R� R� R� R� R� R� R� R� R� R� i����R� R� R� i R� R� R> R� R� R� s cluster_spec = {0}N(- R� RM R5 R) R� R t ClusterDasConfigInfoRq t
failoverLevelR� R� Rh R� R� t ClusterDasVmSettingsR� R� R� R� R� R� t OptionValueR� R� t ClusterDrsConfigInfoR� t DrsBehaviorR� R� R� t vsanClusterConfigR> R� R? R� t$ VsanClusterConfigInfoHostDefaultInfot uuidRE R� R� t DataEfficiencyConfigR� R� t
vsanConfigt VsanClusterConfigInfo(
t cluster_spect cluster_dictt vsan_spect vsan_61t ha_dictt
das_configt adm_pol_dictt vm_set_dictt opt_dictt drs_dictt
drs_configt vsan_dictR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_cluster_dict( s�
c C@ s� t j � } y t j | | � Wn% t j j k
rG } t | � � n Xt � } | d k r� t d � d } t | � } | s� t
d � � q� nI | d k r� t d � d } t j j
j | | � } t d � d } n | j d � rt j j j | � rt d � � n | } t j � } d }
d } d } | j d � r�t j j
j | � }
t |
j � d
k r�t |
j � d k r�t j j d t � }
t } | j d
i � j d � r�t } | d
} | d
=q�q�t } n t | | |
| � t j j
j | | | � | s�|
rFt j j
j | | � } t j j j! | |
� n | r�t | i | d
6� t j j
j" | | � | | d
<q�n i t d 6S( s#
Creates a cluster.
Note: cluster_dict['name'] will be overridden by the cluster param value
config_dict
Dictionary with the config values of the new cluster.
datacenter
Name of datacenter containing the cluster.
Ignored if already contained by proxy details.
Default value is None.
cluster
Name of cluster.
Ignored if already contained by proxy details.
Default value is None.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
# esxdatacenter proxy
salt '*' vsphere.create_cluster cluster_dict=$cluster_dict cluster=cl1
# esxcluster proxy
salt '*' vsphere.create_cluster cluster_dict=$cluster_dict
R! s esxdatacenter.get_detailsRu s 'cluster' needs to be specifiedR s esxcluster.get_detailsR� R> s! VSAN operations are not supportedg @ijv7 t modifyR� Rq t create_clusterN(# R t serializet
jsonschemat validatet
exceptionst ValidationErrorR
R+ R4 R| R R9 R: RH R} R) R> R� R R t ClusterConfigSpecExRE R� t floatt
apiVersionR� R� t ReconfigSpecRb Rv R� R� R� t reconfigure_cluster_vsant update_cluster( R� Ru R� RD t schemat excR> R� R� R� R� t ha_configR� R� t enable_haR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � sZ %
c C@ sD t j � } y t j | | � Wn% t j j k
rG } t | � � n Xt � } | d k r� t d � d } t | � } | s� t
d � � q� nI | d k r� t d � d } t j j
j | | � } t d � d } n | j d � rt j j j | � rt d � � n t j j
j | | � } t j � } t j j
j | d
d g �}
x1 d d
g D]# } t | | t |
d | � � q^W|
d j r�|
d j | _ n d } d }
| j d � rPt j j
j | � } t | j � d k rGt | j � d k rGt! }
t j j j" | � } t j j# d t$ � } | j% | _% d | _% qPt$ }
n t& | | | |
� | r#t' j( d j) | � � t j j j* | | � t j � } t j j
j | d
d g �}
x1 d d
g D]# } t | | t |
d | � � q�W|
d j r|
d j | _ n t& | | � n t j j
j+ | | � i t$ d 6S( s�
Updates a cluster.
config_dict
Dictionary with the config values of the new cluster.
datacenter
Name of datacenter containing the cluster.
Ignored if already contained by proxy details.
Default value is None.
cluster
Name of cluster.
Ignored if already contained by proxy details.
Default value is None.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
# esxdatacenter proxy
salt '*' vsphere.update_cluster cluster_dict=$cluster_dict cluster=cl1
# esxcluster proxy
salt '*' vsphere.update_cluster cluster_dict=$cluster_dict
R! s esxdatacenter.get_detailsRu s 'cluster' needs to be specifiedR s esxcluster.get_detailsR� R> s! VSAN operations are not supportedR� R� R� R� g @ijv7 R� s vsan_spec = {0}R� N(, R R� R� R� R� R� R
R+ R4 R| R R9 R: RH R} R) R> R� R R� R R� R R� R� R� R� RE R� R� R� R� R� Rv R� R� Rb R� R� R� RM R5 R� R� ( R� Ru R� RD R� R� R> R� R� R� R� RM R� R� R� t vsan_info( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� sh $ !
!
c C@ sI t | � } t j j j | � } t j d j | � � | pF | pF | sO t n t } | r� t j
d j | � � g t j j j | d | �D] } | j ^ q� } t j
d j | � � | r� | j
| � n | } n t j j j | | | | | � } g }
t | t j � rZt j j j | | | � } t j j j | d g � } | j d g � }
n g }
x� | D]� } i | j d 6| j j d 6| j j d 6| j j d 6} g } xt g |
D]9 } | j j | j k r�t | j t j � r�| j ^ q�D], } | j
g | j D] } | j ^ q� q�W| r4| | d
<n |
j | � qgW|
S( s�
Returns a list of dict representations of the datastores visible to the
proxy object. The list of datastores can be filtered by datastore names,
backing disk ids (canonical names) or backing disk scsi addresses.
Supported proxy types: esxi, esxcluster, esxdatacenter
datastore_names
List of the names of datastores to filter on
backing_disk_ids
List of canonical names of the backing disks of the datastores to filer.
Default is None.
backing_disk_scsi_addresses
List of scsi addresses of the backing disks of the datastores to filter.
Default is None.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_datastores_via_proxy
salt '*' vsphere.list_datastores_via_proxy datastore_names=[ds1, ds2]
s target name = {}s, Retrieving disk ids for scsi addresses '{0}'t scsi_addressess Found disk ids '{}'s fileSystemVolumeInfo.mountInfoRD R� t
free_spacet capacityt backing_disk_ids( R| R9 R: RH R� R� RM R5 Rb Rv R� t get_disksR� t extendRv Rh R t
HostSystemt get_storage_systemR R) RD RT R� t freeSpaceR� t volumet HostVmfsVolumet extentt diskNameR� ( Ru R� t backing_disk_scsi_addressesRD t targett target_namet get_all_datastorest dt disk_idst
datastorest mount_infost storage_systemR� R� t dst ds_dictt it volRT ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_datastores_via_proxy{ sP "
"
(*
c C@ s� t j d � t j � } y0 t j i i | d 6| d 6| d 6d 6| � Wn% t j j k
rp } t | � � n Xt | � } t
d � d } | r� t j j
j | d | g �} | s� t d j | | � � � q� n t j j
j | | | d
| � }
t S( s�
Creates a ESXi host disk group with the specified cache and capacity disks.
datastore_name
The name of the datastore to be created.
disk_id
The disk id (canonical name) on which the datastore is created.
vmfs_major_version
The VMFS major version.
safety_checks
Specify whether to perform safety check or to skip the checks and try
performing the required task. Default is True.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.create_vmfs_datastore datastore_name=ds1 disk_id=
vmfs_major_version=5
s Validating vmfs datastore inputRD t backing_disk_idt vmfs_versionRx s esxi.get_detailsRc R s& Disk '{0}' was not found in host '{1}'i ( R� R� R R� R� R� R� R� R R| t __proxy__R9 R: RH R� R R5 t create_vmfs_datastoreRb ( t datastore_namet disk_idt vmfs_major_versiont
safety_checksRD R� R� R� t hostnameR� R} ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR � s*
c C@ s� t j d j | | � � t | � } t j j j | | d | g �} | sd t d j | � � � n | d } t j j j | | � t
S( s�
Renames a datastore. The datastore needs to be visible to the proxy.
datastore_name
Current datastore name.
new_datastore_name
New datastore name.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.rename_datastore old_name new_name
s Renaming datastore {0} to {1}Ru s Datastore '{0}' was not foundi ( R� RM R5 R| R9 R: RH Rv R t rename_datastoreRb ( R t new_datastore_nameRD R R R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR s
c C@ s� t j d j | � � t | � } t j j j | d | d | g �} | sd t d j | � � � n t | � d k r� t d j | � � � n t j j j
| | d � t S( s4
Removes a datastore. If multiple datastores an error is raised.
datastore
Datastore name
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.remove_datastore ds_name
s Removing datastore '{0}'t referenceRu s Datastore '{0}' was not foundi s$ Multiple datastores '{0}' were foundi ( R� RM R5 R| R9 R: RH Rv R RG t remove_datastoreRb ( Rx RD R R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR , s c C@ s� t j d � t j j j | � } g | D]{ } i | j d 6| j d 6| j r_ | j d j n d d 6| j d k r~ | j n t j
d 6| j r� | j n d d 6^ q) } | S( s�
Lists all licenses on a vCenter.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_licenses
s Retrieving all licensesR� RD i RG R� t usedN( R� RM R9 R: RH t get_licensest
licenseKeyRD t labelsR� RE t totalRN t maxsizeR ( RD t licensest lR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt
list_licensesN s
�c C@ s3 t j d j | � � t j j j | | | � t S( s�
Adds a license to the vCenter or ESXi host
key
License key.
description
License description added in as a label.
safety_checks
Specify whether to perform safety check or to skip the checks and try
performing the required task
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.add_license key=<license_key> desc='License desc'
s Adding license '{0}'( R� RM R5 R9 R: RH t add_licenseRb ( R� RG R RD ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR$ i s c C@ s� t j d j | � � | d d k r\ t j j j | | d � } t j j j | | d � S| d d k rp d St d j | d � � � d S( s�
Returns the entity associated with the entity dict representation
Supported entities: cluster, vcenter
Expected entity format:
.. code-block:: python
cluster:
{'type': 'cluster',
'datacenter': <datacenter_name>,
'cluster': <cluster_name>}
vcenter:
{'type': 'vcenter'}
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
entity
Entity dict in the format above
s Retrieving entity: {0}R� R� Ru R" s Unsupported entity type '{0}'N(
R� RM R5 R9 R: RH R} R� RE R ( RD t entityR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_entity� s
c C@ s� | d d k r t j � } n8 | d d k r> t j � } n t d j | d � � � y t j | | � Wn% t j j k
r� } t | � � n Xd S( s�
Validates the entity dict representation
entity
Dictionary representation of an entity.
See ``_get_entity`` docstrings for format.
R� R� R" s Unsupported entity type '{0}'N(
R R� R R R5 R� R� R� R� R
( R% R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _validate_entity� s
c C@ s� t j d j | � � t | � t j j j | d t | | � d | �} g | D]} } | d k sr | j
| k rQ i | j
d 6| j d 6| j r� | j d j
n d d 6| j d k r� | j n t j d 6^ qQ S(
sP
Lists the licenses assigned to an entity
entity
Dictionary representation of an entity.
See ``_get_entity`` docstrings for format.
entity_display_name
Entity name used in logging
license_keys:
List of license keys to be retrieved. Default is None.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_assigned_licenses
entity={type:cluster,datacenter:dc,cluster:cl}
entiy_display_name=cl
s' Listing assigned licenses of entity {0}t
entity_reft entity_nameR� RD i RG R� N( R� RM R5 R' R9 R: RH t get_assigned_licensesR& RE R RD R R� R RN R ( R% t entity_display_namet license_keysRD t assigned_licensesR" ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_assigned_licenses� s
c C@ s� t j d j | | � � t | � | r� t j j j | � } g | D] } | j | k rE | ^ qE s� t d j | � � � q� n t j j j
| | | d t | | � d | �d S( s�
Assigns a license to an entity
license_key
Key of the license to assign
See ``_get_entity`` docstrings for format.
license_name
Display name of license
entity
Dictionary representation of an entity
entity_display_name
Entity name used in logging
safety_checks
Specify whether to perform safety check or to skip the checks and try
performing the required task. Default is False.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.assign_license license_key=00000:00000
license name=test entity={type:cluster,datacenter:dc,cluster:cl}
s# Assigning license {0} to entity {1}s License '{0}' wasn't foundR( R) N( R� RM R5 R' R9 R: RH R R R t assign_licenseR& ( t license_keyt license_nameR% R+ R RD R! R" ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR/ � s #
( c
C@ s� | r$ | s$ t j j d � � q$ n t } | s9 t } n t j j j | d | d | d | d | �} g | D] } t j j j | � ^ qm S( s�
Returns a list of hosts for the the specified VMware environment. The list
of hosts can be filtered by datacenter name and/or cluster name
hostnames
Hostnames to filter on.
datacenter_name
Name of datacenter. Only hosts in this datacenter will be retrieved.
Default is None.
cluster_name
Name of cluster. Only hosts in this cluster will be retrieved. If a
datacenter is not specified the first cluster with this name will be
considerred. Default is None.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
CLI Example:
.. code-block:: bash
salt '*' vsphere.list_hosts_via_proxy
salt '*' vsphere.list_hosts_via_proxy hostnames=[esxi1.example.com]
salt '*' vsphere.list_hosts_via_proxy datacenter=dc1 cluster=cluster1
s0 Datacenter is required when cluster is specifiedR� R� R� t
get_all_hosts( R9 R� R Rv Rb R: RH t get_hostsR� ( t hostnamesRu R� RD R2 t hostst h( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_hosts_via_proxy$ s # c
C@ s t | � } t d � d } t j d j | � � t j d j | � � t j d j | � � | ph | sq t n t } g } t j j j
| d | �} d � t j | � D� } xK t j j j
| | | | � D]+ } | j i | j d 6| | j d 6� q� W| S(
s�
Returns a list of dict representations of the disks in an ESXi host.
The list of disks can be filtered by disk canonical names or
scsi addresses.
disk_ids:
List of disk canonical names to be retrieved. Default is None.
scsi_addresses
List of scsi addresses of disks to be retrieved. Default is None
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_disks
salt '*' vsphere.list_disks disk_ids='[naa.00, naa.001]'
salt '*' vsphere.list_disks
scsi_addresses='[vmhba0:C0:T0:L0, vmhba1:C0:T0:L0]'
s esxi.get_detailsRc s Retrieving disks if host '{0}'s disk ids = {0}s scsi_addresses = {0}R c S@ s" i | ] \ } } | | j � q S( ( R� ( t .0t scsi_addrt lun( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pys
<dictcomp>~ s R t scsi_address( R| R R� RM R5 Rb Rv R9 R: RH t get_scsi_address_to_lun_mapR R� R� R� R� (
R R� RD R� R t
get_all_disksR� t scsi_address_to_lunt canonical_name_to_scsi_addressR ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt
list_disksV s
c C@ s� | r | r t d � � n t | � } t d � d } | s� t j j j | � } | | k r| t d j | | � � � n | | j } t
j d j | | | � � n t
j d j | | � � t j j j | | | d | �t
j
d j | | � � t S( s�
Erases the partitions on a disk.
The disk can be specified either by the canonical name, or by the
scsi_address.
disk_id
Canonical name of the disk.
Either ``disk_id`` or ``scsi_address`` needs to be specified
(``disk_id`` supersedes ``scsi_address``.
scsi_address
Scsi address of the disk.
``disk_id`` or ``scsi_address`` needs to be specified
(``disk_id`` supersedes ``scsi_address``.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.erase_disk_partitions scsi_address='vmhaba0:C0:T0:L0'
salt '*' vsphere.erase_disk_partitions disk_id='naa.000000000000001'
s8 Either 'disk_id' or 'scsi_address' needs to be specifieds esxi.get_detailsRc s7 Scsi lun with address '{0}' was not found on host '{1}'s. [{0}] Got disk id '{1}' for scsi address '{2}'s3 Erasing disk partitions on disk '{0}' in host '{1}'R s2 Erased disk partitions on disk '{0}' on host '{1}'( R R| R R9 R: RH R< R R5 R� R� RM t erase_disk_partitionst infoRb ( R R; RD R� R R> ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRA � s*
c C@ s� | r | r t d � � n t | � } t d � d } | s� t j j j | � } | | k r| t d j | | � � � n | | j } t
j d j | | | � � n t
j d j | | � � t j j j | | � } g } x� | j
j D]� } g | j j D] } | j | j k r� | ^ q� d }
i | d 6| d 6| j
j d
6| j d 6| j d 6| j | j d
d 6|
j j |
j j d
|
j j d d 6} | j | � q� W| S( s�
Lists the partitions on a disk.
The disk can be specified either by the canonical name, or by the
scsi_address.
disk_id
Canonical name of the disk.
Either ``disk_id`` or ``scsi_address`` needs to be specified
(``disk_id`` supersedes ``scsi_address``.
scsi_address`
Scsi address of the disk.
``disk_id`` or ``scsi_address`` needs to be specified
(``disk_id`` supersedes ``scsi_address``.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_disk_partitions scsi_address='vmhaba0:C0:T0:L0'
salt '*' vsphere.list_disk_partitions disk_id='naa.000000000000001'
s8 Either 'disk_id' or 'scsi_address' needs to be specifieds esxi.get_detailsRc s7 Scsi lun with address '{0}' was not found on host '{1}'s. [{0}] Got disk id '{1}' for scsi address '{2}'s3 Listing disk partitions on disk '{0}' in host '{1}'i R R2 R5 t partitionR� i t sectorsi t size_KB( R R| R R9 R: RH R< R R5 R� R� RM t get_disk_partition_infoR RC t layoutt partitionFormatR� t endSectort startSectort endt blockt startt blockSizeR� ( R R; RD R� R R> t partition_infoR� t part_specRM t part_layoutt part_dict( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_disk_partitions� s:
"
,c C@ s� t | � } t d � d } t j d j | � � | s? t n t } g } x] t j j j
| | | � D]@ } | j i | j j
d 6g | j D] } | j
^ q� d 6� qg W| S( s�
Returns a list of disk group dict representation on an ESXi host.
The list of disk groups can be filtered by the cache disks
canonical names. If no filtering is applied, all disk groups are returned.
cache_disk_ids:
List of cache disk canonical names of the disk groups to be retrieved.
Default is None.
use_proxy_details
Specify whether to use the proxy minion's details instead of the
arguments
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.list_diskgroups
salt '*' vsphere.list_diskgroups cache_disk_ids='[naa.000000000000001]'
s esxi.get_detailsRc s Listing diskgroups in '{0}'t
cache_diskt capacity_disks( R| R R� RM R5 Rb Rv R9 R: RH t get_diskgroupsR� t ssdR� t nonSsd( t cache_disk_idsRD R� R t get_all_diskgroupsR� t dgR ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt list_diskgroups s
(c C@ s� t j d � t j � } y, t j i i | d 6| d 6g d 6| � Wn% t j j k
rl } t | � � n Xt | � } t
d � d } | r� t j j
j | | g � } | r� t d j | | � � � q� n | } | j d | � t j j
j | d | �}
xQ | D]I } g |
D] } | j | k r| ^ qst d
j | | � � � qqWg |
D] } | j | k r\| ^ q\d }
g |
D] } | j | k r�| ^ q�} t j j j | � } t j j j | | | |
| � } t S( s%
Creates disk group on an ESXi host with the specified cache and
capacity disks.
cache_disk_id
The canonical name of the disk to be used as a cache. The disk must be
ssd.
capacity_disk_ids
A list containing canonical names of the capacity disks. Must contain at
least one id. Default is True.
safety_checks
Specify whether to perform safety check or to skip the checks and try
performing the required task. Default value is True.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.create_diskgroup cache_disk_id='naa.000000000000001'
capacity_disk_ids='[naa.000000000000002, naa.000000000000003]'
s Validating diskgroup inputt cache_idt capacity_idst
diskgroupss esxi.get_detailsRc sA Diskgroup with cache disk id '{0}' already exists ESXi host '{1}'i R s2 No disk with id '{0}' was found in ESXi host '{1}'( R� RM R R� R� R� R� R� R R| R R9 R: RH RV R R5 t insertR� R� R R> t get_vsan_disk_management_systemt create_diskgroupRb ( t
cache_disk_idt capacity_disk_idsR RD R� R� R� R R_ R R� R R RT RU t vsan_disk_mgmt_systemR[ ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRb , sD
(,( c
C@ s} t j d � t j � } y, t j i i | d 6| d 6g d 6| � Wn% t j j k
rl } t | � � n Xt | � } t
d � d } t j j
j | d | �} | rxT | D]I } g | D] }
|
j | k r� |
^ q� s� t d j | | � � � q� q� Wn t j j
j | d | g �} | sAt d
j | | � � � n t j j j | � } t j j j | | | | d | � t S( s�
Adds capacity disks to the disk group with the specified cache disk.
cache_disk_id
The canonical name of the cache disk.
capacity_disk_ids
A list containing canonical names of the capacity disks to add.
safety_checks
Specify whether to perform safety check or to skip the checks and try
performing the required task. Default value is True.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.add_capacity_to_diskgroup
cache_disk_id='naa.000000000000001'
capacity_disk_ids='[naa.000000000000002, naa.000000000000003]'
s Validating diskgroup inputR] R^ R_ s esxi.get_detailsRc R s2 No disk with id '{0}' was found in ESXi host '{1}'RY sB No diskgroup with cache disk id '{0}' was found in ESXi host '{1}'i ( R� RM R R� R� R� R� R� R R| R R9 R: RH R� R� R R5 RV R> Ra t add_capacity_to_diskgroupRb (
Rc Rd R RD R� R� R� R R� R R R_ Re ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRf q s>
( c
C@ s� t j d � t j � } y, t j i i | d 6| d 6g d 6| � Wn+ t j j k
rr } t t | � � � n Xt
| � } t d � d } t j
j j | d | �} | rxT | D]I }
g | D] } | j |
k r� | ^ q� s� t d j |
| � � � q� q� Wn t j
j j | d | g �} | sGt d
j | | � � � n t j d j | � � t j
j j | | | d d
g | D] } | j | k r�| ^ q�d | �t S( s�
Remove capacity disks from the disk group with the specified cache disk.
cache_disk_id
The canonical name of the cache disk.
capacity_disk_ids
A list containing canonical names of the capacity disks to add.
data_evacuation
Specifies whether to gracefully evacuate the data on the capacity disks
before removing them from the disk group. Default value is True.
safety_checks
Specify whether to perform safety check or to skip the checks and try
performing the required task. Default value is True.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.remove_capacity_from_diskgroup
cache_disk_id='naa.000000000000001'
capacity_disk_ids='[naa.000000000000002, naa.000000000000003]'
s Validating diskgroup inputR] R^ R_ s esxi.get_detailsRc R s2 No disk with id '{0}' was found in ESXi host '{1}'RY sB No diskgroup with cache disk id '{0}' was found in ESXi host '{1}'s data_evacuation = {0}i RU t data_evacuation( R� RM R R� R� R� R� R� R t strR| R R9 R: RH R� R� R R5 RV R> t remove_capacity_from_diskgroupRb (
Rc Rd Rg R RD R� R� R� R R� R R R_ ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRi � s> "
(
c C@ s� t j d � t | � } t d � d } t j j j | d | g �} | si t d j | | � � � n t j d j | � � t j j
j | | | d d | �t S( s�
Remove the diskgroup with the specified cache disk.
cache_disk_id
The canonical name of the cache disk.
data_accessibility
Specifies whether to ensure data accessibility. Default value is True.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.remove_diskgroup cache_disk_id='naa.000000000000001'
s Validating diskgroup inputs esxi.get_detailsRc RY sB No diskgroup with cache disk id '{0}' was found in ESXi host '{1}'s data accessibility = {0}i t data_accessibility(
R� RM R| R R9 R: RH RV R R5 R> t remove_diskgroupRb ( Rc Rj RD R� R R_ ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRk � s
c C@ s� i } t | � } t d � d } t j j j | � } | sb t j d j | � � t | d <| Si t
d 6i | j j d 6d 6d j | j
� d 6S( s�
Returns the host cache configuration on the proxy host.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.get_host_cache
s esxi.get_detailsRc s' Host cache not configured on host '{0}'Rq RD Rx s {}MiBt swap_size( R| R R9 R: RH t get_host_cacheR� R� R5 Rv Rb R� RD t swapSize( RD R� R� R t hci( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRm s
c C@ s t j d � t j � } y) t j i | d 6| d 6| d 6| � Wn% t j j k
ri } t | � � n X| s t d � � n i t d 6} t
| � } t d � d } | r� t j
j j | | d | g �} | s� t d j | | � � � n | d
}
n t j
j j | |
| � t S( s�
Configures the host cache on the selected host.
enabled
Boolean flag specifying whether the host cache is enabled.
datastore
Name of the datastore that contains the host cache. Must be set if
enabled is ``true``.
swap_size_MiB
Swap size in Mibibytes. Needs to be set if enabled is ``true``. Must be
smaller than the datastore size.
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
Default is None.
.. code-block:: bash
salt '*' vsphere.configure_host_cache enabled=False
salt '*' vsphere.configure_host_cache enabled=True datastore=ds1
swap_size_MiB=1024
s Validating host cache inputRq R t
swap_size_MiBs) Disabling the host cache is not supporteds esxi.get_detailsRc Ru s+ Datastore '{0}' was not found on host '{1}'i ( R� R� R R� R� R� R� R� R Rv R| R R9 R: RH Rv R R5 t configure_host_cacheRb ( Rq Rx Rp RD R� R� R� R� R Rz R} ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRq < s0
c C@ sX | s6 t | | � } | r' | g } qT t d � � n t | t � sT t d � � n | S( sg
Helper function that checks to see if the host provided is a vCenter Server or
an ESXi host. If it's an ESXi host, returns a list of a single host_name.
If a host reference isn't found, we're trying to find a host object for a vCenter
server. Raises a CommandExecutionError in this case, as we need host references to
check against.
sd No host reference found. If connecting to a vCenter Server, a list of 'host_names' must be provided.s 'host_names' must be a list.( R� R Rh RJ ( RD R, R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� v s c C@ s i } x| d j � D] } | j � j � } | j d � rx | j d � } d | d k rj t | d <qx t | d <Pn | j d � r� | j d � } | d j � | d <n | j d � r� | j d � } | d j � | d
<n | j d � r | j d � } | d j � | d <q q W| S(
s�
Helper function to format the stdout from the get_coredump_network_config function.
cmd_ret
The return dictionary that comes from a cmd.run_all call.
Rf s enabled:t :t truei Rq s
host vnic:Rx s network server ip:t ips network server port:R0 ( t
splitlinesR� t lowert
startswithR� Rb Rv ( t cmd_retR� t lineRq Rx Rt t ip_port( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRn � s&
c C@ s� i t d 6i d 6} xj | d j � D]X } | j d � r@ q% n | j d � rU q% n | j � } t | d � | d | d <q% W| S( s�
Helper function to format the stdout from the get_firewall_status function.
cmd_ret
The return dictionary that comes from a cmd.run_all call.
Ru R{ Rf t Names ---i i ( Rb Ru Rw R� t bool( Rx R� Ry t ruleset_status( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR| � s
c C@ s� i | d d k d 6} | d d k r8 | d | d <n` x] | d j � D]K } | j � } | j d � } | d j � } | d j � } | | | <qI W| S( s�
Helper function to format the stdout from the get_syslog_config function.
cmd_ret
The return dictionary that comes from a cmd.run_all call.
Re i Ru Rf R� s : i ( Ru R� R� ( Rx R� Ry t cfgvarsR� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � s c C@ s
| j j S( s?
Helper function that returns a dateTimeManager object
( R� R� ( t host_reference( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � s c C@ s| t j j j | � j } | r9 | j d | d t � } n | j d | d t � } | d k rx | j d | d t � } n | S( s,
Helper function that returns a host object either from the host location or the host_name.
If host_name is provided, that is the host_object that will be returned.
The function will first search for hosts by DNS Name. If no hosts are found, it will
try searching by IP Address.
t dnsNamet vmSearchRt N( R9 R: RH R� t searchIndext
FindByDnsNameRv RE t FindByIp( RD R, R� t search_indexR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � s c C@ s t | � j d � S( sN
Helper function that returns a list of ssd objects for a given host.
t SSDs( t _get_host_disksR) ( R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR � s c C@ s t | � j d � S( sR
Helper function that returns a list of Non-SSD objects for a given host.
s Non-SSDs( R� R) ( R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR � s c C@ s� | j j } | j j } g } g } xX | D]P } y
| j } Wn t k
rW t } n X| rn | j | � q+ | j | � q+ Wi | d 6| d 6S( s_
Helper function that returns a dictionary containing a list of SSD and Non-SSD disks.
R� s Non-SSDs( R� t
storageSystemt storageDeviceInfot scsiLunRW R\ Rv R� ( R R R� t ssdst non_ssdsR� t has_ssd_attr( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� s
c C@ s
| j j S( sY
Helper function that returns a service manager object from a given host object.
( R� R� ( R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR s c C@ s� i } x{| D]s} t | | d | �} | j j } | d k r} d j | � } t j | � | j i i | d 6| 6� q
n g } | j � } x- | D]% }
|
j d k r� | j
|
� q� q� W| sd j | � } t j | � | j i i | d 6| 6� q
n t | � t
| � } g } xD | D]< }
x3 | D]+ } |
j | j j k r2| j
|
� q2q2Wq%W| j i i | d 6| 6� q
W| S( s
Helper function that returns a dictionary of host_name keys with either a list of eligible
disks that can be added to VSAN or either an 'Error' message or a message saying no
eligible disks were found. Possible keys/values look like:
return = {'host_1': {'Error': 'VSAN System Config Manager is unset ...'},
'host_2': {'Eligible': 'The host xxx does not have any VSAN eligible disks.'},
'host_3': {'Eligible': [disk1, disk2, disk3, disk4],
'host_4': {'Eligible': []}}
R� sz VSAN System Config Manager is unset for host '{0}'. VSAN configuration cannot be changed without a configured VSAN System.Rg R; s5 The host '{0}' does not have any VSAN eligible disks.R� N( R� R� R5 RE R5 R� R� Ri t QueryDisksForVsant stateR� t warningR R R� R� ( RD R, R� RS R� R� R: R� t suitable_disksR� t itemR� t matchingR� t
suitable_disk( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� s8
c
C@ s i }
t } t | t � s' | g } n x� | D]� } | | k r� t j j j | | | | | d | d | d | d | �}
i |
| <|
d d k |
| d <|
d d k r� t } |
d |
| d <q� q. t } i |
| <t |
| d <d
|
| d <q. W| |
d <|
S( sm
Helper function for reset_syslog_config that resets the config and populates the return dictionary.
R/ R0 Rc Rd Re i Ru Rf R� s& Invalid syslog configuration parameter( Rb Rh RJ R9 R: RH R Rv ( R, R- R. Ro R� R� R/ R0 Rc Rd R� t all_successt reset_paramRS ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� U s(
c
C@ sq d j | | � }
i } d d d d d d g } | | k rd | j i t d 6d j | � d
6� | St j j j | | | |
d | d | d
| d | �}
|
d d k r� | j i i t d 6|
d d
6| 6� n | j i i t d 6| 6� | rm| r | } | g } n | } t | | | d | d | d | d | �j | � }
| j i i |
d d k d 6d 6� n | S( si
Helper function for set_syslog_config that sets the config and populates the return dictionary.
s" system syslog config set --{0} {1}R� R� s default-rotates default-sizes default-timeouts
logdir-uniqueRu s% '{0}' is not a valid config variable.R� R/ R0 Rc Rd Re i Rf Rk t syslog_restart(
R5 Ri Rv R9 R: RH R Rb R� R) ( R, R- R. R� R� R/ R0 R� Rc Rd Ro R� R� Rl R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� v s2 (c ) C@ s� i } t | d <g | d <t j j j d | d | d | d | d | � } t j j j | | � }
|
s� | d j d j | � � t | d <n t j j j |
| � } | s� | d j d j | � � t | d <n t j j j
|
| � } | s| d j d
j | � � t | d <n t | d � d k r3| S|
j j
} y t | | |
� }
Wn* t k
r�} d j | j � | d <| SXxV|
D]N} i | | <| | j i t d
6| d 6| d 6| d 6| d 6| d 6� t | | | � } | s | | j i d j | � d 6� t | d <q�n t j j j d | � } t j j d | � } t j j j | � } g | D] } | j | k rf| ^ qf} t | � d k r�| | j i d j | � d 6� t | d <q�n t j j j | � } g | D] } | j | k r�| ^ q�} t | � d k rJ| | j i d j | � d 6� t | d <q�n t j j j | � } | s�| | j i d d 6� t | d <q�n t j j j d | d | j � } t j j j d | g � } t j j j d | d d � } t j d |
j j d | g � } |
j! d | � } y# t j j j" | | d d d! �Wn� t# k
r�} t$ | d � r�t$ | j% d" � r�| | j% j k o�d# | j% j k s�t | d <| | j i | j% j d 6� q�q�q�� n X| j& j' }! d7 }" x: | j j) j* D]) }# |# j+ j, | d j* k r�|# }" Pq�q�W|" sI| | j i d$ d 6� t | d <q�n t j- d% d& d' | d j d |" j+ j, d t j. d( t j/ d) | j d* | j j0 j
� � � }$ | j j) j1 d j2 }% t j3 d% d& d+ d, d t j4 d- |% � � }& t j5 d% d& d. | d t j6 d/ | � � }' t j7 d0 |& g d1 |' g d t j8 d% d2 d |" j+ � g d3 |$ g � }( y2 |! j9 d4 d5 d |( � | | j i t d
6� Wq�t# k
r�} t$ | d" � r�| | j i d6 j | j � d 6� q�q�� q�Xq�W| S(8 s|
Adds an ESXi host to a vSphere Distributed Virtual Switch and migrates
the desired adapters to the DVS from the standard switch.
host
The location of the vCenter server.
username
The username used to login to the vCenter server.
password
The password used to login to the vCenter server.
vmknic_name
The name of the virtual NIC to migrate.
vmnic_name
The name of the physical NIC to migrate.
dvs_name
The name of the Distributed Virtual Switch.
target_portgroup_name
The name of the distributed portgroup in which to migrate the
virtual NIC.
uplink_portgroup_name
The name of the uplink portgroup in which to migrate the
physical NIC.
protocol
Optionally set to alternate protocol if the vCenter server or ESX/ESXi host is not
using the default protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the vCenter server or ESX/ESXi host is not
using the default port. Default port is ``443``.
host_names:
An array of VMware host names to migrate
CLI Example:
.. code-block:: bash
salt some_host vsphere.add_host_to_dvs host='vsphere.corp.com'
username='administrator@vsphere.corp.com' password='vsphere_password'
vmknic_name='vmk0' vmnic_name='vnmic0' dvs_name='DSwitch'
target_portgroup_name='DPortGroup' uplink_portgroup_name='DSwitch1-DVUplinks-181'
protocol='https' port='443', host_names="['esxi1.corp.com','esxi2.corp.com','esxi3.corp.com']"
Return Example:
.. code-block:: yaml
somehost:
----------
esxi1.corp.com:
----------
dvs:
DSwitch
portgroup:
DPortGroup
status:
True
uplink:
DSwitch-DVUplinks-181
vmknic:
vmk0
vmnic:
vmnic0
esxi2.corp.com:
----------
dvs:
DSwitch
portgroup:
DPortGroup
status:
True
uplink:
DSwitch-DVUplinks-181
vmknic:
vmk0
vmnic:
vmnic0
esxi3.corp.com:
----------
dvs:
DSwitch
portgroup:
DPortGroup
status:
True
uplink:
DSwitch-DVUplinks-181
vmknic:
vmk0
vmnic:
vmnic0
message:
success:
True
This was very difficult to figure out. VMware's PyVmomi documentation at
https://github.com/vmware/pyvmomi/blob/master/docs/vim/DistributedVirtualSwitch.rst
(which is a copy of the official documentation here:
https://www.vmware.com/support/developer/converter-sdk/conv60_apireference/vim.DistributedVirtualSwitch.html)
says to create the DVS, create distributed portgroups, and then add the
host to the DVS specifying which physical NIC to use as the port backing.
However, if the physical NIC is in use as the only link from the host
to vSphere, this will fail with an unhelpful "busy" error.
There is, however, a Powershell PowerCLI cmdlet called Add-VDSwitchPhysicalNetworkAdapter
that does what we want. I used Onyx (https://labs.vmware.com/flings/onyx)
to sniff the SOAP stream from Powershell to our vSphere server and got
this snippet out:
.. code-block:: xml
<UpdateNetworkConfig xmlns="urn:vim25">
<_this type="HostNetworkSystem">networkSystem-187</_this>
<config>
<vswitch>
<changeOperation>edit</changeOperation>
<name>vSwitch0</name>
<spec>
<numPorts>7812</numPorts>
</spec>
</vswitch>
<proxySwitch>
<changeOperation>edit</changeOperation>
<uuid>73 a4 05 50 b0 d2 7e b9-38 80 5d 24 65 8f da 70</uuid>
<spec>
<backing xsi:type="DistributedVirtualSwitchHostMemberPnicBacking">
<pnicSpec><pnicDevice>vmnic0</pnicDevice></pnicSpec>
</backing>
</spec>
</proxySwitch>
<portgroup>
<changeOperation>remove</changeOperation>
<spec>
<name>Management Network</name><vlanId>-1</vlanId><vswitchName /><policy />
</spec>
</portgroup>
<vnic>
<changeOperation>edit</changeOperation>
<device>vmk0</device>
<portgroup />
<spec>
<distributedVirtualPort>
<switchUuid>73 a4 05 50 b0 d2 7e b9-38 80 5d 24 65 8f da 70</switchUuid>
<portgroupKey>dvportgroup-191</portgroupKey>
</distributedVirtualPort>
</spec>
</vnic>
</config>
<changeMode>modify</changeMode>
</UpdateNetworkConfig>
The SOAP API maps closely to PyVmomi, so from there it was (relatively)
easy to figure out what Python to write.
Ru R� R, R- R. R/ R0 s1 No Distributed Virtual Switch found with name {0}s' No target portgroup found with name {0}s' No uplink portgroup found with name {0}i s Error retrieving hosts: {0}R� t uplinkR" t vmknict vmnicR� s Host {1} not foundR� s Physical nic {0} not founds Virtual nic {0} not founds- Unable to get the host's virtual nic manager.t
pnicDevicet uplinkPortgroupKeyt pnicSpecRZ t addR R s Adding host to the DVSR4 i R� s already existss$ No matching portgroup on the vSwitcht changeOperationt editR2 t distributedVirtualPortt portgroupKeyt
switchUuidRD t vSwitch0R R� t backingt vswitcht proxySwitcht removet vnict
changeModeR� s Failed to migrate adapters ({0})N(: Rb R9 R: RH RI t _get_dvsR� R5 Rv t _get_dvs_portgroupt _get_dvs_uplink_portgroupRG R� R� R� R R� Ri R� R R� t
HostMemberR? t
_get_pnicsR2 t
_get_vnicst _get_vnic_managert PnicSpecR� t PnicBackingt
ConfigSpect
DVSConfigSpecR t ReconfigureDvs_TaskR7 RL R� R� R� t
networkSystemRE t networkR" R RD t HostVirtualNicConfigt HostVirtualNicSpect& DistributedVirtualSwitchPortConnectiont distributedVirtualSwitchR� R t HostVirtualSwitchConfigt HostVirtualSwitchSpect HostProxySwitchConfigt HostProxySwitchSpect HostNetworkConfigt HostPortGroupConfigt UpdateNetworkConfig() R, R- R. t vmknic_namet
vmnic_nameRV t target_portgroup_namet uplink_portgroup_nameR/ R0 R� RS RD R� t target_portgroupt uplink_portgroupt dvs_uuidRT R� R� t dvs_hostmember_configt dvs_hostmembert p_nicst xt p_nict v_nicst v_nict v_nic_mgrt
dvs_pnic_spect pnic_backingt dvs_hostmember_config_specRW R< t network_systemt source_portgroupt pgt virtual_nic_configt current_vswitch_portst vswitch_configt proxyswitch_configt host_network_config( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt add_host_to_dvs� s �
!
(!
(!
!$
$ c
C@ s� t � } t j j j | � s- t d � � n d
} | d k r� t � \
} } } } } } } }
} } t j j j | | � }
t j j j |
| � } n� | d k r� t
� \ } } } } } } } }
} t j j j | | � } n� | d k rt j j j | � } n� | d k r�t d � } d | k r<t
d � � n t j j j | d | d �} | s}t d
j | d � � � n | d } n t j d j | � � | S( s�
Returns the target object of a proxy.
If the object doesn't exist a VMwareObjectRetrievalError is raised
service_instance
Service instance (vim.ServiceInstance) of the vCenter/ESXi host.
sB '_get_proxy_target' not supported when connected via the ESXi hostR R! R" R s esxi.get_detailss: Proxies connected directly to ESXi hosts are not supportedR� Rc s ESXi host '{0}' was not foundi s reference = {0}N( R+ R9 R: RH R� R RE t _get_esxcluster_proxy_detailsR} R� t _get_esxdatacenter_proxy_detailst get_root_folderR R
R3 R R5 R� RM ( RD R> R R, R- R. R/ R0 R1 R2 R3 Ru R� R� R6 t
references( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR| � s4 ' $
c
C@ s} t d � } | j d � | j d � | j d � | j d � | j d � | j d � | j d � | j d � | j d
� f S( s;
Returns the running esxdatacenter's proxy details
s esxdatacenter.get_detailsR" R- R. R/ R0 R1 R2 R3 Ru ( R4 R) ( t det( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� s
$$c C@ s� t d � } | j d � | j d � | j d � | j d � | j d � | j d � | j d � | j d � | j d
� | j d � f
S( s8
Returns the running esxcluster's proxy details
s esxcluster.get_detailsR" R- R. R/ R0 R1 R2 R3 Ru R� ( R4 R) ( R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� % s
$$$c C@ s� t d � } | j d � } | j d � r8 | d } n d } | j d � r] | d g } n | | j d � | j d � | j d � | j d � | j d � | j d
� | j d � | f S(
s2
Returns the running esxi's proxy details
s esxi.get_detailsR, R" Rc R- R. R/ R0 R1 R2 R3 N( R R) RE ( R� R, Rk ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_esxi_proxy_details0 s
$c C@ s4 t j j j | | d | d | d | d | �} | S( s�
Returns vm object properties.
name
Name of the virtual machine.
datacenter
Datacenter name
vm_properties
List of vm properties.
traversal_spec
Traversal Spec object(s) for searching.
parent_ref
Container Reference object for searching under a given object.
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
Ru t
vm_propertiest traversal_specR� ( R9 R: RH t get_vm_by_property( RD Ru R� R� R� RD t virtual_machine( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_vm@ s c C@ sH t j j j � } | } t j j j � g | _ t j j j | | � } d | k rs t j j j
| | d � } nZ t j j j | d | d | d g �} | s� t j j
d j | d � � � n | d } t j j j | | | g | | � }
|
r%t |
d j � d k r%t j j d � � n |
r@|
d j r@|
d Sd Sd S(
s�
Queries the virtual machine config file and returns
vim.host.DatastoreBrowser.SearchResults object on success None on failure
name
Name of the virtual machine
datacenter
Datacenter name
datastore
Datastore where the virtual machine files are stored
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
R� R� R� R, s# ESXi host named '{0}' wasn't found.i i sE Multiple configuration files found in the same virtual machine folderN( R R, t DatastoreBrowsert
SearchSpect
VmConfigQueryR� R9 R: RH R} R� R3 R� R R5 t get_datastore_filesRG t filet VMwareMultipleObjectsErrorRE ( RD Ru t placementRx RD t browser_spect directoryt datacenter_objectt container_objectt container_objectst files( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_vm_config_filed s8
R� c C@ s� t j d j | � � | d k re t j d j | � � t j j � } d | _ | | _ | | _ n | d k r� t | � | _
n d S( s�
Specifies vm container version or schedules upgrade,
returns True on change and False if nothing have been changed.
hardware_version
Hardware version string eg. vmx-08
config_spec
Configuration spec object
operation
Defines the operation which should be used,
the possibles values: 'add' and 'edit', the default value is 'add'
s8 Configuring virtual machine hardware version version={0}R� s* Scheduling hardware version upgrade to {0}t alwaysR� N( R� RM R5 R t vmt ScheduledHardwareUpgradeInfot
upgradePolicyt
versionKeyt scheduledHardwareUpgradeInfoRh R^ ( t hardware_versionR� RZ t scheduled_hardware_upgrade( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_hardware_version� s
c C@ s� t j d j | � � d | k r8 t | d � | _ n d | k rZ t | d � | _ n d | k r� | d r� | d | _ n d | k r� | d r� | d | _ n d | k r� | d r� | d | _ n d S( s�
Sets CPU core count to the given value
config_spec
vm.ConfigSpec object
cpu_props
CPU properties dict
s6 Configuring virtual machine CPU settings cpu_props={0}t countt cores_per_sockett nestedt hotaddt hotremoveN( R� RM R5 R� t numCPUst numCoresPerSockett nestedHVEnabledt cpuHotAddEnabledt cpuHotRemoveEnabled( R� t cpu_props( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_cpu_config� s
c C@ s! t j d j | � � d | k r� d | k r� y� | d j � d k rX | d d } nV | d j � d k r{ | d } n3 | d j � d k r� t t | d � d � } n Wn' t t f k
r� t | d � } n X| | _ n d | k r| d | _ n d | k r | d | _
n d
S( s�
Sets memory size to the given value
config_spec
vm.ConfigSpec object
memory
Memory size and unit
s6 Configuring virtual machine memory settings memory={0}t sizet unitt kbi t mbt gbt reservation_maxR N( R� RM R5 Rv R� R� t TypeErrort
ValueErrort memoryMBt memoryReservationLockedToMaxt memoryHotAddEnabled( R� t memoryt memory_mb( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_memory_config� s"
! c C@ s& t | d | d t d | �} | d S( s&
Returns extra config parameters from a virtual machine advanced config list
vm_name
Virtual machine name
datacenter
Datacenter name where the virtual machine is available
service_instance
vCenter service instance for connection and configuration
Ru t objectsRD t advanced_configs( t
get_vm_configRb ( t vm_nameRu RD t current_config( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt get_advanced_configs� s
c C@ s� t j d j | � � t | t � r: t j j d � � n x� t j | � D]{ \ } } | r� xf | D]0 } | j
| k rc | j t | � k rc qc qc qc WqJ t j
j d | d | � } | j j | � qJ Wd S( s�
Sets configuration parameters for the vm
config_spec
vm.ConfigSpec object
advanced_config
config key value pairs
vm_extra_config
Virtual machine vm_ref.config.extraConfig object
s1 Configuring advanced configuration parameters {0}sc The specified 'advanced_configs' configuration option cannot be parsed, please check the parametersR� R� N( R� RM R5 Rh Rh R9 R� R R R� R� R� R R� R� t extraConfigR� ( R� t advanced_configt vm_extra_configR� R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_advanced_config s
$
c
C@ s� t | d | d t d | �} t i | d 6| d 6| � } t j j j | | � } t j j j | t j | d d d | �} t j
j � } | d j } t
| | d j | j j � | r� t j j j | | � n i | d 6S( su
Appends extra config parameters to a virtual machine advanced config list
vm_name
Virtual machine name
datacenter
Datacenter name where the virtual machine is available
advanced_configs
Dictionary with advanced parameter key value pairs
service_instance
vCenter service instance for connection and configuration
Ru R RD RD R t
property_namet
container_reft advanced_config_changes( R Rb t compare_vm_configsR9 R: RH R} t get_mor_by_propertyR t VirtualMachineR� R� t diffsR$ t
new_valuesR� R! t update_vm(
R Ru R RD R R+ t datacenter_reft vm_refR� t changes( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt set_advanced_configs" s*
c C@ s� t j d j | � � t | t � r: t j j d � � n g } xi | D]a } xX | D]P } | j | k rT t j
j d | d d � } | j j
| � | j
| � qT qT WqG W| S( s�
Removes configuration parameters for the vm
config_spec
vm.ConfigSpec object
advanced_config
List of advanced config keys to be deleted
vm_extra_config
Virtual machine vm_ref.config.extraConfig object
s. Removing advanced configuration parameters {0}sc The specified 'advanced_configs' configuration option cannot be parsed, please check the parametersR� R� t ( R� RM R5 Rh Rh R9 R� R R� R R� R� R! R� ( R� R" R# t removed_configsR� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _delete_advanced_configM s
c C@ s� t j j j | | � } t j j j | t j | d d d | �} t j j � } t | | | j
j � } | r� t j j j | | � n i | d 6S( s\
Removes extra config parameters from a virtual machine
vm_name
Virtual machine name
datacenter
Datacenter name where the virtual machine is available
advanced_configs
List of advanced config values to be removed
service_instance
vCenter service instance for connection and configuration
R% RD R& R3 (
R9 R: RH R} R) R R* R� R� R4 R� R! R- ( R Ru R RD R. R/ R� R3 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt delete_advanced_configsj s c C@ s] g | D]$ } | r | j | k r | j ^ q } | sU t j j d j | � � � n | d S( s�
Returns key number of the SCSI controller keys
bus_number
Controller bus number from the adapter
scsi_ctrls
List of SCSI Controller objects (old+newly created)
s( SCSI controller number {0} doesn't existi ( t busNumberR� R9 R� t VMwareVmCreationErrorR5 ( t
bus_numbert
scsi_ctrlst ctrlR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_scsi_controller_key� s
$ t GBc
C@ s� t j d j | | | | | | | |
� � t j j j � } t j j j � | _ | | j _ | | j _ t j
� | j _ | r� t j
j j | | � } | d | j _ n | r� | | j j _ n | d k s� | d k r
t j j j j � | j _ d | j j _ n | d k r(| | j j _ n | d k rR| d k rR| | j j _ n | rg| | j _ n | d k r�t j j j j j | _ d j t j
j j | � |
� | j j _ t j j j j j | _ n' | d k r�t j j j j j! | _ n | S( s�
Returns a vim.vm.device.VirtualDeviceSpec object specifying to add/edit
a virtual disk device
unit_number
Add network adapter to this address
key
Device key number
operation
Action which should be done on the device add or edit
disk_label
Label of the new disk, can be overridden
size
Size of the disk
unit
Unit of the size, can be GB, MB, KB
controller_key
Unique umber of the controller key
thin_provision
Boolean for thin provision
eagerly_scrub
Boolean for eagerly scrubbing
datastore
Datastore name where the disk will be located
filename
Full file name of the vm disk
s� Configuring hard disk {0} size={1}, unit={2}, controller_key={3}, thin_provision={4}, eagerly_scrub={5}, datastore={6}, filename={7}R
t
persistentRE R� s [{0}] {1}R� N(" R� RM R5 R R� R2 t VirtualDeviceSpect VirtualDiskR� t
unitNumbert Descriptiont
deviceInfoR9 R: RH t
convert_to_kbt capacityInKBt labelRE t FlatVer2BackingInfoR� t diskModet thinProvisionedt eagerlyScrubt
controllerKeyt OperationR� RZ R� t fileNamet
FileOperationt createt
fileOperationR� (
t unit_numberR� RZ t
disk_labelR
R t controller_keyt thin_provisiont
eagerly_scrubRx t filenamet disk_spect convert_size( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_hard_disk� s@ (
$ R2 c C@ s t j d j | � � | d
k r� t j j j | � } t | t | � � rU | } q| rt j d j | j j
t | � j j d d � d d
j
� | � � qnh | r� | r� t j d j | j j
| � � n | } n1 | s� t j d j | � � n t j j j � } | S( s
Returns a vim.vm.device.VirtualEthernetCard object specifying a virtual
ethernet card information
network_adapter
None or VirtualEthernet object
adapter_type
String, type of adapter
network_adapter_label
string, network adapter name
s< Configuring virtual machine network adapter adapter_type={0}t vmxnett vmxnet2t vmxnet3t e1000t e1000es* Changing type of '{0}' from '{1}' to '{2}'t .i i s7 Cannot change type of '{0}' to '{1}'. Not changing typesL The type of '{0}' has not been specified. Creating of default type 'vmxnet3'( RY RZ R[ R\ R] ( R� RM R5 R9 R: RH t get_network_adapter_typeRh R� RB RE R8 t rsplitRv R� R R� R2 t VirtualVmxnet3( t network_adaptert adapter_typet network_adapter_labelt edited_network_adapter( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _create_adapter_type� s0
&
c C@ s` t j d j | | t j j j | � � � i } | r\| d k r� t j j j | d | g �} | s� t j j d j | � � � n | d } t
j j j
j � } | | _ | | _ q\| d k r\t j j j | d | g �} | st j j d j | � � � n | d } t
j j d | j d
| j j j � } t
j j j
j � } | | _ q\n | S( s
Returns a vim.vm.device.VirtualDevice.BackingInfo object specifying a
virtual ethernet card backing information
network_name
string, network name
switch_type
string, type of switch
parent_ref
Parent reference to search for network
sW Configuring virtual machine network backing network_name={0} switch_type={1} parent={2}t standardt
network_namess) The network '{0}' could not be retrieved.i t distributedR� s, The port group '{0}' could not be retrieved.R� R� ( R� RM R5 R9 R: RH R� t get_networksR� R R R� R2 t VirtualEthernetCardt NetworkBackingInfot
deviceNameR� R� R� t PortConnectionR� R� R� R� t! DistributedVirtualPortBackingInfoR0 ( t network_namet switch_typeR� R� t networkst network_reft dvs_port_connection( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _create_network_backing s@
c
C@ s� | j � j � | j � j � t j d j | | | | | � � t j j j � } t | j | d | �| _ t j
� | j _ | d k r� t j j j j j
| _ n' | d k r� t j j j j j | _ n | r| rt | | | � | j _ | | j j _ n | r| | j _ n | r2| | j j _ n | rS| | j _ d | j _ n t | j _ | r�t j j j j � | j _ | d | j j _ | d | j j _ n | S( sc
Returns a vim.vm.device.VirtualDeviceSpec object specifying to add/edit a
network device
network_adapter_label
Network adapter label
key
Unique key for device creation
network_name
Network or port group name
adapter_type
Type of the adapter eg. vmxnet3
switch_type
Type of the switch: standard or distributed
operation
Type of operation: add or edit
connectable
Dictionary with the device connection properties
mac
MAC address of the network adapter
parent
Parent object reference
s Configuring virtual machine network adapter network_adapter_label={0} network_name={1} adapter_type={2} switch_type={3} mac={4}Rd R� R� t Manualt start_connectedt allow_guest_control( R� Rv R� RM R5 R R� R2 R> Rf RA RB RK R� RZ R� Ru R� RT R� RE t
macAddresst addressTypeRb t wakeOnLanEnabledt
VirtualDevicet ConnectInfot connectablet startConnectedt allowGuestControl(
R� Rp Rc Rq Rd RZ R~ t mact parentt network_spec( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_network_adapter_configR sH "
c C@ s� t j d j | | | | | � � t j j j � } | d k r^ d } t j j j � | _ n~ | d k r� d } t j j j � | _ nT | d k r� d } t j j j � | _ n* | d k r� d } t j j j
� | _ n | d
k rt j j j j j | _
n' | d k r*t j j j j j | _
n | | j _ | | j _ t j � | j _ | | j j _ | | j j _ | d k r�t j j j j j | j _ nT | d
k r�t j j j j j | j _ n* | d k r�t j j j j j | j _ n | S( s�
Returns a vim.vm.device.VirtualDeviceSpec object specifying to
add/edit a SCSI controller
adapter
SCSI controller adapter name
adapter_type
SCSI controller adapter type eg. paravirtual
bus_sharing
SCSI controller bus sharing eg. virtual_sharing
key
SCSI controller unique key
bus_number
Device bus number property
operation
Describes the operation which should be done on the object,
the possibles values: 'add' and 'edit', the default value is 'add'
.. code-block: bash
scsi:
adapter: 'SCSI controller 0'
type: paravirtual or lsilogic or lsilogic_sas
bus_sharing: 'no_sharing' or 'virtual_sharing' or 'physical_sharing'
s_ Configuring scsi controller adapter={0} adapter_type={1} bus_sharing={2} key={3} bus_number={4}t lsilogics LSI Logict lsilogic_sass
LSI Logic Sast paravirtuals VMware paravirtual SCSIt buslogics Bus LogicR� R� t virtual_sharingt physical_sharingt
no_sharing( R� RM R5 R R� R2 R> t VirtualLsiLogicControllert VirtualLsiLogicSASControllert ParaVirtualSCSIControllert VirtualBusLogicControllerRK R� RZ R� R� R6 RA RB RE RT t VirtualSCSIControllert Sharingt virtualSharingt sharedBust physicalSharingt noSharing( t adapterRc t bus_sharingR� R8 RZ t scsi_specRT ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_scsi_controller� s> c C@ s� g } t d d d � } | r� g | D] } | d ^ q% } t j d j | � � xJ t | | � D]6 \ } } | j t | d d | t | d � � � qa Wn | S( s�
Returns a list of vim.vm.device.VirtualDeviceSpec objects representing
IDE controllers
ide_controllers
IDE properties
i8���i���i����R� s Creating IDE controllers {0}R� i� ( R R� RM R5 R R� t _apply_ide_controller_configt abs( t ide_controllerst ide_ctrlsR� t idet devsR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _create_ide_controllers� s (c C@ s� t j d j | � � t j j j � } t j j j � | _ | d k rd t j j j j j | _
n | d k r� t j j j j j | _
n | | j _ | | j _
| r� t j � | j _ | | j j _ | | j j _ n | S( s@
Returns a vim.vm.device.VirtualDeviceSpec object specifying to add/edit an
IDE controller
ide_controller_label
Controller label of the IDE adapter
operation
Type of operation: add or edit
key
Unique key of the device
bus_number
Device bus number property
s3 Configuring IDE controller ide_controller_label={0}R� R� ( R� RM R5 R R� R2 R> t VirtualIDEControllerRK R� RZ R� R� R6 RA RB RE RT ( t ide_controller_labelRZ R� R8 t ide_spec( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� � s
c C@ s� g } t d d d � } | r� g | D] } | d ^ q% } t j d j | � � xD t | | � D]0 \ } } | j t | d d | | d � � qa Wn | S( s�
Returns a list of vim.vm.device.VirtualDeviceSpec objects representing
SATA controllers
sata_controllers
SATA properties
ih��i6��i����R� s Creating SATA controllers {0}R� R8 ( R R� RM R5 R R� t _apply_sata_controller_config( t sata_controllerst
sata_ctrlsR� t sataR� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _create_sata_controllers" s "c C@ s� t j d j | � � t j j j � } t j j j � | _ | d k rd t j j j j j | _
n' | d k r� t j j j j j | _
n | | j _ d | j _
| | j _ | r� t j � | j _ | | j j _ | | j j _ n | S( sB
Returns a vim.vm.device.VirtualDeviceSpec object specifying to add/edit a
SATA controller
sata_controller_label
Controller label of the SATA adapter
operation
Type of operation: add or edit
key
Unique key of the device
bus_number
Device bus number property
s5 Configuring SATA controller sata_controller_label={0}R� R� id ( R� RM R5 R R� R2 R> t VirtualAHCIControllerRK R� RZ R� R� RJ R6 RA RB RE RT ( t sata_controller_labelRZ R� R8 t sata_spec( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� 5 s
i� c C@ sO t j d j | | | | � � t j j j � } t j j j � | _ t j � | j _ | d k r t j j j j
j | _ n' | d k r� t j j j j
j
| _ n | d k rot j j j j � | j _ | d | j j _ | d j d � d j d � d }
t j j j t j j j | � | d
|
g �d } | rP| | j j _ n d j | d � | j j _ nk | d k r�| d
d k r�t j j j j � | j _ q�| d
d k r�t j j j j � | j _ q�n | | j _ | | j j _ | | j _ t j j j j � | j _! | rK| d | j j! _" | d | j j! _# n | S( s�
Returns a vim.vm.device.VirtualDeviceSpec object specifying to add/edit a
CD/DVD drive
drive_label
Leble of the CD/DVD drive
key
Unique key of the device
device_type
Type of the device: client or iso
operation
Type of operation: add or edit
client_device
Client device properties
datastore_iso_file
ISO properties
connectable
Connection info for the device
controller_key
Controller unique identifier to which we will attach this device
parent_ref
Parent object
.. code-block: bash
cd:
adapter: "CD/DVD drive 1"
device_type: datastore_iso_file or client_device
client_device:
mode: atapi or passthrough
datastore_iso_file:
path: "[share] iso/disk.iso"
connectable:
start_connected: True
allow_guest_control:
sa Configuring CD/DVD drive drive_label={0} device_type={1} client_device={2} datastore_iso_file={3}R� R� t datastore_iso_filet patht [i����t ]i Ru s {0}t
client_devicet modet passthrought atapiRw Rx ($ R� RM R5 R R� R2 R> t VirtualCdromRA RB RK R� RZ R� t IsoBackingInfoR� RL RC t
rpartitionR9 R: RH Rv R� Rx RT t RemotePassthroughBackingInfot RemoteAtapiBackingInfoR� RE RJ R| R} R~ R R� ( t drive_labelR� t device_typeRZ R� R� R~ RR R� t
drive_specRx t datastore_object( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_cd_driveY s@ / $ ! c C@ s� t j j j � } | | _ t j j j � | _ | rE | | j _ n | rZ | | j _ n | r� t j j j d | � | j _
| | j _ n t j j j � | j _
| S( s4
Returns a vim.vm.customization.AdapterMapping object containing the IP
properties of a network adapter card
domain
Domain of the host
gateway
Gateway address
ip_addr
IP address
subnet_mask
Subnet mask
mac
MAC address of the guest
t ipAddress(
R R� t
customizationt AdapterMappingRy t
IPSettingsR� t dnsDomaint gatewayt FixedIpRt t
subnetMaskt DhcpIpGenerator( R3 R� t ip_addrt subnet_maskR� t adapter_mapping( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _set_network_adapter_mapping� s c C@ sg t j d j | d | d | d | d � � t j j j � } t j j j � | _ | d k r} t j j j j j | _
n' | d k r� t j j j j j | _
n t j j j j
� } d } | d d k r�t j j j j � } d | d
j � k r t d � � n d | d
j � k r.t d � � n d
| d
j � k rSt d � � n | d
d | _ | d
d | _ | d
d
| _ n | d d k r�t j j j j � } n | d d k r�t j j j j � } n | d d k rt j j j j � } n | d d | _ | d d | _ | | j _ | | j _ d | j _ | | j _ | d | j _ | S( sp
Returns a vim.vm.device.VirtualSerialPort representing a serial port
component
serial_device_spec
Serial device properties
key
Unique key of the device
operation
Add or edit the given device
.. code-block:: bash
serial_ports:
adapter: 'Serial port 1'
backing:
type: uri
uri: 'telnet://something:port'
direction: <client|server>
filename: 'service_uri'
connectable:
allow_guest_control: True
start_connected: True
yield: False
sC Creating serial port adapter={0} type={1} connectable={2} yield={3}R� R� R~ t yieldR� R� R� t uriR� s& vSPC proxy URI not specified in configs& vSPC Direction not specified in configRU s% vSPC Filename not specified in configt directiont pipeR� R2 Rx Rw i N( R� RM R5 R R� R2 R> t VirtualSerialPortRK R� RZ R� R| R} RE t URIBackingInfoR� R t proxyURIR� t
serviceURIt PipeBackingInfot FileBackingInfot DeviceBackingInfoR� R R� R~ R@ R� t yieldOnPoll( t serial_device_specR� RZ t device_spect connect_infot type_backing( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _apply_serial_port� sJ c C@ sd g } t d d d � } | rT g | D] } | d ^ q% } t j d j | � � n x t | | � D]�\ } } d \ } }
} t | d � } d }
d | k r� | d j d � \ } } t | � } t | � } t | d
| �}
na d | k rHxR | D]( } | d | d k r� | d
}
Pq� q� Wt
j j d j | d � � � n d | k r�t
j
j j | | d | d g �d } | d }
n d | k r�| d } n | r�|
s�| r�|
r�t
j j d j |
| � � � n t | | d | d d | d | d d |
d d d | d d d | k r0| d n d d | d | � } | j | � | d 7} qd W| S( s�
Returns a list of disk specs representing the disks to be created for a
virtual machine
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
disks
List of disks with properties
scsi_controllers
List of SCSI controllers
parent
Parent object reference
.. code-block: bash
disk:
adapter: 'Hard disk 1'
size: 16
unit: GB
address: '0:0'
controller: 'SCSI controller 0'
thin_provision: False
eagerly_scrub: False
datastore: 'myshare'
filename: 'vm/mydisk.vmdk'
i0���i����i����R� s Creating disks {0}R
i� t addressRr R9 t
controllerRE R� s( The given controller does not exist: {0}Rx Ru i RU sk You must specify both filename and datastore attributes to place your disk to a specific datastore {0}, {1}RQ R RR RZ R� RS RT i N( NNN( R R� RM R5 R RE R� R� R� R; R9 R� t VMwareObjectNotFoundErrorR: RH Rv R RX R� ( RD R� t scsi_controllersR� t
disk_specsR� R� R� R� RU Rx t
datastore_refR
RR t controller_bus_numberRP t contrRV ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt
_create_disks sd
c C@ s� t d d d � } g } | r� g | D] } | d ^ q% } t j d j | � � xX t | | � D]D \ } } t | d | d | d | | d d � } | j | � qa Wn | S(
s�
Returns a list of vim.vm.device.VirtualDeviceSpec objects representing
SCSI controllers
scsi_devices:
List of SCSI device properties
i���i��i����R� s Creating SCSI devices {0}R� R� R8 R� ( R R� RM R5 R R� R� ( t scsi_devicesR� t
scsi_specst scsiR� R� t scsi_controllerR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _create_scsi_devicesy s
c C@ sF g } g } t d d d � } | r<g | D] } | d ^ q+ } t j d j | � � x� t | | � D]� \ } } t | | d | d | d d | d d
d d d | k r� | d n d d
| d
d | �} | j | � d | k rg t | d d | d d | d d | d d | d
� }
| j |
� qg qg Wn | | f S( s
Returns a list of vim.vm.device.VirtualDeviceSpec objects representing
the interfaces to be created for a virtual machine
network_interfaces
List of network interfaces and properties
parent
Parent object reference
.. code-block: bash
interfaces:
adapter: 'Network adapter 1'
name: vlan100
switch_type: distributed or standard
adapter_type: vmxnet3 or vmxnet, vmxnet2, vmxnet3, e1000, e1000e
mac: '00:11:22:33:44:55'
i`�i.�i����R� s Creating network interfaces {0}RD Rc Rq Rd RZ R� R~ R� R� t mappingR3 R� R� R� N( R R� RM R5 R R� RE R� R� ( t network_interfacesR� t
network_specst
nics_settingsR� t interR� t interfaceR� R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _create_network_adapters� s2
c C@ s� g } t d d d � } | r� g | D] } | d ^ q% } t j d j | � � x? t | | � D]+ \ } } t | | d � } | j | � qa Wn | S( s�
Returns a list of vim.vm.device.VirtualDeviceSpec objects representing the
serial ports to be created for a virtual machine
serial_ports
Serial port properties
i���i���i����R� s Creating serial ports {0}R� ( R R� RM R5 R R� R� ( t serial_portst portsR� t serialR� R0 R� t serial_port_device( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _create_serial_ports� s c C@ s' g } t d d d � } | r#g | D] } | d ^ q% } t j d j | � � x� t | | � D]� \ } } d } | r� t | | d � }
|
j } n | j t | d | | d d d
d
| k r� | d
n d d d | k r� | d n d d d | k r| d n d d
| d | �� qa Wn | S( s'
Returns a list of vim.vm.device.VirtualDeviceSpec objects representing the
CD/DVD drives to be created for a virtual machine
cd_drives
CD/DVD drive properties
controllers
CD/DVD drive controllers (IDE, SATA)
parent_ref
Parent object reference
iH�i�i����R� s Creating cd/dvd drives {0}i� R� R� R� R� R� R~ RR R� N(
R R� RM R5 R t _get_device_by_labelR� R� R� RE ( t cd_drivest controllersR� t cd_drive_specsR� t dvdR� t driveR� RR R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _create_cd_drives� s* c C@ sU g | D] } | j | k r | ^ q } | r6 | d St j j d j | � � � d S( s�
Returns the device with the given key, raises error if the device is
not found.
devices
list of vim.vm.device.VirtualDevice objects
key
Unique key of device
i s9 Virtual machine device with unique key {0} does not existN( R� R9 R� R� R5 ( t devicesR� R t device_keys( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _get_device_by_key� s ( c C@ sX g | D] } | j j | k r | ^ q } | r9 | d St j j d j | � � � d S( s�
Returns the device with the given label, raises error if the device is
not found.
devices
list of vim.vm.device.VirtualDevice objects
key
Unique key of device
i s4 Virtual machine device with label {0} does not existN( RB RE R9 R� R� R5 ( R� RE R t
device_labels( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR� ! s + c C@ sd | r\ xW | D]H } d | k r
d | k r
| j t j j j | d | d � � q
q
Wn t St S( s
Updates the size and unit dictionary values with the new unit values
devices
List of device data objects
R R
( Ri R9 R: RH RC Rv Rb ( R� R2 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _convert_units'! s
+c
C@ s i } t | j � � } | j d � | j d � | j d � xe d D]] } | | k rF t i | | | 6i | | | 6� } | j r� | | | <n | j | � qF qF Wd | k r� | j d � t | d | d � } | j r� | | d <q� n d | k r[| j d � t | d g � t | d g � t | d | d � } | j r[| | d <q[n d | k r�| j d � d } t | | | | � } | j r�| | | <q�n d | k rB| j d � t | d � t | d � t | d | d d
� }
|
j d d � |
j d d
� |
j d d � |
j rB|
| d <qBn d | k r�| j d � t | d | d d � } | j d d � | j r�| | d <q�n xn | D]f } | | k s�| | k r�t d j
| � � � n t | | | | d � } | j r�| | | <q�q�W| S( s�
Compares virtual machine current and new configuration, the current is the
one which is deployed now, and the new is the target config. Returns the
differences between the objects in a dictionary, the keys are the
configuration parameter keys and the values are differences objects: either
list or recursive difference
new_config:
New config dictionary with every available parameter
current_config
Currently deployed configuration
RD Ru Rx R^ t imaget cpuR R R� R� t diff_keyRT RU R� t
interfacesR� se A general device {0} configuration was not supplied or it was not retrieved from remote configuration( s versions image( R+ R� t discardR R+ R� R R t remove_diffR R5 (
t
new_configR R+ R� t property_keyt single_value_difft cpu_difft memory_diffR� t
advanced_difft
disk_diffst interface_diffst device_diffs( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR( 8! sz
c
C@ s8 d d d d d d d d d d
d d d
g
} t j j j | | d | d | �} t j j j d | d | � } i | d
6} i | d d 6| d d 6| d d 6| d d 6| d d 6| d <i | d d 6d d 6| d d 6| d d 6| d <| d | d <| d
| d <i | d <xX | d D]L } y t | j � | d | j <Wq t k
rk| j | d | j <q Xq Wg | d <g | d! <g | d" <g | d# <g | d$ <g | d% <x�| d D]y} t | t
j j j
� r!i }
| j j |
d& <| j |
d' <| j } | d( k rd) |
d* <n2 | d+ k r3d, |
d* <n | d- k rLd. |
d* <n t | t
j j j � rqd/ |
d0 <no t | t
j j j � r�d1 |
d0 <nJ t | t
j j j � r�d2 |
d0 <n% t | t
j j j � r�d3 |
d0 <n | r
| j |
d4 <| j |
d5 <| |
d6 <n | d! j |
� n t | t
j j j � rJi } | j j | d& <| j | d <d7 | d <t | d | j � }
|
j j | d8 <t |
j � d9 t | j � | d: <t j j j | j j � | d; <| j j | d< <| j j! | d= <| r6| j | d5 <| j | d> <|
j | d' <| j | d? <| | d6 <n | d j | � n t | t
j j j" � r�i }
| j j |
d& <t j j j# | � |
d@ <i | j$ j% dA 6| j$ j& dB 6| j$ j' dC 6|
dD <| j( |
dE <t | j t
j j j" j) � r3dF |
dG <| j j* j+ } t j j j, | t
j- | dH d5 dI | �} n7 t | j t
j j j" j. � rjdJ |
dG <| j j/ } n t j j j | � |
d
<| r�| j |
d5 <| |
d6 <n | d" j |
� n t | t
j j j0 � r7i } | j j | d& <t | d | j � }
|
j j | d8 <t | j t
j j j0 j1 � rGdK | dL <i dM dN 6| dK <n t | j t
j j j0 j2 � r�dK | dL <i dO dN 6| dK <n t | j t
j j j0 j3 � r�dP | dL <i | j j4 dQ 6| dP <n i | j$ j% dA 6| j$ j& dB 6| j$ j' dC 6| dD <| r#| j | d5 <| j | d? <| | d6 <n | d$ j | � n t | t
j j j5 � r�i } | j j | d& <t | j t
j j j5 j6 � r�dR | d0 <i | j j7 dS 6| j j8 dT 6| j j9 dU 6| dV <n t | j t
j j j5 j: � r�dW | d0 <n t | j t
j j j5 j; � rdX | d0 <n t | j t
j j j5 j< � rBd4 | d0 <n | j= | dY <i | j$ j% dA 6| j$ j& dB 6| j$ j' dC 6| dD <| r�| j | d5 <| | d6 <n | d# j | � n t | t
j j j> � r�i } | j j | d& <| j | d' <| r | j | d4 <| j | d5 <| | d6 <n | d% j | � q�q�W| S(Z s�
Queries and converts the virtual machine properties to the available format
from the schema. If the objects attribute is True the config objects will
have extra properties, like 'object' which will include the
vim.vm.device.VirtualDevice, this is necessary for deletion and update
actions.
name
Name of the virtual machine
datacenter
Datacenter's name where the virtual machine is available
objects
Indicates whether to return the vmware object properties
(eg. object, key) or just the properties which can be set
service_instance
vCenter service instance for connection and configuration
s config.hardware.devices config.hardware.numCPUs! config.hardware.numCoresPerSockets config.nestedHVEnableds config.cpuHotAddEnableds config.cpuHotRemoveEnableds config.hardware.memoryMBs# config.memoryReservationLockedToMaxs config.memoryHotAddEnableds config.versions config.guestIds config.extraConfigRD R� Ru RD R� R R R R R R R
t MBR R R R R^ R R� R� R R� R� R� R� R8 R� R� R� R� R� R� R� R� R� R� R� R� R2 R� t objectt KBR� Rr R� Rx RS RT RP RR Rc Rx t connectedRw R~ R� Ri Rq R% R& Rg R� R� R� R� R� R� R� R� R� R� RU R� R� R� R� (? R9 R: RH R� R} R� R� R� R Rh R R� R2 R� RB RE R6 R� R� R� R� R� R� R? RD R� RJ Rh R@ R� R� Rx RH RI Rk t get_network_adapter_object_typeR~ R� R R Ry Ro R0 R� R) t DistributedVirtualPortgroupRl R� R� R� R� R� RL R� R� R� R� R� R� R� R� R� t VirtualSATAController( RD Ru R RD R� R� R� R t
extra_confR2 R� R� R� R� t pg_keyRs R� R0 R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR �! sf
$
c C@ sh g } | rdg | D] } | d d ^ q } t j d j | � � x | D]} | d } | d } t | | � } t | _ | j � rJ | d | d k r� t j j d j | d | d | d | d � � � n t j d
j | d | d | d | d � � t
| d | d d d | d d | d d | d �} | d
j | j _ | j
| � qJ qJ Wn | S( sC
Changes the disk size and returns the config spec objects in a list.
The controller property cannot be updated, because controller address
identifies the disk by the unit and bus number properties.
disks_diffs
List of old and new disk properties, the properties are dictionary
objects
t oldR� s Updating disks {0}t newR
sM Disk cannot be downsized size={0} unit={1} controller_key={2} unit_number={3}R RR RP sY Virtual machine disk will be updated size={0} unit={1} controller_key={2} unit_number={3}R� R� R ( R� RM R5 R Rv t ignore_unset_valuest changedR9 R� R RX R� R2 R� ( t
disks_old_newt disk_changesR� R� R� t current_diskt next_diskt
differencet device_config_spec( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt
_update_disksr" s>
!
c C@ s� g } | r�g | D] } | d d ^ q } t j d j | � � x�| D]�} | d } | d } t | | � } t | _ | j � rJ t j d j | d | d | d | d � � | d | d k r�| j t | d
� � | j t | d | d | d | d | d d � � g } xE | d D]9 }
g | D] } | d
^ q6} | j t
| |
� � q)Wxx | D]7 }
t j j
j � } |
| _
d
| _ | j | � qmWq�| j t | d | d | d | d | d d
� � qJ qJ Wn | S( s�
Returns a list of vim.vm.device.VirtualDeviceSpec specifying the scsi
properties as input the old and new configs are defined in a dictionary.
scsi_diffs
List of old and new scsi properties
R R� s Updating SCSI controllers {0}R s[ Virtual machine scsi device will be updated key={0} bus_number={1} type={2} bus_sharing={3}R� R8 R� R� R R� R2 R� ( R� RM R5 R Rv R R R� t _delete_deviceR� R� R R� R2 R> RZ ( t
scsis_old_newt
current_diskst device_config_specsR� R� R� t next_scsit current_scsiR" t disks_to_updatet disk_keyR� t disk_objectsR RV ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _update_scsi_devices�" sR !
c
C@ s
g } | r g | D] } | d d ^ q } t j d j | � � x� | D]� } | d } | d } t | | � } t | _ | j � rJ t j d j | d | d | d | d � � t | d | d | d | d d
d d | d d | �} | j | � qJ qJ Wn | S(
s�
Returns a list of vim.vm.device.VirtualDeviceSpec specifying
configuration(s) for changed network adapters, the adapter type cannot
be changed, as input the old and new configs are defined in a dictionary.
interface_old_new
Dictionary with old and new keys which contains the current and the
next config for a network device
parent
Parent managed object reference
R R� s Updating network interfaces {0}R sa Virtual machine network adapter will be updated switch_type={0} name={1} adapter_type={2} mac={3}Rq RD Rc R� RZ R� R� ( R� RM R5 R Rv R R R� R� (
t interface_old_newR� t network_changesR� R� R� t current_interfacet next_interfaceR" R# ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _update_network_adapters�" s2
!
c C@ s� g } | r� g | D] } | d d ^ q } t j d j | � � xf | D]^ } | d } | d } t | | � } t | _ | j � rJ | j t | | d d � � qJ qJ W| Sd S( s
Returns a list of vim.vm.device.VirtualDeviceSpec specifying to edit a
deployed serial port configuration to the new given config
serial_old_new
Dictionary with old and new keys which contains the current and the
next config for a serial port device
R R� s Updating serial ports {0}R R� R� N( R� RM R5 R Rv R R R� R� ( t serial_old_newt serial_changesR� R� R� t current_serialt next_serialR" ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _update_serial_ports
# s !
c C@ s; g } | r7g | D] } | d d ^ q } t j d j | � � x� | D]� } | d } | d } t | | � } t | _ | j � rJ | r� t | | d � }
|
j } n
| d } | j t
| d | d | d d d
d
| k r� | d
n d d d | k r
| d n d d | d d | d
| �� qJ qJ Wn | S( s�
Returns a list of vim.vm.device.VirtualDeviceSpec specifying to edit a
deployed cd drive configuration to the new given config
drives_old_new
Dictionary with old and new keys which contains the current and the
next config for a cd drive
controllers
Controller device list
parent
Managed object reference of the parent object
R R� s Updating cd/dvd drives {0}R R� RR R� R� R� R� R� R~ R� N( R� RM R5 R Rv R R R� R� R� R� RE ( t drives_old_newR� R� t
cd_changesR� R� R� t
current_drivet new_driveR" R� RR ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt _update_cd_drives## s2 !
c C@ sS t j d j t | � � � t j j j � } t j j j j j | _
| | _ | S( s�
Returns a vim.vm.device.VirtualDeviceSpec specifying to remove a virtual
machine device
device
Device data type object
s Deleting device with type {0}( R� RM R5 R� R R� R2 R> RK R� RZ ( R2 R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR% N# s
c # C@ se t j j j | | � } t j j j | | d | �\ } } t j j j | | | � } t j j � } | | _ | | _
t j j � | _ t j j j
| | d | g �d } | s� t j j d j | � � � n yu t j j j | d � } d | k r/| d d k r/t j d � d j | � | j _ n d j | | � | j _ Wn/ t j j k
ryd j | | � | j _ n Xg } | r�t | | d
� n | r�t | | � n | r�t | | � n |
r�t |
� } | j j | � n | r:g | D] } | j ^ q�} t | | d | d | �} | j j | � n | rkt | d | �\ } } | j j | � n | r�t | � } | j j | � n | r�t | � } | j j | � | j | � n |
r�t! |
� }! | j j |! � | j |! � n | r%t" | d
| d | �}" | j j |" � n | r;t# | | � n t j j j$ | | | | | � i t% d 6S( s�
Creates a virtual machine container.
CLI Example:
.. code-block:: bash
salt vm_minion vsphere.create_vm vm_name=vmname cpu='{count: 2, nested: True}' ...
vm_name
Name of the virtual machine
cpu
Properties of CPUs for freshly created machines
memory
Memory size for freshly created machines
image
Virtual machine guest OS version identifier
VirtualMachineGuestOsIdentifier
version
Virtual machine container hardware version
datacenter
Datacenter where the virtual machine will be deployed (mandatory)
datastore
Datastore where the virtual machine files will be placed
placement
Resource pool or cluster or host or folder where the virtual machine
will be deployed
devices
interfaces
.. code-block:: bash
interfaces:
adapter: 'Network adapter 1'
name: vlan100
switch_type: distributed or standard
adapter_type: vmxnet3 or vmxnet, vmxnet2, vmxnet3, e1000, e1000e
mac: '00:11:22:33:44:55'
connectable:
allow_guest_control: True
connected: True
start_connected: True
disks
.. code-block:: bash
disks:
adapter: 'Hard disk 1'
size: 16
unit: GB
address: '0:0'
controller: 'SCSI controller 0'
thin_provision: False
eagerly_scrub: False
datastore: 'myshare'
filename: 'vm/mydisk.vmdk'
scsi_devices
.. code-block:: bash
scsi_devices:
controller: 'SCSI controller 0'
type: paravirtual
bus_sharing: no_sharing
serial_ports
.. code-block:: bash
serial_ports:
adapter: 'Serial port 1'
type: network
backing:
uri: 'telnet://something:port'
direction: <client|server>
filename: 'service_uri'
connectable:
allow_guest_control: True
connected: True
start_connected: True
yield: False
cd_drives
.. code-block:: bash
cd_drives:
adapter: 'CD/DVD drive 0'
controller: 'IDE 0'
device_type: datastore_iso_file
datastore_iso_file:
path: path_to_iso
connectable:
allow_guest_control: True
connected: True
start_connected: True
advanced_config
Advanced config parameters to be set for the virtual machine
R� Ru i s* Specified datastore: '{0}' does not exist.s summary.typeR> sI The vmPathName should be the datastore name if the datastore type is vsans [{0}]s [{0}] {1}/{1}.vmxR� R� R� R� R� t create_vm(& R9 R: RH R} t
get_placementt
get_folderR R� R� RD t guestIdt FileInfoR� Rv R� R R5 R R� RM t
vmPathNameR R R R R� t deviceChangeR� R2 R� R� R� R� R� R� R$ R> Rb (# R R R R R^ Ru Rx R� R R� R� R� R� R� R� R RD R� t resourcepool_objectt placement_objectt
folder_objectR� R� t
ds_summaryt cd_controllersR� R R� R� t interface_specst nic_settingst serial_port_specst ide_specst
sata_specsR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR> ]# s� w
c ' C@ s� t | d | d t d | �} t i | d 6| d 6| d 6| d 6| d 6| d 6| d
6| d 6| d 6| d 6|
d
6| d 6| d 6|
d 6| � } t j j � } t j j j | | � } t j j j
| t j | d d d | �} | j � } d | k r+| d j
� t � k r+t | | d j � q+n d | k rj| d j
� t � k rjt | | d j � qjn d | k r�t | | d j | j j � n d | k r�t | | d � n d | k r�| | _ n g } d | k rtd
| k rtg } | j t | d j | d
� � x, | d j D] } | j t | d � � q Wt | d j � } | j | � | j j | � n d
| k rOg } | j t! | d
j � � x, | d
j D] } | j t | d � � q�Wg | d D] } | d ^ q�} | j g | D] } | j" ^ q�� | j t# | | d
j d | d | �� | j j | � n d | k r�g } | j t$ | d j | � � x, | d j D] } | j t | d � � q�Wt% | d j | � \ } } | j | � | j j | � n d | k rqg } | j t& | d j � � x, | d j D] } | j t | d � � q#W| j t' | d j � � | j j | � n g } d | k r�t( | d j � }! x, | d j D] } |! j t | d � � q�W| j |! � | j j |! � n d | k r�g }" g | d D] } | d ^ q}# |# j g | D] } | j" ^ q%� |" j t) | d j d |# d | �� x, | d j D] } |" j t | d � � qoW|" j t* | d j d |# d | �� | j j |" � n | r�t j j j+ | | � n i }$ x� t, j- | � D]� \ }% }& t. |& t j j/ j0 � r}|& j1 d d d d � |& j1 d d d d � |& j1 d d d d � |& j1 d d d d � n |& j2 |$ |% <q�W|$ S( s
Updates the configuration of the virtual machine if the config differs
vm_name
Virtual Machine name to be updated
cpu
CPU configuration options
memory
Memory configuration options
version
Virtual machine container hardware version
image
Virtual machine guest OS version identifier
VirtualMachineGuestOsIdentifier
interfaces
Network interfaces configuration options
disks
Disks configuration options
scsi_devices
SCSI devices configuration options
serial_ports
Serial ports configuration options
datacenter
Datacenter where the virtual machine is available
datastore
Datastore where the virtual machine config files are available
cd_dvd_drives
CD/DVD drives configuration options
advanced_config
Advanced config parameters to be set for the virtual machine
service_instance
vCenter service instance for connection and configuration
Ru R RD RD R R R R^ R R� R� R� Rx R� R� R R% R& R� R R� R� R� R� R t diff_listt intersectR� t removed(3 R Rb R( R R� R� R9 R: RH R} R) R* R� R R+ R t current_dictR R$ R, R� R! R RA R� R. RP RQ R� R% R� t addedRD R$ R2 R� R3 R� R8 R� R� R= R� R- R R� Rh t
listdiffert ListDictDifferR R+ (' R R R R R^ R R� R� R� Ru Rx t
cd_dvd_drivesR� R RD R R+ R� R. R/ t difference_keyst new_scsi_devicest scsi_changesR� R t devR� R� R0 t adapterst nicsR5 t new_controllersRN R: R� R0 R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyR- &$ s� 6
c C@ s t j d j | | | � � t j j j | | � } d | k r� t j j j | | d � } t j j j | d d g �} d | k r� | d } n t j j
d � � t j j j | | | | � n d | k r�t j j j | d | d | d g �} | s t j j
d j | d � � � n | d
}
t j j j |
d d g �} d | k r�| d } t j j j | d d g �}
d |
k r�|
d } q�t j j
d � � n t j j
d
� � t j j j | | | | d |
�n i d d 6i t
d 6d 6} | S( s�
Registers a virtual machine to the inventory with the given vmx file.
Returns comments and change list
name
Name of the virtual machine
datacenter
Datacenter of the virtual machine
placement
Placement dictionary of the virtual machine, host or cluster
vmx_path:
Full path to the vmx file, datastore name should be included
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
sW Registering virtual machine with properties datacenter={0}, placement={1}, vmx_path={2}R� R� t resourcePools: The cluster's resource pool object could not be retrieved.R, R� R� s# ESXi host named '{0}' wasn't found.i R� s7 The host parent's parent object could not be retrieved.s0 The host's parent object could not be retrieved.t host_objects- Virtual machine registration action succeededt commentt register_vmR0 ( R� RM R5 R9 R: RH R} R� R R� R Ra R3 Rb ( RD Ru R� t vmx_pathRD R� t cluster_objt
cluster_propst resourcepoolR5 t host_objt
host_propst host_parentR� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRa �$ sZ
c C@ s� t j d j | � � d d g } t j j j | | d | d | �} | d d k ru i d d 6i t d 6d
6} | St j j j | d d d
�i d d 6i t d 6d
6} | S( s_
Powers on a virtual machine specified by it's name.
name
Name of the virtual machine
datacenter
Datacenter of the virtual machine
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.power_on_vm name=my_vm
s Powering on virtual machine {0}RD s summary.runtime.powerStateRu R� t poweredOns% Virtual machine is already powered onR` t power_onR0 R t actiont ons) Virtual machine power on action succeeded( R� RM R5 R9 R: RH R� Rb t power_cycle_vm( RD Ru RD R� R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt power_on_vm,% s
c C@ s� t j d j | � � d d g } t j j j | | d | d | �} | d d k ru i d d 6i t d 6d
6} | St j j j | d d d
�i d d 6i t d 6d
6} | S( sa
Powers off a virtual machine specified by it's name.
name
Name of the virtual machine
datacenter
Datacenter of the virtual machine
service_instance
Service instance (vim.ServiceInstance) of the vCenter.
Default is None.
.. code-block:: bash
salt '*' vsphere.power_off_vm name=my_vm
s Powering off virtual machine {0}RD s summary.runtime.powerStateRu R� t
poweredOffs& Virtual machine is already powered offR` t power_offR0 R Rk t offs* Virtual machine power off action succeeded( R� RM R5 R9 R: RH R� Rb Rm ( RD Ru RD R� R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt power_off_vmV% s
c C@ s� i } | r0 t j j j | | | � \ } } n t j j j | | � } | rk t | | | � t | d <n t j j j | t j | d d d | �} | s� t j
j d j | | � � � n | | f S( s9
Helper function to remove a virtual machine
name
Name of the virtual machine
service_instance
vCenter service instance for connection and configuration
datacenter
Datacenter of the virtual machine
placement
Placement information of the virtual machine
t powered_offR% RD R& s> The virtual machine object {0} in datacenter {1} was not found(
R9 R: RH R? R} Rr Rb R) R R* R� R R5 ( RD Ru RD R� Rp t resultsRE RF R/ ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt
_remove_vm�% s*
c C@ s� i } t j � } y) t j i | d 6| d 6| d 6| � Wn% t j j k
rb } t | � � n Xt | | d | d | d | �\ } } t j j
j | � t | d <| S( s�
Deletes a virtual machine defined by name and placement
name
Name of the virtual machine
datacenter
Datacenter of the virtual machine
placement
Placement information of the virtual machine
service_instance
vCenter service instance for connection and configuration
.. code-block:: bash
salt '*' vsphere.delete_vm name=my_vm datacenter=my_datacenter
RD Ru R� RD Rp t
deleted_vm(
R R� R� R� R� R� R
Ru R9 R: RH t delete_vmRb ( RD Ru R� Rp RD Rt R� R� R/ ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRw �% s"
c C@ s� i } t j � } y) t j i | d 6| d 6| d 6| � Wn% t j j k
rb } t | � � n Xt | | d | d | d | �\ } } t j j
j | � t | d <| S( s�
Unregisters a virtual machine defined by name and placement
name
Name of the virtual machine
datacenter
Datacenter of the virtual machine
placement
Placement information of the virtual machine
service_instance
vCenter service instance for connection and configuration
.. code-block:: bash
salt '*' vsphere.unregister_vm name=my_vm datacenter=my_datacenter
RD Ru R� RD Rp t unregistered_vm(
R R� R� R� R� R� R
Ru R9 R: RH t
unregister_vmRb ( RD Ru R� Rp RD Rt R� R� R/ ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyRy �% s"
( t __doc__t
__future__R R t loggingRN RZ t functoolsR t salt.extR t salt.ext.six.movesR R t salt.utils.argsR9 t salt.utils.dictupdateR: R� t salt.utils.httpt salt.utils.patht salt.utils.pbmt salt.utils.vmwaret salt.utils.vsant salt.utils.listdifferR t salt.utils.dictdifferR t salt.exceptionsR R R R
R R R
R t salt.utils.decoratorsR R t salt.config.schemas.esxclusterR R t salt.config.schemas.vcenterR t salt.config.schemas.esxiR R R t salt.config.schemas.esxvmR R t getLoggerR8 R� R� Rb t HAS_JSONSCHEMAt ImportErrorRv t pyVmomiR R R R t
versionMapt version_infoR� t HAS_PYVMOMIR� t whicht esx_clit HAS_ESX_CLIR$ t __proxyenabled__R% R+ R7 RC R` RE Ra RK Rm Rp Rs Rz R} R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R R R R R R R R R R" R- R0 R3 R= RA RC RY R\ R` Rh Rt R� R� R� R� R� R� R� R� R� R� R� R� R� R� R R R R
R R R! R% RF RN RR RX R[ Ri Rj Rq R{ R| R� R� R� R� R� R� R� R
R R R R# R$ R& R' R. R/ R7 R@ RA RS R\ Rb Rf Ri Rk Rm Rq R� Rn R| R� R� R� R R R� R R� R� R� R� R| R� R� R� R� R� R R R R R$ R1 R4 R5 R; RX Rf Ru R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R R( R R$ R. R3 R8 R= R% R> R- Ra Rn Rr Ru Rw Ry ( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/vsphere.pyt <module>� s, :
"-
_ $ !H K M W N G @ B Z F 3 9 8 i i < A I ' $ $ # # # # # # # # $ ; B N g g g x A = C G f S S ?
" E K % % 4 E 6 / 9 ( % 1 ' ' + $ R + � [ k P 1 " # * . . / 3 A % @ ; > # 5 8!( � I !/
! 6 ' M / 3O I " $W $ H[ / ) `� 3 < ) + � � I ' ' ) (
Mini Shell