You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by "Steve Rowe (Confluence)" <co...@apache.org> on 2013/10/05 14:13:00 UTC

[CONF] Apache Solr Reference Guide > Upgrading Solr

Space: Apache Solr Reference Guide (https://cwiki.apache.org/confluence/display/solr)
Page: Upgrading Solr (https://cwiki.apache.org/confluence/display/solr/Upgrading+Solr)

Change Comment:
---------------------------------------------------------------------
4.5->4.6

Edited by Steve Rowe:
---------------------------------------------------------------------
If you are already using Solr 4.5, Solr 4.6 should not present any major problems. However, you should review the [{{CHANGES.txt}}|http://lucene.apache.org/solr/4_6_0/changes/Changes.html] file found in your Solr package for changes and updates that may effect your existing implementation.

h2. Upgrading from 4.5.x

* The "file" attribute of infoStream in {{solrconfig.xml}} is removed. Control this via your logging configuration (org.apache.solr.update.LoggingInfoStream) instead.
* UniqFieldsUpdateProcessorFactory no longer supports the <lst named="fields"> init param style that was deprecated in Solr 4.5.  If you are still using this syntax, update your configs to use <arr name="fieldName"> instead. See [SOLR-4249|https://issues.apache.org/jira/browse/SOLR-4249] for more details.

h2. Upgrading from Older Versions of Solr

This is a summary of some of the key issues related to upgrading in previous versions of Solr.  Users upgrading from older versions are strongly encouraged to consult {{CHANGES.txt}} for the details of all changes since the version they are upgrading from.

* In Solr 4.5, XML configuration parsing was made more strict about situations where a single setting is allowed but multiple values are found.  Configuration parsing now fails with an error in situations like this.  Also, {{schema.xml}} parsing was also made more strict: "default" or "required" options specified on {{<dynamicField/>}} declarations will cause an init error.  You can safely remove these attributes.
* In Solr 4.5, {{CloudSolrServer}} can now use multiple threads to add documents by default. This is a small change in runtime semantics when using the bulk add method - you will still end up with the same exception on a failure, but some documents beyond the one that failed may have made it in. To get the old, single threaded behavior, set parallel updates to false on the {{CloudSolrServer}} instance.  
* Beginning with 4.4, the use of the Compound File Format is determined by IndexWriter configuration, and not the Merge Policy.  If you have explicitly configured a {{<mergePolicy>}} with the {{setUseCompoundFile}} configuration option, you should changed this to [use the {{useCompoundFile}} configuration option directly in the {{<indexConfig>}} block|IndexConfig in SolrConfig].  Specifying {{setUseCompoundFile}} on the Merge Policy will no longer work in Solr 5.0.
* In Solr 4.4, {{ByteField}} and {{ShortField}} were deprecated, and will be removed in 5.0.  Please switch to using {{TrieIntField}}
* The pre-4.3.0 {{solr.xml}} "legacy" mode and format will no longer be supported in Solr 5.0.  Users are encouraged to migrate from "legacy" to "discovery" {{solr.xml}} configurations, see [Solr Cores and solr.xml].
* As of Solr 4.3 the slf4j/logging jars are no longer included in the Solr webapp to allow for more flexibility in logging.
* Minor changes were made to the Schema API response format in Solr 4.3
* In Solr 4.1 the method Solr uses to identify node names for SolrCloud was changed.  If you are using SolrCloud and upgrading from Solr 4.0, you may have issues with unknown or lost nodes. If this occurs, you can manually set the {{host}} parameter either in {{solr.xml}} or as a system variable. More information can be found in the section on [SolrCloud].
* If you are upgrading from Solr 3.x, you should familiarize yourself with the [Major Changes from Solr 3 to Solr 4]. 


{scrollbar}


Stop watching space: https://cwiki.apache.org/confluence/users/removespacenotification.action?spaceKey=solr
Change email notification preferences: https://cwiki.apache.org/confluence/users/editmyemailsettings.action