Diff for "DocumentationTeam/SystemDocumentation/QuantalUbuntuServerGuide"

QuantalUbuntuServerGuide

Differences between revisions 1 and 158 (spanning 157 versions)

Contents

Kickstart
Contribution table
Getting help
Deadline
Discussion

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!

Here are the different ways to contribute, in order of priority:

Review of existing material on a technical and style level.
Extension of existing material (significant amount of new information, possibly new sub-chapter) or an entirely new chapter. Let me know of your intentions.

There is a Discussion section at the bottom if you feel a topic is missing or if you have some other idea for improvement.

Useful links:

Current release guide: Ubuntu Server Guide - Precise
Bugs: Ubuntu Server Guide Bugs in Launchpad

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 12.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 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-1210
cd ~/sguide-1210
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.

Contribution table

The stuff in green is the priority this cycle (Quantal).

Using the following symbols...

	TO DO
	IN PROGRESS
$Warning /!\$	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.

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
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
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
17.2 -- Subversion
17.3 -- CVS Server
17.4 -- References
18 - Windows Networking
18.1 -- Introduction
18.2 -- Samba File Server
18.3 -- Samba Print Server
18.4 -- Securing a Samba File and Print Server
18.5 -- Samba as a Domain Controller
18.6 -- Samba Active Directory Integration
19 - Backups
19.1 -- Shell Scripts
19.2 -- Archive Rotation
19.3 -- Bacula
20 - Virtualization
20.1 -- libvirt	George Dunlap	dunlapg			Testing and integrating Xen	5%
20.2 -- JeOS and vmbuilder
20.3 -- UEC					this sub-chapter will be removed
20.4 -- Openstack
20.5 -- 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 Ubuntu Doc mailing list
The Ubuntu Server mailing list
The Driver of this project, Peter Matulis.

Deadline

All final merge proposals should be made by October 1, 2012. The string freeze date is September 20 but it looks like we need more time this cycle.

Discussion

Here you can add your thoughts on

Re-organization of topics
Addition of missing topics: Juju
Anything else

DocumentationTeam/SystemDocumentation/QuantalUbuntuServerGuide (last edited 2013-02-04 16:46:37 by petermatulis)

-  ⇤ ← Revision 1 as of 2011-11-11 17:46:27 → 
  Size: 4
  Editor: petermatulis
  Comment:
+   ← Revision 158 as of 2013-02-04 16:46:37 → ⇥
  Size: 11526
  Editor: petermatulis
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-ok
+## page was copied from DocumentationTeam/SystemDocumentation/UbuntuServerGuide
<<Include(DocumentationTeam/SystemDocumentation/MenuBar)>>

||<tablebgcolor="#f1f1ed" tablewidth="30%" tablestyle="margin: 0pt 0pt 1em 1em; float: right;"style="padding: 0.5em;"><<BR>><<TableOfContents(4)>> ||

The [[https://launchpad.net/serverguide | 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!

Here are the different ways to contribute, in order of priority:

 1. '''Review''' of existing material on a [[https://wiki.ubuntu.com/DocumentationTeam/TechReview | technical]] and [[https://wiki.ubuntu.com/DocumentationTeam/StyleGuide | style]] level.
 1. '''Extension''' of existing material (significant amount of new information, possibly new sub-chapter) or an entirely new chapter.  Let [[LaunchpadHome:petermatulis | me]] know of your intentions.

There is a Discussion section at the bottom if you feel a topic is missing or if you have some other idea for improvement.

Useful links:

 * Current release guide: [[https://help.ubuntu.com/12.04/serverguide/C/index.html | Ubuntu Server Guide - Precise]] <<BR>>
 * Bugs: [[https://bugs.launchpad.net/serverguide | Ubuntu Server Guide Bugs in Launchpad]]

== 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 12.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 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-1210
cd ~/sguide-1210
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.

== Contribution table ==

||<bgcolor="#66FF66">The stuff in green is the priority this cycle (Quantal).||

Using the following symbols...

|| {o} || TO DO ||
|| (./) || IN PROGRESS ||
|| /!\ || MERGE PROPOSED ||
|| {OK} || MERGE ACCEPTED, I'M DONE! ||
|| <:( || MERGE REJECTED ||
|| B) || NOTHING TO DO, IT'S GOOD AS IS ||
|| {i} || 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.

[[https://code.launchpad.net/%7Eubuntu-core-doc/serverguide/quantal/+activereviews | Active code reviews]]

|| '''Sub-chapter''' || '''Your name''' || '''Your Launchpad ID''' || '''Review''' || '''Extension''' || '''Comments''' || '''% Complete''' ||
||<rowstyle="background-color: #E8E8E8;" -7> 1 - Introduction ||
|| 1.1 -- Support || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 2 - Installation ||
|| 2.1 -- Preparing to Install || || || {o} || || || ||
|| 2.2 -- Installing from CD || || || {o} || || || ||
|| 2.3 -- Upgrading || || || {o} || || || ||
|| 2.4 -- Advanced Installation || || || {o} || || || ||
|| 2.5 -- Kernel Crash Dumps || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 3 - Package Management ||
|| 3.1 -- Introduction || || || {o} || || || ||
|| 3.2 -- dpkg || || || {o} || || || ||
|| 3.3 -- Apt-Get || || || {o} || || || ||
|| 3.4 -- Aptitude || || || {o} || || || ||
|| 3.5 -- Automatic Updates || || || {o} || || || ||
|| 3.6 -- Configuration || || || {o} || || || ||
|| 3.7 -- References || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 4 - Networking ||
|| 4.1 -- Network Configuration || || || {o} || || || ||
|| 4.2 -- TCP/IP || || || {o} || || || ||
|| 4.3 -- Dynamic Host Configuration Protocol (DHCP) || || || {o} || || || ||
|| 4.4 -- Time Synchronisation with NTP || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 5 - Storage ||
|| 5.1 -- LVM || || || {o} || || || ||
|| 5.2 -- Software RAID (md) || || || {o} || || || ||
|| 5.3 -- DM Multipath || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 6 - Remote Administration ||
|| 6.1 -- OpenSSH Server || || || {o} || || || ||
||<bgcolor="#66FF66"> 6.2 -- Puppet || || || {o} ||  || || ||
|| 6.3 -- Zentyal || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 7 - Network Authentication ||
|| 7.1 -- OpenLDAP Server || || || {o} || || || ||
||<bgcolor="#66FF66"> 7.2 -- Samba and LDAP || || || {o} || || || ||
|| 7.3 -- Kerberos || || || {o} || || || ||
|| 7.4 -- Kerberos and LDAP || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 8 - Domain Name Service (DNS) ||
|| 8.1 -- Installation || || || {o} || || || ||
|| 8.2 -- Configuration || || || {o} || || || ||
|| 8.3 -- Troubleshooting || || || {o} || || || ||
||<bgcolor="#66FF66"> 8.4 -- References || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 9 - Security ||
|| 9.1 -- User Management || || || {o} || || || ||
|| 9.2 -- Console Security || || || {o} || || || ||
|| 9.3 -- Firewall || || || {o} || || || ||
||<bgcolor="#66FF66"> 9.4 -- !AppArmor || || || {o} || || || ||
||<bgcolor="#66FF66"> 9.5 -- Certificates || || || {o} || || || ||
||<bgcolor="#66FF66"> 9.6 -- eCryptfs || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 10 - Monitoring ||
||<bgcolor="#66FF66"> 10.1 -- Overview || || || {o} || || || ||
||<bgcolor="#66FF66"> 10.2 -- Nagios || || || {o} || || || ||
||<bgcolor="#66FF66"> 10.3 -- Munin || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 11 - Web Servers ||
|| 11.1 -- HTTPD - Apache2 Web Server || || || {o} || || || ||
|| 11.2 -- PHP5 - Scripting Language || || || {o} || || || ||
||<bgcolor="#66FF66"> 11.3 -- Squid - Proxy Server || || || {o} || || || ||
||<bgcolor="#66FF66"> 11.4 -- Ruby on Rails || || || {o} || || || ||
||<bgcolor="#66FF66"> 11.5 -- Apache Tomcat || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 12 - Databases ||
|| 12.1 -- MySQL || || || {o} || || || ||
||<bgcolor="#66FF66"> 12.2 -- PostgreSQL || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 13 - LAMP Applications ||
|| 13.1 -- Overview || || || {o} || || || ||
|| 13.2 -- Moin Moin || || || {o} || || || ||
|| 13.3 -- !MediaWiki || || || {o} || || || ||
||<bgcolor="#66FF66"> 13.4 -- phpMyAdmin || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 14 - File Servers ||
|| 14.1 -- FTP Server || || || {o} || || || ||
|| 14.2 -- Network File System (NFS) || || || {o} || || || ||
|| 14.3 -- iSCSI Initiator || || || {o} || || || ||
|| 14.4 -- CUPS - Print Server || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 15 - Email Services ||
||<bgcolor="#66FF66"> 15.1 -- Postfix || || || {o} || || || ||
||<bgcolor="#66FF66"> 15.2 -- Exim4 || || || {o} || || || ||
||<bgcolor="#66FF66"> 15.3 -- Dovecot Server  || || || {o} || || || ||
||<bgcolor="#66FF66"> 15.4 -- Mailman || || || {o} || || || ||
||<bgcolor="#66FF66"> 15.5 -- Mail Filtering || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 16 - Chat Applications ||
|| 16.1 -- Overview || || || {o} || || || ||
|| 16.2 -- IRC Server || || || {o} || || || ||
|| 16.3 -- Jabber Instant Messaging Server || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 17 - Version Control Systems ||
||<bgcolor="#66FF66"> 17.1 -- Bazaar || || || {o} || || || ||
||<bgcolor="#66FF66"> 17.2 -- Subversion || || || {o} || || || ||
||<bgcolor="#66FF66"> 17.3 -- CVS Server || || || {o} || || || ||
||<bgcolor="#66FF66"> 17.4 -- References || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 18 - Windows Networking ||
||<bgcolor="#66FF66"> 18.1 -- Introduction || || || {o} || || || ||
||<bgcolor="#66FF66"> 18.2 -- Samba File Server || || || {o} || || || ||
||<bgcolor="#66FF66"> 18.3 -- Samba Print Server || || || {o} || || || ||
||<bgcolor="#66FF66"> 18.4 -- Securing a Samba File and Print Server || || || {o} || || || ||
||<bgcolor="#66FF66"> 18.5 -- Samba as a Domain Controller || || || {o} || || || ||
||<bgcolor="#66FF66"> 18.6 -- Samba Active Directory Integration || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 19 - Backups ||
|| 19.1 -- Shell Scripts || || || {o} || || || ||
|| 19.2 -- Archive Rotation || || || {o} || || || ||
|| 19.3 -- Bacula || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 20 - Virtualization ||
||<bgcolor="#66FF66"> 20.1 -- libvirt || George Dunlap || dunlapg || (./) || || Testing and integrating Xen || 5% ||
||<bgcolor="#66FF66"> 20.2 -- JeOS and vmbuilder || || || {o} || || || ||
|| 20.3 -- UEC || || || {o} || || {i} this sub-chapter will be removed || ||
|| 20.4 -- Openstack || || || {o} || || || ||
|| 20.5 -- LXC || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 21 - Clustering ||
|| 21.1 -- DRBD || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 22 - VPN ||
||<bgcolor="#66FF66"> 22.1 -- OpenVPN || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> 23 - Other Useful Applications ||
||<bgcolor="#66FF66"> 23.1 -- pam_motd || || || {o} || || || ||
||<bgcolor="#66FF66"> 23.2 -- etckeeper || || || {o} || || || ||
||<bgcolor="#66FF66"> 23.3 -- Byobu || || || {o} || || || ||
||<bgcolor="#66FF66"> 23.4 -- References || || || {o} || || || ||
||<rowstyle="background-color: #E8E8E8;" -7> A - Appendix ||
||<bgcolor="#66FF66"> A.1 -- Reporting Bugs in Ubuntu Server Edition ||  ||  || {o} || ||  || ||



== Getting help ==

Here are the best ways to get answers to any questions you may have:

 * The [[https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc | Ubuntu Doc mailing list]]
 * The [[https://lists.ubuntu.com/mailman/listinfo/ubuntu-server | Ubuntu Server mailing list]]
 * The Driver of this project, [[https://launchpad.net/~petermatulis | Peter Matulis]].

== Deadline ==

All final merge proposals should be made by October 1, 2012.  The [[https://wiki.ubuntu.com/DocumentationStringFreeze | string freeze]] date is [[https://wiki.ubuntu.com/QuantalQuetzel/ReleaseSchedule | September 20]] but it looks like we need more time this cycle.

== Discussion ==

Here you can add your thoughts on

 * Re-organization of topics
 * Addition of missing topics: Juju
 * Anything else

Ubuntu Wiki