upgrade instructions from Zewbra 1.3

[idzebra-moved-to-github.git] / doc / installation.xml

diff --git a/doc/installation.xml b/doc/installation.xml
index d4bc6fd..a1d5c93 100644 (file)
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -1,4 +1,4 @@
-<!-- $Id: installation.xml,v 1.16 2006-01-17 12:06:53 marc Exp $ -->
+<!-- $Id: installation.xml,v 1.22 2006-06-27 12:07:05 marc Exp $ -->
  <chapter id="installation">
   <title>Installation</title>
   <para>
@@ -32,7 +32,7 @@
       (required)</term>
      <listitem>
       <para>
-       Zebra uses YAZ to support Z39.50/SRW. Also the memory management
+       Zebra uses YAZ to support Z39.50/ <ulink url="http://www.loc.gov/standards/sru/srw/">SRW</ulink>. Also the memory management
        utilites from YAZ is used by Zebra.
       </para>
      </listitem>
@@ -204,9 +204,10 @@
   </sect1>
 
   <sect1 id="installation.debian"><title>GNU/Debian</title>
-   <sect2 id="installation.debianlinux"><title>GNU/Debian Linux</title>
+   <sect2 id="installation.debianlinux"><title>GNU/Debian Linux on
+   i686 Platform</title>
     <para>
-     Index Data provides pre-compiled <literal>GNU/Debian
+     Index Data provides pre-compiled <literal>GNU/Debian i686
       Linux</literal> packages at our Debian package archive, both for
      the <literal>Sarge</literal> and the <literal>Etch</literal> release. 
     </para>
@@ -216,13 +217,13 @@
      <literal>/etc/apt/sources.list</literal> configuration file,
      either the <literal>Sarge</literal> sources found at
      <screen>
-      deb http://www.indexdata.dk/debian indexdata/sarge released
-      deb-src http://www.indexdata.dk/debian indexdata/sarge released
+      deb http://ftp.indexdata.dk/t/debian sarge main
+      deb-src http://ftp.indexdata.dk/t/debian sarge main
      </screen>
      or the <literal>Etch</literal> sources from 
      <screen>
-      deb http://www.indexdata.dk/debian indexdata/etch released
-      deb-src http://www.indexdata.dk/debian indexdata/etch released
+      deb http://ftp.indexdata.dk/t/debian etch main
+      deb-src http://ftp.indexdata.dk/t/debian etch main
      </screen>
      After refreshing the package cache with the command
      <screen>
@@ -249,11 +250,11 @@
      <literal>/etc/apt/sources.list</literal> configuration file,
      that is either the <literal>Sarge</literal> sources
      <screen>
-      deb-src http://www.indexdata.dk/debian indexdata/sarge released
+      deb-src http://ftp.indexdata.dk/t/debian sarge main
      </screen>
      or the <literal>Etch</literal> sources
      <screen>
-      deb-src http://www.indexdata.dk/debian indexdata/etch released
+      deb-src http://ftp.indexdata.dk/t/debian etch main
      </screen>
      After refreshing the package cache with the command
      <screen>
@@ -326,8 +327,8 @@
        <literal>EXPAT_DIR</literal></term>
       <listitem><para>
         If <literal>HAVE_EXPAT</literal> is set to 1, Zebra is compiled
-        with Expat support. In this configuration, set 
-        <literal>ZEBRA_DIR</literal> to the Expat source directory.
+        with <ulink url="http://expat.sourceforge.net/">Expat</ulink> support. In this configuration, set 
+        <literal>ZEBRA_DIR</literal> to the <ulink url="http://expat.sourceforge.net/">Expat</ulink> source directory.
        Windows version of Expat can be downloaded from
        <ulink url="http://sourceforge.net/projects/expat/">
         SourceForge
@@ -415,6 +416,35 @@
    </para>
   </sect1>
 
+
+  <sect1 id="installation-upgrade">
+   <title>Upgrading from Zebra version 1.3.x</title>
+   <para>
+    Zebra's installation directories have changed a bit. In addition,
+    the new loadable modules must be defined in the 
+    master <filename>zebra.cfg</filename> configuration file. The old
+    version 1.3.x configuration options
+    <screen>
+     # profilePath - where to look for config files
+     profilePath: some/local/path:/usr/share/idzebra/tab
+    </screen>
+    must be changed to 
+    <screen>
+     # profilePath - where to look for config files
+     profilePath: some/local/path:/usr/share/idzebra2.0/tab
+
+     # modulePath - where to look for loadable zebra modules
+     modulePath: /usr/lib/idzebra2.0/
+    </screen>
+   </para>
+   <para>
+    The internal binary register structures have changed; all Zebra
+    databases must be re-indexed after upgrade.
+   </para>
+   <para>
+    Apart from these two changes, no other incompabilities are known.
+   </para>
+  </sect1>
   
  </chapter>
  <!-- Keep this comment at the end of the file