Ubuntu Server Guide

Merge lp:~mwhudson/serverguide/live-server-guide into lp:serverguide/trunk

  1. live-server-guide
  2. Merge into trunk
Proposed by Michael Hudson-Doyle
Status: Merged
Approved by: Doug Smythies
Approved revision: 356
Merge reported by: Doug Smythies
Merged at revision: not available
Proposed branch: lp:~mwhudson/serverguide/live-server-guide
Merge into: lp:serverguide/trunk
Diff against target: 190 lines (+120/-28)
1 file modified
serverguide/C/installation.xml (+120/-28)
To merge this branch: bzr merge lp:~mwhudson/serverguide/live-server-guide
Reviewer Review Type Date Requested Status
Doug Smythies Approve
Brian Murray Approve
Review via email: mp+343153@code.launchpad.net
To post a comment you must log in.
Revision history for this message
Michael Hudson-Doyle (mwhudson) wrote :

Over to you Brian. Here's what it looks like: http://people.canonical.com/~mwh/serverguide/build/serverguide/C/installation.html.en

Revision history for this message
Brian Murray (brian-murray) wrote :

I've just a couple of changes and one question.

review: Needs Fixing
Revision history for this message
Michael Hudson-Doyle (mwhudson) wrote :

Thanks for the comments, I think I've addressed all of them.

Revision history for this message
Brian Murray (brian-murray) wrote :

Looks good to me now, thanks!

review: Approve
Revision history for this message
Michael Hudson-Doyle (mwhudson) wrote :

Ready for review by the serverguide maintainers then!

Revision history for this message
Doug Smythies (dsmythies) wrote :

The content is O.K.
However, the PDF does not build.
I reverted, and the PDF builds.
I think the problem is somewhere in the table changes.

review: Needs Fixing
Revision history for this message
Doug Smythies (dsmythies) wrote :

O.K., I did this (Indentation reduced for here):

 <title>Recommended Minimum Requirements</title>
- <tgroup cols="5">
+ <tgroup cols="6">
       <colspec colname="1" colwidth="1.0*"/>
       <colspec colname="2" colwidth="1.0*"/>
       <colspec colname="3" colwidth="1.0*"/>
       <colspec colname="4" colwidth="1.0*"/>
- <colspec colname="5" colwidth="1.2*"/>
+ <colspec colname="5" colwidth="1.0*"/>
+ <colspec colname="6" colwidth="1.2*"/>
  <thead>
     <row>
      <entry morerows="1" valign="middle"><para>Install Type</para></entry>
+ <entry morerows="1" valign="middle"><para>Install Method</para></entry>
      <entry morerows="1" valign="middle"><para>CPU</para></entry>
      <entry morerows="1" valign="middle"><para>RAM</para></entry>
- <entry namest="3" nameend="4" align="center"><para>Hard Drive Space</para></entry>
+ <entry namest="4" nameend="5" align="center"><para>Hard Drive Space</para></entry>

And now the PDF builds.

review: Approve
Revision history for this message
Michael Hudson-Doyle (mwhudson) wrote :

A bit late, but thanks so much for sorting this out in time for release!

On 25 April 2018 at 03:21, Doug Smythies <email address hidden> wrote:

> Review: Approve
>
> O.K., I did this (Indentation reduced for here):
>
> <title>Recommended Minimum Requirements</title>
> - <tgroup cols="5">
> + <tgroup cols="6">
> <colspec colname="1" colwidth="1.0*"/>
> <colspec colname="2" colwidth="1.0*"/>
> <colspec colname="3" colwidth="1.0*"/>
> <colspec colname="4" colwidth="1.0*"/>
> - <colspec colname="5" colwidth="1.2*"/>
> + <colspec colname="5" colwidth="1.0*"/>
> + <colspec colname="6" colwidth="1.2*"/>
> <thead>
> <row>
> <entry morerows="1" valign="middle"><para>Install Type</para></entry>
> + <entry morerows="1" valign="middle"><para>Install
> Method</para></entry>
> <entry morerows="1" valign="middle"><para>CPU</para></entry>
> <entry morerows="1" valign="middle"><para>RAM</para></entry>
> - <entry namest="3" nameend="4" align="center"><para>Hard Drive
> Space</para></entry>
> + <entry namest="4" nameend="5" align="center"><para>Hard Drive
> Space</para></entry>
>
> And now the PDF builds.
>
> --
> https://code.launchpad.net/~mwhudson/serverguide/live-
> server-guide/+merge/343153
> You are the owner of lp:~mwhudson/serverguide/live-server-guide.
>

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'serverguide/C/installation.xml'
2--- serverguide/C/installation.xml 2018-04-12 23:42:55 +0000
3+++ serverguide/C/installation.xml 2018-04-19 02:11:53 +0000
4@@ -20,8 +20,14 @@
5 installation. </para>
6 <sect2 id="system-requirements" status="review">
7 <title>System Requirements</title>
8- <para>Ubuntu &distro-rev; Server Edition supports three (3) major architectures: Intel x86, AMD64 and
9- ARM. The table below lists recommended hardware specifications. Depending on your needs, you might manage with less than this. However, most users risk being frustrated if they ignore these suggestions.</para>
10+ <para>
11+ Ubuntu &distro-rev; Server Edition supports four (4) major architectures: AMD64, ARM, POWER8, LinuxONE and z Systems (although this manual does not cover installation on LinuxONE or z Systems, see <ulink url="https://wiki.ubuntu.com/S390X/InstallationGuide">the dedicated guide</ulink> for that).
12+ </para>
13+ <para>
14+ Ubuntu Server 18.04 LTS introduces a new installer, the "live server" installer (sometimes called "Ubiquity for Servers" or simply "subiquity") which provides a more user friendly and faster installation experience. At the time of writing it only supports amd64 processors and does not support LVM or RAID or other more sophisticated storage options, nor does it support reusing existing partitions on the disks of the system you are installing. It also requires access to the Ubuntu archive, possibly via a proxy. The previous, debian-installer based, installer is still available if these restrictions mean you can't use the live server installer.
15+ </para>
16+ <para>
17+ The table below lists recommended hardware specifications. Depending on your needs, you might manage with less than this. However, most users risk being frustrated if they ignore these suggestions.</para>
18 <table>
19 <title>Recommended Minimum Requirements</title>
20 <tgroup cols="5">
21@@ -33,6 +39,7 @@
22 <thead>
23 <row>
24 <entry morerows="1" valign="middle"><para>Install Type</para></entry>
25+ <entry morerows="1" valign="middle"><para>Install Method</para></entry>
26 <entry morerows="1" valign="middle"><para>CPU</para></entry>
27 <entry morerows="1" valign="middle"><para>RAM</para></entry>
28 <entry namest="3" nameend="4" align="center"><para>Hard Drive Space</para></entry>
29@@ -44,14 +51,23 @@
30 </thead>
31 <tbody>
32 <row>
33- <entry><para>Server (Standard)</para></entry>
34+ <entry morerows="1"><para>Server (Standard)</para></entry>
35+ <entry><para>debian-installer</para></entry>
36 <entry><para>1 gigahertz</para></entry>
37 <entry><para>512 megabytes</para></entry>
38 <entry><para>1.5 gigabyte</para></entry>
39 <entry><para>2.5 gigabytes</para></entry>
40 </row>
41 <row>
42+ <entry><para>live server</para></entry>
43+ <entry><para>1 gigahertz (amd64 only)</para></entry>
44+ <entry><para>1 gigabyte</para></entry>
45+ <entry><para>1.5 gigabyte</para></entry>
46+ <entry><para>n/a</para></entry>
47+ </row>
48+ <row>
49 <entry><para>Server (Minimal)</para></entry>
50+ <entry><para>debian-installer</para></entry>
51 <entry><para>300 megahertz</para></entry>
52 <entry><para>384 megabytes</para></entry>
53 <entry><para>1.5 gigabytes</para></entry>
54@@ -102,35 +118,111 @@
55 </sect3>
56 </sect2>
57
58- <sect2 id="backing-up" status="review">
59- <title>Backing Up</title>
60- <itemizedlist>
61- <listitem>
62- <para>
63- Before installing <application>Ubuntu Server Edition</application> you should make sure all data on the system
64- is backed up. See <xref linkend="backups"/> for backup options.
65- </para>
66- <para>
67- If this is not the first time an operating system has been installed on your
68- computer, it is likely you will need to re-partition your disk to make room for Ubuntu.
69- </para>
70- <para>
71- Any time you partition your disk, you should be prepared to
72- lose everything on the disk should you make a mistake or
73- something goes wrong during partitioning. The programs used in installation are
74- quite reliable, most have seen years of use, but they
75- also perform destructive actions.
76- </para>
77- </listitem>
78- </itemizedlist>
79- </sect2>
80- </sect1>
81+ <sect2 id="backing-up" status="review">
82+ <title>Backing Up</title>
83+ <itemizedlist>
84+ <listitem>
85+ <para>
86+ Before installing <application>Ubuntu Server Edition</application> you should make sure all data on the system
87+ is backed up. See <xref linkend="backups"/> for backup options.
88+ </para>
89+ <para>
90+ If this is not the first time an operating system has been installed on your
91+ computer, it is likely you will need to re-partition your disk to make room for Ubuntu.
92+ </para>
93+ <para>
94+ Any time you partition your disk, you should be prepared to
95+ lose everything on the disk should you make a mistake or
96+ something goes wrong during partitioning. The programs used in installation are
97+ quite reliable, most have seen years of use, but they
98+ also perform destructive actions.
99+ </para>
100+ </listitem>
101+ </itemizedlist>
102+ </sect2>
103+</sect1>
104+
105+<sect1 id="installing-live-server" status="review">
106+ <title>Installing using the live server installer </title>
107+ <para>
108+ The basic steps to install Ubuntu Server Edition are the same as those for installing any operating system. Unlike the <emphasis>Desktop Edition</emphasis>, the <emphasis>Server Edition</emphasis> does not include a graphical installation program. The Live Server installer uses a text-based console interface which runs on the default virtual console. The interface can be entirely driven by the enter, up and down arrow keys (with some occasional typing).
109+ </para>
110+ <para>
111+ If you need to at any time during the installation you can switch to a different console (by pressing Ctrl-Alt-F&lt;n&gt; or Ctrl-Alt-Right) to get access to a shell. Up until the point where the installation begins, you can use the "back" buttons to go back to previous screens and choose different options.
112+ </para>
113+ <itemizedlist>
114+ <listitem>
115+ <para>
116+ Download the appropriate ISO file from the <ulink url="http://www.ubuntu.com/download/server/download"> Ubuntu web site</ulink>.
117+ </para>
118+ </listitem>
119+ <listitem>
120+ <para>
121+ Boot the system from media (e.g. USB key) containing the ISO file.
122+ </para>
123+ </listitem>
124+ <listitem>
125+ <para>
126+ At the boot prompt you will be asked to select a language.
127+ </para>
128+ </listitem>
129+ <listitem>
130+ <para>
131+ From the main boot menu there are some additional options to install Ubuntu Server Edition. You can install a basic Ubuntu Server, check the installation media for defects, check the system's RAM, or boot from first hard disk. The rest of this section will cover the basic Ubuntu Server install.
132+ </para>
133+ </listitem>
134+ <listitem>
135+ <para>
136+ After booting into the installer, it will ask you which language to use.
137+ </para>
138+ </listitem>
139+ <listitem>
140+ <para>
141+ Next, the installation process begins by asking for your keyboard layout. You can ask the installer to attempt auto-detecting it, or you can select it manually from a list. Later stages of the installation will require you to type ASCII characters, so if the layout you select does not allow that, you will be prompted for a key combination to switch between a layout that does and the one you select. The default keystroke for this is Alt + Shift.
142+ </para>
143+ </listitem>
144+ <listitem>
145+ <para>
146+ Next, the installer offers the choice to install the system as a vanilla Ubuntu server, a <ulink url="https://maas.io">MAAS</ulink> bare-metal cloud rack controller or a <ulink url="https://maas.io">MAAS</ulink> region controller. If you select one of the MAAS options you will be asked for some details.
147+ </para>
148+ </listitem>
149+ <listitem>
150+ <para>
151+ The installer configures the network to run DHCP on each network interface. If this is not sufficient to get access to the internet you should configure at least one interface manually. Select an interface to configure it.
152+ </para>
153+ </listitem>
154+ <listitem>
155+ <para>
156+ If the Ubuntu archive can only be accessed via a proxy in your environment, it can be entered on the next screen. Leave the field blank if it is not required.
157+ </para>
158+ </listitem>
159+ <listitem>
160+ <para>
161+ You can then choose to let the installer use an entire disk or configure the partitioning manually. The first disk you create a partition on will be selected as the boot disk and have an extra partition created on it to contain the bootloader; you can move the boot partition to a different drive with the "Select as boot disk" button.
162+ </para>
163+ <para>
164+ Once you move on from this screen, the installation progress will begin. It will not be possible to move back to this or previous screens and any data on the disks you have configured the installer to use will be lost.
165+ </para>
166+ </listitem>
167+ <listitem>
168+ <para>
169+ The next screen configures the initial user for the system. You can import SSH keys from Launchpad or Github but a password is still required to be set, as this user will have <emphasis>root</emphasis> access through the <application>sudo</application> utility.
170+ </para>
171+ </listitem>
172+ <listitem>
173+ <para>
174+ The final screen shows the progress of the installer. Once the installation has completed, you will be prompted to reboot into your newly installed system.
175+ </para>
176+ </listitem>
177+ </itemizedlist>
178+</sect1>
179+
180 <sect1 id="installing-from-cd" status="review">
181- <title>Installation</title>
182+ <title>Installation using debian-installer</title>
183 <para>
184 The basic steps to install Ubuntu Server Edition are the same as those for installing any operating system. Unlike
185 the <emphasis>Desktop Edition</emphasis>, the <emphasis>Server Edition</emphasis> does not include a graphical
186- installation program. The Server Edition uses a console menu based process instead.
187+ installation program. The debian-installer installer uses a console menu based process instead.
188 </para>
189 <itemizedlist>
190 <listitem>

Subscribers

People subscribed via source and target branches