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 (ftw@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 2.  This step differs depending on whether you are running OSF/1 V3.0
  28     or later.
  29
  30     FOR DEC OSF/1 V2.0 THROUGH V2.1:
  31
  32     | Add the following lines to the file /sys/conf/files:
  33     |
  34     | streamsm/if_ppp.c         optional ppp Notbinary optimize -g3
  35     | streamsm/ppp_comp.c       optional ppp Notbinary optimize -g3
  36     | streamsm/ppp_init.c       optional ppp Notbinary optimize -g3
  37     | streamsm/vjcompress.c     optional ppp Notbinary optimize -g3
  38     | streamsm/bsd-comp.c       optional ppp Notbinary optimize -g3
  39     | streamsm/deflate.c        optional ppp Notbinary optimize -g3
  40     | streamsm/ppp.c            optional ppp Notbinary optimize -g3
  41     | streamsm/ppp_ahdlc.c      optional ppp Notbinary optimize -g3
  42     | streamsm/zlib.c           optional ppp Notbinary optimize -g3
  43     |
  44     | Edit the file /sys/streams/str_config.c --- at the end there will be a
  45     | comment to the effect of "add new configurations above this comment".
  46     | Add the following lines above this comment:
  47     |
  48     |      bzero((caddr_t)&sb, sizeof(sb));
  49     |      sb.sc_version = OSF_STREAMS_CONFIG_10;
  50     |
  51     |      retval = ppp_configure(SYSCONFIG_CONFIGURE,
  52     |                             &sb, sc_size, &sc, sc_size);
  53
  54     FOR DEC OSF/1 V3.0 THROUGH Digital UNIX V3.2F:
  55
  56     | Add the following lines to the file /sys/conf/files:
  57     |
  58     | streamsm/if_ppp.c         optional ppp if_dynamic ppp Notbinary optimize -g3
  59     | streamsm/ppp_comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
  60     | streamsm/ppp_init.c       optional ppp if_dynamic ppp Notbinary optimize -g3
  61     | streamsm/vjcompress.c     optional ppp if_dynamic ppp Notbinary optimize -g3
  62     | streamsm/bsd-comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
  63     | streamsm/deflate.c        optional ppp if_dynamic ppp Notbinary optimize -g3
  64     | streamsm/ppp.c            optional ppp if_dynamic ppp Notbinary optimize -g3
  65     | streamsm/ppp_ahdlc.c      optional ppp if_dynamic ppp Notbinary optimize -g3
  66     | streamsm/zlib.c           optional ppp if_dynamic ppp Notbinary optimize -g3
  67
  68     FOR Digital UNIX V3.2G AND V4.0 AND BEYOND
  69
  70     This package does not support these versions of Digital UNIX.
  71     PPP is an integral part of the OS.  Please see the Guide to
  72     Network Administration for details on configuring PPP.
  73
  74 4.  Find your system's configuration file.  This should be called
  75     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
  76     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
  77     /sys/conf/ZAPHOD.  I will refer to this file from now on as
  78     /sys/conf/SYSNAME.
  79
  80 5.  Add the following line at the end of /sys/conf/SYSNAME:
  81
  82         options         PPP
  83
  84 6.  Build a new kernel by using the command
  85
  86         doconfig -c SYSNAME
  87
  88     (say "n" to "Do you want to edit...").
  89
  90 7.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
  91     writing over a perfectly good kernel with one that I'm not sure
  92     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
  93     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
  94
  95 8.  Make sure your system is set up so that it can act like a gateway
  96     for messages to your new connection.  In particular, check the file
  97     /etc/rc.config for the line define ROUTER, and make sure it is
  98     defined as "yes".
  99
 100 9.  Reboot and you're ready to go!
 101
 102 Hopefully, that should work with no hitches.  If you find any bugs, or
 103 errors in these instructions, contact Farrell Woods <ftw@zk3.dec.com>.
 104