README.osf

   1 This file (README.osf) contains instructions for installing ppp-2.3 on a
   2 Compaq Alpha-based system running Tru64 Unix (formerly Digital UNIX aka
   3 DEC OSF/1) version 4.0. Please note that  PPP is an integral
   4 component of Tru64 UNIX version 3.2G and beyond (documented in the
   5 Guide to Network Administration),  and though it *is* possible to install
   6 this software on V3.2G and later of Tru64 UNIX, you are likely
   7 to have problems with the "update install" feature of Tru64
   8 UNIX and while installing some OS patches. (See the note on
   9 de-installation below).
  10
  11 Tru64 Unix versions Version 3.X and earlier are no longer supported
  12 in this package.  Please use ppp-2.3.5 on these systems.
  13
  14 INSTALLATION.
  15
  16 If you encounter bugs while using this PPP package under Tru64
  17 UNIX then please let me (varadhan@zk3.dec.com) know.  I can't promise
  18 quick turnaround but I should be able to address issues eventually.
  19
  20 Below are the steps for installing PPP on Tru64 UNIX.
  21 You must do all of the following as "root".
  22
  23 1.  back up /usr/sys/BINARY, /usr/sys/include/net,
  24     /usr/sys/conf/files, /sys/kern/lockinfo.c  and /sys/BINARY/ppp.mod
  25         # mkdir -p /usr/tmp/ppp
  26         # cd /usr/sys
  27         # tar cvf /usr/tmp/ppp/BINARY.tar ./BINARY
  28         # cd /usr/sys/include
  29         # tar cvf /usr/tmp/ppp/usr_sys_include_net.tar  ./net
  30         # cp /usr/sys/conf/files /usr/tmp/ppp/files
  31         # cp /sys/kern/lockinfo.c /usr/tmp/ppp/lockinfo.c
  32         # cp /sys/BINARY/ppp.mod /usr/tmp/ppp/ppp.mod
  33
  34 2.  Edit /usr/sys/conf/files- search for the string: "MODULE/STATIC/ppp"
  35 comment out the existing entries, and change it to look like:
  36
  37 MODULE/STATIC/ppp               optional ppp Binary
  38 #streamsm/ppp_init.c            module ppp
  39 #streamsm/ppp_if.c              module ppp
  40 #streamsm/ppp_async.c           module ppp
  41 #streamsm/ppp_comp.c            module ppp
  42 #streamsm/vjcompress.c          module ppp
  43 #streamsm/bsd_comp.c            module ppp
  44 streamsm/if_ppp.c         module ppp
  45 streamsm/ppp_comp.c       module ppp
  46 streamsm/ppp_init.c       module ppp
  47 streamsm/vjcompress.c     module ppp
  48 streamsm/bsd-comp.c       module ppp
  49 streamsm/deflate.c        module ppp
  50 streamsm/ppp.c            module ppp
  51 streamsm/ppp_ahdlc.c      module ppp
  52 streamsm/zlib.c           module ppp
  53
  54 3.  Make the kernel sources, daemon, chat, and pppstat program by typing
  55
  56         ./configure
  57         make install
  58
  59     in the directory that this file unpacked into.  This installs the
  60     binaries for the PPP daemon and the statistics program in
  61     /usr/local/etc/ppp.  If you want them somewhere else, just change
  62     the definition of BINDIR in the top level Makefile.osf. If you plan
  63     to over-write exisiting pppd executables in /usr/sbin/, it's advisable
  64     that you create back-up copies of these first, before doing the
  65     'make install'
  66
  67     Note that BINDIR and MANDIR/man8 must exist before you do a
  68     'make install'
  69
  70
  71 4.  Edit /sys/kern/lockinfo.c, and conditionally compile out the lines:
  72
  73 #if PPP
  74         SLI("ppp_if_table_lock", ppp_if_table_lock_info, SPLNONE, DEFAULT);
  75         SLI("ppp_if_info.ppp_if_element_lock", ppp_if_element_lock_info, SPLNONE
  76 , DEFAULT);
  77         SLI("ppp_comp_table_lock", ppp_comp_table_lock_info, SPLNONE, DEFAULT);
  78         SLI("ppp_comp_info.ppp_comp_element_lock", ppp_comp_element_lock_info, S
  79 PLNONE, DEFAULT);
  80         SLI("ppp_async_table_lock", ppp_async_table_lock_info, SPLNONE, DEFAULT)
  81 ;
  82         SLI("ppp_async_info.ppp_async_element_lock", ppp_async_element_lock_info
  83 , SPLNONE, DEFAULT);
  84 #endif  /* PPP */
  85
  86 by changing the line
  87
  88 #if PPP
  89
  90 to be
  91
  92 #if 0
  93
  94 5.  Find your system's configuration file.  This should be called
  95     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
  96     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
  97     /sys/conf/ZAPHOD.  I will refer to this file from now on as
  98     /sys/conf/SYSNAME.
  99
 100 6.  Add the following line at the end of /sys/conf/SYSNAME:
 101
 102         options         PPP
 103
 104 7.  Build a new kernel by using the command
 105
 106         doconfig -c SYSNAME
 107
 108     (say "n" to "Do you want to edit...").
 109
 110 8.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
 111     writing over a perfectly good kernel with one that I'm not sure
 112     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
 113     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
 114
 115 9.  Make sure your system is set up so that it can act like a gateway
 116     for messages to your new connection.  In particular, check the file
 117     /etc/rc.config for the line define ROUTER, and make sure it is
 118     defined as "yes".
 119
 120 10.  Reboot and you're ready to go!
 121
 122 Hopefully, that should work with no hitches.  If you find any bugs, or
 123 errors in these instructions, contact Sowmini Varadhan<varadhan@zk3.dec.com>.
 124
 125
 126 DEINSTALLATION
 127
 128 It is advisable to retrace your steps and restore the system
 129 to its normal state before installing patches or running update_install.
 130 Here's how you can retrace..
 131
 132 1. Restore /usr/sys/BINARY, /usr/sys/include/net, /usr/sys/conf/files
 133    and /sys/kern/lockinfo.c and /sys/BINARY/ppp.mod. For example,
 134    if you followed the instructions in step 1 verbatim, you would do
 135
 136         # cd /usr/sys/
 137         # rm -rf ./BINARY
 138         # tar xvf /usr/tmp/ppp/BINARY.tar
 139         # cd /usr/sys/include
 140         # rm -rf ./net
 141         # tar xvf /usr/tmp/ppp/usr_sys_include_net.tar
 142         # cp  /usr/tmp/ppp/files /usr/sys/conf/files
 143         # cp /usr/tmp/ppp/lockinfo.c /sys/kern/lockinfo.c
 144         # cp /usr/tmp/ppp/ppp.mod /sys/BINARY/ppp.mod
 145
 146 Now redo steps 5-10 and install the patch after you have rebooted.