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.
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
installation:migration_notes [2017/07/19 13:09] – [Step-by-Step] demiankatzinstallation:migration_notes [2018/12/19 17:03] – [VuFind Migration Notes] demiankatz
Line 2: Line 2:
  
 This page provides notes on upgrading to the latest VuFind release from earlier versions. This page provides notes on upgrading to the latest VuFind release from earlier versions.
- 
-// Notes on upgrading to the latest VuFind 1.x can be found on the [[legacy:installation:migration_notes|legacy migration notes]] page. // 
  
 ===== Migrating from VuFind 2.x or Newer to the Latest Release ===== ===== Migrating from VuFind 2.x or Newer to the Latest Release =====
Line 19: Line 17:
   - Unpack the new version of VuFind on top of the old version. This will most commonly involve simply downloading the new version, but if you are using Git for version control, it can also be achieved by checking out or merging a different version tag.   - Unpack the new version of VuFind on top of the old version. This will most commonly involve simply downloading the new version, but if you are using Git for version control, it can also be achieved by checking out or merging a different version tag.
     - :!: If you are simply downloading the new version rather than using Git, it is safer to delete non-customized files before unpacking, to ensure that obsolete files do not remain as part of your installation -- this is particularly important for the solr/vendor directory.     - :!: If you are simply downloading the new version rather than using Git, it is safer to delete non-customized files before unpacking, to ensure that obsolete files do not remain as part of your installation -- this is particularly important for the solr/vendor directory.
-  - Run "composer install" to update dependencies.+  - If you are installing from Git rather than a downloaded archive, run "composer install" to update dependencies.
   - Make sure that the config/vufind subdirectory of your [[configuration:local_settings_directory|local settings directory]] may be written by the web server and that autoConfigure is turned on in the [System] section of [[configuration:files:config.ini]].   - Make sure that the config/vufind subdirectory of your [[configuration:local_settings_directory|local settings directory]] may be written by the web server and that autoConfigure is turned on in the [System] section of [[configuration:files:config.ini]].
   - Empty out the cache subdirectory of your [[configuration:local_settings_directory|local settings directory]] to be sure no incompatible settings are cached.   - Empty out the cache subdirectory of your [[configuration:local_settings_directory|local settings directory]] to be sure no incompatible settings are cached.
Line 34: Line 32:
 :!: If you upgrade by reinstalling the DEB package instead of simply unpacking a .zip or .tar.gz archive, be aware that some defaults (particularly in local/httpd-vufind.conf) may be restored. As with other configuration overwriting, backup files should exist that may be easily compared/restored if this causes problems. :!: If you upgrade by reinstalling the DEB package instead of simply unpacking a .zip or .tar.gz archive, be aware that some defaults (particularly in local/httpd-vufind.conf) may be restored. As with other configuration overwriting, backup files should exist that may be easily compared/restored if this causes problems.
  
-Note that Java 1.7 is required starting with VuFind 2.3.+:!: Make sure that your system meets the [[installation:requirements|requirements]] of the new version.
  
 === Special Notes on Upgrading with PostgreSQL === === Special Notes on Upgrading with PostgreSQL ===
installation/migration_notes.txt · Last modified: 2024/02/07 15:47 by demiankatz