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 @@ <!ENTITY client SYSTEM "Client.docbook"> +<!ENTITY client-usage SYSTEM "Client/Usage.docbook"> +<!ENTITY client-usage-overview SYSTEM "Client/Usage/overview.docbook"> <!ENTITY client-install SYSTEM "Client/Install.docbook"> <!ENTITY client-install-overview SYSTEM "Client/Install/overview.docbook"> -<!ENTITY client-install-hardware SYSTEM "Client/Install/hardware.docbook"> -<!ENTITY client-install-software SYSTEM "Client/Install/software.docbook"> +<!ENTITY client-install-modem SYSTEM "Client/Install/modem.docbook"> +<!ENTITY client-install-pppd SYSTEM "Client/Install/pppd.docbook"> +<!ENTITY client-install-wvdial SYSTEM "Client/Install/wvdial.docbook"> +<!ENTITY client-install-scn SYSTEM "Client/Install/scn.docbook"> <!ENTITY client-config SYSTEM "Client/Config.docbook"> <!ENTITY client-config-overview SYSTEM "Client/Config/overview.docbook"> -<!ENTITY client-config-hardware SYSTEM "Client/Config/hardware.docbook"> -<!ENTITY client-config-software SYSTEM "Client/Config/software.docbook"> -<!ENTITY client-usage SYSTEM "Client/Usage.docbook"> +<!ENTITY client-config-modem SYSTEM "Client/Config/modem.docbook"> +<!ENTITY client-config-pppd SYSTEM "Client/Config/pppd.docbook"> +<!ENTITY client-config-wvdial SYSTEM "Client/Config/wvdial.docbook"> +<!ENTITY client-config-scn SYSTEM "Client/Config/scn.docbook"> 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 @@ <title>Dial-Up Client Configuration</title> &client-config-overview; - &client-config-hardware; - &client-config-software; + &client-config-modem; + &client-config-pppd; + &client-config-wvdial; + &client-config-scn; </chapter> 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 @@ +<sect1 id="client-config-hardware"> + + <title>Configuring Modem Hardware</title> + + <para> + ... + </para> + +</sect1> 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 @@ +<sect1 id="client-config-pppd"> + + <title>Configuring <package>pppd</package> Package</title> + <para> + ... + </para> + +</sect1> 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 @@ +<sect1 id="client-config-scn"> + + <title>Configuring <package>system-config-network</package> Package</title> + <para> + ... + </para> + +</sect1> 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 @@ +<sect1 id="client-config-wvdial"> + + <title>Configuring <package>wvdial</package> Package</title> + + <para> + ... + </para> + +</sect1> 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 @@ <title>Dial-Up Client Installation</title> &client-install-overview; - &client-install-hardware; - &client-install-software; + &client-install-modem; + &client-install-pppd; + &client-install-wvdial; + &client-install-scn; </chapter> 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 @@ +<sect1 id="client-install-hardware"> + + <title>Installing Modem Hardware</title> + + <para> + ... + </para> + +</sect1> 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 @@ +<sect1 id="client-install-pppd"> + + <title>Installing <package>pppd</package> Package</title> + <para> + ... + </para> + +</sect1> 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 @@ +<sect1 id="client-install-scn"> + + <title>Installing <package>system-config-network</package> Package</title> + + <para> + ... + </para> + +</sect1> 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 @@ +<sect1 id="client-install-wvdial"> + + <title>Installing <package>wvdial</package> Package</title> + + <para> + ... + </para> + +</sect1> 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 @@ <title>Dial-Up Client Usage</title> - <para> - ... - </para> + &client-usage-overview; </chapter> 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 @@ +<sect1 id="client-usage-overview"> + + <title>Overview</title> + + <para> + ... + </para> + +</sect1> 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 @@ <title>Dial-Up Server Configuration</title> &server-config-overview; - &server-config-hardware; - &server-config-software; + &server-config-modem; + &server-config-mgetty; + &server-config-pppd; + &server-config-wvdial; </chapter> 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 @@ -<sect1 id="server-config-hardware"> - - <title>Configuring Server Hardware</title> - - <para> - ... - </para> - -</sect1> 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 @@ +<sect1 id="server-config-mgetty"> + + <title>Configuring <package>mgetty</package> Package</title> + <para> + ... + </para> + +</sect1> + 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 @@ +<sect1 id="server-config-hardware"> + + <title>Configuring Modem Hardware</title> + + <para> + ... + </para> + +</sect1> 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 @@ +<sect1 id="server-config-pppd"> + + <title>Configuring <package>pppd</package> Package</title> + <para> + ... + </para> + +</sect1> 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 @@ -<sect1 id="server-config-pppd"> - - <title>Configuring Server Software</title> - - <para> - ... - </para> - - <sect2 id="server-config-software-mgetty"> - <title>Configuring <package>mgetty</package> Package</title> - <para> - ... - </para> - </sect2> - - <sect2 id="server-config-software-pppd"> - <title>Configuring <package>pppd</package> Package</title> - <para> - ... - </para> - </sect2> - - <sect2 id="server-config-software-wvdial"> - <title>Configuring <package>wvdial</package> Package</title> - <para> - ... - </para> - </sect2> - -</sect1> 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 @@ +<sect1 id="server-config-wvdial"> + + <title>Configuring <package>wvdial</package> Package</title> + + <para> + ... + </para> + +</sect1> 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 @@ <title>Dial-Up Server Installation</title> &server-install-overview; - &server-install-hardware; - &server-install-software; + &server-install-modem; + &server-install-mgetty; + &server-install-pppd; + &server-install-wvdial; </chapter> 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 @@ -<sect1 id="server-install-hardware"> - - <title>Installing Server Hardware</title> - - <para> - 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. - </para> - - <para> - 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. - </para> - - <para> - 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 <command>lsusb</command> or - <command>lspci</command> commands. These commands need to be - run with administrative privileges, so probably need to - <command>sudo</command> them or login as <systemitem - class="username">root</systemitem> 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 <command>lsusb</command> command would - look like the following: - </para> - -<screen> -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 -</screen> - - <para> - The relevant line here is that mentioning the existence of a - <code>Multi-Tech System, Inc. MT5634ZBA-USB MultiModemUSB (new - firmware)</code> device. If the modem you installed doesn't - appear in this list, it is probably because such hardware is - not supported by &TCD;, yet. - </para> - -</sect1> 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 @@ +<sect1 id="server-install-mgetty"> + + <title>Installing <package>mgetty</package> Package</title> + <para> + ... + </para> + +</sect1> + 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 @@ +<sect1 id="server-install-modem"> + + <title>Installing Modem Hardware</title> + + <para> + 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. + </para> + + <para> + 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 <command>lsusb</command> or + <command>lspci</command> commands. These commands need to be + run with administrative privileges, so probably need to + <command>sudo</command> them or login as <systemitem + class="username">root</systemitem> 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 <command>lsusb</command> command would + look like the following: + </para> + +<screen> +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 +</screen> + + <para> + The relevant line here is that mentioning the existence of a + <code>Multi-Tech System, Inc. MT5634ZBA-USB MultiModemUSB (new + firmware)</code> device. If the modem you installed doesn't + appear in this list, it is probably because such hardware is + not supported by &TCD;, yet. + </para> + +</sect1> 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 @@ +<sect1 id="server-install-pppd"> + + <title>Installing <package>pppd</package> Package</title> + <para> + ... + </para> + +</sect1> 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 @@ -<sect1 id="server-install-wvdial"> - - <title>Installing <package>wvdial</package> Package</title> - - <para> - ... - </para> - -</sect1> 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 @@ +<sect1 id="server-install-wvdial"> + + <title>Installing <package>wvdial</package> Package</title> + + <para> + ... + </para> + +</sect1> 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 @@ +<sect1 id="server-usage-auth"> + + <title>Dial-Up Authentication</title> + + <para> + 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: + </para> + +<screen> + ISP Name: projects.centos.org +ISP Phone: +53043515094 + Username: faith + Password: mail4u.2k10 +</screen> + + <para> + The client computer can use this information to establish + connection to the server computer using any telephone number + from 10:00PM to 12:00AM. + </para> + +</sect1> + 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 @@ +<sect1 id="server-usage-lifetime"> + + <title>Dial-Up Connection Lifetime</title> + + <para> + 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 + <option>maxconnect</option> and <option>idle</option> options + inside the <application>pppd</application>'s configuration + file. + </para> + + <para> + The server computer allows incoming connections everyday from + 10:00PM to 12:00AM. This control can be implemented through a + cron job and the <filename>/etc/nologin.ttyxx</filename> file; + where ttyxx represents the device name of your modem + (e.g., <filename>/etc/nologin.ttyACM0</filename> would prevent + the Modem device installed in + <filename>/dev/ttyACM0</filename> from answering calls). + </para> + +</sect1> + 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 @@ +<sect1 id="server-usage-network"> + + <title>Dial-Up Networking</title> + + <para> + Once you establish connection with the server computer, you + are assigned the <systemitem + class="ipaddress">192.168.0.2</systemitem> IP address and the + <systemitem class="fqdomainname">faith.centos.org</systemitem> + name. On the other side, the server computer has the + <systemitem class="ipaddress">192.168.0.1</systemitem> IP + address and the <systemitem + class="fqdomainname">projects.centos.org</systemitem> name. In + both cases, the addresses provided are inside the <systemitem + class="netmask">192.168.0/24</systemitem> network. The + configuration would look as the following example illustrates: + </para> + +<screen> +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 +</screen> + + <para> + 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. + </para> + +</sect1> + 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 @@ <para> In order for the server computer to answer telephone calls, it is required to install a Modem device in it (see <xref - linkend="server-install-hardware" />). 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 <application>mgetty</application> and <application>pppd</application> programs. The <application>mgetty</application> 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 @@ +<sect1 id="server-usage-phonelines"> + + <title>Dial-Up Telephone Lines</title> + + <para> + 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. + </para> + +</sect1>