Server Guide, Network Configuration Content Refresh
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
ubuntu-docs (Ubuntu) |
Fix Released
|
Low
|
Gilbert Mendoza |
Bug Description
Binary package hint: ubuntu-docs
I am working on a patch to refresh the content of the "Network Configuration" section of the Ubuntu Server Guide (Upcoming Lucid +). The proposed TOC and description of what they will contain is below. Patch to be completed in the next few days. Notes and comments welcome.
The bridging and resources section will not be addressed in this patch, although I do plan on visiting them in the near future. There is also room to add a section on basic Load Balancing (LACP, Round Robin, etc) and 802.1Q VLAN tagging, but that would just be too much for a single bug report / patch.
Proposed TOC:
Networking
Network Configuration
Ethernet Interfaces
* Will outline how network devices receive their device identifier of ethX. e.g. eth0, eth1
* Will explain how to manually control which NIC receives which identifier if needed.
* Will recommend further reading of ethtool man page for Ethernet parameter control.
IP Addressing
Temporary Configurations
* Will give basic examples of temporary configuration of basic addressing (lost on reboot).
* ifconfig, route and ip command examples will be given.
Loopback Addressing
* Will reference loopback entry in /etc/network/
* Will outline how to add loopback subinterfaces.
Dynamic Addressing (DHCP Client)
* Will reference dhcp entry in /etc/network/
* Will reference dhcp3 client configuration options (dhclient.conf)
Static Addressing
* Will reference static entry in /etc/network/
Name Resolution
DNS Configuration
* Will outline nsswitch.conf and how to control order of name lookup process (file, dns, mdns4, etc)
* Will outline how to properly configure resolv.conf
* Will include proper outline of domain search order lists
Static Hostnames
* Brief discussion on /etc/hosts
Bridging
* Leave as-is for time being
Resources
* Leave as-is for time being
Changed in ubuntu-docs (Ubuntu): | |
assignee: | nobody → Gilbert Mendoza (gmendoza) |
status: | New → In Progress |
tags: | added: serverguide |
tags: | added: patch |
Okay, so I've completed the proposed modifications of network-config.xml as they relate to this ticket.
I have been re-reading it over and over again, but you know how an extra pair of eyes can find both grammatical and spelling issues, and would appreciate any suggestions, comments or concerns.
One area that I would like some input on is regarding a section of a displayed configuration file that is just very wide. It's the section regarding Interface Logical Identifiers, displaying the contents of /etc/udev/ rules.d/ 70-persistent- net.rules. The lines are very long and could either be wrapped or abbreviated, but not sure what the official way would be.
Proposed patch is attached.