| Current File : //lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyc |
�
.�t_c @ s� d Z d d l m Z m Z d d l m Z d d l m Z d d l m Z m Z d d l m Z m
Z
d d l Z d d l Z d d l
m Z d d l Z d d l Z d
e e f d � � YZ d e
f d
� � YZ d S( s�
Configuration - VDO manager configuration file handling
$Id: //eng/vdo-releases/magnesium/src/python/vdo/vdomgmnt/Configuration.py#7 $
i ( t
ArgumentErrort MgmntLogger( t StateExitStatus( t
VDOServicei����( t Commandt
runCommand( t FileLockt
YAMLObjectN( t ST_MTIMEt BadConfigurationFileErrorc B s e Z d Z d � Z d � Z RS( sw Exception raised to indicate an error in processing the
configuration file, such as a parse error or missing data.
c O s& t t | � j | | � | | _ d S( N( t superR t __init__t _msg( t selft msgt argst kwargs( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR / s c C s | j S( N( R ( R
( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt __str__4 s ( t __name__t
__module__t __doc__R R ( ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR ' s t
Configurationc B sS e Z d Z e j e j d � Z d g Z i Z d Z d Z
e d � � Z e
d � Z d � Z e d � � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z e d � � Z e d � � Z e d � � Z d � Z e d � � Z d � Z e e
d � Z d � Z! d � Z" d � Z# d � Z$ d � Z% d � Z& e d � � Z' RS( s� Configuration of VDO volumes and associated Albireo servers.
This class is designed for use with the "with" statement. If
Command.noRunMode is True, the file will still be opened and read
but writes will not be performed.
The Configuration is stored in a simple XML format; see
vdoconfig.dtd.
Attributes:
_vdos: A dictionary of VDOServices, indexed by name.
_filename: The name of the configuration file.
_readonly: True iff this Configuration is read-only.
_dirty: True iff this Configuration has been modified but the
changes have not been persisted.
_mustExist: If True, the file must exist (otherwise a missing
file is treated as an empty configuration).
s .Configurationi s /var/lock/vdo-config-singletonsu !Configurationc C se d } t | j d � �G } | j j | � } | d k r[ t | d t �} | | j | <n Wd QX| S( sR Allocates, as necessary, and returns a modifiable, singleton
Configuration instance for the specified filepath. Separate entities can
thus share one in memory copy of the configuration file allowing for
encapsulation of per-entity manipulation of the configuration.
Args:
filepath (str): path to config file
s r+t readonlyN( t NoneR t
singletonLockt modifiableSingltonst getR t False( t clst filepatht configt f( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt modifiableSingletonT s
c C sW | j � | j j d j | � � | r= | j | � r= t S| | j | <t | _ t S( st Adds or replaces a VDOService object in the configuration.
Generates an assertion error if this object is read-only.
Arguments:
name -- name of the VDOService
vdo -- the VDOService to add or replace
replace -- if True, any existing VDOService will be replaced
Returns: False if the VDOService exists and replace is False,
True otherwise
s! Adding vdo "{0}" to configuration( t _assertCanModifyt logt debugt formatt haveVdoR t _vdost Truet _dirty( R
t namet vdot replace( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt addVdog s
c C s$ t j i | j d 6| d 6d t �S( sI Returns the configuration's YAML representation to present to users.
t filenameR t default_flow_style( t yamlt dumpR R ( R
( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt
asYAMLForUser{ s
c C s | j S( s0 Returns the file path of the configuration file.( t _filename( R
( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR � s c C s | j S( s# Retrieves a list of all known VDOs.( R& ( R
( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt
getAllVdos� s c C sJ d } y | j | } Wn, t k
rE t t d � j | � � � n X| S( s Retrieves a VDO by name.s VDO volume {0} not foundN( R R& t KeyErrorR t _R$ ( R
R) R* ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt getVdo� s
c C s
| | j k S( s0 Returns True if we have a VDO with a given name.( R& ( R
R) ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR% � s c C sP t j j | � } x7 | j D], } | t j j | j | j � k r t Sq Wt S( s� Returns a boolean indicating if the configuration contains a VDO using
the specified device.
Both the specified device and the device from the vdos present in the
configuration are fully resolved for the check.
( t ost patht realpathR& t deviceR' R ( R
R: R* ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt isDeviceConfigured� s
"c C s� | j r
d S| j s* | j j d � d S| j j d j | j � � | j � r` | j � d St j i | d 6d t
�} t j � r� t
d � GH| GHt
| _ d S| j d } t j j | � r� t j | � n t | d � �� } | j d � | j t j � | j d
j t
d � � � | j t j � | j d � | j t j � | j | � | j � t j | � Wd QXt j | | j � | j � t
| _ d S( s\ Writes out the Configuration if necessary.
If the Configuration is read-only or has not been modified, this
method will silently return. If Command.noRunMode is True, any
new Configuration will be printed to stdout instead of the file.
This method will generate an assertion failure if the configuration
file is not open.
Ns& Configuration is clean, not persistings Writing configuration to {0}R R. s New configuration (not written):s .newt wsD ####################################################################s # {0}s> THIS FILE IS MACHINE GENERATED. DO NOT EDIT THIS FILE BY HAND.( t _readonlyR( R" R# R$ R t _emptyt _removeFileR/ R0 R R t noRunModeR5 R7 R8 t existst removet opent writet linesept flusht fsynct renamet _fsyncDirectory( R
t st newFilet fh( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt persist� sD
c C s! | j � | j | =t | _ d S( s Removes a VDO by name.N( R! R& R' R( ( R
R) ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt removeVdo� s
c C s� i } d } y) t j | j � } | j | t d � <WnA t k
rx } | j t j k r_ � n t d � | t d � <n X| d k r� t d � | t d � <n) t j d t j
| t � � | t d � <| S( sA Returns a dictionary representing the status of this object.
t Files does not exists
not availables
Last modifieds %Y-%m-%d %H:%M:%SN( R R7 t statR R5 t OSErrort errnot ENOENTt timet strftimet localtimeR ( R
t statust stt ex( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyRW � s c C s
| d � S( Ns /dev/YAMLInstance( ( R ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt _yamlMakeInstance s c C s
d d g S( Nt versiont vdos( ( R
( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt _yamlAttributeKeys s c C s0 t t | � j } | j | d <| j | d <| S( NR[ R\ ( R
R t _yamlDatat _schemaVersionR& ( R
t data( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR^ s
c C s4 t t | � j | � | d | _ | d | _ d S( NR[ R\ ( R
R t _yamlSetAttributesR[ R\ ( R
t
attributes( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyRa s
c C s) t t | � j } | j d d g � | S( NR[ R\ ( R
R t _yamlSpeciallyHandledAttributest extend( R
t specials( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyRc s c C sZ t t | � j | � | j | _ | j | _ x% | j D] } | j | j | � q8 Wd S( N( R
R t _yamlUpdateFromInstanceR[ R_ R\ R& t setConfig( R
t instanceR* ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyRf s
c C s t t | � j � i | _ | | _ | | _ t | _ | | _ d | _ | j r� t
j j | j
� r� t t d � j | j
� � � n | r� d n d } yY t
j j | � r� t
j j | � d k r� t | | � � } | j | � Wd QXq� n Wn% t k
r} t t | � � � n Xd S( s Construct a Configuration.
Args:
filename (str): The path to the XML configuration file
Kwargs:
readonly (bool): If True, the configuration is read-only.
mustExist (bool): If True, the configuration file must exist.
Raises:
ArgumentError
i s& Configuration file {0} does not exist.t rs a+i N( R
R R R& R2 R= R R( t
_mustExistR_ R7 R8 RA R R R5 R$ t getsizeRC t _readt IOErrort str( R
R- R t mustExistt modeRL R ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR ) s$
c C s d j t | � j | j � S( Ns {0}({1})( R$ t typeR R ( R
( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR J s c C s | j s t d � � d S( s< Asserts that mutative operations are allowed on this object.s Configuration is read-onlyN( R= t AssertionError( R
( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR! P s c C s t | j � d k S( s, Returns True if this configuration is empty.i ( t lenR& ( R
( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR> U s c C sp t j j | j � } t j � r5 t d | g � d St j | t j � } z t j | � Wd t j
| � Xd S( sI Open and issue an fsync on the directory containing the config file.
RG N( R7 R8 t dirnameR R R@ R RC t O_RDONLYRG t close( R
Rt t fd( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyRI Z s c C s+ | j j d j | j � � y t j | � } Wn) t j j k
rZ t t d � � � n Xy | d } Wn` t
k
r� t t d � � � n> t k
r� } | j j d j | � � t t d � � � n Xy | j | � Wn> t k
r } | j j d j | � � t t d � � � n Xt
| _ d S( s% Reads in a Configuration from a file.s Reading configuration from {0}s Not a valid configuration fileR s9 Not a valid configuration file (missing 'config' section)s# Not a valid configuration file: {0}i ( R" R# R$ R R/ t safe_loadt scannert ScannerErrorR R5 R4 t ExceptionRf R R( ( R
RL t confR RY ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyRl h s&
c C s� t j � r# t d | j g � d St j j | j � rU t j | j � | j � n y, t | j
d � � } t j | j =Wd QXWn t
k
r� n Xd S( sf Deletes the current configuration file.
In noRun mode, pretend that we're doing an rm of the file.t rmNs r+( R R@ R R R7 R8 RA RB RI R R R R R4 ( R
R ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR? � s
c C s4 | | j k r0 t t d � j d | � � � n d S( s� Checks a configuration file schema version string against the list
of supported schemas.
Args:
ver (str): the schema version string to check
Raises:
BadConfigurationFileError: version not supported.
s, Configuration file version {v} not supportedt vN( t supportedSchemaVersionsR R5 R$ ( R t ver( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt _validateVersion� s (( R R R R t getLoggert mynameR" R R R t yaml_tagt classmethodR R R, R1 t propertyR R3 R6 R% R; RM RN RW RZ R] R^ Ra Rc Rf R' R R R! R> RI Rl R? R� ( ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyR 8 s>
6 ! ( R t R R R R t utilsR R R R RR R7 RP R RT R/ R{ R R ( ( ( s> /usr/lib/python2.7/site-packages/vdo/vdomgmnt/Configuration.pyt <module> s