| 1 | This file explains how to build and install Zephyr on a machine. To |
|---|
| 2 | learn how to use Zephyr once you've installed it, read the file USING. |
|---|
| 3 | To learn how to set up Zephyr service at a site, read the file |
|---|
| 4 | OPERATING. |
|---|
| 5 | |
|---|
| 6 | To build and install Zephyr, run: |
|---|
| 7 | |
|---|
| 8 | ./configure |
|---|
| 9 | make |
|---|
| 10 | make install |
|---|
| 11 | |
|---|
| 12 | This will build Zephyr without Hesiod or Kerberos support, and install |
|---|
| 13 | in /usr/local. To install in a location other than /usr/local, add |
|---|
| 14 | "--prefix=INSTPREFIX" to the configure line, where INSTPREFIX is the |
|---|
| 15 | directory you want to install Zephyr in. |
|---|
| 16 | |
|---|
| 17 | If your site has a Hesiod service with a valid zephyr.sloc entry (or |
|---|
| 18 | you can add one), you can enable Hesiod support by adding the option |
|---|
| 19 | "--with-hesiod=HESPREFIX" to the configure line, where |
|---|
| 20 | HESPREFIX/include and HESPREFIX/lib are the directories you have the |
|---|
| 21 | Hesiod libraries installed in. |
|---|
| 22 | |
|---|
| 23 | If your site has a Kerberos 4 service, you can enable Kerberos support |
|---|
| 24 | by adding the option "--with-krb4=KRBPREFIX" to the configure line, |
|---|
| 25 | where KRBPREFIX/include and KRBPREFIX/lib are the direcetories you |
|---|
| 26 | have the Kerberos libraries installed in. |
|---|
| 27 | |
|---|
| 28 | If you have a make which supports VPATH in a manner compatible with |
|---|
| 29 | GNU make, you can build in a separate directory. Simply invoke the |
|---|
| 30 | configure script from within the build directory and configure will |
|---|
| 31 | locate the source directory for you. (If that doesn't work for some |
|---|
| 32 | reason, you can also specify "--srcdir=SOURCEDIR" on the configuration |
|---|
| 33 | line.) |
|---|
| 34 | |
|---|
| 35 | If configure can't properly find your X11 include or library |
|---|
| 36 | directories, add "--x-includes=INCDIR" and "--x-libraries=LIBDIR" to |
|---|
| 37 | the configure line. To build without X11 support, add "--without-x" |
|---|
| 38 | to the configure line. |
|---|
| 39 | |
|---|
| 40 | If you have Hesiod and/or Kerberos installed such that you can't |
|---|
| 41 | specify a single prefix for both include files and libraries, set the |
|---|
| 42 | environment variables CPPFLAGS and LDFLAGS to include the relevant |
|---|
| 43 | directories, and just configure with "--with-krb4" and |
|---|
| 44 | "--with-hesiod". For instance (for a csh-like shell): |
|---|
| 45 | |
|---|
| 46 | setenv CPPFLAGS "-I/opt/athena/include" |
|---|
| 47 | setenv LDFLAGS "-I/opt/athena/arch/sparc/lib" |
|---|
| 48 | ./configure --with-hesiod --with-krb4 |
|---|
| 49 | make |
|---|
| 50 | make install |
|---|
| 51 | |
|---|
| 52 | Although it's not necessary for Zephyr to function correctly, you |
|---|
| 53 | should add the following services to /etc/services if possible: |
|---|
| 54 | |
|---|
| 55 | zephyr-clt 2103/udp # Zephyr serv-hm connection |
|---|
| 56 | zephyr-hm 2104/udp # Zephyr hostmanager |
|---|
| 57 | zephyr-hm-srv 2105/udp # Zephyr hm-serv connection |
|---|
| 58 | |
|---|
| 59 | To learn how to use Zephyr, read the file USING and the man pages for |
|---|
| 60 | the various Zephyr programs. To learn how to operate a Zephyr |
|---|
| 61 | service, read the file OPERATING. |
|---|
| 62 | |
|---|
| 63 | We have tried to make Zephyr as portable as is reasonably possible, |
|---|
| 64 | but have not taken into account every possible kind of system. If you |
|---|
| 65 | have any problems building or installing Zephyr according to these |
|---|
| 66 | instructions, please send mail to zephyr-bugs@mit.edu. |
|---|
| 67 | |
|---|
