Managing Serial Networks Using UUCP and PPP in Oracle^® Solaris 11.4

How to Configure a System on a Leased Line

1. Become an administrator on the local system (router).

   For more information, see Using Your Assigned Administrative Rights in Securing Users and Processes in Oracle Solaris 11.4.

2. Add an entry for the remote peer in the router's /etc/hosts file.

   # cat /etc/hosts
   #
   # Internet host table
   #
   127.0.0.1       localhost
   192.0.2.10      local2-peer        loghost
   192.0.2.11      local1-net
   198.51.100.25   farISP

   The example /etc/hosts file is for the local router at the fictitious LocalCorp. Note the IP address and host name for the remote peer farISP at the service provider.

3. Create the file /etc/ppp/peers/peer-name to hold information about the provider's peer.

   For this example leased-line link, create the file /etc/ppp/peers/farISP.

   # cat /etc/ppp/peers/farISP
   init '/etc/ppp/conf_hsi'
   local
   /dev/hihp1
   sync
   noauth
   192.0.2.10:198.51.100.25
   passive
   persist
   noccp
   nopcomp
   novj
   noaccomp

   Where:

   • init '/etc/ppp/conf_hsi' – Starts the link. init then configures the HSI interface by using the parameters in the script /etc/ppp/conf_hsi.

   • local – Tells the pppd daemon not to change the state of the Data Terminal Ready (DTR) signal. Also tells pppd to ignore the Data Carrier Detect (DCD) input signal.

   • /dev/hihp1 – Gives the device name of synchronous interface.

   • sync – Establishes synchronous encoding for the link.

   • noauth – Establishes that the local system does not need to demand authentication from the peer. However, the peer could still demand authentication.

   • 192.0.2.10:198.51.100.25 – Defines the IP addresses of the local peer and the remote peer, separated by a colon.

   • passive – Tells the pppd daemon on the local system to go quiet after issuing maximum number of LCP Configure-Requests and to wait for the peer to start.

   • persist – Tells the pppd daemon to try to restart the link after a connection ends.

   • noccp, nopcomp, novj, noaccomp – Disables the Compression Control Protocol (CCP), Protocol Field compression, Van Jacobson compression, and address and control field compression, respectively. These forms of compression accelerate transmissions on a dial-up link but could slow down a leased line.

4. Create an initialization script that is called demand, which creates the PPP link as part of the booting process.

   The demand script contains the pppd command for establishing a leased-line link. The following list explains the content of $PPPDIR/demand.

   # cat /etc/ppp/demand
   #!/bin/sh
   if [ -f /system/volatile/ppp-demand.pid ] &&
      /usr/bin/kill -s 0 `/bin/cat /system/volatile/ppp-demand.pid`
   then
           :
   else
           /usr/bin/pppd call farISP
   fi

   Where:

   if [ -f /system/volatile/ppp-demand.pid ] && /usr/bin/kill -s 0 `/bin/cat /system/volatile/ppp-demand.pid`

   These lines check to see if pppd is running. If pppd is running, it does not need to be started.

   /usr/bin/pppd call farISP

   This line launches pppd. pppd reads the options from /etc/ppp/options. The call farISP option on the command line causes it to read /etc/ppp/peers/farISP, also.

   The Oracle Solaris PPP 4.0 startup script /etc/rc2.d/S47pppd invokes the demand script as part of the booting process. The following lines in /etc/rc2.dS47pppd search for the presence of a file that is called $PPPDIR/demand.

   if [ -f $PPPDIR/demand ]; then
       . $PPPDIR/demand
   fi

   If found, $PPPDIR/demand is read to configure the environment and to establish the link.

   ---

   Note - To reach systems outside the local network, have users run ftp, ssh, or similarly secure commands.

   ---

See Also

If you have followed all the procedures in this chapter, you have completed the configuration of the leased-line link. The following list provides references to related information.

• To find troubleshooting information, see Fixing Leased-Line Problems.

• To learn more about the files and options that are used in this chapter, see Using PPP Options in Files and on the Command Line.