<?xml version="1.0"?>
<!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 "0.35">
  <!ENTITY manrevision "0.35">
  <!ENTITY date "June 2004">
  <!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="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&tool; Manual V&manrevision;</title> 
    <copyright>
      <year>2004</year>
      <holder>Carlos Garnacho Parro</holder>
    </copyright>

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

    <publisher> 
	 <publishername>Carlos Garnacho Parro</publishername> 
    </publisher> 

&legal;
<!-- 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>&tool; Manual V&manrevision;</revnumber>
	   <date>&date;</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 &toolversion; of &tool;.</releaseinfo> 

    <legalnotice> 
	 <title>Feedback</title> 
	 <para> To report a bug or make a suggestion regarding the &tool; or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. </para>
    </legalnotice> 
  </articleinfo> 

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

  <!-- ============= Document Body ============================= -->
  <sect1 id="tool-introduction"> 
    <title>Introduction</title> 
    <para>The <application>&tool;</application> allows you to specify the way your system connect to other computers and to internet.</para> 
  </sect1>

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

    <para>You can start <application>&tool;</application> in the following ways:</para>

    <variablelist>
	 <varlistentry>
	   <term><guimenu>Applications</guimenu> menu</term>
	   <listitem>
		<para>Choose <menuchoice><guisubmenu>System Tools</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>&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>&tool; main window</title>
	 <screenshot>
	   <mediaobject>
		<imageobject>
		  <imagedata fileref="figures/network-tool.png" format="PNG"/>
		</imageobject>
		<textobject>
		  <phrase>Shows &tool; main window.</phrase>
		</textobject>
	   </mediaobject>
	 </screenshot>
    </figure>

    <para>The <application>&tool;</application> main window contains four tabbed sections:</para>

    <variablelist>
	 <varlistentry>
	   <term><guilabel>Connections</guilabel></term>
	   <listitem>
		<para>Shows all the configured network interfaces, it also allows you to modify their settings and to add or delete interfaces</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term><guilabel>General</guilabel></term>
	   <listitem>
		<para>Shows your system host name and domain, it also shows the way your system identifies itself in Windows networks.</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 domains in which your system will search any host when any domain is specified.</para>
	   </listitem>
	 </varlistentry>

      <varlistentry>
	   <term><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-add-new-interface">
	 <title>To create a new interface</title>
	 <para>In the <guilabel>Connections</guilabel> section, press the <guilabel>Add</guilabel> button, depending on the interface type, you will need to provide different data:</para>

	 <variablelist>
	   <varlistentry>
		<term>Ethernet and IRLAN interfaces</term>
		<listitem>
		  <para>You can specify if you want to configure automatically the interface through DHCP or BOOTP, or if you want to configure it manually providing its IP address, netmask and gateway.</para>
		</listitem>
	   </varlistentry>

	   <varlistentry>
		<term>Wireless interfaces</term>
		<listitem>
		  <para>You can specify if you want to configure automatically the interface through DHCP or BOOTP, or if you want to configure it manually providing its IP address, netmask and gateway. You also need to specify the network name (ESSID).</para>
		</listitem>
	   </varlistentry>

	   <varlistentry>
		<term>Parallel line interfaces</term>
		<listitem>
		  <para>You have to specify the IP address that the interface will have, and the IP address of the system to which it will be connected. You can also specify that you want the remote host to be the default gateway.</para>
		</listitem>
	   </varlistentry>

	   <varlistentry>
		<term>PPP/Modem interfaces</term>
		<listitem>
		  <para>You have to specify the phone number, username and password (this data is provided by the ISP), the modem device will be autodetected.</para>
		</listitem>
	   </varlistentry>
	 </variablelist>
    </sect2>

    <sect2 id="tool-modify-connection">
	 <title>To modify an already existing interface</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, BOOTP 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, BOOTP 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 delete an interface</title>
	 <para>In the <guilabel>Connections</guilabel> section, select the interface you want to delete and press the <guilabel>Delete</guilabel> button.</para>
    </sect2>

    <sect2>
	 <title>To activate or deactivate an interface</title>
	 <para>In the <guilabel>Connections</guilabel> section, select the interface and press the <guilabel>Activate</guilabel> or <guilabel>Deactivate</guilabel> button.</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 change the way your system identifies itself in Windows networks</title>
	 <para>In the <guilabel>General</guilabel> section, change the description or workgroup of your system in Windows networks. You can also specify the WINS server if you need one.</para>
    </sect2>

    <sect2>
	 <title>To add a new domain name server</title>
	 <para>In the <guilabel>DNS</guilabel> section, type the new DNS IP address in the DNS text box and press the <guilabel>Add</guilabel> button.</para>
    </sect2>

    <sect2>
	 <title>To delete a domain name server</title>
	 <para>In the <guilabel>DNS</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>DNS</guilabel> section, type the new domain in the search domain text box and press the <guilabel>Add</guilabel> button.</para>
    </sect2>

    <sect2>
	 <title>To delete a search domain</title>
	 <para>In the <guilabel>DNS</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, type a new IP address and the aliases that will point to it and press the <guilabel>Add</guilabel> button.</para>
    </sect2>

    <sect2>
	 <title>To modify a host alias</title>
	 <para>In the <guilabel>Hosts</guilabel> section, select an alias from the list and modify the aliases in the text box.</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 create a new profile</title>
	 <para>Press the <guilabel>Network profiles</guilabel> button, a new window will appear letting you to save your current configuration as a profile pressing the <guilabel>Save current</guilabel> button. You must specify a name for the profile, optionally you can specify a description for this profile.</para>
    </sect2>

    <sect2>
	 <title>To delete an already existing profile</title>
	 <para>Press the <guilabel>Network profiles</guilabel> button, in the network profiles window, select the profile you want to delete and press the <guilabel>Delete</guilabel> button.</para>
    </sect2>

    <sect2>
	 <title>To switch the current profile</title>
	 <para>Change the <guilabel>current network profile</guilabel> menu, all the configuration will be switched automatically to the chosen profile.</para>
    </sect2>
  </sect1>
</article> 
