Difference between revisions of "Migration"

From EPrints Documentation
Redirect page
Jump to: navigation, search
(Import the data)
(Redirected page to Moving a repository)
 
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
#REDIRECT [[Moving a repository]]
 +
 +
[[Category:Management]]
 
This page covers how to migrate from EPrints 2 to EPrints 3.
 
This page covers how to migrate from EPrints 2 to EPrints 3.
  
Line 34: Line 37:
  
 
This script exports the data from your EPrints 2 repostory in a format which can be imported by EPrints 3.
 
This script exports the data from your EPrints 2 repostory in a format which can be imported by EPrints 3.
 +
 +
There have been some problems with exporting non Latin characters (e.g. letters with accents).  If you have any problems, these can probably be solved by editing the export3data script and adding the following line (put it just under the first line).
 +
 +
  use encoding 'utf8';
  
 
To export the data do the following:
 
To export the data do the following:
Line 42: Line 49:
  
 
eprints.xml references the full paths of the files in EPrints 2. If your EPrints 3 is on a different machine you'll need to either make sure they are the same on the new machine or do a big search-and-replace on eprints.xml!
 
eprints.xml references the full paths of the files in EPrints 2. If your EPrints 3 is on a different machine you'll need to either make sure they are the same on the new machine or do a big search-and-replace on eprints.xml!
 +
 +
If the script has any problems, run with the 'skiplog' argument:
 +
 +
  export3data.pl --skiplog errors.txt ARCHIVEID eprints > eprints.xml
 +
 +
Any items with problems will be ignored, but the ids of them will be recorded in the 'errors.txt' file.  Export these by hand if they are important.
  
 
=== Importing ===
 
=== Importing ===
Line 98: Line 111:
  
 
FIX: do them by hand at the end.
 
FIX: do them by hand at the end.
 +
 +
=== Warning messages about "hideemail" ===
 +
 +
hideemail was introduced in a version of EPrints 2 (I forget which). Earlier repositories may not have this field. Some of the EPrints 3 default config files assume it exists (user_fields_default.pl and user_render.pl).
 +
 +
FIX 1: Don't worry about it.
 +
 +
FIX 2: Before importing users.xml, add the hideemail field back into user_fields.pl
 +
          {
 +
            'name' => 'hideemail',
 +
            'input_style' => 'radio',
 +
            'type' => 'boolean',
 +
          },
 +
 +
=== Error missing field: X ===
 +
 +
The default EPrints 3 config. may reference a field not imported. If so you can almost always just remove the offending section of configuration. Examples: searches, citations, views.
 +
 +
=== Problems with bad characters in eprints.xml ===
 +
 +
This is not tested, but I think this should clean it up...
 +
iconv -c eprints.xml --output=eprints_cleaned.xml -f utf-8 -t utf-8
 +
 +
=== Warning about Pagerange ===
 +
 +
Argument "" isn't numeric in addition (+) at
 +
  /opt/eprints3/perl_lib/EPrints/MetaField/Pagerange.pm line 182.
 +
 +
This is a warning that is caused by having non-numeric data in the pagerange field. eg. "iii-xi".
 +
 +
FIX: Don't worry about it.
 +
 +
=== Can't import files which contain "/" ===
 +
 +
eg if your document had index.html and images/dia.jpg
 +
 +
FIX: Make a note of the offenders, and just add those documents by hand.
 +
 +
FIX2: Bug chris to add this to fix this in the final release of 3.0.2 (it's not in beta-1)

Latest revision as of 14:44, 18 May 2012