Current File : //usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l j j Z
d d l Z d d l
Z d d l m Z m Z d d l m Z e j e � Z d � Z d � Z d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z e e e d e e e d � Z! d � Z" d � Z# d d � Z% e d � Z& e d � Z' e( d � Z) d � Z* d � Z+ d � Z, e d � Z- d � Z. d � Z/ d � Z0 d � Z1 d � Z2 d! � Z3 d S(" u
Manage a glusterfs pool
i ( t absolute_importt unicode_literalst print_functionN( t SaltInvocationErrort CommandExecutionError( t sixc C@ s# t j j j d � r t St d f S( u=
Only load this module if the gluster command exists
u glusteru! glusterfs server is not installed( t saltt utilst patht whicht Truet False( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt __virtual__ s c C@ s� d d g } d } t d | � j � } xX | D]P } | j d � r/ | j � d j d � } g | D] } t | � ^ qd } q/ q/ Wt | � S( Ni i u gluster --versionu cmd.runu glusterfsi����u .( t __salt__t
splitlinest
startswitht splitt intt tuple( t versiont cmdt resultt linet i( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt _get_version s
&c C@ s t | j d � j � d k S( uA
Extract boolean return value from Gluster's XML output.
u opReti ( R t findt text( t xml_data( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt _gluster_ok, s c C@ sW d } xJ | j � D]< } | j d � r? | | d j � 7} q | | j � 7} q W| S( u�
Gluster versions prior to 6 have a bug that requires tricking
isatty. This adds "gluster> " to the output. Strip it off and
produce clean xml for ElementTree.
u u gluster>i ( R R t strip( R t retR ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt _gluster_output_cleanup3 s c C@ s t � d k r1 t d d d d j | � �} n t d d d d j | � �} y t j t | � � } Wn3 t j k
r� t d j | j � d
� � � n Xt
| � r� | j d � } | d k r� t
j d | | j d � j � qt
j d
| � n t
j d | | j d � j � | S( u9
Perform a gluster --xml command and log result.
i i u cmd.runu* script -q -c "gluster --xml --mode=script"t stdinu {0}
u gluster --xml --mode=scriptu {0}
u
i����u outputu Gluster call "%s" succeeded: %su Gluster call "%s" succeededu Failed gluster call: %s: %su opErrstr( i i N( R R
t formatt ETt
fromstringR t
ParseErrorR t joinR R R t Nonet logt infoR t error( R R t roott output( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt _gluster_xmlC s( # c C@ s t t | � � S( u@
Perform a gluster command and return a boolean status.
( R R, ( R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt _glusterh s c C@ s7 i } x! | D] } t | � | | j <q
W| p6 | j S( N( t _etree_to_dictt tagR ( t tt dt child( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyR. o s
c C@ s- t j d k r | j | � S| j | � Sd S( u+
Checks for python2.6 or python2.7
i i N( i i ( t syst version_infot getiteratort iter( R* t term( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt _iterv s
c C@ s t d � } t | � s d Si } x� t | d � D]� } | j d � j } i g d 6| | <x� | D]� } | j d k r� | | d j | j � qb | j d k r� xi | D]8 } | j | | d k r� | | d j | j � q� q� Wqb | j d k rb | j | | | j <qb qb Wq2 W| S( ug
Return peer status information
The return value is a dictionary with peer UUIDs as keys and dicts of peer
information as values. Hostnames are listed in one list. GlusterFS separates
one of the hostnames but the only reason for this seems to be which hostname
happens to be used first in peering.
CLI Example:
.. code-block:: bash
salt '*' glusterfs.peer_status
GLUSTER direct CLI example (to show what salt is sending to gluster):
$ gluster peer status
GLUSTER CLI 3.4.4 return example (so we know what we are parsing):
Number of Peers: 2
Hostname: ftp2
Port: 24007
Uuid: cbcb256b-e66e-4ec7-a718-21082d396c24
State: Peer in Cluster (Connected)
Hostname: ftp3
Uuid: 5ea10457-6cb2-427b-a770-7897509625e9
State: Peer in Cluster (Connected)
u peer statusu peeru uuidu hostnamesu hostnameN( R, R R& R8 R R R/ t append( R* R t peert uuidt itemt hostname( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt peer_status� s" "
" c C@ sI t j j j | d � r0 t d j | � � � n d j | � } t | � S( u�
Add another node into the peer list.
name
The remote host to probe.
CLI Example:
.. code-block:: bash
salt 'one.gluster.*' glusterfs.peer two
GLUSTER direct CLI example (to show what salt is sending to gluster):
$ gluster peer probe ftp2
GLUSTER CLI 3.4.4 return example (so we know what we are parsing):
#if the "peer" is the local host:
peer probe: success: on localhost not needed
#if the peer was just added:
peer probe: success
#if the peer was already part of the cluster:
peer probe: success: host ftp2 port 24007 already in peer list
u a-zA-Z0-9._-u% Invalid characters in peer name "{0}"u peer probe {0}( R R t cloudt
check_nameR R! R- ( t nameR ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyR: � s
u tcpc
C@ s� t | t j � r | g } n | rI t | � d k rI t d d � � n xw | D]o } y@ | j d � \ }
} | j d � s� t d j | � � � n WqP t k
r� t d j | � � � qP XqP W| r� | d k r� t d d
� � n d j | � } | r| d j | � 7} n | r/| d
j | � 7} n | rB| d 7} n | rU| d 7} n | d k rw| d j | � 7} n | d j | � 7} | r�| d 7} n t
| � s�t S| r�t | � St
S( u�
Create a glusterfs volume
name
Name of the gluster volume
bricks
Bricks to create volume from, in <peer>:<brick path> format. For multiple bricks use list format: '["<peer1>:<brick1>", "<peer2>:<brick2>"]'
stripe
Stripe count, the number of bricks should be a multiple of the stripe count for a distributed striped volume
replica
Replica count, the number of bricks should be a multiple of the replica count for a distributed replicated volume
arbiter
If true, specifies volume should use arbiter brick(s). Valid configuration limited to "replica 3 arbiter 1" per Gluster documentation. Every third brick in the brick list is used as an arbiter brick.
.. versionadded:: 2019.2.0
device_vg
If true, specifies volume should use block backend instead of regular posix backend. Block device backend volume does not support multiple bricks
transport
Transport protocol to use, can be 'tcp', 'rdma' or 'tcp,rdma'
start
Start the volume after creation
force
Force volume creation, this works even if creating in root FS
CLI Examples:
.. code-block:: bash
salt host1 glusterfs.create newvolume host1:/brick
salt gluster1 glusterfs.create vol2 '["gluster1:/export/vol2/brick", "gluster2:/export/vol2/brick"]' replica=2 start=True
i u% Block device backend volume does not u support multiple bricksu :u /u$ Brick paths must start with / in {0}u% Brick syntax is <peer>:<path> got {0}i u! Arbiter configuration only valid u in replica 3 volumeu volume create {0} u stripe {0} u replica {0} u
arbiter 1 u
device vg u tcpu transport {0} u u force( t
isinstanceR t string_typest lenR R R R! t
ValueErrorR% R- R t start_volumeR
(
RA t brickst stripet replicat device_vgt transportt startt forcet arbitert brickt peer_nameR R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt
create_volume� sH 5
c C@ sE t d � } t | � s d Sg t | d � D] } | j ^ q, } | S( uv
List configured volumes
CLI Example:
.. code-block:: bash
salt '*' glusterfs.list_volumes
u volume listu volumeN( R, R R& R8 R ( R* t xt results( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt list_volumesA s
%c
C@ s� t d j | � � } t | � s% d
Si i d 6i d 6i d 6} d � } i } xT t | d � D]C } | j d � j } | j d � j } | d k r_ | | | <q_ q_ Wx� t | d � D]� } | j d � j } | d k r| j d � j } | | � | d d j | | � <q� | d k rN| j d � j } | | } | | � | d | <q� | j d � j } | | } | | � | d | <q� W| S( u�
Check the status of a gluster volume.
name
Volume name
CLI Example:
.. code-block:: bash
salt '*' glusterfs.status myvolume
u volume status {0}u bricksu nfsu healersc S@ s2 t | � } | d d k | d <| d | d <| S( Nu statusu 1u onlineu hostnameu host( R. ( R0 R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt etree_legacy_wrapi s u nodeu peeridu hostnameu
NFS Serveru Self-heal Daemonu pathu {0}:{1}N( u
NFS Serveru Self-heal Daemon( u
NFS Serveru Self-heal Daemon( R, R! R R& R8 R R (
RA R* R RU t hostreft nodet peeridR= R t
true_hostname( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt statusS s0 #
c C@ s� d } | d k r# | d | 7} n t | � } t | � s? d Si } xXt | d � D]G} | j d � j } t | � | | <i } x� t t | d � d d �D]� \ } } d j | � } i | j d 6| | <x> | D]6 } | j d k s� | | j
i | j | j 6� q� q� Wx( | j � D] \ }
} | | | |
<q Wq� W| | | d
<i } x9 t | d � D]( }
|
j d � j | |
j d � j <qbW| | | d
<qU W| S( u�
.. versionadded:: 2015.8.4
Return gluster volume info.
name
Optional name to retrieve only information of one volume
CLI Example:
.. code-block:: bash
salt '*' glusterfs.info
u volume infou u volumeu nameu brickRL i u brick{0}u pathu bricksu optionu valueu optionsN( R& R, R R8 R R R. t enumerateR! R/ t updatet items( RA R R* R t volumeRG R RO t brickkeyR2 t kt vt optionst option( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyR( � s2 (
%&c C@ s� d j | � } | r' d j | � } n t | � } | | k rS t j d | � t S| r� | | d d k r� t j d | � t St | � S( u
Start a gluster volume
name
Volume name
force
Force the volume start even if the volume is started
.. versionadded:: 2015.8.4
CLI Example:
.. code-block:: bash
salt '*' glusterfs.start mycluster
u volume start {0}u {0} forceu# Cannot start non-existing volume %su statusu 1u Volume %s already started( R! R( R' R) R R
R- ( RA RM R t volinfo( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyRF � s c C@ s� t � } | | k r) t j d | � t St | | d � d k rW t j d | � t Sd j | � } | ry | d 7} n t | � S( u�
Stop a gluster volume
name
Volume name
force
Force stop the volume
.. versionadded:: 2015.8.4
CLI Example:
.. code-block:: bash
salt '*' glusterfs.stop_volume mycluster
u" Cannot stop non-existing volume %su statusi u) Attempt to stop already stopped volume %su volume stop {0}u force( R( R' R) R R t warningR
R! R- ( RA RM Rd R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt stop_volume� s
c C@ s� t � } | | k r) t j d | � t S| | d d k } | r^ | r^ t j d | � t S| r} t | d t �s} t Sn d j | � } t | � S( u�
Deletes a gluster volume
target
Volume to delete
stop : True
If ``True``, stop volume before delete
CLI Example:
.. code-block:: bash
salt '*' glusterfs.delete_volume <volume>
u$ Cannot delete non-existing volume %su statusu 1u) Volume %s must be stopped before deletionRM u volume delete {0}( R( R' R) R Rf R
R! R- ( t targett stopRd t runningR ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt
delete_volume� s
c C@ s t � } | | k r) t j d | � t Sg } d j | � } t | t j � r\ | g } n g | | d j � D] } | d ^ qq } x= | D]5 } | | k r� t j d | | � q� | j
| � q� Wt | � d k rx! | D] } | d j | � 7} q� Wt | � St
S( u�
Add brick(s) to an existing volume
name
Volume name
bricks
List of bricks to add to the volume
CLI Example:
.. code-block:: bash
salt '*' glusterfs.add_volume_bricks <volume> <bricks>
u+ Volume %s does not exist, cannot add bricksu volume add-brick {0}u bricksu pathu6 Brick %s already in volume %s...excluding from commandi u {0}( R( R' R) R R! RB R RC t valuest debugR9 RD R- R
( RA RG Rd t
new_bricksR RR t
volume_bricksRO ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt add_volume_bricks s* +
c C@ s# d j | � } t | � s t St S( u�
Enable quota on a glusterfs volume.
name
Name of the gluster volume
CLI Example:
.. code-block:: bash
salt '*' glusterfs.enable_quota_volume <volume>
u volume quota {0} enable( R! R- R R
( RA R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt enable_quota_volumeN s c C@ s# d j | � } t | � s t St S( u�
Disable quota on a glusterfs volume.
name
Name of the gluster volume
CLI Example:
.. code-block:: bash
salt '*' glusterfs.disable_quota_volume <volume>
u volume quota {0} disable( R! R- R R
( RA R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt disable_quota_volumeb s c C@ ss d j | � } | r+ | d j | � 7} n | rG | d j | � 7} n | r_ t | � s_ q_ n t | � so t St S( u�
Set quota to glusterfs volume.
name
Name of the gluster volume
path
Folder path for restriction in volume ("/")
size
Hard-limit size of the volume (MB/GB)
enable_quota
Enable quota before set up restriction
CLI Example:
.. code-block:: bash
salt '*' glusterfs.set_quota_volume <volume> <path> <size> enable_quota=True
u volume quota {0}u limit-usage {0}u {0}( R! Rp R- R R
( RA R t sizet enable_quotaR ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt set_quota_volumev s c C@ s? d j | � } | r+ | d j | � 7} n t | � s; t St S( u�
Unset quota on glusterfs volume
name
Name of the gluster volume
path
Folder path for restriction in volume
CLI Example:
.. code-block:: bash
salt '*' glusterfs.unset_quota_volume <volume> <path>
u volume quota {0}u remove {0}( R! R- R R
( RA R R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt unset_quota_volume� s c C@ s{ d j | � } | d 7} t | � } t | � s5 d Si } x9 t | d � D]( } | j d � j } t | � | | <qK W| S( u�
List quotas of glusterfs volume
name
Name of the gluster volume
CLI Example:
.. code-block:: bash
salt '*' glusterfs.list_quota_volume <volume>
u volume quota {0}u listu limitu pathN( R! R, R R& R8 R R R. ( RA R R* R t limitR ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt list_quota_volume� s
c C@ s� d j | � } t | � } t | � s= t | j d � j f Si } x� t | d � D]p } xg | D]_ } | j d k r� | j } q` | j d k r` x, | D]! } | j d k r� | j } q� q� Wq` q` WqS W| S( u�
.. versionadded:: 2019.2.0
Returns the glusterfs volume op-version
name
Name of the glusterfs volume
CLI Example:
.. code-block:: bash
salt '*' glusterfs.get_op_version <volume>
u! volume get {0} cluster.op-versionu opErrstru
volGetoptsu Valueu Opt( R! R, R R R R R8 R/ ( RA R R* R t
op_versionR< R2 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt get_op_version� s
c C@ s t � d k r> t d j t d j d � t � D� � � � f Sd } t | � } t | � sr t | j d � j f Si } x� t | d � D]p } xg | D]_ } | j
d k r� | j } q� | j
d
k r� x, | D]! } | j
d k r� | j } q� q� Wq� q� Wq� W| S( u�
.. versionadded:: 2019.2.0
Returns the glusterfs volume's max op-version value
Requires Glusterfs version > 3.9
CLI Example:
.. code-block:: bash
salt '*' glusterfs.get_max_op_version
i i
u6 Glusterfs version must be 3.10+. Your version is {0}.u .c s@ s | ] } t | � Vq d S( N( t str( t .0R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pys <genexpr>� s u% volume get all cluster.max-op-versionu opErrstru
volGetoptsu Valueu Opt( i i
( R R R! Rz R% R, R R R R8 R/ ( R R* R t max_op_versionR< R2 ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt get_max_op_version� s /
c C@ sM d j | � } t | � } t | � s= t | j d � j f S| j d � j S( u�
.. versionadded:: 2019.2.0
Set the glusterfs volume op-version
version
Version to set the glusterfs volume op-version
CLI Example:
.. code-block:: bash
salt '*' glusterfs.set_op_version <volume>
u% volume set all cluster.op-version {0}u opErrstru output( R! R, R R R R ( R R R* ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt set_op_version s
c C@ s d j t � � S( u�
.. versionadded:: 2019.2.0
Returns the version of glusterfs.
CLI Example:
.. code-block:: bash
salt '*' glusterfs.get_version
u .( R% R ( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt get_version- s (4 t __doc__t
__future__R R R t loggingR3 t xml.etree.ElementTreet etreet ElementTreeR" t salt.utils.cloudR t salt.utils.patht salt.exceptionsR R t salt.extR t getLoggert __name__R' R R R R R, R- R. R8 R> R: R RQ RT RZ R& R( RF Rf R
Rj Ro Rp Rq Rt Ru Rw Ry R} R~ R ( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/glusterfs.pyt <module> sJ %
6 & d 6 / ! ! % / $ # "
Mini Shell