About Features Downloads Getting Started Documentation Events Support GitHub

Love VuFind®? Consider becoming a financial supporter. Your support helps build a better VuFind®!

Site Tools


Warning: This page has not been updated in over over a year and may be outdated or deprecated.
legacy:installation:migration_notes

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
legacy:installation:migration_notes [2015/12/11 20:28] – ↷ Links adapted because of a move operation demiankatzlegacy:installation:migration_notes [2015/12/14 16:48] – ↷ Links adapted because of a move operation demiankatz
Line 63: Line 63:
 Check the Solr configuration in the solr directory and the SolrMarc configuration in the import directory.  These are not touched by the upgrade script and will most likely require some manual adjustments. Check the Solr configuration in the solr directory and the SolrMarc configuration in the import directory.  These are not touched by the upgrade script and will most likely require some manual adjustments.
  
-1.4's Solr schema adds several new fields to support [[:hierarchies_and_collections|hierarchies and collections]].  The upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand.+1.4's Solr schema adds several new fields to support [[indexing:hierarchies_and_collections|hierarchies and collections]].  The upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand.
  
-Once you are satisfied with your SolrMarc configuration, it is recommended that you [[:re-indexing|reindex all of your records]].  While the 1.4 schema should be compatible with the 1.3 schema, and both releases use the same Solr version, upgrades are a good time to refresh your index.+Once you are satisfied with your SolrMarc configuration, it is recommended that you [[indexing:re-indexing|reindex all of your records]].  While the 1.4 schema should be compatible with the 1.3 schema, and both releases use the same Solr version, upgrades are a good time to refresh your index.
  
 === Other Configuration Files === === Other Configuration Files ===
Line 73: Line 73:
 === Code and Template Customization === === Code and Template Customization ===
  
-Obviously, if you have customized 1.3's code or templates, these changes will have to be reintegrated with your 1.4 installation.  Most of 1.4's template changes have to do with its new [[:hierarchies_and_collections|hierarchies and collections]] functionality.  Feel free to ask questions on the [[https://lists.sourceforge.net/mailman/listinfo/vufind-tech|vufind-tech]] mailing list if you need help!+Obviously, if you have customized 1.3's code or templates, these changes will have to be reintegrated with your 1.4 installation.  Most of 1.4's template changes have to do with its new [[indexing:hierarchies_and_collections|hierarchies and collections]] functionality.  Feel free to ask questions on the [[https://lists.sourceforge.net/mailman/listinfo/vufind-tech|vufind-tech]] mailing list if you need help!
  
 Remember, if you do a lot of local customizations and find the upgrade process unreasonably tedious, you may be able to make your life easier by using [[legacy:vufind_1.x_developer_manual:subversion#vendor_branching|Subversion Vendor Branching]]. Remember, if you do a lot of local customizations and find the upgrade process unreasonably tedious, you may be able to make your life easier by using [[legacy:vufind_1.x_developer_manual:subversion#vendor_branching|Subversion Vendor Branching]].
Line 133: Line 133:
 1.3's Solr schema has one significant difference from 1.2's (the addition of a publishDateSort field necessitated by changes in Solr 3.x).  The upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand. 1.3's Solr schema has one significant difference from 1.2's (the addition of a publishDateSort field necessitated by changes in Solr 3.x).  The upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand.
  
-Once you are satisfied with your SolrMarc configuration, [[:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run 1.3 with a 1.2-generated index may not work correctly since the new release uses a much newer version of Solr.+Once you are satisfied with your SolrMarc configuration, [[indexing:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run 1.3 with a 1.2-generated index may not work correctly since the new release uses a much newer version of Solr.
  
 === Other Configuration Files === === Other Configuration Files ===
Line 201: Line 201:
 1.2's Solr schema has one minor difference from 1.1's (the addition of the dewey-raw field to aid with call number browsing).  The upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand. 1.2's Solr schema has one minor difference from 1.1's (the addition of the dewey-raw field to aid with call number browsing).  The upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand.
  
-Once you are satisfied with your SolrMarc configuration, [[:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run 1.2 with a 1.1-generated index may not work correctly.+Once you are satisfied with your SolrMarc configuration, [[indexing:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run 1.2 with a 1.1-generated index may not work correctly.
  
 === Other Configuration Files === === Other Configuration Files ===
Line 279: Line 279:
 1.1's Solr schema has some differences from 1.0.x's (to support new features like [[:tracking_record_changes|tracking record changes]], to eliminate some unused legacy fields, and to resolve issues like [[http://vufind.org/jira/browse/VUFIND-259|VUFIND-259]] and [[http://vufind.org/jira/browse/VUFIND-322|VUFIND-322]]).  The upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand. 1.1's Solr schema has some differences from 1.0.x's (to support new features like [[:tracking_record_changes|tracking record changes]], to eliminate some unused legacy fields, and to resolve issues like [[http://vufind.org/jira/browse/VUFIND-259|VUFIND-259]] and [[http://vufind.org/jira/browse/VUFIND-322|VUFIND-322]]).  The upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand.
  
-Once you are satisfied with your SolrMarc configuration, [[:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run 1.1 with a 1.0.x-generated index will not work correctly.+Once you are satisfied with your SolrMarc configuration, [[indexing:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run 1.1 with a 1.0.x-generated index will not work correctly.
  
 === Other Configuration Files === === Other Configuration Files ===
Line 307: Line 307:
 === Automation === === Automation ===
  
-If you want to take advantage of the new [[:alphabetical_heading_browse|alphabetical heading browse]], be aware that you will need to add heading generation to your automated update process in order to keep the browse lists in sync with your index.+If you want to take advantage of the new [[indexing:alphabetical_heading_browse|alphabetical heading browse]], be aware that you will need to add heading generation to your automated update process in order to keep the browse lists in sync with your index.
  
 ===== Upgrading to 1.0.1 ===== ===== Upgrading to 1.0.1 =====
Line 367: Line 367:
 1.0's Solr schema has some differences from RC2's (mainly due to the introduction of [[legacy:vufind_1.x_developer_manual:supporting_a_new_metadata_format|record drivers]]), and the upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand. 1.0's Solr schema has some differences from RC2's (mainly due to the introduction of [[legacy:vufind_1.x_developer_manual:supporting_a_new_metadata_format|record drivers]]), and the upgrade script does not attempt to merge your customizations to the Solr schema or SolrMarc MARC mappings with the new installation.  You will have to do this by hand.
  
-Once you are satisfied with your SolrMarc configuration, [[:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run 1.0 with an RC2-generated index will not work correctly.+Once you are satisfied with your SolrMarc configuration, [[indexing:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run 1.0 with an RC2-generated index will not work correctly.
  
 === Other Configuration Files === === Other Configuration Files ===
Line 437: Line 437:
 Note that the version of SolrMarc included with RC2 is a great deal more configurable than the version in RC1.  You may be able to achieve your old customizations more easily, without the need to build your own customized version of the SolrMarc .jar file.  See the [[:changelog]] for more details on new features. Note that the version of SolrMarc included with RC2 is a great deal more configurable than the version in RC1.  You may be able to achieve your old customizations more easily, without the need to build your own customized version of the SolrMarc .jar file.  See the [[:changelog]] for more details on new features.
  
-Once you are satisfied with your SolrMarc configuration, [[:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run RC2 with an RC1-generated index will not work.+Once you are satisfied with your SolrMarc configuration, [[indexing:re-indexing|REINDEX ALL OF YOUR RECORDS]].  Attempting to run RC2 with an RC1-generated index will not work.
  
 === Code and Template Customization === === Code and Template Customization ===
legacy/installation/migration_notes.txt · Last modified: 2018/12/19 17:03 by demiankatz