doc/INSTALL

   1 Basic Installation
   2 ==================
   3
   4 Netatalk is known to run on at least five operating systems:
   5
   6         OS      Versions        Hardware        Notes
   7         --      --------        --------        -----
   8         Solaris 2.5-8           Sparc
   9         Linux   1.3.x,2.x       PC
  10         FreeBSD 2.2-current     PC              after 12 Sept 96
  11         NetBSD  1.3             PC
  12         OpenBSD 2.2             PC
  13         SunOS   4.1+            Sparc           kernel must have VDDRV
  14                                                 option installed
  15         Ultrix  4.[1-4]         3100,5000
  16         Tru64   4.0             Alpha           afpd only
  17
  18 See ./doc/README.platforms for more information.
  19
  20 Quickly:
  21 $> ./autogen.sh
  22 $> ./configure [options]
  23 $> make
  24 $> make install
  25
  26
  27 ----------------------------------------------------------------
  28 0. Get the source
  29
  30 A. Download a binary. Several Linux distributions support netatalk
  31 with a package. There are also Deb's and RPM packages available on the
  32 the Netatalk Sourceforge
  33 site. (http://sourceforge.net/projects/netatalk/)
  34
  35 B. Download the tarball. There are tar.gz and tar.bz2 files available
  36 for download and compiling.
  37 (http://sourceforge.net/projects/netatalk/)
  38
  39 C. Anonymous CVS. Downloading of the CVS source can be done quickly
  40 and easily.
  41
  42 1. make sure you have cvs installed.
  43 $> which cvs
  44 should produce a path to cvs.
  45
  46 2. if you don't have one make a source directory. Mine is
  47 ~lance/src/working/ cd to this directory.
  48
  49 3. Authenticate yourself with your local cvs and the remote cvs: (all
  50 one line)
  51
  52 cvs \
  53 -d:pserver:anonymous@cvs.netatalk.sourceforge.net:/cvsroot/netatalk \
  54 login
  55
  56 Just hit enter for the password for the anonymous user.
  57
  58 4. Now that both machines know who you are, get the source: (all one
  59 line)
  60
  61 cvs -z3 \
  62 -d:pserver:anonymous@cvs.netatalk.sourceforge.net:/cvsroot/netatalk \
  63 co netatalk
  64
  65 This tells cvs what compression, (-z3) what protocol, repository and
  66 where the source is (-d:protocol:host:path) what to do (co is an alias
  67 for checkout) and what (netatalk) module.
  68
  69 This will create a netatalk directory and download a complete and
  70 fresh copy of the netatalk source
  71
  72
  73 ----------------------------------------------------------------
  74
  75 1. ./autogen.sh (Not necessary for a release tarball.)
  76 This shell script runs libtoolize, aclocal, autoheader, automake and
  77 autoconf. This sets up all the conditions for the next step. You may
  78 or may not have to do this. If you downloaded a release tarball, or if
  79 your download contains a ./configure file then this has already been
  80 run for you.
  81
  82 ----------------------------------------------------------------
  83
  84 2. ./configure
  85 This step reads the options to the ./configure program and checks your
  86 system against the requirements of those options. It generally fails
  87 if your system doesn't meet the requirements. You should read check
  88 the DEVELOPER file because some of these options require external
  89 sources to function correctly. (PAM, SSL, Berkeley DB3, TCP Wrappers,
  90 etc).
  91
  92 Netatalk options to the ./configure script: Use ./configure --help for
  93 a complete list.
  94
  95 --disable-admin-group: disable admin group (default on),
  96
  97 --disable-ddp: disable DDP support (AppleTalk),
  98
  99 --enable-debug: enable debugging messages in syslog,
 100
 101 --enable-dropkludge: enable the experimental dropbox fix
 102         (INSECURE!),
 103
 104 --enable-cnid-db: use persistent cnid database per volume
 105         (EXPERIMENTAL),
 106
 107 --with-db3=PATH: specify path to Berkeley DB3 installation,
 108
 109 --with-did=[scheme]: set DID scheme (last,mtab),
 110         The last DID scheme recreates version 37b behaviour where
 111         directory id's are incrementally calculated versus the new
 112         hash method. Unfortunately for machines that have a lot of
 113         devices, and/or a lot of inodes the hash can fail with
 114         multiple directories resolving to the same DID.
 115
 116 --with-msg-dir=path: path to message files [default=/etc/msg],
 117
 118 --enable-srvloc: Turn on Server Location Protocol support (EXPERIMENTAL),
 119
 120 --with-pam: enable pluggable authentication modules support,
 121         PAM provides a flexible mechanism for authenticating
 122         users. PAM was invented by SUN Microsystems.
 123
 124         Linux-PAM is a suite of shared libraries that enable the local
 125         system administrator to choose how applications authenticate users.
 126         You can get the Linux PAM documentation and sources from
 127         http://www.kernel.org/pub/linux/libs/pam/
 128
 129 --with-shadow: enable shadow password support,
 130
 131 --disable-shell-check: disable checking for a valid shell,
 132
 133 --with-flock-locks: enable flock locks support,
 134
 135 --with-tcp-wrappers: enable TCP wrappers support.
 136         Wietse Venema's network logger, also known as TCPD or
 137         LOG_TCP. These programs log the client host name of incoming
 138         telnet, ftp, rsh, rlogin, finger etc. requests. Security
 139         options are: access control per host, domain and/or service;
 140         detection of host name spoofing or host address spoofing;
 141         booby traps to implement an early-warning system.  TCP
 142         Wrappers can be gotten at
 143         ftp://ftp.porcupine.org/pub/security/
 144
 145 --with-ssl-dirs=[PATH]: specify path to OpenSSL installation.
 146         NOTE: This is dependent on the same directory layout as the
 147         source distribution of Openssl. That is: ./include/ and
 148         ./lib/ to be on the same level. Many .rpm formats do not
 149         have their files laid out in this format.
 150         The OpenSSL Project is a collaborative effort to develop a
 151         robust, commercial-grade, full-featured, and Open Source
 152         toolkit implementing the Secure Sockets Layer (SSL v2/v3)
 153         and Transport Layer Security (TLS v1) protocols as well as a
 154         full-strength general purpose cryptography library.
 155         This is required to enable DHX login support, which
 156         will encrypt all of the passwords being sent across the
 157         connection. (Some old mac clients don't support this, check
 158         the FAQ for the section on AppleShare clients.)
 159         Check to see if your unix has OpenSSL already, or
 160         get everything at http://www.openssl.org/
 161
 162 --with-uams-path=path: path to UAMs [default=PKGCONF/uams]
 163
 164 --enable-fhs: use Filesystem Hierarchy Standard (FHS) compatibility
 165
 166 --with-ssl-dir=PATH: specify path to openssl installation (must contain
 167         lib and include dirs)
 168
 169 --enable-pgp-uam: enable build of PGP UAM module
 170
 171 --enable-krb4-uam: enable build of Kerberos v4 UAM module
 172
 173 --enable-overwrite: Overwrite configuration files in PKGCONFDIR
 174
 175 ----------------------------------------------------------------
 176
 177 3. ./make
 178
 179 Compile all of the programs
 180
 181 ----------------------------------------------------------------
 182
 183 4. ./make install
 184 Install the programs in the places specified by the ./configure process.