From: Eric O. <eob...@us...> - 2009-12-05 13:39:17
|
Update of /cvsroot/ipcop/IPCopDoc/en/admin/xml In directory sfp-cvsdas-1.v30.ch3.sourceforge.com:/tmp/cvs-serv7603 Modified Files: Tag: IPCOP_v1_4_0 dialup.xml Log Message: Backport updated text from v2 branch. Index: dialup.xml =================================================================== RCS file: /cvsroot/ipcop/IPCopDoc/en/admin/xml/Attic/dialup.xml,v retrieving revision 1.1.2.3.6.13 retrieving revision 1.1.2.3.6.14 diff -C2 -d -r1.1.2.3.6.13 -r1.1.2.3.6.14 *** dialup.xml 3 Jul 2009 16:47:58 -0000 1.1.2.3.6.13 --- dialup.xml 5 Dec 2009 13:39:07 -0000 1.1.2.3.6.14 *************** *** 10,235 **** <title>Network Menu</title> <sect2 id="section-ppp-settings"> - - <!-- Text for this section needs to be reviewed --> - <title>Dialup</title> <para> ! This subsection of the Dialup Administration Window ! (AW) is divided into 5 different editable sections and ! is only applicable if you are accessing the Internet ! using an analog modem, an ISDN device or a DSL ! connection. </para> <para> ! Note that you cannot select or modify a profile while ! the IPCop server is online, or waiting to go online in ! <quote>Dial on Demand</quote> ! mode. Before using this page, go to the ! <guilabel>Home</guilabel> AW and if the status line ! reports <guilabel>Connected</guilabel> or <guilabel> ! Dial on Demand waiting</guilabel> then the click on ! the <guibutton>Disconnect</guibutton> button before ! returning to this Window. After setting up or ! selecting Profiles, remember to return to the ! <guilabel>Home</guilabel> AW and click the ! <guibutton>Connect</guibutton> button, if you want your ! IPCop server to go back online. </para> <formalpara> ! <title><guilabel>Profiles </guilabel></title> <para> ! This section of the Window provides the facilities to ! name and set up new Dialup Profiles (up to a total of ! five), or to rename existing Profiles and change their ! parameters. </para> </formalpara> <para> ! Select a Profile to be created or modified from the ! drop-down list. Fill in or change the parameters for ! the profile (see below) and click on the ! <guibutton>Save</guibutton> button. To select the ! Profile to be used for future connections, use the ! drop-down list to make your choice and click the ! <guibutton>Select</guibutton> button at the ! bottom of the page. Use the ! <guibutton>Restore</guibutton> button while editing a Profile to ! reinstate the previous Profile settings. </para> - <formalpara> - <title><guilabel>Telephony </guilabel></title> <para> ! This section allows ! you to do the following: </para> </formalpara> ! <orderedlist> ! <listitem><para>Select the appropriate ! <guilabel>Interface</guilabel> for your Internet connection ! device. This will be either a Communications port ! (COM1 - COM4) used mostly for modems and ISDN ! cards, or PPPoE which is used mostly for DSL ! connections. ! </para></listitem> ! <listitem><para>Select the appropriate <guilabel> ! Computer to modem rate</guilabel>. This will ! decide how quickly data is passed to and from your ! connection device. With older computer systems or ! modems, you may find it necessary to use one of ! the lower data rates to establish reliable ! computer/ modem communications. ! </para></listitem> ! <listitem><para>Enter the correct <guilabel>Number ! </guilabel> to dial for your Internet connection. ! If connecting through the PPPoE interface then ! chances are you will probably be leaving this ! blank. ! </para></listitem> ! <listitem><para>Select whether or not the <guilabel> ! Modem speaker on</guilabel>. Having the speaker on ! allows you to hear the connection taking place and ! can be a useful diagnostic aid when ! troubleshooting. This option is only likely to be ! useful if you are connecting via an analog modem. ! </para></listitem> ! <listitem><para>Select your <guilabel> Dialing mode ! </guilabel>. Use Tone dialing unless your ! telephone connection only recognizes Pulse ! dialing. Pulse dialing is a lot slower than Tone ! dialing. ! </para></listitem> ! <listitem><para>Enter your desired <guilabel>Maximum ! retries</guilabel>. This will decide how often ! IPCop attempts to connect to the Internet after a ! failed connection attempt. ! </para></listitem> ! <listitem><para>Enter your <guilabel> Idle timeout ! </guilabel>. This will decide how IPCop handles ! your Internet connection when nothing is actually ! being sent or received via the Internet ! connection. The number you enter here indicates to ! IPCop how long it should wait after any Internet ! activity before it disconnects the modem link. If ! you set this parameter to <guilabel>0 ! </guilabel> then IPCop, once connected, will not ! disconnect from the Internet of its own accord. ! </para></listitem> ! <listitem> ! <para>The ! <guilabel>Persistent Connection</guilabel> ! checkbox is used to instruct IPCop to ! maintain the modem connection at all times, even ! in the absence of Internet activity. In this mode ! it will attempt to reconnect the Internet ! connection whenever the link fails for any reason, ! such as a connection time-out at the ISP end of ! the modem link. Use this mode with caution. If you ! have metered connection charges you probably will ! not want to use this feature. However, if you have ! unlimited service time (often called "Flatrate") ! with your ISP, you may want to use this in order ! to keep the link connected as much as possible. ! Note that in ! <guilabel>Persistent</guilabel> ! mode, IPCop will cease reconnecting ! after more than the number of consecutive failed ! dial attempts set in ! <guilabel>Maximum Retries</guilabel> ! ! In this event, you have to use ! the ! <guibutton>Dial</guibutton> ! button ! on the ! <guilabel>Home</guilabel> AW. </para> - </listitem> - <listitem><para><guilabel>Dial on Demand</guilabel> is - available by clicking the checkbox. Note that - after enabling Dial on Demand, you still have to - click the <guibutton>Connect</guibutton> button on the <guilabel> - Home</guilabel> AW before IPCop will start - connecting automatically when it detects Internet - activity. The <guilabel>Dial on Demand - </guilabel> option is not available for PPPoE - connections. - </para></listitem> - <listitem><para>The <guilabel>Dial on - Demand for DNS</guilabel> option determines - whether IPCop will connect automatically when it - detects DNS requests. This will be usually what - you will want to happen. - </para></listitem> - <listitem><para><guilabel>Connect on IPCop Restart - </guilabel> will make IPCop connect after booting, - if <guilabel>Dial on Demand</guilabel> - is not selected. You will probably want to set - this option as active if you are also using - <guilabel>Dial on Demand</guilabel>. - This is because the combination of settings will - automatically put the IPCop system into Dial on - Demand waiting mode each time the IPCop server is - switched on or rebooted. - </para></listitem> - <listitem><para><guilabel>ISP Requires Carriage Return - </guilabel> Some ISPs require that the modem - sends a carriage return to signal to indicate that - it is finished sending data. If your ISP requires - this, then leave it checked. If not then you can - uncheck this box. The default is checked. - </para></listitem> - </orderedlist> <para> ! <guilabel>Additional PPPoE settings</guilabel> - If ! either PPPoE or USB ADSL is enabled, additional ! configuration options are available. Here you can ! enter two additional parameters, a service name, and a ! concentrator name, which some ISPs require. If your ! ISP does not require them, or does not give you any, ! then you may leave these two fields blank. Your ISP ! will give you two settings, VPI and VCI, which you ! must enter if you are using a USB ADSL connection. </para> <formalpara> ! <title><guilabel>Authentication</guilabel></title> ! <para><guilabel>Username</guilabel> and <guilabel> ! Password</guilabel> are the username and password that ! your ISP should have supplied to you when you opened ! your account with them. There are several ways in ! which ISPs use this username and password to login to ! their systems. The most common methods are PAP or ! CHAP. Select this if your ISP uses either of those ! two. If your ISP uses a text-based login script, ! choose standard login script. For people in the UK who ! use Demon Internet as their ISP, a special script has ! been created for them to use. The "Other" login script ! option has been provided for people who have ISPs with ! special needs. If you need to do this, you will need ! to login to the IPCop box and create a file in ! /etc/ppp. This filename (without the /etc/ppp ! component) should be entered into the Script name box. ! The file contains 'expect send' pairs, separated by a ! tab. ! <parameter class="function">USERNAME</parameter> will ! be substituted for the username and ! <parameter class="function">PASSWORD</parameter> for the ! password. Examine ! the file demonloginscript in /etc/ppp, and use it as ! an example of what should be in this file. ! </para> </formalpara> <formalpara> ! <title><guilabel>DNS</guilabel></title> ! <para> ! Select <guilabel>Automatic</guilabel> ! if your ISP supports ! automatic DNS server configuration, as is now usually ! the case. The alternative is to leave ! <guilabel>Automatic</guilabel> unticked and put IP ! addresses in the <guilabel>Primary DNS ! </guilabel> and <guilabel>Secondary DNS ! </guilabel> boxes. These IP addresses will generally ! be provided where necessary by your ISP. ! </para> </formalpara> <para> --- 10,335 ---- <title>Network Menu</title> <sect2 id="section-ppp-settings"> <title>Dialup</title> <para> ! This subsection of the Dialup Administration Window ! (AW) is divided into five different editable sections and ! is only applicable if you are accessing the Internet ! using an analog modem, an ISDN device or a DSL ! connection. </para> <para> ! Note that you cannot select or modify a profile while ! IPCop is online, or waiting to go online in ! <quote>Dial on Demand</quote> ! mode. Before using this page, go to the ! <guilabel>Home</guilabel> AW and if the status line ! reports <guilabel>Connected</guilabel> or <guilabel> ! Dial on Demand waiting</guilabel> then the click on ! the <guibutton>Disconnect</guibutton> button before ! returning to this Window. After setting up or ! selecting Profiles, remember to return to the ! <guilabel>Home</guilabel> AW and click the ! <guibutton>Connect</guibutton> button, if you want your ! IPCop to go back online. </para> <formalpara> ! <title><guilabel>Profiles</guilabel></title> ! <para> ! This section provides the facilities to ! name and set up new Dialup Profiles (up to a total of ! five), or to rename existing Profiles and change their ! parameters. ! </para> ! </formalpara> <para> ! Select a Profile to be created or modified from the ! drop-down list. Fill in or change the parameters for ! the profile (see below) and click on the ! <guibutton>Save</guibutton> button. To select the ! Profile to be used for future connections, use the ! drop-down list to make your choice and click the ! <guibutton>Select</guibutton> button at the ! bottom of the page. Use the ! <guibutton>Restore</guibutton> button while editing a Profile to ! reinstate the previous Profile settings. </para> + <formalpara> + <title><guilabel>Connection</guilabel></title> + <para> + Select the appropriate + <guilabel>Interface</guilabel> type for your Internet + connection device from the drop down menu, and click the + <guibutton>Refresh</guibutton> button to populate the + <guilabel>Connection</guilabel> section with the content + relevant to your device. + </para> + </formalpara> + <orderedlist> + <listitem> + <para> + <guilabel>Interface</guilabel>. This will be either + a Communications port (COM1-COM5, ACM0-ACM3 or + USB0-USB1) used mostly for modems and ISDN cards, + or PPPoE which is used mostly for DSL connections. + </para> + </listitem> + <listitem> + <para> + Select the appropriate + <guilabel>Computer to modem rate</guilabel>. + This will decide how quickly data is passed to and + from your connection device. + With older computer systems or modems, you may find it + necessary to use one of the lower data rates to establish + reliable computer/modem communications. + </para> + </listitem> + <listitem> + <para> + Enter the correct + <guilabel>Number</guilabel> to dial for your Internet + connection. + If connecting through the PPPoE interface then + chances are you will probably be leaving this + blank. + </para> + </listitem> + <listitem> + <para> + <guilabel>Modem speaker on</guilabel>. Tick this checkbox + if you want the modem speaker on. With the speaker on + you to hear the connection taking place and this can be + a useful diagnostic aid when troubleshooting. + This option is only likely to be useful if you are + connecting via an analog modem. + </para> + </listitem> + <listitem> + <para> + Select your + <guilabel>Dialing mode</guilabel>. + Use Tone dialing unless your telephone connection only + recognizes Pulse dialing. + Pulse dialing is a lot slower than Tone dialing. + </para> + </listitem> + <listitem> + <para> + <guilabel>ISP Requires Carriage Return</guilabel>. + Some ISPs require that the modem sends a carriage return + to signal that it has finished sending data. + If your ISP requires this, then check this box. + The default is unchecked. + </para> + </listitem> + <listitem> + <para> + Enter your + <guilabel>Idle timeout</guilabel>. + This will decide how IPCop handles your Internet + connection when nothing is actually being sent or + received via the Internet connection. + The number you enter here indicates to IPCop how long + it should wait after any Internet activity before it + disconnects the modem link. + If you set this parameter to + <guilabel>0</guilabel> then IPCop, once connected, will + not disconnect from the Internet of its own accord. + </para> + </listitem> + <listitem> + <para> + <guilabel>Connect on IPCop Restart</guilabel> will make + IPCop connect after booting, if + <guilabel>Dial on Demand</guilabel> is not selected. + </para> + <para> + You will probably want to set this option as active if + you are also using <guilabel>Dial on Demand</guilabel>. + This is because the combination of settings will + automatically put IPCop into Dial on Demand waiting + mode each time IPCop is switched on or rebooted. + </para> + </listitem> + <listitem> + <para> + <guilabel>Connection debugging</guilabel>. Tick this checkbox + to write extra log information in the <guilabel>RED</guilabel> + category of the + <link linkend="logs-system"><guimenuitem>System Logs</guimenuitem></link>. + This can be a very useful addition when troubleshooting + <quote>failure to connect</quote> situations. + </para> + </listitem> + </orderedlist> + <formalpara> + <title><guilabel>Reconnection</guilabel></title> + <para> + You can reconnect in one of three ways: Manual, Persistent, + and Dial on Demand. + </para> + </formalpara> + <orderedlist> + <listitem> + <para> + With the <guilabel>Manual</guilabel> connection method + you will have to click the + <guibutton>Connect</guibutton> button on the Homepage. + </para> + </listitem> + <listitem> + <para> + The <guilabel>Persistent</guilabel> connection + radiobutton is used to instruct IPCop to maintain + the modem connection at all times, even in the absence + of Internet activity. + </para> + <para> + In this mode it will attempt to reconnect the Internet + connection whenever the link fails for any reason, + such as a connection time-out at the ISP end of + the modem link. + </para> + <para> + Use this mode with caution. + If you have metered connection charges you probably will + not want to use this feature. + However, if you have unlimited service time + (often called 'Flatrate') with your ISP, + you may want to use this in order + to keep the link connected as much as possible. + </para> + <para> + Note that in + <guilabel>Persistent</guilabel> mode, IPCop will + cease reconnecting after more than the number of + consecutive failed dial attempts set in + <guilabel>Maximum Retries</guilabel>. + In this event, you have to use the + <guibutton>Connect</guibutton> button on the Homepage. + </para> + </listitem> + <listitem> + <para> + <guilabel>Dial on Demand</guilabel> is available by + selecting the appropriate radiobutton. + Note that after enabling Dial on Demand, you still + have to click the + <guibutton>Connect</guibutton> button on the Homepage + before IPCop will start connecting automatically when + it detects Internet activity. + The <guilabel>Dial on Demand</guilabel> option is not + available for PPPoE connections. + </para> + </listitem> + <listitem> + <para> + The <guilabel>In case reconnection fails, + switch to profile</guilabel> drop down menu allows + you to pick an alternative profile to automatically + switch to if your main connection fails. + </para> + </listitem> + <listitem> + <para> + The <guilabel>Dial on Demand for DNS</guilabel> option + determines whether IPCop will connect automatically + when it detects DNS requests. + This will usually be what you want to happen. + </para> + </listitem> + <listitem> + <para> + The <guilabel>Holdoff time</guilabel> is the period, + in seconds, that IPCop should wait between retries. + The default is thirty seconds. + </para> + </listitem> + <listitem> + <para> + Enter your desired + <guilabel>Maximum retries</guilabel>. + This will decide how often IPCop attempts to connect + to the Internet after a failed connection attempt. + </para> + </listitem> + </orderedlist> + <formalpara> + <title><guilabel>ADSL settings</guilabel></title> + <para> + If either PPPoE or USB ADSL is enabled, additional + configuration options are available. + </para> </formalpara> <para> ! In this section you can select different protocols, ! encapsulation methods, or add optional parameters, ! such as a service name, or a concentrator name, ! which some ISPs require. ! If your ISP does not require them, or does not give you any, ! then you may leave these two fields blank. </para> <para> ! Your ISP will give you two settings, VPI and VCI, which you ! must enter if you are using a USB ADSL connection. </para> + <formalpara> + <title><guilabel>Authentication</guilabel></title> + <para> + <guilabel>User Name</guilabel> and + <guilabel>Password</guilabel> are the username and + password that your ISP should have supplied to you + when you opened your account with them. + </para> </formalpara> ! <para> ! There are several ways in which ISPs use this ! username and password to login to their systems. ! The most common methods are PAP or CHAP. ! Select this if your ISP uses either of those ! two. </para> <para> ! In the rare event that your ISP uses a text-based login script, ! you will need to login to IPCop and create a file in the ! <filename>/etc/ppp/</filename> folder/directory. ! This filename (without the <filename>/etc/ppp/</filename> ! prefix) should be entered into the ! <guilabel>Script name</guilabel> field. ! The file should contain 'expect send' pairs, ! separated by a tab. ! Examine the file <filename>/etc/ppp/demonloginscript</filename> ! for an example of what should be in this file. ! <parameter class="function">USERNAME</parameter> will ! be substituted for the username and ! <parameter class="function">PASSWORD</parameter> for the ! password. </para> <formalpara> ! <title><guilabel>DNS</guilabel></title> ! <para> ! Select <guilabel>Automatic</guilabel> ! if your ISP supports automatic DNS server configuration, ! as is now usually the case. ! Alternatively, select ! <guilabel>Manual</guilabel> and put IP addresses in the ! <guilabel>Primary DNS</guilabel> and ! <guilabel>Secondary DNS</guilabel> fields. ! These IP addresses will generally be provided, ! where necessary, by your ISP. ! </para> </formalpara> <formalpara> ! <title>Profile name</title> ! <para> ! To name, or re-name, a profile, enter it in this field. ! </para> ! </formalpara> ! <formalpara> ! <title>Save</title> ! <para> ! To save your configuration, click the ! <guilabel>Save</guilabel> button. ! </para> </formalpara> <para> *************** *** 253,257 **** </figure> </para> - </sect2> --- 353,356 ---- |