<chapter id="pppsvrconfig.convert.app-1"><title>Migrating From Asynchronous
Solaris PPP to Solaris PPP 4.0 (Tasks)</title><highlights><itemizedlist><para>Earlier versions of the Solaris
OS included a different PPP implementation,
Asynchronous Solaris PPP (<command>asppp</command>).
If you want to convert peers that
run <command>asppp</command> to the
newer PPP 4.0, you need to run a conversion
script. This chapter covers the following
topics in PPP conversion:</para><listitem><para><olink targetptr="pppsvrconfig.convert.app-2" remap="internal">Before
Converting asppp Files</olink></para>
</listitem><listitem><para><olink targetptr="pppsvrconfig.convert.app-5" remap="internal">Running
the asppp2pppd Conversion Script (Tasks)</olink></para>
</listitem>
</itemizedlist><para>The chapter uses a sample <command>asppp</command> configuration to explain
how to accomplish PPP conversion.
For a description of the differences
between Solaris PPP 4.0 and <command>asppp</command>, go to <olink targetptr="pppsvrconfig.intro-5" remap="internal">Which
Version of Solaris PPP to Use</olink>.</para>
</highlights><sect1 id="pppsvrconfig.convert.app-2"><title>Before Converting <command>asppp</command> Files</title><itemizedlist><para>You can use the conversion
script <command>/usr/sbin/asppp2pppd</command> to
convert the files that compose a standard <command>asppp</command> configuration:</para><listitem><para><filename>/etc/asppp.cf</filename> &ndash;
Asynchronous PPP configuration file</para>
</listitem><listitem><para><filename>/etc/uucp/Systems</filename> &ndash; UUCP file that
describes the characteristics of the
remote peer</para>
</listitem><listitem><para><filename>/etc/uucp/Devices</filename> &ndash; UUCP file that
describes the modem on the local machine</para>
</listitem><listitem><para><filename>/etc/uucp/Dialers</filename> &ndash; UUCP file that
contains the login sequence to be
used by the modem that is described
in the <filename>/etc/uucp/Devices</filename> file</para>
</listitem>
</itemizedlist><para>For more information about <command>asppp</command>, see the <emphasis>Solaris
8 System Administration Collection,
Volume 3</emphasis>, available from <literal>http://docs.sun.com</literal>.</para><sect2 id="pppsvrconfig.convert.app-3"><title>Example of the <filename>/etc/asppp.cf</filename> Configuration File</title><para>The procedure that is
shown in <olink targetptr="ppp.convert-21" remap="internal">How to
Convert From asppp to Solaris PPP
4.0</olink> uses the following <filename>/etc/asppp.cf</filename> file.</para><screen>#
ifconfig ipdptp0 plumb mojave gobi up

path
 inactivity_timeout 120     # Approx. 2 minutes
	interface ipdptp0
	peer_system_name Pgobi    # The name we log in with (also in
				                     # /etc/uucp/Systems</screen><para>The file contains the following
parameters.</para><variablelist><varlistentry><term><literal>ifconfig
ipdptp0 plumb mojave gobi up</literal></term><listitem><para>Runs the <command>ifconfig</command> command to configure a
link from PPP interface <literal>ipdptp0</literal> on
the local machine <literal>mojave</literal> to
the remote peer <literal>gobi</literal></para>
</listitem>
</varlistentry><varlistentry><term><literal>inactivity_timeout
120</literal></term><listitem><para>Terminates the line
after  two minutes of inactivity</para>
</listitem>
</varlistentry><varlistentry><term><literal>interface
ipdptp0</literal></term><listitem><para>Configures the interface <filename>ipdptp0</filename> on the dial-out
machine for asynchronous PPP</para>
</listitem>
</varlistentry><varlistentry><term><literal>peer_system_name
Pgobi</literal></term><listitem><para>Gives the name of
the remote peer, <literal>Pgobi</literal></para>
</listitem>
</varlistentry>
</variablelist>
</sect2><sect2 id="pppsvrconfig.convert.app-9"><title>Example of the <filename>/etc/uucp/Systems</filename> File</title><para>The procedure that is
shown in <olink targetptr="ppp.convert-21" remap="internal">How to
Convert From asppp to Solaris PPP
4.0</olink> uses the following <filename>/etc/uucp/Systems</filename> file.</para><screen>#ident  "@(#)Systems	1.5  92/07/14 SMI"  /* from SVR4 bnu:Systems 2.4 */
#

# .
# .
Pgobi Any ACU 38400 15551212 in:--in: mojave word: sand</screen><para>The file contains the following
parameters:</para><variablelist><varlistentry><term><literal>Pgobi</literal></term><listitem><para>Uses <literal>Pgobi</literal> as
the host name of the remote peer.</para>
</listitem>
</varlistentry><varlistentry><term><literal>Any ACU</literal></term><listitem><para>Tells the modem on
the dial-out machine <literal>mojave</literal> to
establish a link with a modem on <literal>Pgobi</literal> at any time of the
day. Any ACU means &ldquo;look for
ACU in the <filename>/etc/uucp/Devices</filename> file.&rdquo;</para>
</listitem>
</varlistentry><varlistentry><term><literal>38400</literal></term><listitem><para>Sets 38400 as the
maximum speed of the link.</para>
</listitem>
</varlistentry><varlistentry><term><literal>15551212</literal></term><listitem><para>Gives the telephone
number of <literal>Pgobi</literal>.</para>
</listitem>
</varlistentry><varlistentry><term><literal>in:&mdash;in:
mojave word: sand</literal></term><listitem><para>Defines the login
script that is required by <literal>Pgobi</literal> to authenticate dial-out
machine <literal>mojave</literal>.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2><sect2 id="pppsvrconfig.convert.app-10"><title>Example of the <filename>/etc/uucp/Devices</filename> File</title><para>The procedure that is
shown in <olink targetptr="ppp.convert-21" remap="internal">How to
Convert From asppp to Solaris PPP
4.0</olink> uses the following <filename>/etc/uucp/Devices</filename> file.</para><screen>#ident  "@(#)Devices  1.6  92/07/14 SMI"  /* from SVR4 bnu:Devices 2.7 */

.
.
#

TCP,et - - Any TCP -
.
.
#
ACU cua/b - Any hayes
# 0-7 are on a Magma 8 port card
Direct cua/0 - Any direct
Direct cua/1 - Any direct
Direct cua/2 - Any direct
Direct cua/3 - Any direct
Direct cua/4 - Any direct
Direct cua/5 - Any direct
Direct cua/6 - Any direct
Direct cua/7 - Any direct
# a is the console port (aka "tip" line)
Direct cua/a - Any direct
# b is the aux port on the motherboard
Direct cua/b - Any direct
# c and d are high speed sync/async ports
Direct cua/c - Any direct
Direct cua/d - Any direct</screen><para>The file supports any Hayes
modem that is connected to serial
port <literal>cua/b</literal>.</para>
</sect2><sect2 id="pppsvrconfig.convert.app-11"><title>Example of the <filename>/etc/uucp/Dialers</filename> File</title><para>The procedure that is
shown in <olink targetptr="ppp.convert-21" remap="internal">How to
Convert From asppp to Solaris PPP
4.0</olink> uses the following <filename>/etc/uucp/Dialers</filename> file.</para><screen>#
#<lineannotation>&lt;Much information about modems supported by Solaris UUCP></lineannotation>


penril	=W-P	"" \d > Q\c : \d- > s\p9\c )-W\p\r\ds\p9\c-) y\c : \E\TP > 9\c OK
ventel	=&amp;-%	"" \r\p\r\c $ k\c ONLINE!
vadic	=K-K	"" \005\p *-\005\p-*\005\p-* D\p BER? \E\T\e \r\c LINE
develcon ""	"" \pr\ps\c est:\007 \E\D\e \n\007
micom	""	"" \s\c NAME? \D\r\c GO
direct
#
#
#
#   Hayes Smartmodem -- modem should be set with the configuration
#   switches as follows:
#
#       S1 - UP		S2 - UP		S3 - DOWN	S4 - UP
#       S5 - UP		S6 - DOWN	S7 - ?		S8 - DOWN
#
hayes	=,-,	"" \dA\pTE1V1X1Q0S2=255S12=255\r\c OK\r \EATDT\T\r\c CONNECT

<lineannotation>&lt;much more information about modems supported by Solaris UUCP></lineannotation></screen><para>This file contains the chat
scripts for all types of modems, including
the Hayes modems that are supported
in the <filename>/etc/uucp/Dialers
file</filename>.</para>
</sect2>
</sect1><sect1 id="pppsvrconfig.convert.app-5"><title>Running the <command>asppp2pppd</command> Conversion
Script (Tasks)</title><para>The <command>/usr/sbin/asppp2pppd</command> script
copies the PPP information  in <command>/etc/asppp.cf</command> and PPP-related UUCP files
to appropriate locations in the Solaris
PPP 4.0 files. </para><sect2 id="pppsvrconfig.convert.app-12"><title>Task Prerequisites</title><itemizedlist><para>Before doing the next task,
you should have done the following:</para><listitem><para>Installed
the Solaris 9 release or Solaris 10
release on the machine that also has
the <command>asppp</command> and UUCP
configuration files</para>
</listitem><listitem><para>Become superuser on
the machine with the PPP files, for
example, the machine <literal>mojave</literal></para>
</listitem>
</itemizedlist>
</sect2><task id="ppp.convert-21"><title>How
to Convert From <command>asppp</command> to
Solaris PPP 4.0</title><procedure><step id="pppsvrconfig.convert.app-step-7"><para>Start the conversion script.</para><screen># <userinput>/usr/sbin/asppp2pppd</userinput></screen><para>The conversion process starts
and gives you the following screen
output.</para><screen>This script provides only a suggested translation for your existing aspppd
configuration.  You will need to evaluate for yourself whether the translation
is appropriate for your operating environment.
Continue [Yn]? </screen>
</step><step id="pppsvrconfig.convert.app-step-13"><para>Type &ldquo;Y&rdquo; to continue.</para><para>You receive the following output.</para><screen>Chat cannot do echo checking; requests for this removed.
Adding 'noauth' to /etc/ppp/options

Preparing to write out translated configuration:
    1 chat file:
        1.  /etc/ppp/chat.Pgobi.hayes
    2 option files:
        2.  /etc/ppp/peers/Pgobi
        3.  /etc/ppp/options
    1 script file:
        4.  /etc/ppp/demand</screen><para>The new Solaris PPP 4.0 files
have been generated.</para>
</step>
</procedure>
</task><task id="ppp.convert-22"><title>How
to View the Results of the Conversion</title><tasksummary><para>You can view the Solaris
PPP 4.0 files that were created by
the <command>/usr/sbin/asppp2pppd</command> conversion
script at the end of the conversion
process. The script displays the following
list of options.</para><screen>Enter option number:
        1 - view contents of file on standard output
        2 - view contents of file using /usr/bin/less
        3 - edit contents of file using /usr/bin/vi
        4 - delete/undelete file from list
        5 - rename file in list
        6 - show file list again
        7 - escape to shell (or "!")
        8 - abort without saving anything
        9 - save all files and exit (default)
Option:</screen>
</tasksummary><procedure><step id="pppsvrconfig.convert.app-step-15"><para>Type <userinput>1</userinput> to
view the contents of the files on
the screen. </para><para>The script
requests the number of the file you
want to view.</para><screen>File number (1 .. 4):</screen><para>The numbers refer to the translated
files that are listed during the conversion
process, as shown in the previous
Step 2.</para>
</step><step id="pppsvrconfig.convert.app-step-16"><para>Type <literal>1</literal> to
view the chat file <filename>/etc/ppp/chat.Pgobi.hayes</filename>.</para><screen>File number (1 .. 4):  1
"" \d\dA\p\pTE1V1X1Q0S2=255S12=255\r\c
OK\r ATDT\T\r\c
CONNECT \c
in:--in: mojave
word: sand</screen><para>The chat script contains the
modem &ldquo;chat&rdquo; information
that appears on the hayes line in
the sample <filename>/etc/uucp/Dialers</filename> file. <filename>/etc/ppp/chat.Pgobi.hayes</filename> also
contains the login sequence for <literal>Pgobi</literal> that appears in the
sample <filename>/etc/uucp/Systems</filename> file.
The chat script is now in the <filename>/etc/ppp/chat.Pgobi.hayes</filename> file.</para>
</step><step id="pppsvrconfig.convert.app-step-17"><para>Type <literal>2</literal> to
view the peers file, <filename>/etc/ppp/peers/Pgobi</filename>. </para><screen>File number (1 .. 4):  2
/dev/cua/b
38400
demand
idle 120
connect "/usr/bin/chat -f /etc/ppp/chat.Pgobi.hayes -T '15551212'"
user NeverAuthenticate
mojave:gobi</screen><para>The serial port information
(<filename>/dev/cua/b</filename>)
is from the <filename>/etc/uucp/Devices</filename> file.
The link speed, idle time, authentication
information, and peer names are from
the <filename>/etc/asppp.cf</filename> file. &ldquo;demand&rdquo;
refers to the &ldquo;demand&rdquo;
script, to be called when the dial-out
machine tries to connect to peer <literal>Pgobi</literal>.</para>
</step><step id="pppsvrconfig.convert.app-step-18"><para>Type <literal>3</literal> to
view the <filename>/etc/ppp/options</filename> file
that are created for dial-out machine <literal>mojave</literal>.</para><screen>File number (1 .. 4):  3
#lock
noauth</screen><para>The information in <filename>/etc/ppp/options</filename> is from the <filename>/etc/asppp.cf</filename> file.</para>
</step><step id="pppsvrconfig.convert.app-step-19"><para>Type <literal>4</literal> to
view the contents of the <filename>demand</filename> script.</para><screen>File number (1 .. 4):  4
/usr/bin/pppd file /etc/ppp/peers/Pgobi</screen><para>This script, when invoked, runs
the <command>pppd</command> command,
which then reads the <filename>/etc/ppp/peers/Pgobi</filename> to initiate the link between <literal>mojave</literal> and <literal>Pgobi</literal>.</para>
</step><step id="pppsvrconfig.convert.app-step-20"><para>Type <literal>9</literal> to
save the created files. Then exit
the conversion script.</para>
</step>
</procedure>
</task>
</sect1>
</chapter>