
		Installation and Release Notes for NET-2

			Base Utilities Distribution

			Version: 0.23 NET-2 Rev.E

		    Mon, 16 Aug 17:00:00 1993 METDST


			    Fred N. van Kempen,

			<waltje@uwalt.hacktic.nl>
		       <waltje@uwalt.nl.mugnet.org>



PREFACE
This document describes the contents of the NET-2 "Base Distribution"
of the NET-2 network package for the Linux operating system.  Read it
carefully, and, when you encounter problems, also read the "NET-2 FAQ"
that has been added to this distribution, see the file called "FAQ".

If you cannot find it there, send electronic mail to:

	Matt Welsh <mdw@tc.cornell.edu>

and ask for a copy of the NET-2 FAQ.



NEWSFLASH

The following things changed since the previous release:

- Minor changes to the command sources ro get them compile with C++.
  This is not finished yet, DIP and WdSetup still don't compile clean.

- New DIP command: "echo" and "init".

- An even newer installation script, which was re-done (part A) by
  Johannes (John) Grosen (grosen@argv.cs.ndsu.nodak.edu).  This should
  fix a lot of problems.

- Re-format of the "netstat" program while I was changing it for the
  new NET-2e release include files.

- This archive also contains a dump of the new include files for the
  </usr/include/net> and </usr/include/netinet> directories. Unpack
  the 'includes.tar' archive before compiling this stuff !


NETWORK PROGRAMS

NET-2 has changed a lot, so a new set of "base utilities" comes with
it.  These programs allow you to set up and maintain your network.
To compile and install:

	1.  Create the directory:

		# mkdir /usr/src/commands/usr.net/net

	2.  Unpack the distribution:

		# cd /usr/src/commands/usr.net/net
		# tar xfvz /tmp/net-base.tgz

	3.  Make the stuff.

	    If you do not have the correct configuration files at hand
	    (which is the case if you are installing this package for
	    the first time!), type:

		# make install

	    otherwise, type

		# make firsttime

The "firsttime" installation takes the NET-2 sample config files, and
put them in their corresponding places in the file system.  It also
sets up the necessary symbolic links where needed.

Note, that in LINUX/Pro, all system config files are kept in /conf, and
all non-needed binaries (like the TCP/IP and RPC servers) are in /usr/etc.
However, all programs and library procedures reference those files in the
standardized "/etc" directory, so if you do not like the /conf concept,
simply remove all symbolic links and put the real files into /etc.

Have a look at the sample config files in the net-base distribution, and
pay close attention to the "rc.inet[12]" files, which set up your network.


CONFIGURATION FILES

A complete set of "sample" configuration files can be found in the
"sample" subdirectory of this package.  You can either install them
into the /etc directory, put them in /etc/inet (if you run SLS) or,
if you run LINUX/Pro, put them in the /conf/net directory.

After installing the files, check all of them and see if you have to
change them.  Some of them are quite static (like the "services" and
"rpc" file, for example), but others may change often (like the
"hosts" and "networks" files...).

Also, pay close attention to the "rc.inet" files.  These are the files
that setup your network at boot time, and these are the files that
cause the most trouble for people.

The "rc.inet1" script is the one started by INIT, right after booting.
It does basic things like setting up the interfaces (using the
/etc/ifconfig command), and then setting up routes to them (using
the /etc/route command).  You *will* have to edit this file.

The "rc.inet2" script is also started by INIT, but only after the
system has been brought up for multi-user operation (the state of
the system where all kinds of daemon processes may run, etc.) You
can leave this file as-is for most setups


SOURCES

The sources for all NET-2 related programs (including those of this
package, which may have reached you as a binary-only package) can be
obtained by anonymous FTP from:

	tsx-11.mit.edu:/pub/linux/packages/net/net-2/sources/*

and by all machines that shadow this directory.  Note that the source
distributions often have somewhat more recent versions of the programs
than the binary packages, because of obvious release delays.
