README.osf

   1 This file (README.osf) contains instructions for installing ppp-2.3 on a
   2 Digital Alpha-based system running Digital UNIX (aka DEC OSF/1)
   3 version 2.0 through version 3.2F.  Digial UNIX version 3.2G and beyond
   4 are not supported by this package, since PPP is an integral component
   5 of those releases.  (Although it *is* possible to install this software
   6 on V3.2G and later of Digital UNIX, I would discourage this activity
   7 because it's likely to break the "update install" feature of Digital
   8 UNIX.  You were warned...)
   9
  10 If you encounter bugs in this using this PPP package under Digital
  11 UNIX then please let me (varadhan@zk3.dec.com) know.  I can't promise
  12 quick turnaround but I should be able to address issues eventually.
  13
  14 Below are the steps for installing PPP on Digital UNIX.
  15 You must do all of the following as "root".
  16
  17 1.  Make the kernel sources, daemon, chat, and pppstat program by typing
  18
  19         ./configure
  20         make install
  21
  22     in the directory that this file unpacked into.  This installs the
  23     binaries for the PPP daemon and the statistics program in
  24     /usr/local/etc/ppp.  If you want them somewhere else, just change
  25     the definition of BINDIR in the top level Makefile.osf.
  26
  27     Note that BINDIR and MANDIR/man8 must exist before you do a
  28     'make install'
  29
  30 2.  This step differs depending on whether you are running OSF/1 V3.0
  31     or later.
  32
  33     FOR DEC OSF/1 V2.0 THROUGH V2.1:
  34
  35     | Add the following lines to the file /sys/conf/files:
  36     |
  37     | streamsm/if_ppp.c         optional ppp Notbinary optimize -g3
  38     | streamsm/ppp_comp.c       optional ppp Notbinary optimize -g3
  39     | streamsm/ppp_init.c       optional ppp Notbinary optimize -g3
  40     | streamsm/vjcompress.c     optional ppp Notbinary optimize -g3
  41     | streamsm/bsd-comp.c       optional ppp Notbinary optimize -g3
  42     | streamsm/deflate.c        optional ppp Notbinary optimize -g3
  43     | streamsm/ppp.c            optional ppp Notbinary optimize -g3
  44     | streamsm/ppp_ahdlc.c      optional ppp Notbinary optimize -g3
  45     | streamsm/zlib.c           optional ppp Notbinary optimize -g3
  46     |
  47     | Edit the file /sys/streams/str_config.c --- at the end there will be a
  48     | comment to the effect of "add new configurations above this comment".
  49     | Add the following lines above this comment:
  50     |
  51     |      bzero((caddr_t)&sb, sizeof(sb));
  52     |      sb.sc_version = OSF_STREAMS_CONFIG_10;
  53     |
  54     |      retval = ppp_configure(SYSCONFIG_CONFIGURE,
  55     |                             &sb, sc_size, &sc, sc_size);
  56
  57     FOR DEC OSF/1 V3.0 THROUGH Digital UNIX V3.2F:
  58
  59     | Add the following lines to the file /sys/conf/files:
  60     |
  61     | streamsm/if_ppp.c         optional ppp if_dynamic ppp Notbinary optimize -g3
  62     | streamsm/ppp_comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
  63     | streamsm/ppp_init.c       optional ppp if_dynamic ppp Notbinary optimize -g3
  64     | streamsm/vjcompress.c     optional ppp if_dynamic ppp Notbinary optimize -g3
  65     | streamsm/bsd-comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
  66     | streamsm/deflate.c        optional ppp if_dynamic ppp Notbinary optimize -g3
  67     | streamsm/ppp.c            optional ppp if_dynamic ppp Notbinary optimize -g3
  68     | streamsm/ppp_ahdlc.c      optional ppp if_dynamic ppp Notbinary optimize -g3
  69     | streamsm/zlib.c           optional ppp if_dynamic ppp Notbinary optimize -g3
  70
  71     FOR Digital UNIX V3.2G AND V4.0 AND BEYOND
  72
  73     This package does not support these versions of Digital UNIX.
  74     PPP is an integral part of the OS.  Please see the Guide to
  75     Network Administration for details on configuring PPP.
  76
  77 4.  Find your system's configuration file.  This should be called
  78     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
  79     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
  80     /sys/conf/ZAPHOD.  I will refer to this file from now on as
  81     /sys/conf/SYSNAME.
  82
  83 5.  Add the following line at the end of /sys/conf/SYSNAME:
  84
  85         options         PPP
  86
  87 6.  Build a new kernel by using the command
  88
  89         doconfig -c SYSNAME
  90
  91     (say "n" to "Do you want to edit...").
  92
  93 7.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
  94     writing over a perfectly good kernel with one that I'm not sure
  95     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
  96     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
  97
  98 8.  Make sure your system is set up so that it can act like a gateway
  99     for messages to your new connection.  In particular, check the file
 100     /etc/rc.config for the line define ROUTER, and make sure it is
 101     defined as "yes".
 102
 103 9.  Reboot and you're ready to go!
 104
 105 Hopefully, that should work with no hitches.  If you find any bugs, or
 106 errors in these instructions, contact Sowmini Varadhan<varadhan@zk3.dec.com>.
 107