README.sol2

   1 Introduction.
   2 *************
   3
   4   This file describes the installation process for ppp-2.5 on systems
   5   running an OpenSolaris-derived OS, such as Illumos or OpenIndiana.
   6   For these systems, the STREAMS kernel modules are supplied with the
   7   OS itself and are used as-is by this distribution. For more
   8   information on these distributions (including kernel source) see:
   9
  10     https://www.illumos.org/
  11     https://illumos.org/docs/about/distro/
  12
  13   For Oracle Solaris systems, either use the vendor-supplied PPP
  14   implementation ("Solaris PPP 4.0" based on pppd-2.4.0), or download
  15   an older version of the pppd sources here:
  16
  17     https://download.samba.org/pub/ppp/
  18
  19   The last version known to compile and run correctly on Oracle
  20   Solaris 10 is pppd-2.4.8. It may be possible to compile and use
  21   newer versions on either Solaris 11 or by installing third-party
  22   compilers; this has not been tested.
  23
  24
  25 Installation.
  26 *************
  27
  28 1. Make sure you have a suitable compiler installed. This package was
  29    tested with "pkg install gcc-14" but other modern compilers should
  30    work.
  31
  32 2. Run the configure script and build the package.
  33
  34      ./configure --with-runtime-dir=/var/run --with-logfile-dir=/var/log/ppp
  35      make
  36
  37    The configure script will automatically find the compiler if it's in
  38    the standard location (/usr/bin/gcc). By default, everything will be
  39    installed in /usr/local. Use "--prefix" to choose a different
  40    installation directory if desired. Use "./configure -h" to see other
  41    options.
  42
  43 3. Install the programs.
  44
  45      sudo make install
  46
  47    This installs the following:
  48
  49      /usr/local/sbin            pppd, chat, pppstats, pppdump
  50      /usr/local/share/man/man8  man pages
  51      /usr/local/include/pppd    plug-in header files
  52      /usr/local/lib/pppd/$VER   plug-in modules
  53      /usr/local/etc/ppp         example configuration files
  54
  55    If your system normally has only one network interface at boot
  56    time, the default Solaris system startup scripts will disable IP
  57    forwarding in the IP kernel module.  This will prevent the remote
  58    machine from using the local machine as a gateway to access other
  59    hosts.  The solution is to create an /etc/ppp/ip-up script
  60    containing something like this:
  61
  62      #!/bin/sh
  63      /usr/sbin/ndd -set /dev/ip ip_forwarding 1
  64
  65    See the man page for ip(7p) for details.
  66
  67
  68 Synchronous Serial Support.
  69 ***************************
  70
  71   This version has working but limited support for the on-board
  72   synchronous HDLC interfaces.  It has been tested with the
  73   /dev/se_hdlc, /dev/zsh, HSI/S, and HSI/P drivers.  Synchronous mode
  74   was tested with a Cisco router.
  75
  76   The ppp daemon does not directly support controlling the serial
  77   interface.  It relies on the OS-supplied /usr/sbin/syncinit command
  78   to initialize HDLC mode and clocking.
  79
  80   How to start pppd with synchronous support:
  81
  82         #!/bin/sh
  83
  84         local=1.1.1.1   # your ip address here
  85         baud=38400      # needed, but ignored by serial driver
  86
  87         # Change to the correct serial driver/port
  88         #dev=/dev/zsh0
  89         dev=/dev/se_hdlc0
  90
  91         # Change the driver, nrzi mode, speed and clocking to match
  92         # your setup.
  93         # This configuration is for external clocking from the DCE
  94         connect="syncinit se_hdlc0 nrzi=no speed=64000 txc=rxc rxc=rxc"
  95
  96         /usr/sbin/pppd $dev sync $baud novj noauth $local: connect "$connect"
  97
  98   Sample Cisco router config excerpt:
  99
 100         !
 101         ! Cisco router setup as DCE with RS-232 DCE cable
 102         !
 103         !
 104         interface Serial0
 105          ip address 1.1.1.2 255.255.255.0
 106          encapsulation ppp
 107          clockrate 64000
 108          no nrzi-encoding
 109          no shutdown
 110         !