How to Configure a Machine on a Leased Line

Language:

Become an administrator on the local machine (router).
For more information, see Using Your Assigned Administrative Rights in Securing Users and Processes in Oracle Solaris 11.3.

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.

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

For this example leased-line link, you 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

The following table explains the options and parameters that are used in /etc/ppp/peers/farISP.

Option	Definition
`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 machine 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.

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

$ 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

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

Code Sample	Explanation
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 executed. During the course of executing $PPPDIR/demand, the link is established.

Note - To reach machines outside the local network, have users run telnet, ftp, rsh, or similar 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.