Current File : //usr/lib/python2.7/site-packages/salt/modules/solr.pyo
�
���^c @@ sS d Z d d l m Z m Z m Z d d l Z d d l m Z d d l m Z
m Z m
Z m Z m Z d d l Z d d l Z d � Z d � Z d � Z e d d d d � Z d d d
� Z d d d d � Z d � Z d d
� Z d d d d � Z d d d � Z! d � Z" d � Z# d d d � Z$ d d � Z% d d � Z& d d � Z' d d d � Z( d d d � Z) d d d � Z* d d d � Z+ d d d � Z, d d e- d � Z. d d d � Z/ d d d � Z0 d d � Z1 d d d � Z2 d d d � Z3 d d e- d! � Z4 d d e- d" � Z5 d d d d d# � Z6 d d d d d$ � Z7 d d e- d% � Z8 d S(& u�
Apache Solr Salt Module
Author: Jed Glazner
Version: 0.2.1
Modified: 12/09/2011
This module uses HTTP requests to talk to the apache solr request handlers
to gather information and report errors. Because of this the minion doesn't
necessarily need to reside on the actual slave. However if you want to
use the signal function the minion must reside on the physical solr host.
This module supports multi-core and standard setups. Certain methods are
master/slave specific. Make sure you set the solr.type. If you have
questions or want a feature request please ask.
Coming Features in 0.3
----------------------
1. Add command for checking for replication failures on slaves
2. Improve match_index_versions since it's pointless on busy solr masters
3. Add additional local fs checks for backups to make sure they succeeded
Override these in the minion config
-----------------------------------
solr.cores
A list of core names e.g. ['core1','core2'].
An empty list indicates non-multicore setup.
solr.baseurl
The root level URL to access solr via HTTP
solr.request_timeout
The number of seconds before timing out an HTTP/HTTPS/FTP request. If
nothing is specified then the python global timeout setting is used.
solr.type
Possible values are 'master' or 'slave'
solr.backup_path
The path to store your backups. If you are using cores and you can specify
to append the core name to the path in the backup method.
solr.num_backups
For versions of solr >= 3.5. Indicates the number of backups to keep. This
option is ignored if your version is less.
solr.init_script
The full path to your init script with start/stop options
solr.dih.options
A list of options to pass to the DIH.
Required Options for DIH
------------------------
clean : False
Clear the index before importing
commit : True
Commit the documents to the index upon completion
optimize : True
Optimize the index after commit is complete
verbose : True
Get verbose output
i ( t absolute_importt unicode_literalst print_functionN( t six( t urlopent HTTPBasicAuthHandlert HTTPDigestAuthHandlert build_openert install_openerc C@ s< t j j j d � r d St j j j d � r2 d St d f S( uZ
PRIVATE METHOD
Solr needs to be installed to use this.
Return: str/bool
u solru apache-solruf The solr execution module failed to load: requires both the solr and apache-solr binaries in the path.( t saltt utilst patht whicht False( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt __virtual__U s
c C@ sN | d k r d S| s | St | t j � rF | j � d k rB d S| Sd Sd S( ug
PRIVATE METHOD
Checks to see if the value of a primitive or built-in container such as
a list, dict, set, tuple etc is empty or none. None type is returned if the
value is empty/None/False. Number data types that are 0 will return None.
value : obj
The primitive or built-in container to evaluate.
Return: None or value
u noneN( t Nonet
isinstanceR t string_typest lower( t value( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _get_none_or_valuec s c C@ s t t d d � � d k S( u�
PRIVATE METHOD
Checks to see if using_cores has been set or not. if it's been set
return it, otherwise figure it out and set it. Then return it
Return: boolean
True if one or more cores defined in __opts__['solr.cores']
u
config.optionu
solr.coresi ( t lent __salt__( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _check_for_cores} s
c C@ sn | d k r i n | } | d k r* g n | } | d k rB g n | } i | d 6| d 6| d 6| d 6} | S( u
PRIVATE METHOD
Creates a new return dict with default values. Defaults may be overwritten.
success : boolean (True)
True indicates a successful result.
data : dict<str,obj> ({})
Data to be returned to the caller.
errors : list<str> ([()])
A list of error messages to be returned to the caller
warnings : list<str> ([])
A list of warnings to be returned to the caller.
Return: dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
u successu datau errorsu warningsN( R ( t successt datat errorst warningst ret( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _get_return_dict� s
c C@ ss | d k r g n | } | d k r* g n | } | | d <| d j | � | d | | d <| d | | d <| S( u�
PRIVATE METHOD
Updates the return dictionary and returns it.
ret : dict<str,obj>
The original return dict to update. The ret param should have
been created from _get_return_dict()
success : boolean (True)
True indicates a successful result.
data : dict<str,obj> ({})
Data to be returned to the caller.
errors : list<str> ([()])
A list of error messages to be returned to the caller
warnings : list<str> ([])
A list of warnings to be returned to the caller.
Return: dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
u successu datau errorsu warningsN( R t update( R R R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _update_return_dict� s
c
C@ s4 | d k r g n | } t | � d k s6 | d k rI t d d � } n t d d � } t d d � } t | � d k r� | d k s� t | � d k r� d j | | | | � Sd j | | | | d j | � � Sn\ | d k s� t | � d k r d
j | | | | | � Sd j | | | | | d j | � � Sd S(
uR
PRIVATE METHOD
Formats the URL based on parameters, and if cores are used or not
handler : str
The request handler to hit.
host : str (None)
The solr host to query. __opts__['host'] is default
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you
are not using cores or if you want to check all cores.
extra : list<str> ([])
A list of name value pairs in string format. e.g. ['name=value']
Return: str
Fully formatted URL (http://<host>:<port>/solr/<handler>?wt=json&<extra>)
u Noneu
config.optionu solr.hostu solr.portu solr.baseurli u http://{0}:{1}{2}/{3}?wt=jsonu! http://{0}:{1}{2}/{3}?wt=json&{4}u &u! http://{0}:{1}{2}/{3}/{4}?wt=jsonu% http://{0}:{1}{2}/{3}/{4}?wt=json&{5}N( R R R R t formatt join( t handlert hostt core_namet extrat portt baseurl( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _format_url� s c
C@ s� t d d t � } t d d t � } t d d d � } | r� | r� t � } | j d | d | d | d | � t � } | j d | d | d | d | � t t | | � � n d
S( u-
Install an auth handler for urllib2
u
config.getu solr.useru solr.passwdu solr.auth_realmu Solrt realmt urit usert passwdN( R R
t _HTTPBasicAuthHandlert add_passwordt _HTTPDigestAuthHandlert _install_openert
_build_opener( t urlR+ t passwordR) t basict digest( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _auth� s c C@ s� t | � ya t d d � } | d k r/ i n
i | d 6} t j j j t | | � � } t t | g � SWn/ t
k
r� } t t i d j | | � g � SXd S( u�
PRIVATE METHOD
Uses salt.utils.json.load to fetch the JSON results from the solr API.
url : str
a complete URL that can be passed to urllib.open
request_timeout : int (None)
The number of seconds before the timeout should fail. Leave blank/None
to use the default. __opts__['solr.request_timeout']
Return: dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
u
config.optionu solr.request_timeoutu timeoutu {0} : {1}N(
R6 R R R R
t jsont loadt _urlopenR t Truet ExceptionR
R ( R2 t request_timeoutt kwargsR t err( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt
_http_request s
c C@ sV | d k r g n | } d j | � g | } t d d | d | d | �} t | � S( u�
PRIVATE METHOD
Performs the requested replication command and returns a dictionary with
success, errors and data as keys. The data object will contain the JSON
response.
command : str
The replication command to execute.
host : str (None)
The solr host to query. __opts__['host'] is default
core_name: str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
params : list<str> ([])
Any additional parameters you want to send. Should be a lsit of
strings in name=value format. e.g. ['name=value']
Return: dict<str, obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
u command={0}u replicationR# R$ R% N( R R R( R? ( t commandR# R$ t paramsR% R2 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _replication_request s
c C@ s. t d j | � | d | �} t | � } | S( u�
PRIVATE METHOD
Calls the _http_request method and passes the admin command to execute
and stores the data. This data is fairly static but should be refreshed
periodically to make sure everything this OK. The data object will contain
the JSON response.
command : str
The admin command to execute.
host : str (None)
The solr host to query. __opts__['host'] is default
core_name: str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
Return: dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
u admin/{0}R$ ( R( R R? ( R@ R# R$ R2 t resp( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _get_admin_info9 s c C@ s t d d � d k S( u�
PRIVATE METHOD
Simple method to determine if the minion is configured as master or slave
Return: boolean::
True if __opts__['solr.type'] = master
u
config.optionu solr.typeu master( R ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt
_is_masterR s c C@ s~ t d d � } t | t � r/ | j | � n xH t j | � D]7 \ } } t | t � r? t j | � j � | | <q? q? W| S( u�
PRIVATE METHOD
updates the default import options from __opts__['solr.dih.import_options']
with the dictionary passed in. Also converts booleans to strings
to pass to solr.
options : dict<str,boolean>
Dictionary the over rides the default options defined in
__opts__['solr.dih.import_options']
Return: dict<str,boolean>::
{option:boolean}
u
config.optionu solr.dih.import_options( R R t dictR R t iteritemst boolt text_typeR ( t optionst defaultst keyt val( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _merge_options^ s c C@ s t | � d k r2 t � r2 d g } t t | � St | � d k rf t � rf d g } t t d | �St | | | � } | d r� | d d } | d k r� d g } t t d | �S| d
k r d j | � g } t t d | d d | �Sn, d
j | � g } t t d | d d | �S| S( u�
PRIVATE METHOD - MASTER CALL
Does a pre-check to make sure that all the options are set and that
we can talk to solr before trying to send a command to solr. This
Command should only be issued to masters.
handler : str
The import handler to check the state of
host : str (None):
The solr host to query. __opts__['host'] is default
core_name (None):
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
REQUIRED if you are using cores.
Return: dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
u> solr.pre_indexing_check can only be called by "master" minionsu9 solr.full_import is not safe to multiple handlers at onceR u successu datau statusu busyu' An indexing process is already running.R u idleu Unknown status: "{0}"R u* Status check failed. Response details: {0}N( R R RE R R
R t
import_statusR: R ( R" R# R$ R> R RC t statust warn( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _pre_index_checkv s$
c C@ s� | d k r | } n d j | | � } g } x� t j | � D]� \ } } | | k rl | j i | | 6� n t | t � r� x9 | D]. } t | t � r� | t | | | � } q� q� Wn t | t � r= | t | | | � } q= q= W| S( u�
PRIVATE METHOD
Traverses a dictionary of dictionaries/lists to find key
and return the value stored.
TODO:// this method doesn't really work very well, and it's not really
very useful in its current state. The purpose for this method is
to simplify parsing the JSON output so you can just pass the key
you want to find and have it return the value.
ret : dict<str,obj>
The dictionary to search through. Typically this will be a dict
returned from solr.
key : str
The key (str) to find in the dictionary
Return: list<dict<str,obj>>::
[{path:path, value:value}]
u {0}:{1}N( R R R RG t appendR t listRF t _find_value( t ret_dictRL R R t ikeyRM t item( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyRU � s
c C@ s t � } t | � d k r� t � r� t } x� t d d � D]~ } t d d | �} | d r� | d d d } i i | d 6| 6} n i i d d 6| 6} t } t | | | | d
� } q; W| St d d | �} | d r
| d d d } t t i | d 6| d
� S| Sd S(
u?
Gets the lucene version that solr is using. If you are running a multi-core
setup you should specify a core name since all the cores run under the same
servlet container, they will all have the same version.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
Return: dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.lucene_version
u
config.optionu
solr.coresu systemR$ u successu datau luceneu lucene-spec-versionu lucene_versionu errorsu versionN( R R R R R: R RD R
R ( R$ R R t nameRC t version_numR ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt lucene_version� s"
c C@ s t � } t | � d k r� t � r� t } x� t d D]� } t d d | �} | d r� | d d } i i | d d 6| 6} n t } i i d d 6| 6} t | | | | d | d
� } q5 W| St d d | �} | d r| d d d } t t i | d 6| d | d
� S| Sd S( u
Gets the solr version for the core specified. You should specify a core
here as all the cores will run under the same servlet container and so will
all have the same version.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.version
u
solr.coresu systemR$ u successu datau luceneu solr-spec-versionu versionu errorsu warningsN( R R R R R: t __opts__RD R
R ( R$ R R RY RC t luceneR RZ ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt version� s&
c
C@ s( t � } t | � d k r� t � r� t } x� t d d � D]� } t d d | d | d d g �} t | � } | d r� i i | d d 6| 6} t | | | | d
| d � } q; t } i i | d d 6| 6} t | | | | d
| d � } q; W| St d d | d | d d g �} t | � Sd S(
u�
Search queries fast, but it is a very expensive operation. The ideal
process is to run this with a master/slave configuration. Then you
can optimize the master, and push the optimized index to the slaves.
If you are running a single solr instance, or if you are going to run
this on a slave be aware than search performance will be horrible
while this command is being run. Additionally it can take a LONG time
to run and your HTTP request may timeout. If that happens adjust your
timeout settings.
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.optimize music
u
config.optionu
solr.coresu updateR# R$ R% u
optimize=trueu successu datau errorsu warningsN(
R R R R R: R R( R? R R
( R# R$ R R RY R2 RC R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt optimize% s&
c C@ s� t � } t | � d k r� t � r� t } x� t d D]z } t d d | d | �} | d r| i i | d d d 6| 6} n t } i i d d 6| 6} t | | | | d � } q5 W| St d d | d | �} | Sd S(
u�
Does a health check on solr, makes sure solr can talk to the indexes.
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.ping music
u
solr.coresu pingR# R$ u successu datau statusu errorsN( R R R R R: R\ RD R
R ( R# R$ R R RY RC R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt pingX s
c @ s� t � } t } t � rH | d k rH d g } | j i t d 6| d 6� S� f d � } t | � d k r� t � r� x{ t d D]9 } t d d | d | �� | | | � | � \ } } q} Wn3 t d d | d | �� | | | � | � \ } } | S(
u
SLAVE CALL
Check for errors, and determine if a slave is replicating or not.
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.is_replication_enabled music
u5 Only "slave" minions can run "is_replication_enabled"u successu errorsc @ s � d r| d d d } d } | d } d | k r� t } d j | | d | � } | d j | � | d k rz | n i i | d 6| 6} n | d
d d } | d k r� | d
j d � t } n | d d k r� t } | d j d � n t | | | | d | d
� } n | | f S( Nu successu datau detailsu slaveu falseu masterUrlu ERRORu {0}: {1} - {2}u errorsu
masterDetailsu masteru replicationEnabledu warningsu" Replication is disabled on master.u isPollingDisabledu trueu warningu Polling is disabled( R
R RS R R ( R R RC t coret slavet enabledt
master_urlR> R ( t response( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _checks� s(
) u
solr.coresu detailsR# R$ N(
R R: RE R R R
R R R\ RB ( R# R$ R R R Rf RY ( ( Re s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt is_replication_enabled} s " c @ s� t � } t } t � rH t | � d k rH | j i t d 6d g d 6� S� f d � } t | � d k r� t � r� t } x{ t d D]9 } t d d | d | �� | | | � | � \ } } q� Wn3 t d d | d | �� | | | � | � \ } } | S(
u5
SLAVE CALL
Verifies that the master and the slave versions are in sync by
comparing the index version. If you are constantly pushing updates
the index the master and slave versions will seldom match. A solution
to this is pause indexing every so often to allow the slave to replicate
and then call this method before allowing indexing to resume.
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.match_index_versions music
u successu? solr.match_index_versions can only be called by "slave" minionsu errorsc
@ s� � d ry| d d d } | d d d d } d | k r� | d } t } d j | | | � } | d j | � | d k r� | n i i | d 6| 6} n� i | d d
d d
6| d d d d 6| d
d 6g d 6} d | k r| j i | d d 6� n | d
| d k r0t } | d j d � n | d k rB| n i i | d 6| 6} t | | | | d | d � } n2 t } | d } | d } t | | | d | �} | | f S( Nu successu datau detailsu slaveu masterUrlu ERRORu {0}: {1} - {2}u errorsu
masterDetailsu masteru replicatableIndexVersionu indexVersionu nextExecutionAtu next_replicationu failed_listu replicationFailedAtListu- Master and Slave index versions do not match.u warningsR ( R
R RS R R R (
R R RC Ra Rb Rd t errorR> R t versions( Re ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt _match� s<
)
&
u
solr.coresu detailsR# R$ N(
R R: RE R R R R
R R\ RB ( R# R$ R R Rj RY ( ( Re s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt match_index_versions� s" ( " c C@ s� t � } t | � d k r� t } x� t d D]V } t d d | d | �} i i | d d 6| 6} t | | | | d | d � } q, WnQ t d d | d | �} | d r� t | | d | d | d | d � } n | S| S(
u�
Get the full replication details.
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.replication_details music
u
solr.coresu detailsR# R$ u datau errorsu warningsu successN( R R R R: R\ RB R ( R# R$ R R RY RC R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt replication_details# s
c
C@ s� t d } t d } | d k rK | j t j j � sK | t j j 7} qK n t � } t | � d k rRt � rRt } x� t d D]� } g } | d k r� | r� | | n | } | j
d j | | � � n | j
d j | � � t d d | d | d | �} | d
st
} n i i | d d 6| 6}
t | | |
| d | d
� } q� W| S| d k r�| d k r�| r�| | 7} q�n | d k r�d j | � g } n | j
d j | � � t d d | d | d | �} | Sd S( uP
Tell solr make a backup. This method can be mis-leading since it uses the
backup API. If an error happens during the backup you are not notified.
The status: 'OK' in the response simply means that solr received the
request successfully.
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
append_core_to_path : boolean (False)
If True add the name of the core to the backup path. Assumes that
minion backup path is not None.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.backup music
u solr.backup_pathu solr.num_backupsu
solr.coresu
&location={0}u &numberToKeep={0}u backupR# R$ RA u successu datau errorsu warningsu location={0}N( R\ R t endswitht osR t sepR R R R: RS R RB R
R ( R# R$ t append_core_to_pathR t num_backupsR R RY RA RC R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt backupI s>
c
C@ s t � } t � rH t | � d k rH d g } | j i t d 6| d 6� S| rT d n d } t | � d k r� t � r� t } xu t d D]i } t | d | d | �} | d s� t } n i i | d d 6| 6} t
| | | | d | d
� } q� W| St | d | d | �} | Sd S( uW
SLAVE CALL
Prevent the slaves from polling the master for updates.
polling : boolean
True will enable polling. False will disable it.
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to check all cores.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.set_is_polling False
u9 solr.set_is_polling can only be called by "slave" minionsu successu errorsu
enablepollu disapblepollu
solr.coresR# R$ u datau warningsN( R RE R R R R
R R: R\ t set_is_pollingR RB (
t pollingR# R$ R R> t cmdR RY RC R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyRs � s"
c
C@ s t � r/ t | � d k r/ t t d d g �S| r; d n d } t | � d k r� t � r� t � } t } xo t d D]c } t | | | � } | d s� t } n i i | d d 6| 6} t | | | | d | d � } qv W| S| r� t
| d
| d | �St
| d
| d | �Sd S(
u�
MASTER ONLY
Sets the master to ignore poll requests from the slaves. Useful when you
don't want the slaves replicating during indexing or when clearing the
index.
status : boolean
Sets the replication status to the specified state.
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str (None)
The name of the solr core if using cores. Leave this blank if you are
not using cores or if you want to set the status on all cores.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.set_replication_enabled false, None, music
R u. Only minions configured as master can run thisu enablereplicationu disablereplicationu
solr.coresu successu datau errorsu warningsR# R$ N( RE R R R R
R R: R\ t set_replication_enabledR RB ( RP R# R$ Ru R R RY RC R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyRv � s$
c C@ sw d
} | | k rI | d d j | d � f } d j | d j | � � Sd j t d | � } t d
| d t �d S( u�
Signals Apache Solr to start, stop, or restart. Obviously this is only
going to work if the minion resides on the solr host. Additionally Solr
doesn't ship with an init script so one must be created.
signal : str (None)
The command to pass to the apache solr init valid values are 'start',
'stop', and 'restart'
CLI Example:
.. code-block:: bash
salt '*' solr.signal restart
u startu stopu restarti����u or {0}u* {0} is an invalid signal. Try: one of: {1}u , u {0} {1}u solr.init_scriptu cmd.runt python_shellN( u startu stopu restart( R R! R\ R R
( t signalt
valid_signalst msgRu ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyRx � s c
C@ s t � } t � s6 d g } | j i t d 6| d 6� St | � d
k r� t � r� t } xl t d D]` } t | | � } | d s� t } n i i | d d 6| 6} t | | | | d | d � } qb W| Sd d j
| � g } t d d
| d d
d | �} t | � S( u�
MULTI-CORE HOSTS ONLY
Load a new core from the same configuration as an existing registered core.
While the "new" core is initializing, the "old" one will continue to accept
requests. Once it has finished, all new request will go to the "new" core,
and the "old" core will be unloaded.
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str
The name of the core to reload
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.reload_core None music
Return data is in the following format::
{'success':bool, 'data':dict, 'errors':list, 'warnings':list}
u; solr.reload_core can only be called by "multi-core" minionsu successu errorsu
solr.coresu datau warningsu
action=RELOADu core={0}u admin/coresR# R$ R% N(
R R R R
R R R: R\ t reload_coreR R R( R? (
R# R$ R R> R RY RC R R% R2 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyR{ s"
c
C@ s t � } t � s6 d g } | j i t d 6| d 6� St | � d
k r� t � r� t } xl t d D]` } t | | � } | d s� t } n i i | d d 6| 6} t | | | | d | d � } qb W| Sd d j
| � g } t d d
| d d
d | �} t | � S( u�
MULTI-CORE HOSTS ONLY
Get the status for a given core or all cores if no core is specified
host : str (None)
The solr host to query. __opts__['host'] is default.
core_name : str
The name of the core to reload
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.core_status None music
u; solr.reload_core can only be called by "multi-core" minionsu successu errorsu
solr.coresu datau warningsu
action=STATUSu core={0}u admin/coresR# R$ R% N(
R R R R
R R R: R\ R{ R R R( R? (
R# R$ R R> R RY RC R R% R2 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt core_status0 s"
c
C@ s� t � r2 t | � d k r2 d g } t t | � St | � d k rc t � rc d g } t t | � Sd g } | r� | j d � n t | d | d | d | �} t | � S( u�
MASTER ONLY
re-loads the handler config XML file.
This command can only be run if the minion is a 'master' type
handler : str
The name of the data import handler.
host : str (None)
The solr host to query. __opts__['host'] is default.
core : str (None)
The core the handler belongs to.
verbose : boolean (False)
Run the command with verbose output.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.reload_import_config dataimport None music {'clean':True}
u> solr.pre_indexing_check can only be called by "master" minionsu< No core specified when minion is configured as "multi-core".u command=reload-configu verbose=trueR# R$ R% N( RE R R R R
R RS R( R? ( R" R# R$ t verboseR> RA R2 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt reload_import_configZ s
c
C@ s� t � r5 t | � d k r5 d g } t t d | �St | � d k rf t � rf d g } t t | � Sd g } | r� | j d � n t | d | d | d | �} t | � S(
u�
MASTER ONLY
Aborts an existing import command to the specified handler.
This command can only be run if the minion is configured with
solr.type=master
handler : str
The name of the data import handler.
host : str (None)
The solr host to query. __opts__['host'] is default.
core : str (None)
The core the handler belongs to.
verbose : boolean (False)
Run the command with verbose output.
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.abort_import dataimport None music {'clean':True}
u8 solr.abort_import can only be called on "master" minionsR u< No core specified when minion is configured as "multi-core".u
command=abortu verbose=trueR# R$ R% N( RE R R R R
R RS R( R? ( R" R# R$ R} R> RA R2 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt abort_import� s
c
C@ se | d k r i n | } | d k r* g n | } t � sR d g } t t d | �St | � d k r� t � r� d g } t t | � St | | | � } | d s� | St | � } | d r� t t d | d | �} | d s� d g } t t d | �Sn d g } x6 t j
| � D]% \ } }
| j d
j | |
� � qWt
| d | d | d | | �} t | � S(
u�
MASTER ONLY
Submits an import command to the specified handler using specified options.
This command can only be run if the minion is configured with
solr.type=master
handler : str
The name of the data import handler.
host : str (None)
The solr host to query. __opts__['host'] is default.
core : str (None)
The core the handler belongs to.
options : dict (__opts__)
A list of options such as clean, optimize commit, verbose, and
pause_replication. leave blank to use __opts__ defaults. options will
be merged with __opts__
extra : dict ([])
Extra name value pairs to pass to the handler. e.g. ["name=value"]
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.full_import dataimport None music {'clean':True}
u7 solr.full_import can only be called on "master" minionsR u< No core specified when minion is configured as "multi-core".u successu cleanR# R$ u3 Failed to set the replication status on the master.u command=full-importu &{0}={1}R% N( R RE R R
R R RR RN Rv R RG RS R R( R? ( R" R# R$ RJ R% R> RC R RA RL RM R2 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt full_import� s.
c C@ sV | d k r i n | } | d k r* g n | } t � re t | � d k re d g } t t d | �St | d | d | �} | d s� | St | � } | d r� t � r� t t d | d | �} | d s� d g } t t d | �Sn d g } x6 t j
| � D]% \ } }
| j d j | |
� � qWt
| d | d | d
| | �} t | � S( u�
Submits an import command to the specified handler using specified options.
This command can only be run if the minion is configured with
solr.type=master
handler : str
The name of the data import handler.
host : str (None)
The solr host to query. __opts__['host'] is default.
core : str (None)
The core the handler belongs to.
options : dict (__opts__)
A list of options such as clean, optimize commit, verbose, and
pause_replication. leave blank to use __opts__ defaults. options will
be merged with __opts__
extra : dict ([])
Extra name value pairs to pass to the handler. e.g. ["name=value"]
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.delta_import dataimport None music {'clean':True}
u8 solr.delta_import can only be called on "master" minionsR R# R$ u successu cleanu3 Failed to set the replication status on the master.u command=delta-importu {0}={1}R% N( R RE R R R
RR RN R Rv R RG RS R R( R? ( R" R# R$ RJ R% R> RC R RA RL RM R2 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt delta_import� s(
c C@ s| t � r5 t | � d k r5 d g } t t d | �Sd g } | rT | j d � n t | d | d | d | �} t | � S( u�
Submits an import command to the specified handler using specified options.
This command can only be run if the minion is configured with
solr.type: 'master'
handler : str
The name of the data import handler.
host : str (None)
The solr host to query. __opts__['host'] is default.
core : str (None)
The core the handler belongs to.
verbose : boolean (False)
Specifies verbose output
Return : dict<str,obj>::
{'success':boolean, 'data':dict, 'errors':list, 'warnings':list}
CLI Example:
.. code-block:: bash
salt '*' solr.import_status dataimport None music False
u9 solr.import_status can only be called by "master" minionsR u command=statusu verbose=trueR# R$ R% N( RE R R R R
RS R( R? ( R" R# R$ R} R R% R2 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyRO s (9 t __doc__t
__future__R R R Rn t salt.extR t! salt.ext.six.moves.urllib.requestR R9 R R- R R/ R R1 R R0 t salt.utils.jsonR t salt.utils.pathR R R R: R R R R( R6 R? RB RD RE RN RR RU R[ R^ R_ R` Rg Rk Rl R
Rr Rs Rv Rx R{ R| R~ R R� R� RO ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/solr.pyt <module>< sL (
' 0 ' + -3%J\&=.0 /*+)96
Mini Shell