Current File : //lib/python2.7/site-packages/salt/states/zpool.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l m Z e j e
� Z d Z d � Z
d d � Z d d d d d � Z e e d � Z d S(
u"
States for managing zpools
:maintainer: Jorge Schrauwen <sjorge@blackdot.be>
:maturity: new
:depends: salt.utils.zfs, salt.modules.zpool
:platform: smartos, illumos, solaris, freebsd, linux
.. versionadded:: 2016.3.0
.. versionchanged:: 2018.3.1
Big refactor to remove duplicate code, better type converions and improved
consistancy in output.
.. code-block:: yaml
oldpool:
zpool.absent:
- export: true
newpool:
zpool.present:
- config:
import: false
force: true
- properties:
comment: salty storage pool
- layout:
- mirror:
- /dev/disk0
- /dev/disk1
- mirror:
- /dev/disk2
- /dev/disk3
partitionpool:
zpool.present:
- config:
import: false
force: true
- properties:
comment: disk partition salty storage pool
ashift: '12'
feature@lz4_compress: enabled
- filesystem_properties:
compression: lz4
atime: on
relatime: on
- layout:
- /dev/disk/by-uuid/3e43ce94-77af-4f52-a91b-6cdbb0b0f41b
simplepool:
zpool.present:
- config:
import: false
force: true
- properties:
comment: another salty storage pool
- layout:
- /dev/disk0
- /dev/disk1
.. warning::
The layout will never be updated, it will only be used at time of creation.
It's a whole lot of work to figure out if a devices needs to be detached, removed,
etc. This is best done by the sysadmin on a case per case basis.
Filesystem properties are also not updated, this should be managed by the zfs state module.
i ( t absolute_importt print_functiont unicode_literalsN( t OrderedDictu zpoolc C@ s t j d � s t d f St S( u
Provides zpool state
u zfs_supportu3 The zpool state cannot be loaded: zfs not supported( t
__grains__t gett Falset __virtualname__( ( ( s5 /usr/lib/python2.7/site-packages/salt/states/zpool.pyt __virtual__W s
c C@ s� g } | r( t j j | � r( d } n t | t � r� xC| D]i } t | t � rl | j t | | � � q> | r� | d d k r� t j j | | � } n | j
| � q> Wn� t | t � rwx� | D]� } | j d � d } | | } | d k r| j
| � n t | t � s$| j d � } n xI | D]A } | r_| d d k r_t j j | | � } n | j
| � q+Wq� Wn d } | S( u�
Turn the layout data into usable vdevs spedcification
We need to support 2 ways of passing the layout:
.. code::
layout_new:
- mirror:
- disk0
- disk1
- mirror:
- disk2
- disk3
.. code:
layout_legacy:
mirror-0:
disk0
disk1
mirror-1:
disk2
disk3
i u /u -u disku N( t ost patht existst Nonet
isinstancet listR t extendt _layout_to_vdevt joint appendt split( t layoutt
device_dirt vdevst vdevt vdev_typet vdev_diskt disk( ( s5 /usr/lib/python2.7/site-packages/salt/states/zpool.pyR ` s0
c
C@ s� i | d 6i d 6d0 d 6d d 6} i t d 6d0 d 6d0 d 6t d 6} t d
d k ra d | d <n t d
d
k r~ d | d <n | r� | j | � n | } | r� t d | � } n | d0 k r� i } n | r� t d | � } n | d0 k r� i } n t | | d � } | r"| j d | � n t j d | | � t j d | | � t j d | | � t j d | | � t | d <t
d r�t | d <t d | � r�d | d | <n | d r�d n d | d | <d j | | d | � | d <n�t d | � r_t | d <t d | d t �} g } | r�xZ | D]O }
|
| k rZt j
d | |
� q/n | |
| |
k r/| j |
� q/q/Wn x� | D]� }
t d | |
| |
� } | d r�| | d k r�i | d | <n | |
| d | |
<q�t | d <| d d k rd | d <n d! j | d |
� | d <q�W| d r�| d rOd" n d# | d <q�nK| d r�t d$ | d% | d d& | d �} | d | d <| d r�d | d | <d' j | � | d <q�n | d r�| r�t j d( | � t d) d% | d d* | d+ | | � } | d | d <| d rOd | d | <d, j | � | d <q�d- | k rl| d- | d <q�d. j | � | d <n | d r�| r�d/ j | � | d <n | S(1 uE
ensure storage pool is present on the system
name : string
name of storage pool
properties : dict
optional set of properties to set for the storage pool
filesystem_properties : dict
optional set of filesystem properties to set for the storage pool (creation only)
layout: dict
disk layout to use if the pool does not exist (creation only)
config : dict
fine grain control over this state
.. note::
The following configuration properties can be toggled in the config parameter.
- import (true) - try to import the pool before creating it if absent
- import_dirs (None) - specify additional locations to scan for devices on import (comma-seperated)
- device_dir (None, SunOS=/dev/dsk, Linux=/dev) - specify device directory to prepend for none
absolute device paths
- force (false) - try to force the import or creation
.. note::
It is no longer needed to give a unique name to each top-level vdev, the old
layout format is still supported but no longer recommended.
.. code-block:: yaml
- mirror:
- /tmp/vdisk3
- /tmp/vdisk2
- mirror:
- /tmp/vdisk0
- /tmp/vdisk1
The above yaml will always result in the following zpool create:
.. code-block:: bash
zpool create mypool mirror /tmp/vdisk3 /tmp/vdisk2 mirror /tmp/vdisk0 /tmp/vdisk1
.. warning::
The legacy format is also still supported but not recommended,
because ID's inside the layout dict must be unique they need to have a suffix.
.. code-block:: yaml
mirror-0:
/tmp/vdisk3
/tmp/vdisk2
mirror-1:
/tmp/vdisk0
/tmp/vdisk1
.. warning::
Pay attention to the order of your dict!
.. code-block:: yaml
- mirror:
- /tmp/vdisk0
- /tmp/vdisk1
- /tmp/vdisk2
The above will result in the following zpool create:
.. code-block:: bash
zpool create mypool mirror /tmp/vdisk0 /tmp/vdisk1 /tmp/vdisk2
Creating a 3-way mirror! While you probably expect it to be mirror
root vdev with 2 devices + a root vdev of 1 device!
u nameu changesu resultu u commentu importu import_dirsu
device_diru forceu kernelu SunOSu /dev/dsku Linuxu /devu zfs.from_auto_dicti u zpool.present::%s::config - %su zpool.present::%s::vdevs - %su# zpool.present::%s::properties - %su. zpool.present::%s::filesystem_properties - %su testu zpool.existsu uptodateu importedu createdu storage pool {0} was {1}u zpool.gett parsableu0 zpool.present::%s::update - unknown property: %su zpool.setu setu* The following properties were not updated:u {0} {1}u properties updatedu no update neededu zpool.importt forcet diru storage pool {0} was importedu zpool.present::%s::creatingu zpool.createt
propertiest filesystem_propertiesu storage pool {0} was createdu erroru! could not create storage pool {0}uK storage pool {0} was not imported, no (valid) layout specified for creationN( R t TrueR R t updatet __utils__R t insertt logt debugt __opts__t __salt__t formatt warningR (
t nameR R R t configt rett default_configR t properties_currentt properties_updatet propt rest mod_res( ( s5 /usr/lib/python2.7/site-packages/salt/states/zpool.pyt present� s� O
!
c C@ sV i | d 6i d 6d d 6d d 6} t j d | | � t j d | | � t d | � r5i } t | d <t d r t | d <nQ | r� t d
| d | �} | d | d <n$ t d
| d | �} | d | d <| d r| r� d n d | d | <d j | | d | � | d <qRd | k rR| d | d <qRn t | d <d j | � | d <| S( u�
ensure storage pool is absent on the system
name : string
name of storage pool
export : boolean
export instread of destroy the zpool if present
force : boolean
force destroy or export
u nameu changesu resultu u commentu$ zpool.absent::%s::config::force = %su% zpool.absent::%s::config::export = %su zpool.existsu testu zpool.exportR u exportedu
zpool.destroyu destroyedu storage pool {0} was {1}u erroru storage pool {0} is absentN( R R$ R% R' R R& R R( ( R* t exportR R, R2 ( ( s5 /usr/lib/python2.7/site-packages/salt/states/zpool.pyt absent s0
!
( t __doc__t
__future__R R R R t loggingt salt.utils.odictR t getLoggert __name__R$ R R R R R3 R R5 ( ( ( s5 /usr/lib/python2.7/site-packages/salt/states/zpool.pyt <module>G s I�
Mini Shell