X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Finstallation.xml;h=e1c77d341dd5579a4eaaa64fb09759dbfab720ef;hb=8b2d919ca1ab2134c098057bb0965ec7dc42cd9d;hp=a1d5c93574a7a52d85f54b21f85848e4e375f255;hpb=2ae72487ef112b855407623eb4e37d73d1d0b99d;p=idzebra-moved-to-github.git

diff --git a/doc/installation.xml b/doc/installation.xml
index a1d5c93..e1c77d3 100644
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -1,4 +1,4 @@
-<!-- $Id: installation.xml,v 1.22 2006-06-27 12:07:05 marc Exp $ -->
+<!-- $Id: installation.xml,v 1.28 2006-08-14 19:56:50 adam Exp $ -->
  <chapter id="installation">
   <title>Installation</title>
   <para>
@@ -114,7 +114,7 @@
 
   <sect1 id="installation.unix"><title>UNIX</title>
    <para>
-    On Unix, <literal>gcc</literal> works fine, but any native
+    On Unix, GCC works fine, but any native
     C compiler should be possible to use as long as it is 
     ANSI C compliant.
    </para>
@@ -197,7 +197,7 @@
     By default this will install the Zebra executables in 
     <filename>/usr/local/bin</filename>,
     and the standard configuration files in 
-    <filename>/usr/local/share/idzebra</filename>
+    <filename>/usr/local/share/idzebra-2.0</filename>
     You can override this with the <literal>--prefix</literal> option
     to configure.
    </para>
@@ -207,23 +207,23 @@
    <sect2 id="installation.debianlinux"><title>GNU/Debian Linux on
    i686 Platform</title>
     <para>
-     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. 
+     Index Data provides pre-compiled GNU/Debian i686 Linux packages
+     at our Debian package archive, both for
+     the Sarge and the Etch release. 
     </para>
     
     <para>
      To install these packages, you need to add two lines to your
-     <literal>/etc/apt/sources.list</literal> configuration file,
-     either the <literal>Sarge</literal> sources found at
+     <filename>/etc/apt/sources.list</filename> configuration file,
+     either the Sarge sources found at
      <screen>
-      deb http://ftp.indexdata.dk/t/debian sarge main
-      deb-src http://ftp.indexdata.dk/t/debian sarge main
+      deb http://ftp.indexdata.dk/debian sarge main
+      deb-src http://ftp.indexdata.dk/debian sarge main
      </screen>
-     or the <literal>Etch</literal> sources from 
+     or the Etch sources from 
      <screen>
-      deb http://ftp.indexdata.dk/t/debian etch main
-      deb-src http://ftp.indexdata.dk/t/debian etch main
+      deb http://ftp.indexdata.dk/debian etch main
+      deb-src http://ftp.indexdata.dk/debian etch main
      </screen>
      After refreshing the package cache with the command
      <screen>
@@ -233,45 +233,45 @@
      <ulink url="http://indexdata.dk/zebra/">Zebra</ulink> indexer is
      easily installed issuing
      <screen>
-      apt-get install idzebra idzebra-doc
+      apt-get install idzebra-2.0 idzebra-2.0-doc
      </screen>
     </para>
    </sect2>
    
    <sect2 id="installation.debianother">
-    <title>GNU/Debian On Other Platforms</title>
+    <title>Ubuntu/Debian and GNU/Debian on other platforms</title>
     <para>
      These <ulink url="http://indexdata.dk/zebra/">Zebra</ulink>
      packages are specifically compiled for
-     <literal>GNU/Debian Linux</literal> systems. Installation on other 
-     <literal>GNU/Debian</literal> systems is possible by
+     GNU/Debian Linux systems. Installation on other 
+     GNU/Debian systems is possible by
      re-compilation the Debian way: you need to add only the 
      <literal>deb-src</literal> sources lines to the 
-     <literal>/etc/apt/sources.list</literal> configuration file,
-     that is either the <literal>Sarge</literal> sources
+     <filename>/etc/apt/sources.list</filename> configuration file,
+     that is either the Sarge sources
      <screen>
-      deb-src http://ftp.indexdata.dk/t/debian sarge main
+      deb-src http://ftp.indexdata.dk/debian sarge main
      </screen>
-     or the <literal>Etch</literal> sources
+     or the Etch sources
      <screen>
-      deb-src http://ftp.indexdata.dk/t/debian etch main
+      deb-src http://ftp.indexdata.dk/debian etch main
      </screen>
      After refreshing the package cache with the command
      <screen>
       apt-get update
+      apt-get build-dep idzebra-2.0
      </screen>
      as <literal>root</literal>, the 
      <ulink url="http://indexdata.dk/zebra/">Zebra</ulink> indexer is
      recompiled and installed issuing
      <screen>
-      apt-get build-dep idzebra
-      apt-get source --compile idzebra
+      apt-get source --compile idzebra-2.0
      </screen>
      as normal user.
-     The compiled <literal>GNU/Debian</literal> packages can then be
+     The compiled GNU/Debian packages can then be
      installed as <literal>root</literal> issuing
      <screen>
-      dpkg -i install idzebra*.deb idzebra-doc*.deb
+      dpkg -i install idzebra-2.0*.deb libidzebra-2.0*.deb
      </screen>
     </para>
    </sect2>
@@ -431,10 +431,10 @@
     must be changed to 
     <screen>
      # profilePath - where to look for config files
-     profilePath: some/local/path:/usr/share/idzebra2.0/tab
+     profilePath: some/local/path:/usr/share/idzebra-2.0/tab
 
      # modulePath - where to look for loadable zebra modules
-     modulePath: /usr/lib/idzebra2.0/
+     modulePath: /usr/lib/idzebra-2.0/
     </screen>
    </para>
    <para>
@@ -442,8 +442,55 @@
     databases must be re-indexed after upgrade.
    </para>
    <para>
-    Apart from these two changes, no other incompabilities are known.
+    The attribute set defintion files may no longer contain
+    redirection to other fields. 
+    For example the following snippet of
+    a custom <filename>custom/bib1.att</filename> 
+    Bib-1 attribute set definition file is no
+    longer supported:
+    <screen>
+     att 1016            Any 		1016,4,1005,62
+    </screen>
+    and should be changed to 
+    <screen>
+     att 1016            Any
+    </screen>
+   </para>
+   <para>
+    Similar behaviour can be expressed in the new release by defining
+    a new index <literal>Any:w</literal> in all GRS
+    <filename>*.abs</filename> record indexing configuration files.
+    The above example configuration needs to make the changes
+    from version 1.3.x indexing instructions
+    <screen>
+     xelm /*/alternative  Body-of-text:w,Title:s,Title:w
+     xelm /*/title        Body-of-text:w,Title:s,Title:w
+    </screen>
+    to version 2.0.0 indexing instructions
+    <screen>
+     xelm /*/alternative  Any:w,Body-of-text:w,Title:s,Title:w
+     xelm /*/title        Any:w,Body-of-text:w,Title:s,Title:w
+    </screen>
    </para>
+   <para>
+    It is also possible to map the numerical attribute value  
+    <literal>@attr 1=1016</literal> onto another already existing huge
+    index, in this example, one could for example use the mapping
+    <screen>
+     att 1016            Body-of-text
+    </screen>
+    with equivalent outcome without editing all  GRS
+    <filename>*.abs</filename> record indexing configuration files.
+   </para>
+
+   <para>
+    Server installations which use the special
+    <literal>IDXPATH</literal> attribute set must add the following
+    line to the <filename>zebra.cfg</filename> configuration file:
+    <screen>
+     attset: idxpath.att
+    </screen>
+    </para>
   </sect1>
   
  </chapter>