Apache Solr Reference Guide Covering Apache Solr 6.0

Managed Schema Default
When a is not explicitly declared in a solrconfig.xml file, Solr implicitly uses a Manage
dIndexSchemaFactory , which is by default "mutable" and keeps schema information in a managed-schem
a file.
true
managed-schema
If you wish to explicitly configure ManagedIndexSchemaFactory the following options are available:
mutable - controls whether changes may be made to the Schema data. This must be set to true to allow
edits to be made with the Schema API.
managedSchemaResourceName is an optional parameter that defaults to "managed-schema", and
defines a new name for the schema file that can be anything other than " schema.xml".
With the default configuration shown above, you can use the Schema API to modify the schema as much as you
want, and then later change the value of mutable to false if you wish to "lock" the schema in place and prevent
future changes.
Classic schema.xml
An alternative to using a managed schema is to explicitly configure a ClassicIndexSchemaFactory.
Class
icIndexSchemaFactory requires the use of a schema.xml configuration file, and disallows any programatic
changes to the Schema at run time. The schema.xml file must be edited manually and is only loaded only
when the collection is loaded.
Switching from schema.xml to Managed Schema
If you have an existing Solr collection that uses ClassicIndexSchemaFactory, and you wish to convert to
use a managed schema, you can simplify modify the solrconfig.xml to specify the use of the ManagedInde
xSchemaFactory. Once Solr is restarted and it detects that a schema.xml file exists, but the managedSchem
aResourceName file (ie: " managed-schema") does not exist, the existing schema.xml file will be renamed to s
chema.xml.bak and the contents are re-written to the managed schema file. If you look at the resulting file,
you'll see this at the top of the page:
You are now free to use the Schema API as much as you want to make changes, and remove the schema.xml
.bak.
Changing to Manually Edited schema.xml
If you have started Solr with managed schema enabled and you would like to switch to manually editing a sche
ma.xml file, you should take the following steps:
Apache Solr Reference Guide 6.0
439