<?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 GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 06, 2003
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="oc">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>Network Administration Tool Manual</title> 
    <copyright>
      <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
	  License (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="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
	  distributed with this manual.
         </para>
         <para> This manual is part of a collection of GNOME 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 license to the manual, as described in
          section 6 of the license.
	</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 GNOME documentation, and the members of
	  the GNOME Documentation Project are made aware of those
	  trademarks, then the names are in capital letters or initial
	  capital letters.
	</para>

	<para>
	  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>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>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>
        <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>
	   <revnumber>Network Administration Tool Manual V2.15.2</revnumber>
	   <date>Agost de 2006</date>
	   <revdescription>
          <para role="author">carlosg@gnome.org (Carlos Garnacho Parro)</para>
          <para role="publisher">carlosg@gnome.org (Carlos Garnacho Parro)</para>
	   </revdescription>
	 </revision>
	 <revision>
	   <revnumber>Network Administration Tool Manual V0.35</revnumber>
	   <date>Junh de 2004</date>
	   <revdescription>
          <para role="author">carlosg@gnome.org (Carlos Garnacho Parro)</para>
          <para role="publisher">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 Network Administration Tool or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. </para>
    </legalnotice>
    <abstract role="description">
      <para>The Network Administration Tool allows you to specify the way your system connects to other computers and to internet.</para>
    </abstract> 
  </articleinfo> 

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

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

  <sect1 id="tool-getting-started">
    <title>Per començar</title>

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

    <variablelist>
	 <varlistentry>
	   <term>Menut <guimenu>Sistèma</guimenu></term>
	   <listitem>
		<para>Choose <menuchoice><guisubmenu>Administration</guisubmenu><guimenuitem>Networking</guimenuitem></menuchoice>.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Linha de comanda</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>Network Administration Tool main window</title>
	 <screenshot>
	   <mediaobject>
		<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><guilabel>Connexions</guilabel></term>
	   <listitem>
		<para>Shows all network interfaces, it also allows you to modify their settings.</para>
	   </listitem>
	 </varlistentry>

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

    	 <varlistentry>
	   <term><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><guilabel>Òstes</guilabel></term>
	   <listitem>
		<para>Shows the list of aliases for accessing other computers.</para>
	   </listitem>
	 </varlistentry>
    </variablelist>
  </sect1>

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

    <sect2 id="tool-modify-connection">
	 <title>To modify a connection settings</title>
	 <para>In the <guilabel>Connections</guilabel> section, select the interface you want to modify and press the <guilabel>Properties</guilabel> 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, press the <guilabel>Add</guilabel> 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 press the <guilabel>Delete</guilabel> button.</para>
    </sect2>

    <sect2>
	 <title>To add a new search domain</title>
	 <para>In the <guilabel>Search Domains</guilabel> section, press the <guilabel>Add</guilabel> 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 press the <guilabel>Delete</guilabel> button.</para>
    </sect2>

    <sect2>
	 <title>To add a new host alias</title>
	 <para>In the <guilabel>Hosts</guilabel> section, press the <guilabel>Add</guilabel> button and type an IP address and the aliases that will point to 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, press the <guilabel>Properties</guilabel> 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 press the <guilabel>Delete</guilabel> button.</para>
    </sect2>

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

    <sect2>
	 <title>To delete a location</title>
	 <para>Press the <guilabel>Remove</guilabel> 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>
