I. SYSTEM REQUIREMENTS

  1. INN will not install nor run on Sun SPARCstation under
     plain Solaris 1.1  or 2.x unless you install some
     additional software packages and utilities
     (fortunately, they are free).  Also, your machine's IP
     number (of the news server) has to be entered in a
     Domain Name Service database (DNS) to be resolvable.
     Ask your Network Administrator about DNS or read the
     O'Reilly & Associates, Inc. book: "DNS and BIND" by Paul
     Albitz & Cricket Liu, ISBN 1-56592-010-4.
     
     Further, test the resolver on your machine by
     pinging a hostname not entered in your /etc/hosts file.
     For example, type: 
      "ping ftp.uu.net"
     The response should be: "ftp.uu.net is alive".

     If you get: "unknown host ftp.uu.net", consult the
     O'Reilly's book.

     (Solaris 2.x - the most common problem with DNS 
     results from not switching on DNS support.  Check
     the line "hosts:" in the /etc/nsswitch.conf file.
     It should read: "hosts:   files dns").
   
  2. Be sure to su to root before performing tasks
     outlined below.  Next, check if you have a directory
     /usr/local and about 90 Mb of space in the partition
     where this directory is located.  Create directories:
     /usr/local/bin, /usr/local/lib and /usr/local/man if
     you do not have them.  Add /usr/local/bin to your path
     and /usr/local/man to your MANPATH.  On Solaris 2.x,
     create /opt/local tree and make a symbolic link
     from /usr ("ln -s /opt/local /usr/local").
         
  3. INN uses gnu versions of grep, awk and sed.  Moreover,
     it is  recommended to compile INN with the gnu
     versions of make and the gnu gcc compiler instead of
     the Sun's Solaris 1.x unbundled cc compiler. (C
     compiler is not included with Solaris 2.x.  The cc in
     /usr/ucb is bad.  Be sure to remove it from path.)  If you
     don't have the gnu software package, create a directory
     /usr/local/gnu, cd to this directory and ftp to
     prep.ai.mit.edu (18.71.0.38). Go to directory /pub/gnu
     and get the newest version of the following programs:

      bison      bison-x.x.tar.gz    
      flex       flex-x.x.x.tar.gz 
      gawk       gawk-x.x.x.tar.gz
      gcc        gcc-x.x.x.tar.gz
      grep       grep-x.x.tar.gz
      gzip       gzip-x.x.x.tar (Note: no .gz)
      make       make-x.x.tar.gz
      patch	 patch-x.x.tar.gz
      perl	 perl-x.x.tar.gz
      sed        sed-x.x.tar.gz
      tar        tar-x.x.x.tar.gz
      texinfo    texinfo-x.x.tar.gz

     Installation of these programs is not complicated,
     and is really beneficial both for Solaris 1.x and
     Solaris 2.x users.  After you complete the
     installation, check if older versions of these programs
     are not present somewhere in your path.  Delete or
     rename these old versions.

     Solaris 2.x: First, after connecting through ftp
     to prep.ai.mit.edu, cd to directory:
       /pub/gnu/sparc-sun-solaris2
     and get the file INSTALL.gcc.  Follow the instructions
     for installing binaries for gcc and gzip (installed
     in /opt/gnu).  Next, follow the instructions for
     Solaris 1.1, but read the doc file for gcc-x.x.x.
     To avoid problems, rename /usr/ucb/cc to something 
     else, or remove it from path.  Make a symbolic link
     in the /opt/gnu/bin directory from gcc to cc.    
	When you finish the installation, the new utilities
     will be installed in the /usr/local tree.  Delete and
     remove from path the /opt/gnu tree.  As the binaries
     you downloaded are pretty old, it is advisable to
     start with the new gcc and to compile all the
     gnu utilities with this new gcc.  NOTE: it makes
     no difference, if you install gnu stuff in /opt/gnu
     or in /usr/local.  The installation scripts for gnu
     utilities default to the /usr/local directory tree,
     so I find it simple to use this path.  Whatever
     you do, be sure to have the gnu utilities in
     your path before /usr/bin and /usr/ccs/bin.

     Solaris 2.x: be sure to include /usr/ccs/bin
     and /usr/ccs/lib in your path.  Important
     utilities (e.g. - ar, cpp) are located there.
     Please note, that the /usr/ccs stuff is only
     installed, when you do a full install of Solaris.
     If you do not have e.g. - /usr/ccs/bin/ar, re-install
     Solaris 2.x!

   a. Start with gzip.  In /usr/local/gnu type:
      "tar xvf gzip-x.x.x.tar".  A directory gzip-x.x.x will
      be created.  Change to this directory and type:
      "sh ./configure".  Next, edit the Makefile
      with the vi editor and change the line starting with
      "CC" to read: "CC = cc". Then, type: "make".
      Compilation should complete without errors.  Finally,
      type: "make install" to complete installation of gzip,
      gunzip, and other utilities in /usr/local/bin.     
  
   b. Compile and install texinfo - info, makeinfo, the GNU
      hypertext system.  Makeinfo is needed for error-free
      installation of many GNU programs and utilities.
      In /usr/local/gnu type: "gunzip texinfo-x.x.tar.gz".
      Next, type: "tar xvf texinfo-x.x.tar".  A directory
      texinfo-x.x will be created.  Cd to this directory
      and type: "sh ./configure".  Next, edit the Makefile
      as described above for gzip.  Now, type: "make"
      and ignore any non-fatal errors.  Finally, type:
      "make install".  With newer versions of texinfo,
      you will get a lot of messages about "emacs",
      "*.elc", and "*.el" files.  Just ignore these
      messages.
 
   c. Installation of the gnu version of tar is
      beneficial.  You will be able to use
      "tar -Zxvf <file name>.tar.Z" or
      "tar -zxvf <file name>.tar.gz" to uncompress
      and untar files in one step.  Uncompress, compile
      and install tar as above.  Be sure that /usr/local/bin
      is the first directory in your path.

   d. Uncompress, compile and install gnu make.  Follow the
      steps described for texinfo.  Gnu make will install in
      /usr/local/bin.  To disable Sun's make, cd to /usr/bin
      (/usr/ccs/bin for Solaris 2.x) and type:
       
       "mv make make.sun".

   e. Compile and install bison following the procedure
      described for texinfo.

   f. Uncompress gcc.  Cd to /usr/local/gnu/gcc-x.x.x and
      type:

         sh ./configure

      Next type:
        make
      This step will take about 17 minutes to complete.
      Ignore warnings reported for insn-emit.c.  Next, type:
        make stage1
      Ignore reported non-fatal errors.  Next, type:
        make CC="stage1/xgcc -Bstage1/" CFLAGS="-g -O"
      This step will take about 19 minutes to complete.
      Next, type:
        make stage2
      Ignore reported non-fatal errors.  Next, type:
        make CC="stage2/xgcc -Bstage2/" CFLAGS="-g -O"
      In this step, which lasts about 13 minutes, you will
      make the final stage 3 compiler.  Now type: "make
      compare". No errors should be reported here.  Finally,
      type:
        make install CC="stage2/xgcc -Bstage2/" CFLAGS="-g\
        -O"
      (NOTE: backslash "\" is used in this FAQ to break the
      line for formatting purposes.  You can use the 
      backslash for the same purpose in a command line.
      Please read Sun documentation, if you need more
      information.) 
      to install the gcc compiler.  It is advisable to
      recompile patch, gzip, texinfo, make and bison with
      gcc.  It will be a good test for proper gcc
      functionality.

   g. Uncompress gawk. Cd to directory gawk-x.x.x and type:
       sh ./configure sunos41
        (for Solaris 2.x: sh ./configure solaris2.cc)     
	Next type: "make".  When gawk will compile, type:
        make install
      Finally, disable Sun's awk by typing:
        mv /usr/bin/awk /usr/bin/awk_sun
      and create a link to gawk for awk by typing:
        ln -s /usr/local/bin/gawk /usr/bin/awk

   h. Uncompress grep.  Cd to directory grep-x.x and type:
        ./configure
      Next type: "make" and "make install".  Grep will
      also be installed in /usr/local/bin as fgrep
      and egrep.  Finally, as some programs expect to find
      grep, egrep and fgrep in /usr/bin, disable Sun's grep
      and create appropriate links, just like described
      for awk.  INN expects to find a program "egnugrep" in
      /usr/local/bin.  Create it by typing:
         cp /usr/local/bin/egrep /usr/local/bin/egnugrep

   i. Uncompress sed and patch.  Compile and install these
      utilities following the instructions for grep.


   j. INN comes with some scripts written in the perl
      language.  Uncompress perl, cd to directory perl-x.xxx
      and type:
       sh ./Configure
      and hit Return for default answers to all questions.
      Next, type: "make depend", then "make".  Now type:
       make test
      to check, if perl works without errors.  Finally,
      type:
       make install
      to complete installation of perl.
      
      Solaris 2.x: answer "none" for -I/usr/ucbinclude
      and add libraries: -lm -lnsl -lsocket