Current File : //usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyo
�
���^c @@ s| d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d Z
e j e � Z
d � Z e j j j d � Z e j j j d � Z d � Z d � Z d
� Z d � Z d � Z e d
� Z d � Z d � Z d � Z e d � Z d � Z d � Z d � Z! d � Z" d � Z# d � Z$ d � Z% d � Z& d � Z' d � Z( d � Z) d � Z* d � Z+ d � Z, d S( u�
Apache Traffic Server execution module.
.. versionadded:: 2015.8.0
``traffic_ctl`` is used to execute individual Traffic Server commands and to
script multiple commands in a shell.
i ( t absolute_importt unicode_literalst print_functionNu
trafficserverc C@ s8 t j j j d � s* t j j j d � r. t St d f S( Nu traffic_ctlu traffic_lineuZ trafficserver execution module not loaded: neither traffic_ctl nor traffic_line was found.( t saltt utilst patht whicht __virtualname__t False( ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt __virtual__ s *u traffic_lineu traffic_ctlc G@ s t g t | � S( N( t _TRAFFICCTLt list( t args( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt _traffic_ctl$ s c G@ s t g t | � S( N( t _TRAFFICLINER ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt
_traffic_line( s c C@ s. t r t d d � } n t d � } t | � S( Nu serveru statusu --status( R
R
R t _subprocess( t cmd( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt
_statuscmd, s c C@ s� t j d d j | � � yk t j | d t j �} t j j j | j
� d � j � } | j � } | ro | S| d k r t
St SWn! t k
r� } t j | � t SXd S( u5
Function to standardize the subprocess call
u
Running: "%s"u t stdouti i N( t logt debugt joint
subprocesst Popent PIPER R t stringutilst
to_unicodet communicatet stript waitt TrueR t OSErrort error( R t proct rett retcodet err( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyR 5 s %
c C@ s. t r t d d � } n t d � } t | � S( u�
Bounce all Traffic Server nodes in the cluster. Bouncing Traffic Server
shuts down and immediately restarts Traffic Server, node-by-node.
.. code-block:: bash
salt '*' trafficserver.bounce_cluster
u clusteru restartu -B( R
R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt bounce_clusterK s
c C@ sD t r t d d � } n t d � } | r: | d g } n t | � S( u$
Bounce Traffic Server on the local node. Bouncing Traffic Server shuts down
and immediately restarts the Traffic Server node.
drain
This option modifies the restart behavior such that traffic_server
is not shut down until the number of active client connections
drops to the number given by the
proxy.config.restart.active_client_threshold configuration
variable.
.. code-block:: bash
salt '*' trafficserver.bounce_local
salt '*' trafficserver.bounce_local drain=True
u serveru restartu -bu --drain( R
R
R R ( t drainR ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt bounce_local] s c C@ s1 t r t d d d � } n t d � } t | � S( u�
Clears accumulated statistics on all nodes in the cluster.
.. code-block:: bash
salt '*' trafficserver.clear_cluster
u metricu clearu --clusteru -C( R
R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt
clear_clustery s c C@ s. t r t d d � } n t d � } t | � S( u
Clears accumulated statistics on the local node.
.. code-block:: bash
salt '*' trafficserver.clear_node
u metricu clearu -c( R
R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt
clear_node� s c C@ s1 t r t d d d � } n t d � } t | � S( u�
Restart the traffic_manager process and the traffic_server process on all
the nodes in a cluster.
.. code-block:: bash
salt '*' trafficserver.restart_cluster
u clusteru restartu --manageru -M( R
R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt restart_cluster� s
c C@ sG t r t d d d � } n t d � } | r= | d g } n t | � S( u�
Restart the traffic_manager and traffic_server processes on the local node.
drain
This option modifies the restart behavior such that
``traffic_server`` is not shut down until the number of
active client connections drops to the number given by the
``proxy.config.restart.active_client_threshold`` configuration
variable.
.. code-block:: bash
salt '*' trafficserver.restart_local
salt '*' trafficserver.restart_local drain=True
u serveru restartu --manageru -Lu --drain( R
R
R R ( R' R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt
restart_local� s c C@ s4 t r t d d | � } n t d | � } t | � S( u�
Display the current values of all metrics whose names match the
given regular expression.
.. versionadded:: 2016.11.0
.. code-block:: bash
salt '*' trafficserver.match_metric regex
u metricu matchu -m( R
R
R ( t regexR ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt match_metric� s c C@ s4 t r t d d | � } n t d | � } t | � S( u�
Display the current values of all configuration variables whose
names match the given regular expression.
.. versionadded:: 2016.11.0
.. code-block:: bash
salt '*' trafficserver.match_config regex
u configu matchu -m( R
R
R R ( R- R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt match_config� s c G@ s~ i } t r t d d � } n t d � } y< x5 | D]- } t j d | � t | | g � | | <q4 WWn t k
ry n X| S( u�
Read Traffic Server configuration variable definitions.
.. versionadded:: 2016.11.0
.. code-block:: bash
salt '*' trafficserver.read_config proxy.config.http.keep_alive_post_out
u configu getu -ru Querying: %s( R
R
R R R R t KeyError( R R# R t arg( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt read_config� s
c G@ s~ i } t r t d d � } n t d � } y< x5 | D]- } t j d | � t | | g � | | <q4 WWn t k
ry n X| S( u�
Read Traffic Server one or more metrics.
.. versionadded:: 2016.11.0
.. code-block:: bash
salt '*' trafficserver.read_metric proxy.process.http.tcp_hit_count_stat
u metricu getu -ru Querying: %s( R
R
R R R R R0 ( R R# R R1 ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt read_metric s
c C@ sP t r t d d | | � } n t d | d | � } t j d | | � t | � S( uA
Set the value of a Traffic Server configuration variable.
variable
Name of a Traffic Server configuration variable.
value
The new value to set.
.. versionadded:: 2016.11.0
.. code-block:: bash
salt '*' trafficserver.set_config proxy.config.http.keep_alive_post_out 0
u configu setu -su -vu Setting %s to %s( R
R
R R R R ( t variablet valueR ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt
set_config$ s
c C@ s5 t r t d � } n t d d � } t | � t � S( ux
Shut down Traffic Server on the local node.
.. code-block:: bash
salt '*' trafficserver.shutdown
u -Su serveru stop( R R R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt shutdown> s
c C@ s5 t r t d � } n t d d � } t | � t � S( uq
Start Traffic Server on the local node.
.. code-block:: bash
salt '*' trafficserver.start
u -Uu serveru start( R R R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt startupR s
c C@ s. t r t d d � } n t d � } t | � S( uu
Initiate a Traffic Server configuration file reread. Use this command to
update the running configuration after any configuration file modification.
The timestamp of the last reconfiguration event (in seconds since epoch) is
published in the proxy.node.config.reconfigure_time metric.
.. code-block:: bash
salt '*' trafficserver.refresh
u configu reloadu -x( R
R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt refreshf s
c C@ s1 t r t d d d � } n t d � } t | � S( u�
Reset performance statistics to zero across the cluster.
.. code-block:: bash
salt '*' trafficserver.zero_cluster
u metricu clearu --clusteru -Z( R
R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt zero_cluster{ s c C@ s. t r t d d � } n t d � } t | � S( u�
Reset performance statistics to zero on the local node.
.. code-block:: bash
salt '*' trafficserver.zero_cluster
u metricu clearu -z( R
R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt zero_node� s c C@ s4 t r t d d | � } n t d | � } t | � S( u�
Mark a cache storage device as offline. The storage is identified by a path
which must match exactly a path specified in storage.config. This removes
the storage from the cache and redirects requests that would have used this
storage to other storage. This has exactly the same effect as a disk
failure for that storage. This does not persist across restarts of the
traffic_server process.
.. code-block:: bash
salt '*' trafficserver.offline /path/to/cache
u storageu offlineu --offline( R
R
R R ( R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt offline� s c C@ s. t r t d d � } n t d � } t | � S( u�
List all alarm events that have not been acknowledged (cleared).
.. code-block:: bash
salt '*' trafficserver.alarms
u alarmu listu --alarms( R
R
R R ( R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt alarms� s c C@ s4 t r t d d | � } n t d | � } t | � S( uD
Clear (acknowledge) an alarm event. The arguments are “all” for all current
alarms, a specific alarm number (e.g. ‘‘1’‘), or an alarm string identifier
(e.g. ‘’MGMT_ALARM_PROXY_CONFIG_ERROR’‘).
.. code-block:: bash
salt '*' trafficserver.clear_alarms [all | #event | name]
u alarmu clearu --clear_alarms( R
R
R R ( t alarmR ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt clear_alarms� s c C@ s t � S( u�
Show the current proxy server status, indicating if we’re running or not.
.. code-block:: bash
salt '*' trafficserver.status
( R ( ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt status� s (- t __doc__t
__future__R R R t loggingR t salt.utils.pathR t salt.utils.stringutilsR t getLoggert __name__R R R R R R R
R
R R R R& R R( R) R* R+ R, R. R/ R2 R3 R6 R7 R8 R9 R: R; R< R= R? R@ ( ( ( s> /usr/lib/python2.7/site-packages/salt/modules/trafficserver.pyt <module> sD
Mini Shell