SCO PPP from Morning Star Release and Installation Notes

An enhanced and robust connectivity PPP (Point-to-Point Protocol) implementation that is heavily used by Internet Service Providers to support networking over serial lines for Internet applications. SCO PPP from Morning Star includes extensive modem/connectivity device support, advanced error checking and negotiation, and authorization through PAP/CHAP.

For the latest information and downloadable updates of SCO® Internet Products, visit the SCO Internet Family (http://www2.sco.com/) page.

System requirements

SCO PPP from Morning Star 2.1.3a

 Software:     SCO OpenServer Release 5
 RAM:          32MB
 Disk Space:   1MB free disk space

SCO PPP from Morning Star 2.1.3 is supported on the following releases:

SCO OpenServer 5.0.5
SCO OpenServer 5.0.4
SCO OpenServer 5.0.2
SCO OpenServer 5.0.0
SCO Internet FastStart 1.1
SCO Internet FastStart 1.0

Licensing and support information

Using Additional Client Licenses

When using your Additional Client Licenses with SCO OpenServer Release 5.0 or 5.02, the rs40b patch supplement must be installed prior to installing your Mail-User Client License. Use the SCOadmin Software Manager (in the System Administration window on your desktop) to view patches that have been applied. If the SCO Internet Supplement (rs40b) has not been installed, you must do so prior to installing the client licenses. The rs40b patch is not required if you are installing on SCO OpenServer 5.0.4.

Use the SCOadmin Software Manager to load and apply these patch supplements from the SCO OpenServer Optional Services CD-ROM. For information on using the Software Manager, see ``Installing and managing software components'' (http://osr5doc.sco.com:457/HANDBOOK/swaN.admin.html in SCO OpenServer Handbook (http://osr5doc.sco.com:457/HANDBOOK/CONTENTS.html) or ``Installing, removing software'' (http://osr5doc.sco.com:1996/FASTSTART/swaN.admin.html) in SCO Internet FastStart http://osr5doc.sco.com:1996/Internet/FASTSTART/.

Using evaluation licenses

If you are using evaluation licenses for any of the products on the SCO OpenServer Optional Services CD-ROM, remember that the evaluation licenses are good for sixty (60) days from the date of installation of the particular product. To use the product beyond the 60-day period, you must purchase a permanent Certificate of License and Authenticity (COLA) from your SCO Authorized Reseller, and install that license with the SCOadmin License Manager in the System Administration window on your desktop.

Evaluation license numbers cannot be reused; removing a product installed with a particular license number and attempting to use that number for the installation of another product will not be successful.

If you are using evaluation licenses for any of the products on this CD-ROM intended for use on SCO OpenServer systems, do not attempt to remove the evaluation license with the License Manager after it is installed. Doing so will cause that license to be invalid should it be used in a subsequent installation.

Obtaining product updates

For product updates, patches, and other product assistance, visit:

http://www2.sco.com

Accessing documentation

To access online documentation on SCO OpenServer systems, double-click on the Desktop Help icon or point your existing Netscape browser to:

http://ServerName:457/dochome.html

NOTE: Using the SCOhelp browser to view SCO OpenServer documentation is recommended.

The Morning Star PPP User's Guide is available online (http://osr5doc.sco.com:1996/Internet/Secure/secure2.htm) and in PostScript (http://www.sco.com/documentation/postscript/secure/) format.

To access printable PostScript images:

Download and install the gunzip utility.
Download the files from http://www.sco.com/documentation/postscript/mst/ppp/ to a temporary directory (such as /tmp).
Change to the download directory:

cd /tmp
Uncompress and print the files:

/usr/bin/gunzip * | lp -opost -dprintername *
Substitute the name of a PostScript printer for printername and, if necessary, change the -opost option depending on your printer model script.

To order printed Netscape documentation:

Visit the Netscape home page (http://home.netscape.com).
Click on Netscape Store, then Bookstore & Courses.

NOTE: Be sure to check the addendum (http://osr5doc.sco.com:1996/Internet/PPP/ug211/addendum.htm) for differences between the Morning Star PPP User's Guide (http://www.sco.com/documentation/postscript/mst/ppp/) book from Morning Star and the SCO version of the software.

Downloading gunzip

The PostScript books on the WWW are distributed in gzip (.gz) compressed format. You must use gunzip to uncompress these files. To download and install the gunzip utility:

Point your browser at http://www.sco.com/documentation/postscript/bin/ and download gunzip_osr5.tar to a temporary directory (such as /tmp).
Use tar(C) to extract the tarfile:

cd /tmp
tar xvf gunzip_osr5.tar
This extracts the gunzip binary into the /usr/bin directory.

To download the entire gzip package from Skunkware:

Point your browser at http://www.sco.com/skunkware/osr5/shellutil/gzip/.
Download gzip-1.2.4-VOLS.tar to a temporary directory (such as /tmp).
Use tar(C) to extract the tarfile:

cd /tmp
tar xvf gunzip_osr5.tar
Use the SCOadmin Software Manager (custom) to install (select Media Images when prompted for a media device and enter the temporary directory for the directory name).
For information on using the Software Manager, see ``Installing and managing software components'' (http://osr5doc.sco.com:457/HANDBOOK/swaN.admin.html in SCO OpenServer Handbook (http://osr5doc.sco.com:457/HANDBOOK/CONTENTS.html) or ``Installing, removing software'' (http://osr5doc.sco.com:1996/FASTSTART/swaN.admin.html) in SCO Internet FastStart http://osr5doc.sco.com:1996/Internet/FASTSTART/.

Installing and removing SCO PPP from Morning Star 2.1.3

NOTE: Before installing SCO PPP from Morning Star, read ``SCO PPP from Morning Star 2.1.3 notes''.

To install SCO PPP from Morning Star:

Install software patches, if necessary.
If you are installing onto:
SCO OpenServer Release 5.0.5
No patches are required.

SCO OpenServer Release 5.0.4
Install this patch:
- Release Supplement 504C for SCO OpenServer Release 5.0.4 (rs504c)
SCO OpenServer Release 5.0.2
Install these patches:
- SCO Internet Supplement for SCO Internet FastStart 1.0.0, 1.1.0 and SCO OpenServer 5.0.0, 5.0.2 (rs40b)
- Sendmail Security Supplement (OSS443a) (if you are using the sendmail mail system)
- Networking Performance SLS (OSS449f)
- SCOhelp Supplement for SCO OpenServer 5.0.2 Localization Support (rs311a)
SCO OpenServer Release 5.0.0
Install these patches:
- SCO OpenServer Release 5 Release Supplement Version 5.0.0d (rs500d)
- SCO Networking Supplement Release 1.0 (net100)
- SCO Internet Supplement for SCO Internet FastStart 1.0.0, 1.1.0 and SCO OpenServer 5.0.0, 5.0.2 (rs40b)
- SCOhelp Supplement for SCO OpenServer 5.0.0 Localization Support (rs.2.5.a)
- Sendmail Security Supplement (OSS443a) (if you are using the sendmail mail system)
- Networking Performance SLS (OSS449f)
SCO Internet FastStart
Install these patches:
- Sendmail Security Supplement (OSS443a) (if you are using the sendmail mail system)
- Networking Performance SLS (OSS449f)
These patches are available from the SCO FTP Archive Site (ftp://ftp.sco.com/).
Use the SCOadmin Software Manager (in the System Administration window on your desktop) to load and apply these patch supplements. For information on using the Software Manager, see ``Installing and managing software components'' (http://osr5doc.sco.com:457/HANDBOOK/swaN.admin.html in SCO OpenServer Handbook (http://osr5doc.sco.com:457/HANDBOOK/CONTENTS.html) or ``Installing, removing software'' (http://osr5doc.sco.com:1996/FASTSTART/swaN.admin.html) in SCO Internet FastStart http://osr5doc.sco.com:1996/Internet/FASTSTART/.
NOTE: If you try to install SCO PPP from Morning Star before you install the required patches, you will be notified that a patch is required. However, the Software Manager (custom(ADM)) continues the first part of the installation of the product. This might take a few minutes. Afterwards, the custom window that lists the products installed on the system shows the product as partially installed. Because only the product package files are loaded at this point, you are not able to run SCO PPP from Morning Star. Install the required patches, then reinstall SCO PPP from Morning Star to be able to run the product on your system.
Use the Software Manager to install the product.

To remove a product or patch, use the Software Manager.

For information on using the Software Manager, see ``Installing and managing software components'' (http://osr5doc.sco.com:457/HANDBOOK/swaN.admin.html in SCO OpenServer Handbook (http://osr5doc.sco.com:457/HANDBOOK/CONTENTS.html) or ``Installing, removing software'' (http://osr5doc.sco.com:1996/FASTSTART/swaN.admin.html) in SCO Internet FastStart http://osr5doc.sco.com:1996/Internet/FASTSTART/.

SCO PPP from Morning Star 2.1.3 notes

These notes cover important information for running SCO PPP from Morning Star 2.1.3 on SCO OpenServer.

Panic bug fixed

On SCO PPP from Morning Star 2.1.2 and earlier, systems under heavy load would occasionally panic in the PPP tunnel driver. This has been corrected in 2.1.3.

Improved modem support

In this release of SCO PPP from Morning Star, any modem type listed in /usr/lib/uucp/defaults can now be used as the dialer field in /usr/lib/mstppp/Devices.

Improved multiport serial card support

On SCO PPP from Morning Star 2.1.2 and earlier, some serial devices were incorrectly locked. This has been corrected.

Log file readability improved

The Morning Star PPP log file normally contains timestamp information in a format that is difficult to read. This release of Morning Star PPP includes a script, /usr/lib/mstppp/readlog, that converts timestamp information into readable dates and times.

The command uses the syntax readlog filename, where filename is the name of the log file to view. When no filename is specified, the command defaults to /usr/adm/pppd.log. To read from the standard input, specify the filename as ``-''. For example, to view the log file as it is being written, enter:

tail -f /usr/adm/pppd.log | /usr/lib/mstppp/readlog -

Installing SCO PPP from Morning Star on SCO OpenServer 5.0.0

If you install SCO PPP from Morning Star on SCO OpenServer 5.0.0, you see an error at the end of the installation regarding not being able to find the add_setmember_libstz.sh file. Ignore this error as the product will fully install and run fine. The only result from this error is that you cannot search the MST_PPP manual pages from within SCOhelp.

Installing SCO PPP from Morning Star as a layered product

No graphical configuration utility is available if SCO PPP is installed as a layered product. However, if SCO PPP is installed as part of SCO Internet FastStart, the graphical Internet Manager is available.

Locating the local IP address of each PPP connection

The local IP address of each PPP connection must be on a different subnet number than the Ethernet IP address (if there is one).

Using dialback

Dialback is only supported for clients calling back servers (\M in Systems chat script); SCO PPP from Morning Star does not support servers calling back clients.

Connecting at baud rates of 115200

Connections made using SCO PPP from Morning Star will reach baud rates of 115200.

Running up to 250 concurrent sessions

Up to 250 concurrent sessions are supported.

To run 250 PPP concurrent connections:

Tune the kernel by running the following command:

/etc/conf/bin/idtune NMUXLINKS 320
Relink the kernel.

NOTE: Even after tuning the kernel, not every system will be able to support 250 connections, because pppd consumes system resources, such as memory, swap space, and CPU time.

PPP sessions do not count as logins

PPP sessions do not consume user licenses on SCO OpenServer and SCO Internet FastStart systems. Thus, for example, a system with a two-user UNIX license still supports up to 250 incoming PPP sessions.

Assigning IP addresses from a pool

To configure the system to automatically select an IP address for inbound PPP connections from a pool of addresses, first define the pool and then activate IP address pool selection:

Create the file /usr/lib/mstppp/IPPool with one line for each IP address you want to include in the pool of addresses.
On each line, include three fields: local IP address, remote IP address that may connect to the local address, and netmask. For example:
```
154.227.87.98   145.127.182.124   255.255.255.0
```
Configure the inbound PPP connection:
- If you have the Internet Manager installed, on the Internet Services page, click on the Network button, then click on PPP Connections. Click on Add New Dial-in PPP Connection or select an existing dial-in connection to modify.
  When the /usr/lib/mstppp/IPPool file exists, the inbound PPP connection configuration page displays a ``Use IP Address Pool'' checkbox. If you check this box, an IP address for the inbound connection will be chosen from available addresses listed in the IPPool file.
- If you do not have the Internet Manager installed, use the word ``POOL'' as the first argument after the login name in the Accounts file. Do not specify IP addresses or a netmask on this line. For example, Accounts contains a line like the following (presented here on two lines for clarity):
```
   ppp1  121.201.37.5:121.201.37.6
   exec /usr/lib/mstppp/exec.dialin netmask 255.255.255.0
```
  Change this line to:
```
   ppp1    POOL exec /usr/lib/mstppp/exec.dialin
```
Make sure dynamic reassignment of IP addresses is enabled on the system dialing in. If the dialing system is also running SCO PPP from MorningStar, do this by performing either of the following actions:
- If the dialing system has an Internet Manager, select the ``Dynamic'' checkbox when configuring the dial-out connection.
- If the dialing system does not have the Internet Manager, add a tilde (``~'') after each of the IP addresses specified in the Autostart file:
```
   /usr/lib/mstppp/dialout 127.0.0.2~:127.0.0.3~ auto exec
   /usr/lib/mstppp/exec.dialout netmask 255.255.255.0
```
If the dialing system is not running SCO PPP from MorningStar, see the documentation for that PPP software.

Line not dropped when active inbound PPP connection deleted

If you delete a PPP connection (with the Internet Manager) while that connection is active, the line will not be dropped, the pppd daemon will not be killed, and the /dev/tty* file will still be owned by the UID of the deleted user. To correct this, the system administrator must kill the orphaned pppd process (or reboot).

How the pppd daemon writes to the log file

The log file now records the time as the number of seconds since the UNIX epoch (January 1, 1970). This permits SCO Doctor™ to monitor and respond to PPP problems.

PPP dialin failure during initialization

PPP dial-in connections sometimes fail during initialization, logging this error message to /usr/adm/pppd.log:

pppd: Fatal system error: Can't ifconfig du1 (SIOCSIFADDR): File exists

Repeating the dial-in attempt should be successful.

Using dynamically assigned remote IP address as primary connection

On SCO systems other than SCO Internet FastStart systems, if you use a PPP connection with a dynamically assigned remote IP address as your primary connection to the Internet, you must edit /etc/tcp to add the default boot-time route.

File ownership of ttys

/usr/bin/enable and /usr/bin/disable change the file owner for the specified tty to bin. This might cause the following error even if /usr/lib/uucp/Devices is properly configured:

Connect failed: CAN'T ACCESS DEVICE

To fix this problem, run chmod 666 on the tty device.

Using hardware handshaking on modems

When using hardware handshaking on modems, rtscts-crtsfl is the pppd option you should use with the SCO serial driver. When needed, this option should be added to the entry in the /usr/lib/mstppp/Autostart file for outgoing connections, and the /usr/lib/mstppp/Accounts file for incoming connections.

For a list of all the options available with PPP, enter:

/usr/lib/mstppp/pppd help | more

Supported data speeds on COM1 and COM2

An enhanced serial driver is incorporated the SCO Internet Supplement for SCO OpenServer 5.0.0 and 5.0.2, and is a standard feature of SCO OpenServer 5.0.4. (See ``Installing and removing SCO PPP from Morning Star 2.1.3'' for information on these supplements.) This serial driver provides data speeds up to and including 115200bps on your standard COM1 and COM2 ports, as well as other non-intelligent serial boards listed by the mkdev serial command. However, these high serial speeds are subject to the following hardware limitations:

Serial ports without a 16550 UART chip are only supported at data rates up to and including 9600bps. Contact your serial board or system manufacturer to be sure that you are using a serial board with a 16550 UART.
Due to the rate at which interrupts can be handled and the speed at which the UART buffer is overwritten at high speeds, simultaneous data rates of 57600bps or higher are only supported on a single serial port at a time.

For more information:

SCO PPP from Morning Star User's Guide: Online:
http://osr5doc.sco.com:1996/Internet/PPP/ug211/ppp1_2.html
PostScript (on the WWW):
http://www.sco.com/documentation/postscript/mst/ppp/

See ``Documentation notes'' for notes on the Morning Star documentation.

Documentation notes

Because SCO PPP is supported by several operating systems, the documentation might include information specific to other operating systems. You can ignore such information.

The following additions and corrections to the Morning Star PPP book is specific to the SCO OpenServer and SCO Internet FastStart versions of the products.

See ``Accessing documentation'' for information on accessing the online and PostScript versions of the documentation.

SCO PPP from Morning Star User's Guide addendum

These notes supplement the SCO PPP from Morning Star User's Guide, which is available online from http://osr5doc.sco.com:1996/Internet/PPP/ug211/ppp1_2.html. PostScript for this book is available on the WWW at http://www.sco.com/documentation/postscript/mst/ppp/.

The example on page 53 recommends editing the /etc/passwd file. It is recommended that you use the SCOadmin Account Manager instead.