Created in: 2007-06-26 23:45:17
Author: martin
Size: 4700 bytes
Last updated: 2007-06-26 23:45:17
There isn't related documents
This guide will describe the required process to migrate from previous jLibrary verisons to more recent versions.
jLibrary will automatically adapt your repositories from 1.0.x versions to 1.1. Basically the only thing you have to do is to export your repositories and import them back in jLibrary 1.1
jLibrary 1.0.1 is a bugfix release and so the process to update from 1.0 to 1.0.1 is very easy as you will see. Obviously, even though the update process does not should give you any problems, you should make an information backup before doing the migration.
I have bad news here. jLibrary 1.0.1 remote server is not compatible with jLibrary 1.0. This is due to a problem on the web services performance that have been fixed on the 1.0.1 and that forced me to change some of the web services interface. So, you won't be able to connect from a jLibrary 1.0 client to a jLibrary 1.0.1 server and also the opposite. So you must ensure to update the client and the server packages.
If you have installed the jLibrary 1.0 standalone server, then you have two different possibilities for upgrading the system:
On both cases, if you have touched some configuration files on the webapp application you should overwrite the new files with your customized ones, because the 1.0.1 version comes with the default configuration.
Easier but advanced installationThere is another very easy way to update the jLibrary server but it's a little advanced, so I have separated it from the standard update paths. jLibrary 1.0.1 only changes a few .jar files: the jlibrary server jar file, the Apache Derby jar file and the Apache Jackrabbit jar file. So, another easy way to update your application is to copy the changed jar files into your current deployment. There shouldn't be any problem doing this, but remember to make a backup :-)
To update the jLibrary client you must first uninstall the previous jLibrary installation, and install the new 1.0.1 jLibrary client. If you have data on your local repository, then remember to use the same local repository data location when running jLibrary 1.0.1 the first time.
Currently, jLibrary 1.0 client and server are only compatible between each other. This means that you cannot use a jLibrary 1.0b4 client to access to a jLibrary 1.0 server, or a jLibrary 1.0 client to access to a jLibrary 1.0b4 server.
But, don't worry, jLibrary provides a very easy to use migration system, that would help you to move your old repositories to your new system practically without any effort. You only must follow the following steps:
And that's all! Very easy, isn't it? Note that on the backgrounds jLibrary is doing extensive process work on the repository data, and also converting old data models to new data models. If you combine this fact with a huge repository you will obtain that maybe you have to wait some minutes to get the data imported.
If you have some problems, leave a message on the forums or mailing lists.