<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY toolversion "2.15.2">
<!ENTITY manrevision "2.15.2">
<!ENTITY date "August 2006">
<!ENTITY tool "Network Administration Tool">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the MATE Documentation Project
  http://developer.mate.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 06, 2003
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en-GB">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>Network Administration Tool Manual</title> 
    <copyright lang="en">
      <year>2004-2006</year>
      <holder>Carlos Garnacho Parro</holder>
    </copyright>

<!-- translators: uncomment this:
  <copyright>
   <year>2003</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>
   -->

    <publisher role="maintainer"> 
	 <publishername>Carlos Garnacho Parro</publishername> 
    </publisher> 

  <legalnotice id="legalnotice">
	<para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation Licence (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this <ulink type="help" url="help:fdl">link</ulink> or in the file COPYING-DOCS distributed with this manual.</para>
         <para>This manual is part of a collection of MATE manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the licence to the manual, as described in section 6 of the licence.</para>

	<para>Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any MATE documentation, and the members of the MATE Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.</para>

	<para lang="en">
	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
	  WITH THE FURTHER UNDERSTANDING THAT:

	  <orderedlist>
		<listitem>
		  <para lang="en">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
                    EXCEPT UNDER THIS DISCLAIMER; AND
		  </para>
		</listitem>
		<listitem>
		  <para lang="en">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
                       THE POSSIBILITY OF SUCH DAMAGES.
		  </para>
		</listitem>
	  </orderedlist>
	</para>
  </legalnotice>


<!-- This file  contains link to license for the documentation (GNU FDL), and 
     other legal stuff such as "NO WARRANTY" statement. Please do not change 
     any of this. -->

    <authorgroup> 
      <author lang="en">
        <firstname>Carlos</firstname>
        <surname>Garnacho Parro</surname>
      </author>
      <!-- This is appropriate place for other contributors: translators,
           maintainers,  etc. Commented out by default.
        <othercredit role="translator">
	      <firstname>Latin</firstname> 
	      <surname>Translator 1</surname> 
	      <affiliation> 
	      	<orgname>Latin Translation Team</orgname> 
	       	<address> <email>translator@gnome.org</email> </address> 
	      </affiliation>
	      <contrib>Latin translation</contrib>
        </othercredit>
-->
    </authorgroup>

    <revhistory>
	 <revision lang="en">
	   <revnumber>Network Administration Tool Manual V2.15.2</revnumber>
	   <date>August 2006</date>
	   <revdescription>
          <para role="author" lang="en">carlosg@gnome.org (Carlos Garnacho Parro)</para>
          <para role="publisher" lang="en">carlosg@gnome.org (Carlos Garnacho Parro)</para>
	   </revdescription>
	 </revision>
	 <revision lang="en">
	   <revnumber>Network Administration Tool Manual V0.35</revnumber>
	   <date>June 2004</date>
	   <revdescription>
          <para role="author" lang="en">carlosg@gnome.org (Carlos Garnacho Parro)</para>
          <para role="publisher" lang="en">carlosg@gnome.org (Carlos Garnacho Parro)</para>
	   </revdescription>
	 </revision>
    </revhistory>

    <releaseinfo>This manual describes version 2.15.2 of Network Administration Tool.</releaseinfo> 

    <legalnotice> 
	 <title>Feedback</title> 
	 <para>To report a bug or make a suggestion regarding the <application>Network Administration Tool</application> or this manual, follow the directions in the <ulink url="help:mate-feedback" type="help">MATE Feedback Page</ulink>.</para>
    </legalnotice>
    <abstract role="description">
      <para>The <application>Network Administration Tool</application> allows you to specify the way your system connects to other computers and to the Internet.</para>
    </abstract> 
  </articleinfo> 

  <indexterm zone="index" lang="en"> 
    <primary>Network Administration Tool</primary> 
  </indexterm> 

  <!-- ============= Document Body ============================= -->
  <sect1 id="tool-introduction"> 
    <title>Introduction</title> 
    <para>The <application>Network Administration Tool</application> allows you to specify the way your system connects to other computers and to the Internet.</para> 
  </sect1>

  <sect1 id="tool-getting-started">
    <title>Getting started</title>

    <para>You can start <application>Network Administration Tool</application> in the following ways:</para>

    <variablelist>
	 <varlistentry>
	   <term><guimenu>System</guimenu> menu</term>
	   <listitem>
		<para>Choose <menuchoice><guisubmenu>Administration</guisubmenu><guimenuitem>Networking</guimenuitem></menuchoice>.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Command line</term>
	   <listitem>
		<para>Execute the following command: <command>network-admin</command></para>
	   </listitem>
	 </varlistentry>
    </variablelist>

    <para>When you start <application>Network Administration Tool</application>, you will be prompted for the administrator password. This is necessary because the changes done with this tool will affect the whole system.</para>

    <para>After entering the administrator password, the following window is displayed.</para>

    <figure id="network-main-window">
	 <title><application>Network Administration Tool</application> main window</title>
	 <screenshot>
	   <mediaobject lang="en">
		<imageobject>
		  <imagedata fileref="figures/network-tool.png" format="PNG"/>
		</imageobject>
		<textobject>
		  <phrase>Shows Network Administration Tool main window.</phrase>
		</textobject>
	   </mediaobject>
	 </screenshot>
    </figure>

    <para>The <application>Network Administration Tool</application> main window contains four tabbed sections:</para>

    <variablelist>
	 <varlistentry>
	   <term lang="en"><guilabel>Connections</guilabel></term>
	   <listitem>
		<para>Shows all network interfaces. It also allows you to modify their settings.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term lang="en"><guilabel>General</guilabel></term>
	   <listitem>
		<para>Allows you to modify your system host name and domain name.</para>
	   </listitem>
	 </varlistentry>

    	 <varlistentry>
	   <term lang="en"><guilabel>DNS</guilabel></term>
	   <listitem>
		<para>Contains two sections, the <guilabel>DNS servers</guilabel> are what your computer use for resolving the IP addresses from the domain names. The <guilabel>search domains</guilabel> are the default domains in which your system will search any host when no domain is specified.</para>
	   </listitem>
	 </varlistentry>

      <varlistentry>
	   <term lang="en"><guilabel>Hosts</guilabel></term>
	   <listitem>
		<para>Shows the list of aliases for accessing other computers.</para>
	   </listitem>
	 </varlistentry>
    </variablelist>
  </sect1>

  <sect1 id="tool-usage">
    <title>Usage</title>

    <sect2 id="tool-modify-connection">
	 <title>To modify connection settings</title>
	 <para>In the <guilabel>Connections</guilabel> section, select the interface you want to modify and press the <guibutton>Properties</guibutton> button. Depending on the interface type you will be able to modify different data.</para>

	 <variablelist>
	   <varlistentry>
		<term>Ethernet and IRLAN interfaces</term>
		<listitem>
		  <para>You can modify the way the interface is configured (DHCP or manually). If the interface is configured manually, you can also modify the interface IP address, netmask and gateway.</para>
		</listitem>
	   </varlistentry>

	   <varlistentry>
		<term>Wireless interfaces</term>
		<listitem>
		  <para>You can modify the way the interface is configured (DHCP or manually). If the interface is configured manually, you can also modify the interface IP address, netmask and gateway. You can also modify the network name (ESSID) for this interface.</para>
		</listitem>
	   </varlistentry>

	   <varlistentry>
		<term>Parallel line interfaces</term>
		<listitem>
		  <para>You can modify the interface IP address, as well as the remote IP address.</para>
		</listitem>
	   </varlistentry>

	   <varlistentry>
		<term>PPP/Modem interfaces</term>
		<listitem>
		  <para>You can modify the modem device, whether you want it to dial using tones or pulses, the modem volume, the phone number, the username and password that your ISP provided and other advanced settings for PPP.</para>
		</listitem>
	   </varlistentry>
	 </variablelist>
    </sect2>

    <sect2>
	 <title>To activate or deactivate an interface</title>
	 <para>In the <guilabel>Connections</guilabel> section, enable or disable the checkbox beside the interface.</para>
    </sect2>
    
    <sect2>
	 <title>To change your host name and domain name</title>
	 <para>In the <guilabel>General</guilabel> section, change the hostname or domain name text boxes.</para>
    </sect2>

    <sect2>
	 <title>To add a new domain name server</title>
	 <para>In the <guilabel>DNS Servers</guilabel> section, click on the <guibutton>Add</guibutton> button and fill in the new list row with the new domain name server.</para>
    </sect2>

    <sect2>
	 <title>To delete a domain name server</title>
	 <para>In the <guilabel>DNS Servers</guilabel> section, select a DNS IP address from the list and click on the <guibutton>Delete</guibutton> button.</para>
    </sect2>

    <sect2>
	 <title>To add a new search domain</title>
	 <para>In the <guilabel>Search Domains</guilabel> section, click on the <guibutton>Add</guibutton> button and fill in the new list row with the new search domain.</para>
    </sect2>

    <sect2>
	 <title>To delete a search domain</title>
	 <para>In the <guilabel>Search Domains</guilabel> section, select a search domain from the list and click on the <guibutton>Delete</guibutton> button.</para>
    </sect2>

    <sect2>
	 <title>To add a new host alias</title>
	 <para>In the <guilabel>Hosts</guilabel> section, click on the <guibutton>Add</guibutton> button and type an IP address and the aliases to which it will point in the window that pops up.</para>
    </sect2>

    <sect2>
	 <title>To modify a host alias</title>
	 <para>In the <guilabel>Hosts</guilabel> section, select an alias, click on the <guibutton>Properties</guibutton> button from the list and modify the alias settings in the window that pops up.</para>
    </sect2>

    <sect2>
	 <title>To delete a host alias</title>
	 <para>In the <guilabel>Hosts</guilabel> section, select an alias from the list and click on the <guibutton>Delete</guibutton> button.</para>
    </sect2>

    <sect2 id="tool-add-new-profile">
	 <title>To save your current network configuration as a "Location"</title>
	 <para>Click on the <guibutton>Add</guibutton> button besides the <guilabel>Locations</guilabel> menu and specify the location name in the window that pops up.</para>
    </sect2>

    <sect2>
	 <title>To delete a location</title>
	 <para>Click on the <guibutton>Remove</guibutton> button besides the <guilabel>Locations</guilabel> menu. The selected profile will be deleted.</para>
    </sect2>

    <sect2>
	 <title>To switch to a location</title>
	 <para>Select one location from the <guilabel>Locations</guilabel> menu. All the configuration will be switched automatically to the chosen location.</para>
    </sect2>
  </sect1>
</article>
