diff options
Diffstat (limited to 'docs/docs/stable/mcc-help/en/drakconnect.xml')
| -rw-r--r-- | docs/docs/stable/mcc-help/en/drakconnect.xml | 845 |
1 files changed, 845 insertions, 0 deletions
diff --git a/docs/docs/stable/mcc-help/en/drakconnect.xml b/docs/docs/stable/mcc-help/en/drakconnect.xml new file mode 100644 index 00000000..9ac952dd --- /dev/null +++ b/docs/docs/stable/mcc-help/en/drakconnect.xml @@ -0,0 +1,845 @@ +<?xml version='1.0' encoding='utf-8'?><section xmlns="http://docbook.org/ns/docbook" xmlns:ns5="http://www.w3.org/1998/Math/MathML" xmlns:ns4="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:ns2="http://www.w3.org/1999/xlink" xmlns:ns="http://docbook.org/ns/docbook" version="5.0" xml:id="drakconnect"> + <info annotations="simonnzg listened to Aicha by Khaled & Faudel whilst editing this document."> + <title xml:id="drakconnect-ti1">Set up a new network interface (LAN, ISDN, + ADSL, ...)</title> + + <subtitle>drakconnect</subtitle> + </info> + + <mediaobject> + <imageobject> + <imagedata revision="1" xml:id="drakconnect-im1" align="center" format="PNG" fileref="drakconnect.png"/> + </imageobject> + </mediaobject> + + <section> + <title>Introduction</title> + + <para>This tool<footnote> + <para>You can start this tool from the command line, by typing + <emphasis role="bold">drakconnect</emphasis> as root.</para> + </footnote> allows to configure much of local network or Internet + access. You have to know some information from your access provider or + your network administrator.</para> + + <para>Select the type of connection you want to set, according to which + hardware and provider you have.</para> + </section> + + <section> + <title>A new Wired connection (Ethernet)</title> + + <orderedlist> + <listitem> + <para>The first window lists the interfaces which are available. + Select the one to configure.</para> + </listitem> + + <listitem> + <para>At this point, the choice is given between an automatic or a + manual IP address.</para> + </listitem> + + <listitem> + <para>Automatic IP</para> + + <orderedlist> + <listitem> + <para><emphasis>Ethernet/IP settings</emphasis>: you have to + select if DNS servers are declared by the DHCP server or are + manually specified, as explained below. In the last case, the IP + address of DNS servers has to be set. The HOSTNAME of the computer + can be specified here. If no HOSTNAME is specified, the name + <literal>localhost.localdomain</literal> is attributed by default. + The Hostname can also be provided by the DHCP server with the + option <emphasis>Assign host name from DHCP server</emphasis>. Not + all DHCP servers have such a function and if you're setting up + your PC to get an IP address from a domestic ADSL router, it is + unlikely.</para> + + <mediaobject> + <imageobject> + <imagedata fileref="drakconnect5.png"/> + </imageobject> + </mediaobject> + </listitem> + + <listitem> + <para>The advanced button give the opportunity to specify:</para> + + <itemizedlist> + <listitem> + <para>Search domain (not accessible, as provided by the DHCP + server)</para> + </listitem> + + <listitem> + <para>the DHCP client</para> + </listitem> + + <listitem> + <para>DHCP timeout</para> + </listitem> + + <listitem> + <para>Get YP server from DHCP (checked by default): specify + the NIS server</para> + </listitem> + + <listitem> + <para>Get NTPD server from DHCP (synchronisation of + clocks)</para> + </listitem> + + <listitem> + <para>the HOSTNAME required by DHCP. Only use this option if + the DHCP server requires the client to specify a hostname + before receiving an IP address. This option is not dealt by + some DHCP servers.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>After accepting, the last steps which are common to all + connection configurations are explained: <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist> + </listitem> + + <listitem> + <para>Manual configuration</para> + + <orderedlist> + <listitem> + <para><emphasis>Ethernet/IP settings</emphasis>: you need to + declare what DNS servers to use. The HOSTNAME of the computer can + be specified here. If no HOSTNAME is specified, the name + <literal>localhost.localdomain</literal> is attributed by + default.</para> + + <para>For a residential network, the IP address usually looks like + <emphasis>192.168.x.x</emphasis>, Netmask is + <emphasis>255.255.255.0</emphasis>, and the Gateway and DNS + servers are available from your service provider's website.</para> + + <para>In advanced settings, you can specified a <emphasis>Search + domain</emphasis>. It would usually be your home domain, i.e. if + your computer is called "splash", and it's full domain name is + "splash.boatanchor.net", the Search Domain would be + "boatanchor.net". Unless you specifically need it, it's ok not to + define this setting. Again, domestic ADSL would not need this + setting.</para> + + <mediaobject> + <imageobject> + <imagedata fileref="drakconnect30.png"/> + </imageobject> + </mediaobject> + </listitem> + + <listitem> + <para>The next steps are exposed at <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist> + </listitem> + </orderedlist> + </section> + + <section> + <title>A new Satellite connection (DVB)</title> + + <para>This section hasn't been written yet for lack of resources. If you + think you can write this help, please contact <link ns2:href="https://wiki.mageia.org/en/Documentation_team"> the Doc + team.</link> Thanking you in advance.</para> + </section> + + <section> + <title>A new Cable modem connection</title> + + <orderedlist> + <listitem> + <para>The first window lists the interfaces which are available. + Select the one to configure.</para> + </listitem> + + <listitem> + <para>At this point, the choice is given between an automatic or a + manual IP address.</para> + </listitem> + + <listitem> + <para>You have to specify a authentication method:</para> + + <itemizedlist> + <listitem> + <para>None</para> + </listitem> + + <listitem> + <para>BPALogin (necessary for Telstra). In this case you have to + provide User name and password.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>Automatic IP</para> + + <orderedlist> + <listitem> + <para><emphasis>Cable/IP settings</emphasis>: you have to select + if DNS servers are declared by the DHCP server or are manually + specified, as explained below. In the last case, the IP address of + DNS servers has to be set. The HOSTNAME of the computer can be + specified here. If no HOSTNAME is specified, the name + <literal>localhost.localdomain</literal> is attributed by default. + The Hostname can also be provided by the DHCP server with the + option <emphasis>Assign host name from DHCP server</emphasis>. Not + all DHCP servers have such a function and if you're setting up + your PC to get an IP address from a domestic ADSL router, it is + unlikely.</para> + </listitem> + + <listitem> + <para>The advanced button give the opportunity to specify:</para> + + <itemizedlist> + <listitem> + <para>Search domain (not accessible, as provided by the DHCP + server)</para> + </listitem> + + <listitem> + <para>the DHCP client</para> + </listitem> + + <listitem> + <para>DHCP timeout</para> + </listitem> + + <listitem> + <para>Get YP server from DHCP (checked by default): specify + the NIS server</para> + </listitem> + + <listitem> + <para>Get NTPD server from DHCP (synchronisation of + clocks)</para> + </listitem> + + <listitem> + <para>the HOSTNAME required by DHCP. Only use this option if + the DHCP server requires the client to specify a hostname + before receiving an IP address. This option is not dealt by + some DHCP servers.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>After accepting, the last steps which are common to all + connection configurations are explained: <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist> + </listitem> + + <listitem> + <para>Manual configuration</para> + + <orderedlist> + <listitem> + <para><emphasis>Cable/IP settings</emphasis>: you need to declare + what DNS servers to use. The HOSTNAME of the computer can be + specified here. If no HOSTNAME is specified, the name + <literal>localhost.localdomain</literal> is attributed by + default.</para> + + <para>For a residential network, the IP address usually looks like + <emphasis>192.168.x.x</emphasis>, Netmask is + <emphasis>255.255.255.0</emphasis>, and the Gateway and DNS + servers are available from your service provider's website.</para> + + <para>In advanced settings, you can specified a <emphasis>Search + domain</emphasis>. It would usually be your home domain, i.e. if + your computer is called "splash", and it's full domain name is + "splash.boatanchor.net", the Search Domain would be + "boatanchor.net". Unless you specifically need it, it's ok not to + define this setting. Again, domestic connection would not need + this setting.</para> + + <mediaobject> + <imageobject> + <imagedata fileref="drakconnect32.png"/> + </imageobject> + </mediaobject> + </listitem> + + <listitem> + <para>The next steps are exposed at <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist> + </listitem> + </orderedlist> + </section> + + <section> + <title>A new DSL connection</title> + + <para><orderedlist> + <listitem> + <para>If the tool detects network interfaces, it offers to select + one and to configure it.</para> + </listitem> + + <listitem> + <para>A list of providers is proposed, classified by countries. + Select your provider. If it is not listed, select the option + <guilabel>Unlisted</guilabel> and then enter the options your + provider gave.</para> + </listitem> + + <listitem> + <para>Select one of the protocols available:</para> + + <itemizedlist> + <listitem> + <para>Dynamic Host Configuration Protocol (DHCP)</para> + </listitem> + + <listitem> + <para>Manual TCP/IP configuration</para> + </listitem> + + <listitem> + <para>PPP over ADSL (PPPoA)</para> + </listitem> + + <listitem> + <para>PPP over Ethernet (PPPoE)</para> + </listitem> + + <listitem> + <para>Point to Point Tunneling Protocol (PPTP)</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>Access settings</para> + + <itemizedlist> + <listitem> + <para>Account Login (user name)</para> + </listitem> + + <listitem> + <para>Account password</para> + </listitem> + + <listitem> + <para>(Advanced) Virtual Path ID (VPI)</para> + </listitem> + + <listitem> + <para>(Advanced) Virtual Circuit ID (VCI)</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>The next steps are exposed at <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist></para> + </section> + + <section> + <title>A new ISDN connection</title> + + <para><orderedlist> + <listitem> + <para>The wizard asks which device to configure:</para> + + <itemizedlist> + <listitem> + <para>Manual choice (internal ISDN card)</para> + </listitem> + + <listitem> + <para>External ISDN modem</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>A list of hardware is proposed, classified by category and + manufacturer. Select your card.</para> + </listitem> + + <listitem> + <para>Select one of the protocols available:</para> + + <itemizedlist> + <listitem> + <para>Protocol for the rest of the world, except Europe + (DHCP)</para> + </listitem> + + <listitem> + <para>Protocol for Europe (EDSS1)</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>A list of providers is then offered, classified by countries. + Select your provider. If it is not listed, select the option + <guilabel>Unlisted</guilabel> and then enter the options your + provider gave you. Then it is asked for parameters:</para> + + <itemizedlist> + <listitem> + <para>Connection name</para> + </listitem> + + <listitem> + <para>Phone number</para> + </listitem> + + <listitem> + <para>Login ID</para> + </listitem> + + <listitem> + <para>Account password</para> + </listitem> + + <listitem> + <para>Authentication method</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>After that, you have to select if you get the IP address by + automatic or manual method. In the last case, specify IP address and + Subnet mask.</para> + </listitem> + + <listitem> + <para>The next step is to choose how DNS servers address are + obtained, by automatic or manual method. In the case of manual + configuration, you have to put:</para> + + <itemizedlist> + <listitem> + <para>Domain name</para> + </listitem> + + <listitem> + <para>First and second DNS Server</para> + </listitem> + + <listitem> + <para>Select if the hostname is set from IP. This option is to + select only if you are sure that your provider is configured to + accept it.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>The next step is to choose how the gateway address is + obtained, by automatic or manual method. In the case of manual + configuration, you have to enter the IP address.</para> + </listitem> + + <listitem> + <para>The next steps are exposed at <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist></para> + </section> + + <section> + <title>A new Wireless connection (WiFi)</title> + + <orderedlist> + <listitem> + <para>A first window lists the interfaces which are available and an + entry for Windows driver (ndiswrapper). Select the one to configure. + Use ndiswrapper only if the other configuration methods did not + work.</para> + </listitem> + + <listitem> + <para>At this step, the choice is given between the different access + points that the card has detected.</para> + </listitem> + + <listitem> + <para>Specific parameter for the wireless card are to provide:</para> + + <mediaobject> + <imageobject> + <imagedata fileref="drakconnect31.png"/> + </imageobject> + </mediaobject> + + <itemizedlist> + <listitem> + <para>Operating mode:</para> + + <variablelist> + <varlistentry> + <term>Managed</term> + + <listitem> + <para>To access to an existing access point (the most + frequent).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Ad-Hoc</term> + + <listitem> + <para>To configure direct connection between + computers.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + + <listitem> + <para>Network Name (ESSID)</para> + </listitem> + + <listitem> + <para>Encryption mode: it depends of how the access point is + configured.</para> + + <variablelist> + <varlistentry> + <term>WPA/WPA2</term> + + <listitem> + <para>This encryption mode is to prefer if your hardware + allows it.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>WEP</term> + + <listitem> + <para>Some old hardware deals only this encryption + method.</para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + + <listitem> + <para>Encryption key</para> + + <para>It is generally provided with the hardware which give the + access point.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>At this step, the choice is given between an automatic IP + address or a manual IP address.</para> + </listitem> + + <listitem> + <para>Automatic IP</para> + + <orderedlist> + <listitem> + <para><emphasis>IP settings</emphasis>: you have to select if DNS + servers are declared by the DHCP server or are manually specified, + as explained below. In the last case, IP address of DNS servers + has to be set. The HOSTNAME of the computer can be specified here. + If no HOSTNAME is specified, the name localhost.localdomain is + attributed by default. The Hostname can also be provided by the + DHCP server with the option <emphasis>Assign host name from DHCP + server</emphasis></para> + </listitem> + + <listitem> + <para>The advanced button give the opportunity to specify:</para> + + <itemizedlist> + <listitem> + <para>Search domain (not accessible, as provided by the DHCP + server)</para> + </listitem> + + <listitem> + <para>the DHCP client</para> + </listitem> + + <listitem> + <para>DHCP timeout</para> + </listitem> + + <listitem> + <para>Get YP server from DHCP (checked by default): specify + the NIS servers</para> + </listitem> + + <listitem> + <para>Get NTPD server from DHCP (synchronisation of + clocks)</para> + </listitem> + + <listitem> + <para>the HOSTNAME required by DHCP. Only use this option if + the DHCP server requires the client to specify a hostname + before receiving an IP address. This option is not dealt by + some DHCP servers.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>After accepting the configuration the step, which is common + to all connection configurations, is explained: <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist> + </listitem> + + <listitem> + <para>Manual configuration</para> + + <orderedlist> + <listitem> + <para><emphasis>IP settings</emphasis>: you have to declare DNS + servers. The HOSTNAME of the computer can be specified here. If no + HOSTNAME is specified, the name + <literal>localhost.localdomain</literal> is attributed by + default.</para> + + <para>For a residential network, the IP address always looks like + <emphasis>192.168.x.x</emphasis>, Netmask is + <emphasis>255.255.255.0</emphasis>, and the Gateway and DNS + servers are available from your providers website.</para> + + <para>In advanced settings, you can specified a <emphasis>Search + domain</emphasis>. It must seem to your hostname without the first + name, before the period.</para> + </listitem> + + <listitem> + <para>The next steps are exposed at <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist> + </listitem> + </orderedlist> + </section> + + <section> + <title>A new GPRS/Edge/3G connection</title> + + <para><orderedlist> + <listitem> + <para>If the tool detects wireless interfaces, it offers to select + one and to configure it.</para> + </listitem> + + <listitem> + <para>The PIN is asked. Leave empty if the PIN is not + required.</para> + </listitem> + + <listitem> + <para>The wizard asks for network. If it is not detected, select the + option <guilabel>Unlisted</guilabel>.</para> + </listitem> + + <listitem> + <para>A list of providers is proposed, classified by countries. + Select your provider. If it is not listed, select the option + <guilabel>Unlisted</guilabel> and then enter the options your + provider gave.</para> + </listitem> + + <listitem> + <para>Provide access settings</para> + + <itemizedlist> + <listitem> + <para>Access Point Name</para> + </listitem> + + <listitem> + <para>Account Login (user name)</para> + </listitem> + + <listitem> + <para>Account password</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>The next steps are exposed at <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist></para> + </section> + + <section> + <title>A new Bluetooth Dial-Up Networking connection</title> + + <para>This section hasn't been written yet for lack of resources. If you + think you can write this help, please contact <link ns2:href="https://wiki.mageia.org/en/Documentation_team"> the Doc + team.</link> Thanking you in advance.</para> + </section> + + <section> + <title>A new Analog telephone modem connection (POTS)</title> + + <orderedlist> + <listitem> + <para>The wizard asks which device to configure:</para> + + <itemizedlist> + <listitem> + <para>Manual choice</para> + </listitem> + + <listitem> + <para>Detected hardware, if any.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>A list of ports is proposed. Select your port.</para> + </listitem> + + <listitem> + <para>If not yet installed, it will be suggested that you install the + package <emphasis>kppp-provider</emphasis>.</para> + </listitem> + + <listitem> + <para>A list of providers is proposed, classified by countries. Select + your provider. If it is not listed, select the option + <guilabel>Unlisted</guilabel> and then enter the options your provider + gave. Then it is asked for Dialup options:</para> + + <itemizedlist> + <listitem> + <para><emphasis>Connection name</emphasis></para> + </listitem> + + <listitem> + <para><emphasis>Phone number</emphasis></para> + </listitem> + + <listitem> + <para><emphasis>Login ID</emphasis></para> + </listitem> + + <listitem> + <para><emphasis>Password</emphasis></para> + </listitem> + + <listitem> + <para><emphasis>Authentication</emphasis>, choose between:</para> + + <itemizedlist> + <listitem> + <para>PAP/CHAP</para> + </listitem> + + <listitem> + <para>Script-based</para> + </listitem> + + <listitem> + <para>PAP</para> + </listitem> + + <listitem> + <para>Terminal-based</para> + </listitem> + + <listitem> + <para>CHAP</para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>The next steps are exposed at <xref linkend="drakconnect-end"/></para> + </listitem> + </orderedlist> + </section> + + <section xml:id="drakconnect-end"> + <title>Ending the configuration</title> + + <para>In the next step, you can specify:</para> + + <itemizedlist> + <listitem> + <para><emphasis>Allow users to manage the connection</emphasis></para> + </listitem> + + <listitem> + <para><emphasis>Start the connection at boot</emphasis></para> + </listitem> + + <listitem> + <para><emphasis>Enable traffic accounting</emphasis></para> + </listitem> + + <listitem> + <para><emphasis>Allow interface to be controlled by Network + Manager</emphasis></para> + </listitem> + + <listitem> + <para>In the case of a wireless connection, a supplemental box is + <emphasis>Allow access point roaming</emphasis> which give the + possibility to switch automatically between access point according to + the signal strength.</para> + </listitem> + </itemizedlist> + + <para>With the advanced button, you can specify:</para> + + <itemizedlist> + <listitem> + <para>Metric (10 by default)</para> + </listitem> + + <listitem> + <para>MTU</para> + </listitem> + + <listitem> + <para>Network Hotplugging</para> + </listitem> + + <listitem> + <para>Enable IPv6 to IPv4 tunnel</para> + </listitem> + </itemizedlist> + + <para>The last step allows you to specify if the connection is to start + immediately or not.</para> + + <mediaobject> + <imageobject> + <imagedata fileref="drakconnect9.png"/> + </imageobject> + </mediaobject> + </section> +</section>
\ No newline at end of file |