path: root/docs/mcc-help/en/drakconnect.xml

<?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 &amp; 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>