home *** CD-ROM | disk | FTP | other *** search
/ linuxmafia.com 2016 / linuxmafia.com.tar / linuxmafia.com / pub / linux / gale / install.xml < prev    next >
Text File  |  2000-11-12  |  8KB  |  99 lines
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
  2. <html><head><title>Gale Installing</title><link href="../style.css"
  3. rel="stylesheet" type="text/css"></head><body><div><span
  4. class="header">gale.org</span><br><span class="navigation"><a
  5. href="../index.xml">Home</a> > <a
  6. href="../docs.xml">Documentation</a> > <a
  7. href="index.xml">for Administrators</a> > <b>Installing</b> > <a
  8. href="../download.xml">Download</a>^</span><br></div><hr><h1><a name="Gale Installation Instructions"></a>Gale Installation Instructions</h1><p>For the most part, installing Gale is a matter of building the binaries 
  9.   and getting them in the right places.  The exception is the authentication 
  10.   system, which requires a certain amount of finicky setup -- including setuid 
  11.  
  12.   binaries -- to do its job correctly and securely.</p><p><b>First</b>, <a href="../download.xml">download the Gale 
  13.   source code</a> and unpack it.  It should create a directory named
  14.   "gale-(version)", where (version) is the version number you downloaded.
  15.   (We'll refer to this directory as "gale".)</p><hr><h1><a name="Fetching Required Libraries"></a>Fetching Required Libraries</h1><p><b>Second</b>, make sure you have some libraries Gale depends 
  16.   on:</p><div class="subsection-title"><b><a name="RSAREF"></a><a
  17. href="http://download.gale.org/rsaref20.tar.Z">RSAREF</a></b></div><div class="titled-subsection">
  18.     <p>Get the RSAREF library.  Unpack the rsaref20.tar.Z file in the 
  19.     "gale/rsaref" directory.  The configuration and build process will 
  20.     automatically detect its presence, build it and link with it.  This will 
  21.     only work with the "genuine" RSAREF.</p>
  22.  
  23.     <p>Alternatively, you can build the library (or a workalike) yourself.
  24.     If you do, install librsaref.a and the RSAREF headers into system lib and 
  25.     include directories; remember where you put them for the next step.</p>
  26.   </div><div class="subsection-title"><b><a
  27. name="The Boehm conservative garbage collector"></a><a
  28. href="http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc.tar.gz">The Boehm conservative garbage collector</a></b></div><div class="titled-subsection">
  29.     <p>Unpack the tarball in the "gale" directory; it will expand into 
  30.     "gale/gc".</p>
  31.  
  32.     <p>You may alternatively build and install it yourself elsewhere.  If 
  33.     so, make sure you know where to find libgc.a and gc.h.</p>
  34.   </div><div class="subsection-title"><b><a
  35. name="Ian Jackson's asynchronous DNS library (ADNS)"></a><a
  36. href="http://www.chiark.greenend.org.uk/~ian/adns/adns.tar.gz">Ian Jackson's asynchronous DNS library (ADNS)</a></b></div><div class="titled-subsection">
  37.     <p>ADNS is now required for Gale.  Follow the included directions to
  38.     configure and install this library.  Make sure you know where adns.h and 
  39.     libadns.* are.</p>
  40.  
  41.     <p><b>** Use version 0.9 or newer! **</b>
  42.     At the time of this writing, the only known working versions are 0.5
  43.     and 0.9.  Versions 0.4, 0.6, 0.7 and 0.8 don't work.
  44.     Versions after 0.9 should also work (try it and see!).</p>
  45.   </div><div class="subsection-title"><b><a
  46. name="Unicode conversion library (iconv)"></a><a
  47. href="http://clisp.cons.org/~haible/packages-libiconv.html">Unicode conversion library (iconv)</a></b></div><div class="titled-subsection">
  48.     <p>Gale requires the Unix98 standard iconv(3) functions to perform
  49.     Unicode character set translation.  However, some operating systems do 
  50.     not yet provide this function, or do not provide a sufficiently powerful 
  51.     version.  To use Unicode character sets on these systems, you will need 
  52.     to install <a href="http://clisp.cons.org/~haible/packages-libiconv.html">Bruno Haible's 
  53.     libiconv</a>.  The GNU libc 2.1 iconv is broken, but GNU libc 2.2 
  54.     will work.</p>
  55.  
  56.     <p>Without these functions, Gale will still work, but I/O will be 
  57.     limited to the ASCII character set.  (This is perfectly sufficient for 
  58.     many English-speaking users.)</p>
  59.   </div><hr><h1><a name="Configuration"></a>Configuration</h1><p><b>Third</b>, get ready to run the provided "configure"
  60.   script.  The typical "configure" options (--prefix etc.) apply; run 
  61.   "sh configure --help" for usage information.</p><p>The gzgw (Gale/Zephyr gateway) is not built by default.  To enable it, 
  62.   use the --enable-gzgw flag to "configure".  If you do this, make sure 
  63.   "configure" can find the Zephyr libraries and headers by using the proper 
  64.   -L and -I flags (if necessary) in the LDFLAGS and CPPFLAGS environment 
  65.   variables, respectively.</p><p>If you want to use a preinstalled RSAREF library, include the 
  66.   appropriate flags in LDFLAGS and CPPFLAGS so "configure" can find librsaref.a
  67.   and the RSAREF headers (rsaref.h etc).  (Don't worry about this if you've 
  68.   unpacked rsaref20.tar.Z into gale/rsaref as directed in the second 
  69.   step.)</p><p>Similarly, if you want to use a preinstalled Boehm GC library, make 
  70.   sure LDFLAGS and CPPFLAGS include the location of libgc.a and gc.h, 
  71.   respectively.  ADNS, libiconv, and any other required libraries must also 
  72.   be available via these paths.</p><p>By default and where supported, Gale will install static and shared 
  73.   libraries, and install binaries linked against shared libraries.  You may 
  74.   use --disable-shared or --disable-static to modify this behavior.</p><p>Once you've figured out the right options and set the right environment 
  75.   variables, <b>run the script</b>.</p><hr><h1><a name="Compiling"></a>Compiling</h1><p><b>Fourth, run "make"</b> in the top-level Gale directory.  
  76.   With luck, this will build everything without incident.  If not, now you 
  77.   get to figure out what went wrong and why; enjoy!  Feel free to 
  78.   <a href="mailto:egnor-gale.org@ofb.net">contact me</a> with 
  79.   questions and patches.  Many architectures are currently unsupported, but 
  80.   the changes are typically not too painful.</p><p>Then become a user (eg. "root") which has permission to write 
  81.   (and create, if necessary) the install directories (/usr/local/..., unless 
  82.   you specified otherwise).  <b>Run "make install"</b> from the 
  83.   top-level "gale" directory; this should install the Gale binaries, libraries,
  84.   and header files.</p><p>Make sure the installed binaries are on the PATH for future 
  85.   steps!</p><hr><h1><a name="Final Setup"></a>Final Setup</h1><p><b>Fifth, run the "gale-install" script</b> that was installed 
  86.   by "make install".  This may ask questions if it can't find a previous 
  87.   configuration.  Feel free to interrupt and re-start it at any point.</p><p>Finally, if you have not already set up your domain, you need to do so.
  88.   Become the "gale user" selected in the last step and run "gale-install" 
  89.   again.  Follow the directions; these will involve sending your key to the 
  90.   proper authority to get it signed.  I manage ROOT and most "top-level" 
  91.   domains (.edu, .com, .org, .nu, .ml.org, etc.) for now.  
  92.   <a href="mailto:egnor-gale.org@ofb.net">When in doubt, ask 
  93.   me</a>.</p><hr><h1><a name="Happy Puffing!"></a>Happy Puffing!</h1><p>Enjoy your new installation; you may find the
  94. <a href="../users">user documentation</a> useful.  
  95. If you have any problems, feel free to
  96. <a href="mailto:egnor-gale.org@ofb.net">send me e-mail</a>.</p><hr></body></html>
  97.  
  98. <!-- This page was served in 191 milliseconds by Cocoon 1.7.4 -->
  99.