UbuntuServerGuide
Contents
|
Ubuntu Server Guide - Saucy
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 - Raring
Last release version of this document: RaringUbuntuServerGuide
Kickstart
Here are some sample core commands for someone (local user john with a Launchpad id of johnlpid) wishing to review sub-chapter 7.1 (OpenLDAP section under Network Authentication chapter) for Ubuntu 13.10. 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 7.1 if you're not reviewing 7.1).
0. Install the software
sudo apt-get install bzr docbook docbook-xsl xsltproc libxml2-utils yelp-tools yelp-xsl
1. Download the current branch
mkdir ~/sguide-1310 cd ~/sguide-1310 bzr branch lp:serverguide serverguide-review-7.1
2. Review and edit the material (a little bit at a time)
cd serverguide-review-7.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 --fixes lp:<bug-#> -m 'Reviewing sub-chapter 7.1; other notes can go here' bzr push lp:~johnlpid/serverguide/serverguide-review-7.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 |
...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.
Sub-chapter |
Your name |
Your Launchpad ID |
Review |
Extension |
Comments |
% Complete |
1 - Introduction |
||||||
1.1 -- Support |
|
|
|
|
|
|
2 - Installation |
||||||
2.1 -- Preparing to Install |
|
|
|
|
|
|
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 |
|
|
|
|
|
|
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 |
|
|
|
|
|
|
8.4 -- References |
|
|
|
|
|
|
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 |
|
|
|
|
|
|
11.4 -- Ruby on Rails |
|
|
|
|
|
|
11.5 -- Apache Tomcat |
|
|
|
|
|
|
12 - Databases |
||||||
12.1 -- MySQL |
|
|
|
|
|
|
12.2 -- PostgreSQL |
|
|
|
|
|
|
13 - LAMP Applications |
||||||
13.1 -- Overview |
|
|
|
|
|
|
13.2 -- Moin Moin |
|
|
|
|
|
|
13.3 -- MediaWiki |
|
|
|
|
|
|
13.4 -- phpMyAdmin |
|
|
|
|
|
|
13.5 -- WordPress |
|
|
|
|
|
|
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 |
|
|
|
|
|
|
15.2 -- Exim4 |
|
|
|
|
|
|
15.3 -- Dovecot Server |
|
|
|
|
|
|
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 |
Chris Glass |
|
|
|
|
|
17.2 -- Git |
Chris Glass |
|
|
|
||
17.3 -- Subversion |
Chris Glass |
|
|
|
|
|
17.X -- CVS Server |
Chris Glass |
|
|
|
||
17.4 -- References |
Chris Glass |
|
|
|
|
|
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 |
|
|
|
|
|
|
20.2 -- JeOS and vmbuilder |
|
|
|
|
|
|
20.3 -- Ubuntu Cloud |
|
|
|
|
|
|
20.4 -- LXC |
|
|
|
|
|
|
21 - Clustering |
||||||
21.1 -- DRBD |
|
|
|
|
|
|
22 - VPN |
||||||
22.1 -- OpenVPN |
Mark T |
markthomas |
|
|
|
|
23 - Other Useful Applications |
||||||
23.1 -- pam_motd |
Peter Matulis |
|
|
|
|
|
23.2 -- etckeeper |
Peter Matulis |
|
|
|
|
|
23.3 -- Byobu |
Peter Matulis |
|
|
|
|
|
23.4 -- References |
Peter Matulis |
|
|
|
|
|
A - Appendix |
||||||
A.1 -- Reporting Bugs in Ubuntu Server Edition |
Peter Matulis |
|
|
|
|
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 October 3rd, 2013. See DocumentationStringFreeze and SaucySalamanderReleaseSchedule.
Discussion
Here you can add your thoughts on
- Re-organization of topics
- Addition of missing topics:
- Juju
- Git / gitolite server : in progress by Chris Glass
- Anything else
Notes:
- sub-section 3.1.4 is about named-checkzone. There should also be a 3.1.5 about named-checkconf.
Specifications
We are proposing moving the developemnt and publishing of the Guide to the rolling release model as well as changing the management/scheduling of translations. See here:
The intention is to create a Blueprint out of this and discuss it at the next UDS for 13.10 (uds-13.08 ???).