RaringUbuntuServerGuide
|
Ubuntu Server Guide - Raring
The Ubuntu Server Guide project is part of System Documentation and, as such, everything that has been written on that topic applies equally here. Follow the above links to understand the process of contributing to Ubuntu System Documentation.
The purpose of this page is to organize contributions made to the Server Guide for the upcoming Ubuntu release. It is also cool to see what other people are up to. Subscribe to this page!
In addition to this focus wiki page, there is a focus Launchpad team replete with a mailing list. If you are committed to the improvement of the Guide please do become a member of the Ubuntu Server Guide Helpers team!
Here are ways to contribute, in order of priority:
Correct (and/or Triage) a filed bug. Ubuntu Server Guide Bugs
Extend by adding a significant amount of new information (possibly new sub-chapter or an entirely new chapter). Let me know of your intentions.
Propose ideas for improvement (new topics, re-organization). There is a Discussion section at the bottom.
Useful links:
Current release guide: Ubuntu Server Guide - Quantal
Last release version of this document: QuantalUbuntuServerGuide
Kickstart
Here are some sample core commands for someone (local user john with a Launchpad id of johnlpid) wishing to review sub-chapter 6.1 (OpenLDAP section under Network Authentication chapter) for Ubuntu 13.04. Please do read up on what they do; it's all explained in the links at the top of the page.
Change text in the below commands to fit your own situation (ex: do not paste in 6.1 if you're not reviewing 6.1).
1. Get the repository
sudo apt-get install bzr docbook docbook-xsl xsltproc libxml2-utils yelp-tools mkdir ~/sguide-1304 cd ~/sguide-1304 bzr branch lp:serverguide serverguide-review-6.1
2. Review and edit the material (a little bit at a time)
cd serverguide-review-6.1 vi serverguide/C/network-auth.xml make serverguide-html
3. View and verify the changes in your browser
firefox build/serverguide/C/openldap-server.html
Repeat the above 2 steps until crispy.
4. Send the modified repository to your Launchpad account
scripts/validate.sh serverguide/C/serverguide.xml bzr commit -m 'Reviewing sub-chapter 6.1; other notes can go here' bzr push lp:~johnlpid/serverguide/serverguide-review-6.1
5. Submit a proposal to merge the modifications with the main branch
Enter the Code section of your Launchpad account, select the appropriate branch, and submit a merge proposal.
Alternative help method
Although the above is the preferred method for contributing, if you find it too laborious or you just can't make it work an alternative route is to create a bug about what you think is wrong in the guide and include some replacement text. Of course, if you are working already from an existing bug then just add the text in a new bug comment. If you have multiple bugs that affect the same sub-chapter then create a single bug for all of them.
Contribution table
The stuff in green is the priority this cycle. |
Using the following symbols...
|
TO DO |
|
IN PROGRESS |
|
MERGE PROPOSED |
|
MERGE ACCEPTED, I'M DONE! |
|
MERGE REJECTED |
|
NOTHING TO DO, IT'S GOOD AS IS |
|
COMMENT |
![Warning /!\](/moin_static198/light/img/icon_eek.png "Warning /!\"){kind=icon}
...let us know what you want to do, where you're at, and any comments you may have. While In Progress, update the % Complete column regularly.
Active code reviews for this cycle. All Active code reviews.
Sub-chapter |
Your name |
Your Launchpad ID |
Review |
Extension |
Comments |
% Complete |
1 - Introduction |
||||||
1.1 -- Support |
|
|
|
|
|
|
2 - Installation |
||||||
2.1 -- Preparing to Install |
Doug S |
dsmythies |
|
|
LP 1050595 |
100% |
2.2 -- Installing from CD |
|
|
|
|
|
|
2.3 -- Upgrading |
|
|
|
|
|
|
2.4 -- Advanced Installation |
|
|
|
|
|
|
2.5 -- Kernel Crash Dumps |
|
|
|
|
|
|
3 - Package Management |
||||||
3.1 -- Introduction |
|
|
|
|
|
|
3.2 -- dpkg |
|
|
|
|
|
|
3.3 -- Apt-Get |
|
|
|
|
|
|
3.4 -- Aptitude |
|
|
|
|
|
|
3.5 -- Automatic Updates |
|
|
|
|
|
|
3.6 -- Configuration |
|
|
|
|
|
|
3.7 -- References |
|
|
|
|
|
|
4 - Networking |
||||||
4.1 -- Network Configuration |
|
|
|
|
|
|
4.2 -- TCP/IP |
|
|
|
|
|
|
4.3 -- Dynamic Host Configuration Protocol (DHCP) |
|
|
|
|
|
|
4.4 -- Time Synchronisation with NTP |
|
|
|
|
|
|
5 - Storage |
||||||
5.1 -- LVM |
|
|
|
|
|
|
5.2 -- Software RAID (md) |
|
|
|
|
|
|
5.3 -- DM Multipath |
|
|
|
|
|
|
6 - Remote Administration |
||||||
6.1 -- OpenSSH Server |
|
|
|
|
|
|
6.2 -- Puppet |
Spencer Krum |
krum-spencer |
|
|
MP: #152090 |
100% |
6.3 -- Zentyal |
|
|
|
|
|
|
7 - Network Authentication |
||||||
7.1 -- OpenLDAP Server |
|
|
|
|
|
|
7.2 -- Samba and LDAP |
|
|
|
|
|
|
7.3 -- Kerberos |
|
|
|
|
|
|
7.4 -- Kerberos and LDAP |
|
|
|
|
|
|
8 - Domain Name Service (DNS) |
||||||
8.1 -- Installation |
|
|
|
|
|
|
8.2 -- Configuration |
|
|
|
|
|
|
8.3 -- Troubleshooting |
|
|
|
|
Note 1 |
|
8.4 -- References |
Bryan Fullerton |
fehwalker |
|
|
MP: 155020 |
100% |
9 - Security |
||||||
9.1 -- User Management |
|
|
|
|
|
|
9.2 -- Console Security |
|
|
|
|
|
|
9.3 -- Firewall |
|
|
|
|
|
|
9.4 -- AppArmor |
|
|
|
|
|
|
9.5 -- Certificates |
|
|
|
|
|
|
9.6 -- eCryptfs |
|
|
|
|
|
|
10 - Monitoring |
||||||
10.1 -- Overview |
|
|
|
|
|
|
10.2 -- Nagios |
|
|
|
|
|
|
10.3 -- Munin |
|
|
|
|
|
|
11 - Web Servers |
||||||
11.1 -- HTTPD - Apache2 Web Server |
|
|
|
|
|
|
11.2 -- PHP5 - Scripting Language |
|
|
|
|
|
|
11.3 -- Squid - Proxy Server |
Bryan Fullerton |
fehwalker |
|
|
LP: #1000442 |
100% |
11.4 -- Ruby on Rails |
|
|
|
|
|
|
11.5 -- Apache Tomcat |
Bryan Fullerton |
fehwalker |
|
|
MP: #157219 |
100% |
12 - Databases |
||||||
12.1 -- MySQL |
|
|
|
|
LP: #1152672 done |
|
12.2 -- PostgreSQL |
William Van Hevelingen |
blkperl |
|
|
MP: #152308 |
100% |
13 - LAMP Applications |
||||||
13.1 -- Overview |
|
|
|
|
|
|
13.2 -- Moin Moin |
|
|
|
|
|
|
13.3 -- MediaWiki |
|
|
|
|
|
|
13.4 -- phpMyAdmin |
|
|
|
|
|
|
13.5 -- WordPress |
Jay Wren |
jwren |
|
|
Rev 104 |
100% |
14 - File Servers |
||||||
14.1 -- FTP Server |
|
|
|
|
|
|
14.2 -- Network File System (NFS) |
|
|
|
|
|
|
14.3 -- iSCSI Initiator |
|
|
|
|
|
|
14.4 -- CUPS - Print Server |
|
|
|
|
|
|
15 - Email Services |
||||||
15.1 -- Postfix |
Doug S |
dsmythies |
|
|
jwren akurolwa |
100% |
15.2 -- Exim4 |
|
|
|
|
|
|
15.3 -- Dovecot Server |
Doug S |
dsmythies |
|
|
jwren akurolwa |
100% |
15.4 -- Mailman |
|
|
|
|
|
|
15.5 -- Mail Filtering |
|
|
|
|
|
|
16 - Chat Applications |
||||||
16.1 -- Overview |
|
|
|
|
|
|
16.2 -- IRC Server |
|
|
|
|
|
|
16.3 -- Jabber Instant Messaging Server |
|
|
|
|
|
|
17 - Version Control Systems |
||||||
17.1 -- Bazaar |
|
|
|
|
|
|
17.2 -- Subversion |
|
|
|
|
|
|
17.3 -- CVS Server |
|
|
|
|
|
|
17.4 -- References |
|
|
|
|
|
|
18 - Samba |
||||||
18.1 -- Introduction |
|
|
|
|
|
|
18.2 -- File Server |
|
|
|
|
|
|
18.3 -- Print Server |
|
|
|
|
|
|
18.4 -- Securing File and Print Server |
|
|
|
|
|
|
18.5 -- As a Domain Controller |
|
|
|
|
|
|
18.6 -- Active Directory Integration |
|
|
|
|
|
|
19 - Backups |
||||||
19.1 -- Shell Scripts |
|
|
|
|
|
|
19.2 -- Archive Rotation |
|
|
|
|
|
|
19.3 -- Bacula |
|
|
|
|
|
|
20 - Virtualization |
||||||
20.1 -- libvirt |
Doug S |
dsmythies |
|
|
LP 1129649 |
100% |
20.2 -- JeOS and vmbuilder |
|
|
|
|
|
|
20.3 -- Ubuntu Cloud |
|
|
|
|
|
|
20.4 -- LXC |
|
|
|
|
|
|
21 - Clustering |
||||||
21.1 -- DRBD |
|
|
|
|
|
|
22 - VPN |
||||||
22.1 -- OpenVPN |
|
|
|
|
|
|
23 - Other Useful Applications |
||||||
23.1 -- pam_motd |
|
|
|
|
|
|
23.2 -- etckeeper |
|
|
|
|
|
|
23.3 -- Byobu |
|
|
|
|
|
|
23.4 -- References |
|
|
|
|
|
|
A - Appendix |
||||||
A.1 -- Reporting Bugs in Ubuntu Server Edition |
|
|
|
|
|
|
Getting help
Here are the best ways to get answers to any questions you may have:
The Driver of this project, Peter Matulis.
Deadline
All final merge proposals should be made by April 4, 2013. See DocumentationStringFreeze and RaringRingtailReleaseSchedule.
Discussion
Here you can add your thoughts on
- Re-organization of topics
- Addition of missing topics: Juju
- Anything else
Note 1: DNS troubleshooting section still mentions editing resolv.conf, which is a no no. Fixed,as are other legacy resolv.conf issues. sub-section 3.1.4 is about named-checkzone. There should also be a 3.1.5 about named-checkconf. Not done, won't be done this cycle.
HTML version of the serverguide centering issue: Solved: see MP: #155154
DocumentationTeam/SystemDocumentation/RaringUbuntuServerGuide (last edited 2013-06-06 16:04:35 by petermatulis)