From b46cda58ab1e2e3cdd45b3b9e8438d90c2e3ed8d Mon Sep 17 00:00:00 2001 From: Alain Reguera Delgado Date: Oct 11 2011 03:22:14 +0000 Subject: Reorganize file structure for `trunk/Manuals/HowTos/Dialup' documentation manual. --- diff --git a/Manuals/HowTos/Dialup/Client.ent b/Manuals/HowTos/Dialup/Client.ent index c89c2b8..ad1d416 100644 --- a/Manuals/HowTos/Dialup/Client.ent +++ b/Manuals/HowTos/Dialup/Client.ent @@ -1,10 +1,15 @@ + + - - + + + + - - - + + + + diff --git a/Manuals/HowTos/Dialup/Client/Config.docbook b/Manuals/HowTos/Dialup/Client/Config.docbook index 6396561..3f8064c 100644 --- a/Manuals/HowTos/Dialup/Client/Config.docbook +++ b/Manuals/HowTos/Dialup/Client/Config.docbook @@ -3,7 +3,9 @@ Dial-Up Client Configuration &client-config-overview; - &client-config-hardware; - &client-config-software; + &client-config-modem; + &client-config-pppd; + &client-config-wvdial; + &client-config-scn; diff --git a/Manuals/HowTos/Dialup/Client/Config/modem.docbook b/Manuals/HowTos/Dialup/Client/Config/modem.docbook new file mode 100644 index 0000000..21df06e --- /dev/null +++ b/Manuals/HowTos/Dialup/Client/Config/modem.docbook @@ -0,0 +1,9 @@ + + + Configuring Modem Hardware + + + ... + + + diff --git a/Manuals/HowTos/Dialup/Client/Config/pppd.docbook b/Manuals/HowTos/Dialup/Client/Config/pppd.docbook new file mode 100644 index 0000000..c46501e --- /dev/null +++ b/Manuals/HowTos/Dialup/Client/Config/pppd.docbook @@ -0,0 +1,8 @@ + + + Configuring <package>pppd</package> Package + + ... + + + diff --git a/Manuals/HowTos/Dialup/Client/Config/scn.docbook b/Manuals/HowTos/Dialup/Client/Config/scn.docbook new file mode 100644 index 0000000..63bc71a --- /dev/null +++ b/Manuals/HowTos/Dialup/Client/Config/scn.docbook @@ -0,0 +1,8 @@ + + + Configuring <package>system-config-network</package> Package + + ... + + + diff --git a/Manuals/HowTos/Dialup/Client/Config/wvdial.docbook b/Manuals/HowTos/Dialup/Client/Config/wvdial.docbook new file mode 100644 index 0000000..bedda86 --- /dev/null +++ b/Manuals/HowTos/Dialup/Client/Config/wvdial.docbook @@ -0,0 +1,9 @@ + + + Configuring <package>wvdial</package> Package + + + ... + + + diff --git a/Manuals/HowTos/Dialup/Client/Install.docbook b/Manuals/HowTos/Dialup/Client/Install.docbook index 6753e7d..fc1c470 100644 --- a/Manuals/HowTos/Dialup/Client/Install.docbook +++ b/Manuals/HowTos/Dialup/Client/Install.docbook @@ -3,7 +3,9 @@ Dial-Up Client Installation &client-install-overview; - &client-install-hardware; - &client-install-software; + &client-install-modem; + &client-install-pppd; + &client-install-wvdial; + &client-install-scn; diff --git a/Manuals/HowTos/Dialup/Client/Install/modem.docbook b/Manuals/HowTos/Dialup/Client/Install/modem.docbook new file mode 100644 index 0000000..c879194 --- /dev/null +++ b/Manuals/HowTos/Dialup/Client/Install/modem.docbook @@ -0,0 +1,9 @@ + + + Installing Modem Hardware + + + ... + + + diff --git a/Manuals/HowTos/Dialup/Client/Install/pppd.docbook b/Manuals/HowTos/Dialup/Client/Install/pppd.docbook new file mode 100644 index 0000000..0ac5fe4 --- /dev/null +++ b/Manuals/HowTos/Dialup/Client/Install/pppd.docbook @@ -0,0 +1,8 @@ + + + Installing <package>pppd</package> Package + + ... + + + diff --git a/Manuals/HowTos/Dialup/Client/Install/scn.docbook b/Manuals/HowTos/Dialup/Client/Install/scn.docbook new file mode 100644 index 0000000..4215391 --- /dev/null +++ b/Manuals/HowTos/Dialup/Client/Install/scn.docbook @@ -0,0 +1,9 @@ + + + Installing <package>system-config-network</package> Package + + + ... + + + diff --git a/Manuals/HowTos/Dialup/Client/Install/wvdial.docbook b/Manuals/HowTos/Dialup/Client/Install/wvdial.docbook new file mode 100644 index 0000000..3f5813f --- /dev/null +++ b/Manuals/HowTos/Dialup/Client/Install/wvdial.docbook @@ -0,0 +1,9 @@ + + + Installing <package>wvdial</package> Package + + + ... + + + diff --git a/Manuals/HowTos/Dialup/Client/Usage.docbook b/Manuals/HowTos/Dialup/Client/Usage.docbook index 281aca0..af40f42 100644 --- a/Manuals/HowTos/Dialup/Client/Usage.docbook +++ b/Manuals/HowTos/Dialup/Client/Usage.docbook @@ -2,8 +2,6 @@ Dial-Up Client Usage - - ... - + &client-usage-overview; diff --git a/Manuals/HowTos/Dialup/Client/Usage/overview.docbook b/Manuals/HowTos/Dialup/Client/Usage/overview.docbook new file mode 100644 index 0000000..a8f32d8 --- /dev/null +++ b/Manuals/HowTos/Dialup/Client/Usage/overview.docbook @@ -0,0 +1,9 @@ + + + Overview + + + ... + + + diff --git a/Manuals/HowTos/Dialup/Server/Config.docbook b/Manuals/HowTos/Dialup/Server/Config.docbook index 40c442b..88ebf36 100644 --- a/Manuals/HowTos/Dialup/Server/Config.docbook +++ b/Manuals/HowTos/Dialup/Server/Config.docbook @@ -3,7 +3,9 @@ Dial-Up Server Configuration &server-config-overview; - &server-config-hardware; - &server-config-software; + &server-config-modem; + &server-config-mgetty; + &server-config-pppd; + &server-config-wvdial; diff --git a/Manuals/HowTos/Dialup/Server/Config/hardware.docbook b/Manuals/HowTos/Dialup/Server/Config/hardware.docbook deleted file mode 100644 index 4660bc4..0000000 --- a/Manuals/HowTos/Dialup/Server/Config/hardware.docbook +++ /dev/null @@ -1,9 +0,0 @@ - - - Configuring Server Hardware - - - ... - - - diff --git a/Manuals/HowTos/Dialup/Server/Config/mgetty.docbook b/Manuals/HowTos/Dialup/Server/Config/mgetty.docbook new file mode 100644 index 0000000..7b193df --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Config/mgetty.docbook @@ -0,0 +1,9 @@ + + + Configuring <package>mgetty</package> Package + + ... + + + + diff --git a/Manuals/HowTos/Dialup/Server/Config/modem.docbook b/Manuals/HowTos/Dialup/Server/Config/modem.docbook new file mode 100644 index 0000000..3cec53a --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Config/modem.docbook @@ -0,0 +1,9 @@ + + + Configuring Modem Hardware + + + ... + + + diff --git a/Manuals/HowTos/Dialup/Server/Config/pppd.docbook b/Manuals/HowTos/Dialup/Server/Config/pppd.docbook new file mode 100644 index 0000000..fd3be5c --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Config/pppd.docbook @@ -0,0 +1,8 @@ + + + Configuring <package>pppd</package> Package + + ... + + + diff --git a/Manuals/HowTos/Dialup/Server/Config/software.docbook b/Manuals/HowTos/Dialup/Server/Config/software.docbook deleted file mode 100644 index e9c1e44..0000000 --- a/Manuals/HowTos/Dialup/Server/Config/software.docbook +++ /dev/null @@ -1,30 +0,0 @@ - - - Configuring Server Software - - - ... - - - - Configuring <package>mgetty</package> Package - - ... - - - - - Configuring <package>pppd</package> Package - - ... - - - - - Configuring <package>wvdial</package> Package - - ... - - - - diff --git a/Manuals/HowTos/Dialup/Server/Config/wvdial.docbook b/Manuals/HowTos/Dialup/Server/Config/wvdial.docbook new file mode 100644 index 0000000..ee97a72 --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Config/wvdial.docbook @@ -0,0 +1,9 @@ + + + Configuring <package>wvdial</package> Package + + + ... + + + diff --git a/Manuals/HowTos/Dialup/Server/Install.docbook b/Manuals/HowTos/Dialup/Server/Install.docbook index fcc98c2..80989b5 100644 --- a/Manuals/HowTos/Dialup/Server/Install.docbook +++ b/Manuals/HowTos/Dialup/Server/Install.docbook @@ -3,7 +3,9 @@ Dial-Up Server Installation &server-install-overview; - &server-install-hardware; - &server-install-software; + &server-install-modem; + &server-install-mgetty; + &server-install-pppd; + &server-install-wvdial; diff --git a/Manuals/HowTos/Dialup/Server/Install/hardware.docbook b/Manuals/HowTos/Dialup/Server/Install/hardware.docbook deleted file mode 100644 index 72b37bb..0000000 --- a/Manuals/HowTos/Dialup/Server/Install/hardware.docbook +++ /dev/null @@ -1,61 +0,0 @@ - - - Installing Server Hardware - - - In order to establish a PPP link between two computers using - the telephone line as medium for data transmission, you need - to install (at least) one modem device in each computer. - - - - To install a modem device in computer you need to attach the - modem hardware to the computer and later the telephone line to - the modem hardware. To connect the modem to your computer, you - need to connect the serial or USB cable that comes from the - modem hardware to the appropriate input on your computer. To - connect the modem to the telephone line system, you need to - unplug the cable that connects your telephone device and plug - it on the modem device, specifically in the port reserved for - data transmission. Later, using a similar cable, you could - connect your telephone device to the modem's telephone port, - so you can realize telephone calls when no data transmition - take place. - - - - To be on the safe side, do all the installation with the - computer turned off. Then, when everthing has been put in - place, turn it on. Once the system is up, you can verify the - modem hardware using either the lsusb or - lspci commands. These commands need to be - run with administrative privileges, so probably need to - sudo them or login as root user in order to execute - thme. For example, assuming you are logged in as root user, - and you are using an USB modem like that one we mentioned - before, the output of lsusb command would - look like the following: - - - -Bus 003 Device 001: ID 0000:0000 -Bus 001 Device 001: ID 0000:0000 -Bus 001 Device 002: ID 058f:6366 Alcor Micro Corp. Multi Flash Reader -Bus 002 Device 001: ID 0000:0000 -Bus 005 Device 003: ID 06e0:f104 Multi-Tech Systems, Inc. -MT5634ZBA-USB MultiModemUSB (new firmware) -Bus 005 Device 001: ID 0000:0000 -Bus 005 Device 002: ID 046d:c018 Logitech, Inc. Optical Wheel Mouse -Bus 004 Device 001: ID 0000:0000 - - - - The relevant line here is that mentioning the existence of a - Multi-Tech System, Inc. MT5634ZBA-USB MultiModemUSB (new - firmware) device. If the modem you installed doesn't - appear in this list, it is probably because such hardware is - not supported by &TCD;, yet. - - - diff --git a/Manuals/HowTos/Dialup/Server/Install/mgetty.docbook b/Manuals/HowTos/Dialup/Server/Install/mgetty.docbook new file mode 100644 index 0000000..7901a59 --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Install/mgetty.docbook @@ -0,0 +1,9 @@ + + + Installing <package>mgetty</package> Package + + ... + + + + diff --git a/Manuals/HowTos/Dialup/Server/Install/modem.docbook b/Manuals/HowTos/Dialup/Server/Install/modem.docbook new file mode 100644 index 0000000..b68c3e0 --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Install/modem.docbook @@ -0,0 +1,58 @@ + + + Installing Modem Hardware + + + In order to establish a PPP link between two computers using + the telephone line as medium for data transmission, you need + to install (at least) one modem device in each computer. To + install a modem device in computer you need to attach the + modem hardware to the computer and later the telephone line to + the modem hardware. To connect the modem to your computer, you + need to connect the serial or USB cable that comes from the + modem hardware to the appropriate input on your computer. To + connect the modem to the telephone line system, you need to + unplug the cable that connects your telephone device and plug + it on the modem device, specifically in the port reserved for + data transmission. Later, using a similar cable, you could + connect your telephone device to the modem's telephone port, + so you can realize telephone calls when no data transmition + take place. + + + + To be on the safe side, do all the installation with the + computer turned off. Then, when everthing has been put in + place, turn it on. Once the system is up, you can verify the + modem hardware using either the lsusb or + lspci commands. These commands need to be + run with administrative privileges, so probably need to + sudo them or login as root user in order to execute + thme. For example, assuming you are logged in as root user, + and you are using an USB modem like that one we mentioned + before, the output of lsusb command would + look like the following: + + + +Bus 003 Device 001: ID 0000:0000 +Bus 001 Device 001: ID 0000:0000 +Bus 001 Device 002: ID 058f:6366 Alcor Micro Corp. Multi Flash Reader +Bus 002 Device 001: ID 0000:0000 +Bus 005 Device 003: ID 06e0:f104 Multi-Tech Systems, Inc. +MT5634ZBA-USB MultiModemUSB (new firmware) +Bus 005 Device 001: ID 0000:0000 +Bus 005 Device 002: ID 046d:c018 Logitech, Inc. Optical Wheel Mouse +Bus 004 Device 001: ID 0000:0000 + + + + The relevant line here is that mentioning the existence of a + Multi-Tech System, Inc. MT5634ZBA-USB MultiModemUSB (new + firmware) device. If the modem you installed doesn't + appear in this list, it is probably because such hardware is + not supported by &TCD;, yet. + + + diff --git a/Manuals/HowTos/Dialup/Server/Install/pppd.docbook b/Manuals/HowTos/Dialup/Server/Install/pppd.docbook new file mode 100644 index 0000000..cf8882a --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Install/pppd.docbook @@ -0,0 +1,8 @@ + + + Installing <package>pppd</package> Package + + ... + + + diff --git a/Manuals/HowTos/Dialup/Server/Install/software.docbook b/Manuals/HowTos/Dialup/Server/Install/software.docbook deleted file mode 100644 index b7f1591..0000000 --- a/Manuals/HowTos/Dialup/Server/Install/software.docbook +++ /dev/null @@ -1,9 +0,0 @@ - - - Installing <package>wvdial</package> Package - - - ... - - - diff --git a/Manuals/HowTos/Dialup/Server/Install/wvdial.docbook b/Manuals/HowTos/Dialup/Server/Install/wvdial.docbook new file mode 100644 index 0000000..b7f1591 --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Install/wvdial.docbook @@ -0,0 +1,9 @@ + + + Installing <package>wvdial</package> Package + + + ... + + + diff --git a/Manuals/HowTos/Dialup/Server/Usage/auth.docbook b/Manuals/HowTos/Dialup/Server/Usage/auth.docbook new file mode 100644 index 0000000..fde3908 --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Usage/auth.docbook @@ -0,0 +1,28 @@ + + + Dial-Up Authentication + + + The credential required by the client computers to establish + dial-up connection with the server computer are always the + same. There is only one public username and password for all + client computers that must be used in order to establish + dial-up connection with the server computer. This information + is the following: + + + + ISP Name: projects.centos.org +ISP Phone: +53043515094 + Username: faith + Password: mail4u.2k10 + + + + The client computer can use this information to establish + connection to the server computer using any telephone number + from 10:00PM to 12:00AM. + + + + diff --git a/Manuals/HowTos/Dialup/Server/Usage/lifetime.docbook b/Manuals/HowTos/Dialup/Server/Usage/lifetime.docbook new file mode 100644 index 0000000..ec67cb8 --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Usage/lifetime.docbook @@ -0,0 +1,28 @@ + + + Dial-Up Connection Lifetime + + + The server computer restricts the lifetime of established + dial-up connections to 15 minutes from the establishment + moment on. Once the connection has been established, if the + link is idle for 1 minute, the server computer will also close + the established connection to free the telephone line. This + control can be implemented through the + and options + inside the pppd's configuration + file. + + + + The server computer allows incoming connections everyday from + 10:00PM to 12:00AM. This control can be implemented through a + cron job and the /etc/nologin.ttyxx file; + where ttyxx represents the device name of your modem + (e.g., /etc/nologin.ttyACM0 would prevent + the Modem device installed in + /dev/ttyACM0 from answering calls). + + + + diff --git a/Manuals/HowTos/Dialup/Server/Usage/networking.docbook b/Manuals/HowTos/Dialup/Server/Usage/networking.docbook new file mode 100644 index 0000000..a37c9f4 --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Usage/networking.docbook @@ -0,0 +1,35 @@ + + + Dial-Up Networking + + + Once you establish connection with the server computer, you + are assigned the 192.168.0.2 IP address and the + faith.centos.org + name. On the other side, the server computer has the + 192.168.0.1 IP + address and the projects.centos.org name. In + both cases, the addresses provided are inside the 192.168.0/24 network. The + configuration would look as the following example illustrates: + + + +The Server Computer The Client Computer +----------------------- ----------------------- +192.168.0.1/24 | Modem ~~~ TelephoneLine ~~~ Modem | 192.168.0.2/24 +----------------------- ----------------------- +projects.centos.org faith.centos.org + + + + Notice that, before you can use this IP addresses and names, + they must be firstly configured that way by the system + administrator. See ..., to know how to configure the IP + addresses and names in the server computer. + + + + diff --git a/Manuals/HowTos/Dialup/Server/Usage/overview.docbook b/Manuals/HowTos/Dialup/Server/Usage/overview.docbook index 519e6fb..3239924 100644 --- a/Manuals/HowTos/Dialup/Server/Usage/overview.docbook +++ b/Manuals/HowTos/Dialup/Server/Usage/overview.docbook @@ -38,8 +38,8 @@ In order for the server computer to answer telephone calls, it is required to install a Modem device in it (see ). Once the Modem device - has been installed, you need to install and configure both + linkend="server-install-modem" />). Once the Modem device has + been installed, you need to install and configure both mgetty and pppd programs. The mgetty program must be run by diff --git a/Manuals/HowTos/Dialup/Server/Usage/phonelines.docbook b/Manuals/HowTos/Dialup/Server/Usage/phonelines.docbook new file mode 100644 index 0000000..7a52e97 --- /dev/null +++ b/Manuals/HowTos/Dialup/Server/Usage/phonelines.docbook @@ -0,0 +1,20 @@ + + + Dial-Up Telephone Lines + + + In this configuration there is only one telephone line + available (e.g., +53043515094) in the server computer to + receive incoming calls. The number of telephone lines + directly affects the possibilities a client computer has to + establish connection with the server computer in an + environment where more than one client computer are struggling + among themselves to establish a dial-up connection with the + server computer. To prevent this issue from happening, it is + innevitable for the server computer to provide more telephone + lines for incoming calls (at least one for each user the + server computer expect to receive incoming calls from). Sadly, + that is not possible at present time. + + +