This commit is contained in:
gferg 2000-06-21 14:35:52 +00:00
parent 8aaa4658f1
commit d065e12233
1 changed files with 548 additions and 0 deletions

View File

@ -0,0 +1,548 @@
<!DOCTYPE LINUXDOC SYSTEM>
<ARTICLE>
<title>call-back mini HOWTO
<author>by Pawel Skonecki, <tt><htmlurl url="mailto:stona@fizyka.umcs.lublin.pl" name="stona@fizyka.umcs.lublin.pl"></tt>
<date>v1.1a, June 2000</date>
<abstract>
This document describes how to set up call-back by using the Linux
system and modem. I would like to thank Anna for her patience.
</abstract>
<TOC>
<SECT>Introduction
<SECT1>OPINION
<P>
I'll will be waiting for all opinions about this document. I have tried
to gather information as complete as possible. Tell me when your find
any mistakes. I'll be grateful to people who will send me any suggestions
or corrections. Their contributions will make this document better.
I don't mind answering your questions but I'd rather you read the
whole article first.
</SECT1>
<SECT1>PUBLISHING
<P>
This document can by published under the conditions of Linux Documentation
Project. Get in touch with the author if you can't get this license.
This document is free.
</SECT1>
</SECT>
<SECT>Procedure
<SECT1>PART I: Net at home ?
<P>
Most of us use the Internet in a place of work. However we offen need
the net at home or outside the place of work. It may be possible that
the work from home is cheaper then from a company building. I think
that the best solution is to install call-back software on the Linux
server. Call-back makes it possible to re-call index number at the
cost of the company. I'll try to present how it works. An entitled
person calls modem is varied for the first time in Linux server. Then
on the user's side the "hang up modem" is switched on. At the same
time Linux calls the user. User is verified again. We have connection
and the server is charged. The user pays only for the initiation of
connection. The double verification and extra options in the call-back
program unable the unsuitable persons to charge our bill. We can restrict
the access to the connection only to corporation network or Internet.
Call-back is very flexible. Below, I'll try to present the configuration
of a call-back server on Linux system and I'll show you how to set
up your computer for re-calling the connection.
</SECT1>
<SECT1>PART II: The first steps with modem.
<P>
The administrators prefer different modem but while buying a modem
we should remember about certain rules:
<itemize>
<item>Don't buy the Win-Modem because it doesn't work with Linux
<item>The external modem works faster than the modem which is inside your
computer
<item>The internal modem with ISA slot is better then the are with PCI
slot (you can use your PCI slot for something different)
<item>Don't use Plug&amp;Play modem. If you have it set off, Plug&amp;Play options
and set up modem on free com (read Plug&amp;Play-HOWTO).
</itemize>
<P>
When we have the suitable modem we have to set it up in our system.
We have to check on which com our modem is. Then we have to make a
symbolic link to this hardware and /dev/modem. For example, if we
have the modem for the 2nd com we write:
<VERB>
ln -s /dev/cua1 /dev/modem
</VERB>
We check it
<VERB>
lrwxrwxrwx 1 root uucp 9 Sep 19 19:10 /dev/modem -> /dev/cua1
</VERB>
If we have the modem on different com we have to remember that
<VERB>
/dev/cua0 is com1
/dev/cua1 is com2
/dev/cua2 is com3
/dev/cua3 is com4
</VERB>
For new kernels:
<VERB>
/dev/ttyS0 is com1
/dev/ttyS1 is com2
/dev/ttyS2 is com3
/dev/ttyS3 is com4
</VERB>
Now, we check our configuration using the program minicom.
</SECT1>
<SECT1>PART III Call Linux
<P>
The first step to make the call-back on Linux accessible is to set
up a suitable parameter in kernel. Then we check whether our kernel
serves the protocol ppp. If you don't have ppp in your kernel or in
module you will have to compile your kernel and add ppp. You will
find more information in Kernel-HOWTO. OK. We have a good kernel.
Now, we have to set up software to our system. The call-back program
is a part of mgetty-sendfax and ppp. You will find it all in your
distribution. Because call-back system we have double verification
and we create a user who will be running ppp on the side of server.
<VERB>
pppuser:klkIOM89mn65H:230:PPP Dialin:/home/pppuser:/etc/ppp/ppplogin
</VERB>
Then change the password. We have to add information abut password in
the file <TT>/etc/ppp/pap-secrets</TT> (more in man pppd)
<VERB>
pppuser * password_for_pppuser *
</VERB>
This user doesn't have a usual shell but a file <TT>/etc/ppp/ppplogin</TT>.
We have to make it ourselves. for example <TT>vi /etc/ppp/ppplogin</TT> and
we type:
<VERB>
#!/bin/sh
exec /usr/sbin/pppd -detach 192.168.1.1:192.168.1.2
</VERB>
where the address 192.168.1.1 is the address of server with modem and
the address 192.168.1.2 is the address which we assigned to our modem.
We set up executable options for this file. Because we will use the
ppp demon we have to set up the options for this demon. We edit file
<TT>/etc/ppp/options</TT>:
<VERB>
netmask 255.255.255.0
proxyarp
lock
crtscts
modem
</VERB>
Proxyarp is the most important from the above options, because you
can go to Internet by the modem in the server. The remaining options
are used control your modem. Your user can work only in local network
if you remove proxyarp option. You have to see PPP-HOWTO and man pppd
for more information. We will set up our modem now. Our server must
be ready to receive a connection after start. We edit file <TT>/etc/inittab</TT>
and we add it's to modem on the 2en com.
<VERB>
s1:2345:respawn:/sbin/mgetty ttyS1 -D /dev/ttyS1 vt100
</VERB>
For the 1st com line looks as follows:
<VERB>
s0:2345:respawn:/sbin/mgetty ttyS1 -D /dev/ttyS1 vt100
</VERB>
We make <TT>init q</TT>. If we don't have information about any mistakes in
logs we go to the next step. We come back to directory <TT>/etc/ppp</TT> and
create <TT>options.ttyS1</TT> (for modem com1 <TT>options.ttyS0</TT>)
<VERB>
IP_local: IP_remote
</VERB>
for our net it will be
<VERB>
192.168.1.1:192.168.1.2
</VERB>
We have done a lot work so far. Now, we check the file
<TT>/etc/mgetty+sendfax/login.config</TT>. The most important line is:
<VERB>
/AutoPPP/ - a_ppp /usr/sbin/pppd auth -chap +pap login detach kdebug 7 debug
</VERB>
The remaining lines can be marked <TT>#</TT>.
<P>
We have to set up suid for ppp demon, because pppuser has to run pppd
and make interface work.
<VERB>
chmod u+s /usr/sbin/pppd
</VERB>
and its effect is:
<VERB>
-rwsr-xr-x 1 root root 106892 Jan 11 1999 /usr/sbin/pppd
</VERB>
I think that it is a good idea is to add it to cron becouse I had a
problem after restart of my server pppd changed preference.
Our server will work as router. We have to enable IP forwarding and
we add this line for the file <tt>/etc/rc.d/rc.local</tt> :
<VERB>
echo "1" > /proc/sys/net/ipv4/ip_forward
</VERB>
If you are RedHat user you can change in <TT>/etc/sysconfig/network</TT> from
<TT>FORWARD_IPV4=false</TT> to <TT>FORWARD_IPV4=true</TT>.
<P>
For verification we call to Linux. We use scripts for it. If we do this in
MS Windows we mark options <tt>"call out a terminal after connection"</TT>.
We login as pppuser with its password. I hope that all is OK.
</SECT1>
<SECT1>PART IV Linux calls us
<P>
We can already call our Linux. Now it's time Linux called us. It's
not very diffucalt. We have to edit only two files. We create a file
<TT>/etc/mgetty+sendfax/callback.conf</TT> and we leave it empty.
<P>
Then we have to ask our users for their phone number. It's time to
write the numbers we have connected earlier. In order to do it we
edit <TT>/etc/mgetty+sendfax/login.conf</TT> and add line:
<VERB>
call - - /usr/sbin/callback - S 123456
</VERB>
where call is a pseudo-user needed to initiate the connection. The
line in the <TT>/etc/mgetty+sendfax/login.conf</TT> puts in motion the program
calling the given number (in this case it's 123456). The same procedures
can be applied to other users. I'll try to explain how it works. When
we call a server. It asks us to give verification. We login as pseudo-user,
in this case it calls. The script in our computer hangs up the modem.
We wait and the connection is cut off. The program call-back starts
working and recalls us. We verify ourselves again as pppuser with
password. We combine the connection and interface ppp. That's all. The
configuration of work-stations is very simple. When you have MS
Windows, you have to install dial-up for your number. In the modem
propriety we find " propriety---&gt;extended---&gt; extra options" where
we write.
<VERB>
&amp;c0s0=1
</VERB>
We close the window and call. We log in according to the description
given above. If we want to use Linux, we must refer to the script.
It's difficult to give only one good script for our Linux. A good
configuration of ppp in the system is of primary importance. (You
can call it as pppuser through the scripts first).The scripts below
were whiten by A. Gozdz. I suggest putting everything to catalogue.
It is only my suggestion &amp; you don't have to start the scripts here.
Detailed information cocernig writing scripts on Linux can found in
PPP-HOWTO.
<P>
<BF>THESE SCRIPTS WORK WELL WITH SLACKWARE</BF>
<P>
The configuration file of daemon ppp (an example for modem on com2)
<TT>/etc/options</TT>
<VERB>
lock
defaultroute
noipdefault
modem
/dev/cua1
33600
crtscts
debug
passive
asyncmap 0
</VERB>
and the specific scripts
<itemize>
<item>the first named /etc/ppp/ppp-call
<VERB>
#!/bin/bash
teksta="Connection failed"
tekstb="Probably, You will be connect"
# /sbin/setserial /dev/cua1 spd_vhi
killall -INT pppd 2>/dev/null
rm -f /var/lock/LCK* /var/run/ppp*.pid
(/usr/sbin/pppd -detach /dev/ttyS1 115200 \
connect "/usr/sbin/chat -v -f /etc/ppp/pppcallback" &amp;) || \
(echo $teksta; ls marsss >/dev/null; exit 1)
echo $tekstb
exit 0
</VERB>
<item>the second file called /etc/ppp/pppcallback
<VERB>
TIMEOUT 60
ABORT 'ERROR'
ABORT 'BUSY'
ABORT 'NO ANSWER'
ABORT 'NO DIALTONE'
ABORT '\nVOICE\r'
ABORT '\nRINGING\r\n\r\nRINGING\r'
'' AT&amp;FH0 <p>'OK-+++\c-OK' 'AT&amp;C0S0=1'
TIMEOUT 75
OK ATDT123456
CONNECT ''
ogin:-ogin: ppp_pseudouser
'\nNO CARRIER\r' ''
TIMEOUT 180
'\nRING\r' AT&amp;C1A
CONNECT ''
TIMEOUT 20
ogin:-ogin: pppuser
sword:-sword password_for_pppuser
</VERB>
<item>You can ppp-call, now. :)
</itemize>
<P>
<BF>THESE SCRIPTS WORK GOOD WITH LINUX RED HAT 6.x</BF>
<itemize>
<item>/etc/ppp/options
<VERB>
lock
defaultroute
noipdefault
modem
33600
crtscts
debug
passive
asyncmap 0
</VERB>
<item>/etc/ppp/pppcallback
<VERB>
TIMEOUT 5
ABORT 'ERROR'
ABORT 'BUSY'
ABORT 'NO ANSWER'
ABORT 'NO DIALTONE'
ABORT '\nVOICE\r'
ABORT '\nRINGING\r\n\r\nRINGING\r'
'' AT&amp;FH0 'OK-+++\c-OK' 'AT&amp;C0S0=1'
TIMEOUT 40
OK ATDT5376443 CONNECT ''
ogin:-ogin: ppp-pseudo-user
'\nNO CARRIER\r' ''
TIMEOUT 180
'\nRING\r' AT&amp;C1A
CONNECT ''
TIMEOUT 20
ogin:-ogin: pppuser
sword:-sword password_for_ppuser
</VERB>
<item>/usr/bin/ppp-call
<VERB>
#!/bin/bash
teksta="Connection failed"
tekstb="Probably, You will be connect"
# /sbin/setserial /dev/cua1 spd_vhi
killall -INT pppd 2>/dev/null
rm -f /var/lock/LCK* /var/run/ppp*.pid
(/usr/sbin/pppd -detach call ppp_call &amp;) || \
(echo $teksta; ls marsss >/dev/null; exit 1)
echo $tekstb
exit 0
</VERB>
<item>You can run ppp-call, now. :)
</itemize>
<P>
If you have M$ Windows you can use this script for conection. I don't
test it (I use terminal) you can ask some more Adrian Debkowski
(<htmlurl url="mailto:adrian@cr-media.pl" name="adrian@cr-media.pl">).
<VERB>
proc main
delay 1
waitfor "ogin:"
transmit "call^M"
waitfor "RING"
transmit "ATA^M"
waitfor "CONNECT"
waitfor "ogin:"
transmit "pppuser^M"
waitfor "word:"
transmit "ppp^M"
endproc
</VERB>
</SECT1>
<SECT1>PART V Summary
<P>
The Configuration of call-back is not complicated. The most important
thing is a proper arrangement of ppp server on Linux. I don't know
a better way of setting up an access - server. The configuration presented
above is a result of numerous attempts and it can be done in a different
way. That's way I suggest reading all documents concerning this issue
man pppd, NET4-HOWTO, PPP-HOWTO.
</SECT1>
</SECT>
</ARTICLE>