You are viewing a plain text version of this content. The canonical link for it is here.
Posted to solr-commits@lucene.apache.org by Apache Wiki <wi...@apache.org> on 2008/09/01 02:39:57 UTC

[Solr Wiki] Update of "CoreAdmin" by HossMan

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Solr Wiki" for change notification.

The following page has been changed by HossMan:
http://wiki.apache.org/solr/CoreAdmin

The comment on the change is:
minor formating fixes and "multi core" vocab cleanup

------------------------------------------------------------------------------
+ = Core Administration =
  <!> ["Solr1.3"]
+ 
+ Since ["Solr1.3"], !SolrCore can optionally be managed at runtime.  Additionally, Solr allows multiple !SolrCore instances to run within a single web-app.  The cores can be dynamically managed via the !CoreAdminHandler.  For alternative ways to manage multiple indicies, see MultipleIndexes.
  
  [[TableOfContents]]
  
- = Overview =
- 
- Since ["Solr1.3"], SolrCore can optionally be managed at runtime.  Additionally, Solr allows multiple SolrCore instances to run within a single web-app.  The cores can be dynamically managed via the CoreAdminHandler.  For alternative ways to manage multiple indicies, see MultipleIndexes.
- 
  = Configuration =
  
- To enable multi core support, place a file named ''solr.xml'' in the solr.home 
+ To enable support for dynamic !SolrCore administration, place a file named ''solr.xml'' in the solr.home 
  directory.  Here is an example ''solr.xml'' file:
  {{{
  <solr persistent="true" sharedLib="lib">
@@ -38, +37 @@

  The properties can also be defined in a core's scope (inside the <core> element) in which case they can be used only in that core's scope. If a property by that name already exists in the container scope then it will be overridden.
  
  Besides them, a few properties are automatically added in the core scope. They are:
-  * solr.core.name -- The core's name as defined in solr.xml
+  * `solr.core.name` -- The core's name as defined in solr.xml
-  * solr.core.instanceDir -- The core's instance directory (i.e. the directory under which that core's config and data directory are located)
+  * `solr.core.instanceDir` -- The core's instance directory (i.e. the directory under which that core's `conf/` and `data/` directory are located)
-  * solr.core.configName -- The name of the core's config file (solrconfig.xml by default)
+  * `solr.core.configName` -- The name of the core's config file (solrconfig.xml by default)
-  * solr.core.schemaName -- The name of the core's schema file (schema.xml by default)
+  * `solr.core.schemaName` -- The name of the core's schema file (schema.xml by default)
  
  Such properties can be used inside solrconfig.xml and schema.xml files by specifying an expression with optionally, a default value.
  {{{
@@ -59, +58 @@

  
  == cores ==
  The `<cores>` tag accepts one attribute:
-   *'''adminPath''' - RequestHandler path to access the !CoreAdminHandler for dynamic core manipulation.  For example, adminPath="/admin/cores" configures access via http://localhost:8983/solr/admin/cores.  If this attribute is not specified, dynamic manipulation is unavailable.
+   *'''adminPath''' - Relative path to access the !CoreAdminHandler for dynamic core manipulation.  For example, adminPath="/admin/cores" configures access via http://localhost:8983/solr/admin/cores.  If this attribute is not specified, dynamic manipulation is unavailable.
  
  == core ==
  The `<core>` tag accepts two attributes:
@@ -73, +72 @@

  
  = Example =
  
- Solr ships with an example running two cores together setup.  To run this configuration, start jetty using:
+ Solr ships with an example running two cores together setup.  To run this configuration, start jetty in the `example/` directory using:
  {{{
  java -Dsolr.solr.home=multicore -jar start.jar
  }}}
@@ -93, +92 @@

  
  The !CoreAdminHandler is a special SolrRequestHandler that is used to manage existing cores.
  Unlike normal !SolrRequestHandlers, the !CoreAdminHandler is not attached to a core,
- it is configured in solr.xml.  A single CoreAdminHandler exists for each web-app
+ it is configured in solr.xml.  A single !CoreAdminHandler exists for each web-app
  
  To enable dynamic core configuration, make sure the ''adminPath'' attribute is set in
  solr.xml.  If this attribute is absent, the !CoreAdminHandler will not be available.