~ubuntu-branches/ubuntu/wily/xubuntu-docs/wily-proposed

<?xml version="1.0" encoding="UTF-8"?>

        <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 

                "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [

        <!ENTITY % globalent SYSTEM "../../libs/global.ent">

        %globalent;

    <!ENTITY % xubuntu-ent SYSTEM "../../libs/xubuntu.ent">

    %xubuntu-ent;

        <!ENTITY % xinclude SYSTEM "../../libs/xinclude.mod">

        %xinclude;

        <!ENTITY language "en">

        <!ENTITY ubuntu '<phrase>Xubuntu</phrase>'>

        ]>

<section id="networking" status="review">

        <title>Home Networks</title>

        <para>This section provides instructions on how to communicate with other 

        computers using a Local Area Network (<acronym>LAN</acronym>).</para>

        <section id="networking-browsenetcomps" status="review">

                <title>View other computers on the network</title>

                <para>To view computers on the network, open &network-servers;.</para>

                <para>You may need to enter a username, password, and domain. 

                You should obtain these from your network administrator where 

                necessary. The username and password will normally be the username 

                and password for a user of the computer on which you are trying 

                to connect.</para>

                <para>The domain can often be left blank.</para>

                <para>See <ulink url='http://goodies.xfce.org/projects/applications/gigolo'>the 

                Gigolo website</ulink> for more information.</para>

    </section>

<!-- REMOVED UNTIL SOMEONE MAKES A DECISION ON GNOME-NETWORK-TOOLS INCLUSION

    <section id="networking-changecompname" status="review">

                <title>Change computer name</title>

        <para>When connected to a network, your computer can be referred to by its <emphasis>host name</emphasis>. It is possible to change the host name of your computer.</para>

<important><para>You must be a member of the <emphasis>admin</emphasis> group in order to change the computer host name.</para></important>

        <procedure>

                <step>

                <para>Open &networking;.</para>

                </step>

                <step>

                        <para>Press <guibutton>Unlock</guibutton> and enter your password in the                                <guilabel>Password for (username): </guilabel> field.</para>

                </step> 

                <step>

                        <para>Press the <guibutton>Authenticate</guibutton> button.</para>

                </step>

                <step>

                <para>Click the <guilabel>General</guilabel> tab. Enter the name of the computer in the <guilabel>Host name</guilabel> field.</para>

            </step>

        </procedure>

        <para>Restart the computer for the change to take effect.</para>

        </section>

-->        

        <section id="networking-shares" status="review">

                <title>Share Files and Folders With Other Computers</title>

                <para>You can share files and folders with other people on your 

                network through <application>Shared Folders</application>.</para>

                <section id="networking-shares-sharesadmin" status="review">

                        <title>Sharing Folders Via the Shared Folders Application</title>

                        <para>To share folders using the <application>Shared 

                        Folders</application> application:</para>

                        <procedure>

                                <step>

                                        <para>Press &terminal; to open a 

                                        <application>Terminal</application>.</para>

                                </step>

                                <step>

                                        <para>Type <command>shares-admin</command> 

                                        and press <keycap>Enter</keycap> to open 

                                        <application>Shared Folders</application>.</para>

                                </step>

                                <step>

                                        <para>Press the <guibutton>padlock</guibutton> 

                                        button labeled <guilabel>Click to make 

                                        changes</guilabel> and type your password.</para>

                                </step> 

                                <step>

                                        <para>Press <keycap>Enter</keycap> or 

                                        the <guibutton>Authenticate</guibutton> 

                                        button.</para>

                                </step>

                                <step>

                                        <para>You may receive a message that says 

                                        <guilabel>Sharing services are not installed</guilabel>. 

                                        If this happens, ensure that the two 

                                        checkboxes in the message box are checked 

                                        and press <guibutton>Install services</guibutton>. 

                                        Sharing service support will then be 

                                        downloaded and installed; this may take 

                                        a while.</para>

                                </step>

                                <step>

                                        <para>Select the <guilabel>Shared Folders</guilabel> 

                                        tab and press <guibutton>Add</guibutton>.</para>

                                </step>

                                <step>

                                        <para>Select the location of the folder 

                                        you wish to share by changing the 

                                        <guilabel>Path</guilabel> option.</para>

                                </step>

                                <step>

                                        <para>In the <guilabel>Share through</guilabel> 

                                        option, choose <guilabel>Windows networks 

                                        (SMB)</guilabel> if you want to share 

                                        your folders with other computers running 

                                        Windows operating systems. Choose 

                                        <guilabel>Unix networks (NFS)</guilabel> 

                                        if you want to share your folders with 

                                        other Unix based computers.</para>

                                </step>

                                <step>

                                        <para>Press the <guibutton>Add</guibutton> button.</para>

                                </step>

                                <step>

                                        <para>In the<guilabel>Add allowed hosts

                                        </guilabel> box, you can specify which 

                                        hosts (other computers) will have access 

                                        to your shared folders by entering the 

                                        <guilabel>IP address</guilabel>, 

                                        <guilabel>Host name</guilabel> or 

                                        <guilabel>Domain</guilabel> of the other 

                                        computers.</para>

                                </step>

                                <step>

                                        <para>If you would like people accessing 

                                        the shared folder(s) to be able to add, 

                                        change and remove files in the folder, 

                                        uncheck <guilabel>Read only</guilabel>. 

                                        If you leave <guilabel>Read only</guilabel> 

                                        checked, people will only be able to view 

                                        files in the folder.</para>

                                </step>

                                <step>

                                        <para>Press <guibutton>OK</guibutton> to 

                                        make the shared folder(s) available. Other 

                                        computers on the same (<acronym>LAN</acronym>) 

                                        as you should now be able to access the 

                                        folder(s).</para>

                                </step>

                        </procedure>                    

        <note><para>You may receive a message that says <guilabel>You do not 

        have permission to create a usershare</guilabel>. If this happens, contact 

        your system administrator or configure the <application>Folder sharing 

        service (samba)</application>.</para></note>

                <para>See the <ulink url='http://library.gnome.org/users/shares-admin/stable/tool-introduction.html'>Shared 

                Folders Administration Tool manual</ulink> for more information 

                on managing network shares.</para>

                </section> 

                <section id="networking-shares-windows" status="review">

                        <title>Accessing shared folders via Windows</title>

                        <para>If you would like to access a shared folder hosted 

                        on an Xubuntu computer by using computers running Windows, 

                        you may have to perform some additional steps:</para>

                        <procedure>

                                <step>

                                        <para>Press &terminal; to open a Terminal.</para>

                                </step>

                                <step>

                                        <para>Type <command>sudo smbpasswd -a username</command>, 

                                        replacing <quote>username</quote> with 

                                        your own username. Press <keycap>Enter</keycap> 

                                        to run the command.</para>

                                        <note>

                                                <para>You can find out what your 

                                                username is by typing <command>whoami

                                                </command> into the Terminal and 

                                                then pressing <keycap>Enter</keycap>.</para>

                                        </note>

                                </step>

                                <step>

                                        <para>Enter your password when prompted 

                                        with <quote>[sudo] password for username:

                                        </quote> and press <keycap>Enter</keycap> 

                                        again.</para>

                                </step>

                                <step>

                                        <para>When prompted with <quote>New SMB 

                                        password:</quote>, enter the password 

                                        that you would like to use to access the 

                                        shared folder and then press <keycap>Enter</keycap>. 

                                        You can leave the password blank, which 

                                        will allow anyone to access the shared folder.</para>

                                </step>

                                <step>

                                        <para>When prompted with <quote>Retype 

                                        new SMB password:</quote>, enter the 

                                        password that you just entered and then 

                                        press <keycap>Enter</keycap>.</para>

                                </step>

                                <step>

                                        <para>You should now be able to connect 

                                        to the shared folders on the Xubuntu 

                                        computer.</para>

                                </step>

                        </procedure>

                </section>

                

                <section id="networking-shares-troubleshooting" status="review">

                        <title>Problems connecting to shared folders in Windows</title>

                                <para>If you are unable to connect to a shared 

                                folder using Windows, try using the <emphasis>IP 

                                address</emphasis> of the Xubuntu computer rather 

                                than its <emphasis>host name</emphasis> to access 

                                the share:</para>

                                <para></para>

                                <procedure>

                                        <step>

                                                <para>Click &network-tools; and select the <guilabel>Devices</guilabel> tab.</para>

                                        </step>

                                        <step>

                                                <para>Select the name of your network connection from the <guilabel>Network device</guilabel> option list (for example, <quote>eth0</quote>). If you have several network connections, you may have to try this several times.</para>

                                        </step>

                                        <step>

                                                <para>Make a note of the number in the <guilabel>IP address</guilabel> column. It should consist of four numbers separated by dots (for example, <quote>192.168.2.10</quote>)</para>

                                        </step>

                                        <step>

                                                <para>On the Windows computer, select <menuchoice><guimenuitem>Start</guimenuitem><guimenuitem>Run</guimenuitem></menuchoice> and type <userinput>\\ipaddress</userinput> in the text box, replacing <quote>ipaddress</quote> with the IP address of the Xubuntu computer</para>

                                        </step>

                                        <step>

                                                <para>Press <guibutton>OK</guibutton> to connect to the shared folder.</para>

                                        </step>

                                </procedure>

                                

                                <para>If you are still unable to access the shared folder, check that the folder sharing service is running on the Xubuntu computer:</para>

                                <procedure>

                                        <step>

                                                <para>Press &services;</para>

                                        </step>

                                        <step>

                                                <para>Find the <guilabel>Folder sharing service (samba)</guilabel> and ensure that the checkbox next to it is checked. If it is not checked, press <guibutton>Unlock</guibutton> and enter your administrative password. Press <guibutton>Authenticate</guibutton>, then enable the Folder sharing service.</para>

                                        </step>

                                        <step>

                                                <para>Press <guibutton>Close</guibutton></para>

                                        </step>

                                </procedure>

                                <para>More information can be found on the Ubuntu <ulink url='https://help.ubuntu.com/community/SettingUpSamba'>community help pages</ulink>.</para>

                        </section>

        </section>

<!-- SECTION REMOVED TO CONSOLIDATE WITH A SINGLE TROUBLESHOOTING SECTION AND TO REMOVE REFERENCE TO FLAMING NETWORK    

        <section id="network-troubleshooting" status="review">

                <title>Tools to help with network connection problems</title>

                <para>If you have a network connection which is not working properly, you can use a few tools to help diagnose the problem.</para>

                <para>Most of the tools in this section require use of the Terminal, which you can open by pressing &terminal;.</para>

                

                <section id="network-troubleshooting-ifconfig" status="review">

                        <title>Get information about the current connection</title>

                        <para><application>ifconfig</application> is intended to allow you to change the settings of your network connections.  It can also be used to list information about the current connection.</para>

                        <orderedlist>

                                <listitem><para>Press &terminal; to open a Terminal.</para></listitem>

                                <listitem>

                                        <para>Type <command>ifconfig eth1</command> in the Terminal and press <keycap>Enter</keycap>.  Replace <emphasis>eth1</emphasis> with the name of your network interface if it is different.</para>

                                        <itemizedlist>

                                                <listitem><para><emphasis>inet addr</emphasis> shows the current <emphasis>IP address</emphasis> of the connection.</para></listitem>

                                                <listitem><para><emphasis>HWaddr</emphasis> shows the <emphasis>MAC address</emphasis> of your network device.</para></listitem>

                                        </itemizedlist>

                                </listitem>

                        </orderedlist>

                </section>              

 

                <section id="network-troubleshooting-ping" status="review">

                        <title>Check if a connection is working correctly</title>

                        <para>A good way of checking if a connection is working correctly is to <emphasis>ping</emphasis> another computer on the network or the Internet.</para>

                        <para>To check if you are connected to the Internet:</para>

                        <orderedlist>

                                <listitem><para>Press &network-tools; to open the networking tools suite.</para></listitem>

                                <listitem><para>Select the <guilabel>Ping</guilabel> tab.</para></listitem>

                                <listitem><para>Type <userinput>ubuntu.com</userinput> into the <guilabel>Network address</guilabel> box and then press <guibutton>Ping</guibutton>.</para></listitem>

                                <listitem>

                                        <para>After a while, a graph should appear. Look at the number for <guilabel>Successful packets</guilabel> under <guilabel>Transmission Statistics</guilabel></para>

                                        <itemizedlist>

                                                <listitem><para><emphasis>100% successful packets</emphasis> - Your computer has a good connection to the Internet.</para></listitem>

                                                <listitem><para><emphasis>Less than 100% successful</emphasis> - Your computer probably has a poor connection to the Internet or a poor wireless signal.</para></listitem>

                                                <listitem><para><emphasis>0% successful packets</emphasis> - Your computer has a very bad connection, or is connected to an access point or router which is not connected to the Internet</para></listitem>

                                        </itemizedlist>

                                </listitem>

                        </orderedlist>

                        <para>If you get an error message which says <emphasis>The address &apos;ubuntu.com&apos; cannot be found</emphasis>, then you cannot reach a <emphasis>DNS server</emphasis>.</para>

                </section>

                

                <section id="network-troubleshooting-dns" status="review">

                        <title>Check the DNS</title>

                        <para>A good way of checking if a connection is working correctly is to <emphasis>ping</emphasis> another computer on the network or the Internet.</para>

                        <para>To check if you are connected to the Internet:</para>

                        <orderedlist>

                                <listitem><para>Press &network-tools; to open the networking tools suite.</para></listitem>

                                <listitem><para>Select the <guilabel>Ping</guilabel> tab.</para></listitem>

                                <listitem><para>Type <userinput>91.189.94.249</userinput> into the <guilabel>Network address</guilabel> box and then press <guibutton>Ping</guibutton>.</para></listitem>

                                <listitem>

                                        <para>After a while, a graph should appear. Look at the number for <guilabel>Successful packets</guilabel> under <guilabel>Transmission Statistics</guilabel>.</para>

                                        <itemizedlist>

                                                <listitem><para><emphasis>100% successful packets</emphasis> - Your computer has a good connection to the Internet.</para></listitem>

                                                <listitem><para><emphasis>Less than 100% successful</emphasis> - Your computer probably has a poor connection to the Internet or a poor wireless signal.</para></listitem>

                                                <listitem><para><emphasis>0% successful packets</emphasis> - Your computer has a very bad connection, or is connected to an access point or router which is not connected to the Internet.</para></listitem>

                                        </itemizedlist>

                                </listitem>

                        </orderedlist>

                        <para>If you get an error message which says <emphasis>The address &apos;91.189.94.249&apos; cannot be found</emphasis>, then there is no connection.</para>

                        <para>If the address is found then try the next stage.</para>

                </section>

        </section>        

-->

</section>