from 1.1 to 1.2-alpha

I. Emilda Directory, Database

Always make a backup of your database before upgrading!

The easiest way to upgrade the Emilda source is probably to move the old directory to a backup location, install the new source from the tarball and copy over required files from the old installation. Here's an example:

mv emilda emilda-1.1
tar -zxf emilda-1.2-alpha.tar.gz
mv emilda-1.2-alpha/src emilda
cp emilda-1.1/config emilda/
cp -a emilda-1.1/perl/barcodes/* emilda/perl/barcodes/

Also copy/move over any other files/directories you may have in the old emilda dir that didn't come with the original tarball. If you have the Zebra database in the emilda-1.1 directory, move it to the new emilda directory.

Now point your Internet browser to http://your-old-emilda-address/setup.php and follow the on-screen instructions. After a successful setup your Emilda database will have been converted to the right version. Now you should edit config in the Emilda directory and remove everything except the MySQL section, as the rest is in the database now. Remember to disallow access to setup.php after completing the installation!

Note: MARC configuration has been moved to the database also but setup.php won't convert any changes you might have made to the old MARC_config file. After a successful upgrade you should log in to Emilda and modify MARC settings from the configuration panel if you made any changes to the old file.

II. Zebra

Upgrading Zebra is almost identical to when installing a new Emilda environment. To ensure that all files that have been updated are present on your system, we encourage you to download this tarball, and operate as follows.

1. Move your existing zebra folder to another location, but be sure not to delete it yet as this would result in you loosing all your records.
2. Extract the tarball to the same location where you had the old one, with the same name and same permissions.
3. Copy your records folder (typically records/) from your old zebra folder. If you have made any custom changes to your Emilda instance, you probably are so familiar with Zebra that you will figure out which files you need to restore from your old folder to be able to use those changes. Just make sure that also the "new" issues released will be taken into consideration. Now you can theoretically delete your old zebra folder, but it might be a good idea to hold on to it until you are certain that everything works.
4. Initialize and update your new Zebra instance by issuing the following set of commands:

   1. Go into the Zebra root folder: "cd /path/to/emilda/zebra/
   2. Init Zebra: "zebraidx init"
   3. Index the records/ folder: "zebraidx -g emilda update records"
   4. Commit results into shadow: "zebraidx commit"
   5. Start the zebrasrv-process: "zebrasrv -l /path/to/log @:9999"

   As you might notice the syntax has slightly changed, so if you have any scripts or similar that run Zebra at startup it might be a good idea to make these compatible with the new system.