Config Templates

Configs can be declared as immutable, which means they cannot be deleted or have their Schema updated by the Schema API. Immutable configs are uneditable config templates that are the basis for additional configs. After a config is made immutable, you cannot change it back without accessing ZooKeeper directly as the solr (or solr@EXAMPLE.COM principal, if you are using Kerberos) super user.

Solr provides a set of immutable config templates. These templates are only available after Solr initialization, so templates are not available in upgrades until after Solr is initialized or re-initialized. Templates include:

Table 1. Available Config Templates and Attributes
Template Name Supports Schema API Uses Schemaless Solr
managedTemplate Feature Present Feature Absent
schemalessTemplate Feature Present Feature Present

Config templates are managed using the solrctl config command. For example:

  • To create a new config based on the managedTemplate template:
    solrctl config --create <newConfig> managedTemplate -p immutable=false
  • To create a new template (immutable config) from an existing config:
    solrctl config --create <newTemplate> <existingConfig> -p immutable=true