README.osf

   1
   2 This file (README.osf) contains instructions for installing ppp-2.2 on a
   3 DEC Alpha running OSF/1 version 2.0 or 3.0.  The original STREAMS
   4 module code is by (and copyrighted by) Brad Clements.  See the source
   5 files and the general README file for full credits and copyright notices.
   6
   7 If you would like to be on a mailing list concerning the ppp package,
   8 send mail to srt@cs.unt.edu and let me know.  This mailing list should
   9 not have any regular traffic --- I will use it only if bugs are reported
  10 to notify everyone of bug-fixes.
  11
  12 Note for users of the ppp-2.1.2 package:  I have included a fix
  13 for the non-STREAMS tty drivers in this release.  If you were using
  14 version 2.1.2 with a hardware serial port, then you probably used the
  15 "rlogin-kludge" that I described in the README that came with 2.1.2.
  16 You don't need this any more, and will have a more efficient connection
  17 if you get rid of this old work-around.
  18
  19 Below are the steps for installing PPP on a Digital Equipment Corp.
  20 Alpha system running Digital UNIX (formerly known as DEC OSF/1.)
  21
  22 You must do all of the following as "root".
  23
  24 1.  Make the kernel sources, daemon, chat, and pppstat program by typing
  25
  26         ./configure
  27         make install
  28
  29     in the directory that this file unpacked into.  This installs the
  30     binaries for the PPP daemon and the statistics program in
  31     /usr/local/etc/ppp.  If you want them somewhere else, just change
  32     the definition of BINDIR in the top level Makefile.osf.
  33
  34 2.  This step differs depending on whether you are running OSF/1 V3.0
  35     or later.
  36
  37     FOR DEC OSF/1 VERSIONS PRIOR TO V3.0:
  38
  39     | Add the following lines to the file /sys/conf/files:
  40     |
  41     |      streamsm/ppp_if.c                    optional ppp Notbinary
  42     |      streamsm/ppp_async.c                 optional ppp Notbinary
  43     |      streamsm/ppp_init.c                  optional ppp Notbinary
  44     |      streamsm/vjcompress.c                optional ppp Notbinary
  45     |      streamsm/bsd-comp.c                  optional ppp Notbinary
  46     |      streamsm/ppp_comp.c                  optional ppp Notbinary
  47     |
  48     |
  49     | Edit the file /sys/streams/str_config.c --- at the end there will be a
  50     | comment to the effect of "add new configurations above this comment".
  51     | Add the following lines above this comment:
  52     |
  53     |      bzero((caddr_t)&sb, sizeof(sb));
  54     |      sb.sc_version = OSF_STREAMS_CONFIG_10;
  55     |
  56     |      retval = ppp_configure(SYSCONFIG_CONFIGURE,
  57     |                             &sb, sc_size, &sc, sc_size);
  58
  59     FOR DEC OSF/1 VERSIONS V3.0 AND LATER, INCLUDING DIGITAL UNIX:
  60
  61     | Add the following lines to the file /sys/conf/files:
  62     |
  63     |      streamsm/ppp_if.c          optional ppp if_dynamic ppp Notbinary
  64     |      streamsm/ppp_async.c       optional ppp if_dynamic ppp Notbinary
  65     |      streamsm/ppp_init.c        optional ppp if_dynamic ppp Notbinary
  66     |      streamsm/vjcompress.c      optional ppp if_dynamic ppp Notbinary
  67     |      streamsm/bsd-comp.c        optional ppp if_dynamic ppp Notbinary
  68     |      streamsm/ppp_comp.c        optional ppp if_dynamic ppp Notbinary
  69
  70 4.  Find your system's configuration file.  This should be called
  71     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
  72     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
  73     /sys/conf/ZAPHOD.  I will refer to this file from now on as
  74     /sys/conf/SYSNAME.
  75
  76 5.  Add the following line among the other options in /sys/conf/SYSNAME:
  77
  78         options         PPP
  79
  80 6.  Build a new kernel by using the command
  81
  82         doconfig -c SYSNAME
  83
  84     (say "n" to "Do you want to edit...").
  85
  86 7.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
  87     writing over a perfectly good kernel with one that I'm not sure
  88     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
  89     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
  90
  91 8.  Make sure your system is set up so that it can act like a gateway
  92     for messages to your new connection.  In particular, check the file
  93     /etc/rc.config for the line define ROUTER, and make sure it is
  94     defined as "yes".
  95
  96 9.  Reboot and you're ready to go!
  97
  98 Hopefully, that should work with no hitches.  If there are problems, or
  99 if I have made a mistake in these instructions, please let me know.
 100
 101 Steve Tate
 102 University of North Texas
 103 srt@cs.unt.edu
 104