README.sol2

   1 This file describes the installation process for ppp-2.3 on systems
   2 running Solaris 2.  The Solaris 2 and SVR4 ports share a lot of code
   3 but are not identical.  The STREAMS kernel modules and driver for
   4 Solaris 2 are in the svr4 directory (and use some code from the
   5 modules directory).
   6
   7 This version has been tested under Solaris 7, and the upcoming
   8 Solaris 8. As of now, it will only work when the system is booted
   9 in 32-bit mode. 64-bit clean driver as well as IPv6 support for
  10 Solaris 8 are currently under development.
  11
  12 NOTE: Although the kernel driver and modules have been designed to
  13 operate correctly on SMP systems, they have not been extensively
  14 tested on SMP machines.  Some users of SMP Solaris x86 systems have
  15 reported system problems apparently linked to the use of previous
  16 versions of this software.  I believe these problems have been fixed.
  17
  18
  19 Installation.
  20 *************
  21
  22 1. Run the configure script and make the user-level programs and the
  23 kernel modules.
  24
  25         ./configure
  26         make
  27
  28 If you wish to use gcc (or another compiler) instead of Sun's cc, edit
  29 the svr4/Makedefs file and uncomment the definition of CC.  You can
  30 also change the options passed to the C compiler by editing the COPTS
  31 definition.
  32
  33 2. Install the programs and kernel modules: as root, do
  34
  35         make install
  36
  37 This installs pppd, chat and pppstats in /usr/local/bin and the kernel
  38 modules in /kernel/drv and /kernel/strmod, and creates the /etc/ppp
  39 directory and populates it with default configuration files.  You can
  40 change the installation directories by editing svr4/Makedefs.
  41
  42 If your system normally has only one network interface, the default
  43 Solaris 2 system startup scripts will disable IP forwarding in the IP
  44 kernel module.  This will prevent the remote machine from using the
  45 local machine as a gateway to access other hosts.  The solution is to
  46 create an /etc/ppp/ip-up script containing something like this:
  47
  48         #!/bin/sh
  49         /usr/sbin/ndd -set /dev/ip ip_forwarding 1
  50
  51 See the man page for ip(7p) for details.
  52
  53 Synchronous Serial Support.
  54 ***************************
  55
  56 This version has working but limited support for the on-board synchronous HDLC
  57 interfaces. It has been tested with the /dev/se_hdlc and /dev/zsh drivers.
  58 Synchronous mode was tested with a Cisco router.
  59
  60 There ppp daemon does not directly support controlling the serial interface.
  61 It relies on the /usr/sbin/syncinit command to initialize HDLC mode and
  62 clocking.
  63
  64 Some bugs remain: large sized frames are not sent/received properly, and
  65 may be related to the IP mtu. This
  66 may be due to bugs in pppd itself, bugs in Solaris or the serial drivers.
  67 The /dev/zsh driver seems more larger and can send/receive larger frames
  68 than the /dev/se_hdlc driver. There is a confirmed bug with NRZ/NRZI mode
  69 in the /dev/se_hdlc driver, and Solaris patch 104596-11 is needed to correct
  70 it. (However this patch seems to introduce other serial problems. If you
  71 don't apply the patch, the workaround is to change the nrzi mode to yes or
  72 no, whichever works)
  73
  74 How to start pppd with synchronous support:
  75
  76 #!/bin/sh
  77
  78 local=1.1.1.1   # your ip address here
  79 baud=38400      # needed, but ignored by serial driver
  80
  81 # Change to the correct serial driver/port
  82 #dev=/dev/zsh0
  83 dev=/dev/se_hdlc0
  84
  85 # Change the driver, nrzi mode, speed and clocking to match your setup
  86 # This configuration is for external clocking from the DCE
  87 connect="syncinit se_hdlc0 nrzi=no speed=64000 txc=rxc rxc=rxc"
  88
  89 /usr/sbin/pppd $dev sync $baud novj noauth $local: connect "$connect"
  90
  91
  92 Sample Cisco router config excerpt:
  93
  94 !
  95 ! Cisco router setup as DCE with RS-232 DCE cable
  96 !
  97 !
  98 interface Serial0
  99  ip address 1.1.1.2 255.255.255.0
 100  encapsulation ppp
 101  clockrate 64000
 102  no nrzi-encoding
 103  no shutdown
 104 !
 105