openstack/openstack-manuals
Code Issues Proposed changes

Precise-->Trusty patches for several guides

Browse Source 
As Juno will not be supported on Ubuntu 12.04 Precise,
this patch changes all references to 14.04 Trusty, which will
support the next 4 releases.
Updated section_ubuntu_example.xml for consistency.

Change-Id: Ib52513db38b17240026e6a278e8c97c0438358ec
This commit is contained in:
Tom Fifield 2014-07-17 12:53:44 -07:00 committed by Diane Fleming
parent 61e4a39c4f
commit 1985ce7ca9
14 changed files with 139 additions and 215 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/admin-guide-cloud/ch_compute.xml
View File

@ -328,8 +328,8 @@
<?db-font-size 50%?><computeroutput>+--------------------------------------+-------------------------------+--------+--------------------------------------+
| ID | Name | Status | Server |
+--------------------------------------+-------------------------------+--------+--------------------------------------+
| aee1d242-730f-431f-88c1-87630c0f07ba | Ubuntu 12.04 cloudimg amd64 | ACTIVE | |
| 0b27baa1-0ca6-49a7-b3f4-48388e440245 | Ubuntu 12.10 cloudimg amd64 | ACTIVE | |
| aee1d242-730f-431f-88c1-87630c0f07ba | Ubuntu 14.04 cloudimg amd64 | ACTIVE | |
| 0b27baa1-0ca6-49a7-b3f4-48388e440245 | Ubuntu 14.10 cloudimg amd64 | ACTIVE | |
| df8d56fc-9cea-4dfd-a8d3-28764de3cb08 | jenkins | ACTIVE | |
+--------------------------------------+-------------------------------+--------+--------------------------------------+</computeroutput></screen>
</para>

6
doc/admin-guide-cloud/compute/section_compute-instance-building-blocks.xml
View File

@ -16,8 +16,8 @@
<?db-font-size 50%?><computeroutput>+--------------------------------------+-------------------------------+--------+--------------------------------------+
| ID | Name | Status | Server |
+--------------------------------------+-------------------------------+--------+--------------------------------------+
| aee1d242-730f-431f-88c1-87630c0f07ba | Ubuntu 12.04 cloudimg amd64 | ACTIVE | |
| 0b27baa1-0ca6-49a7-b3f4-48388e440245 | Ubuntu 12.10 cloudimg amd64 | ACTIVE | |
| aee1d242-730f-431f-88c1-87630c0f07ba | Ubuntu 14.04 cloudimg amd64 | ACTIVE | |
| 0b27baa1-0ca6-49a7-b3f4-48388e440245 | Ubuntu 14.10 cloudimg amd64 | ACTIVE | |
| df8d56fc-9cea-4dfd-a8d3-28764de3cb08 | jenkins | ACTIVE | |
+--------------------------------------+-------------------------------+--------+--------------------------------------+</computeroutput></screen>
</para>
@ -71,4 +71,4 @@
| 5 | m1.xlarge | 16384 | 160 | N/A | 0 | 8 | |
+----+-----------+-----------+------+-----------+------+-------+-------------+
</computeroutput></screen>
</section>
</section>

2
doc/common/app_support.xml
View File

@ -56,7 +56,7 @@
<para>
<link
xlink:href="http://docs.openstack.org/trunk/install-guide/install/apt/content/">
<citetitle>Installation Guide for Ubuntu 12.04/14.04
<citetitle>Installation Guide for Ubuntu 14.04
(LTS)</citetitle>
</link></para>
</listitem>

2
doc/common/section_compute-configure-vnc.xml
View File

@ -275,7 +275,7 @@ vncserver_listen=192.168.1.2</programlisting>
template. To alter them, edit the
<filename>_detail_vnc.html</filename> template file. The
location of this file varies based on Linux distribution. On
Ubuntu 12.04, the file is at
Ubuntu 14.04, the file is at
<filename>/usr/share/pyshared/horizon/dashboards/nova/instances/templates/instances/_detail_vnc.html</filename>.</para>
<para>Modify the <option>width</option> and
<option>height</option> options, as follows:</para>

2
doc/config-reference/compute/section_hypervisor_lxc.xml
View File

@ -26,7 +26,7 @@
[libvirt]
virt_type = lxc</programlisting></para>
<para>On Ubuntu 12.04, enable LXC support in OpenStack by installing the
<para>On Ubuntu, enable LXC support in OpenStack by installing the
<literal>nova-compute-lxc</literal> package.</para>
</section>

13
doc/config-reference/compute/section_hypervisor_vmware.xml
View File

@ -700,20 +700,21 @@ datastore_regex=&lt;optional datastore regex&gt;</programlisting>
several formats (such as, qcow2) can be converted to the VMDK
format.</para>
<para>For example, the following command can be used to convert
a <link xlink:href="http://cloud-images.ubuntu.com/precise/current/precise-server-cloudimg-amd64-disk1.img">qcow2 Ubuntu Precise cloud image</link>:</para>
<screen><prompt>$</prompt> <userinput>qemu-img convert -f qcow2 ~/Downloads/precise-server-cloudimg-amd64-disk1.img \
-O vmdk precise-server-cloudimg-amd64-disk1.vmdk</userinput></screen>
a <link
xlink:href="http://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-amd64-disk1.img">qcow2 Ubuntu Trusty cloud image</link>:</para>
<screen><prompt>$</prompt> <userinput>qemu-img convert -f qcow2 ~/Downloads/trusty-server-cloudimg-amd64-disk1.img \
-O vmdk trusty-server-cloudimg-amd64-disk1.vmdk</userinput></screen>
<para>VMDK disks converted through <code>qemu-img</code> are
<emphasis role="italic">always</emphasis> monolithic sparse
VMDK disks with an IDE adapter type. Using the previous
example of the Precise Ubuntu image after the
example of the Ubuntu Trusty image after the
<code>qemu-img</code> conversion, the command to upload the
VMDK disk should be something like:</para>
<screen><prompt>$</prompt> <userinput>glance image-create --name precise-cloud --is-public=False \
<screen><prompt>$</prompt> <userinput>glance image-create --name trusty-cloud --is-public=False \
--container-format=bare --disk-format=vmdk \
--property vmware_disktype="sparse" \
--property vmware_adaptertype="ide" &lt; \
precise-server-cloudimg-amd64-disk1.vmdk</userinput></screen>
trusty-server-cloudimg-amd64-disk1.vmdk</userinput></screen>
<para>Note that the <option>vmware_disktype</option> is set to
<emphasis role="italic">sparse</emphasis> and the
<code>vmware_adaptertype</code> is set to <emphasis role="italic">ide</emphasis> in the previous command.</para>

12
doc/image-guide/ch_obtaining_images.xml
View File

@ -30,14 +30,14 @@
set of Ubuntu-based images</link>.</para>
<para>Images are arranged by Ubuntu release, and by image release date, with "current" being
the most recent. For example, the page that contains the most recently built image for
Ubuntu 12.04 "Precise Pangolin" is <link
xlink:href="http://cloud-images.ubuntu.com/precise/current/"
>http://cloud-images.ubuntu.com/precise/current/</link>. Scroll to the bottom of the
Ubuntu 14.04 "Trusty Tahr" is <link
xlink:href="http://cloud-images.ubuntu.com/trusty/current/"
>http://cloud-images.ubuntu.com/trusty/current/</link>. Scroll to the bottom of the
page for links to images that can be downloaded directly.</para>
<para>If your deployment uses QEMU or KVM, we recommend using the images in qcow2
format. The most recent version of the 64-bit QCOW2 image for Ubuntu 12.04 is <link
xlink:href="http://uec-images.ubuntu.com/precise/current/precise-server-cloudimg-amd64-disk1.img"
>precise-server-cloudimg-amd64-disk1.img</link>.<note>
format. The most recent version of the 64-bit QCOW2 image for Ubuntu 14.04 is <link
xlink:href="http://uec-images.ubuntu.com/trusty/current/trusty-server-cloudimg-amd64-disk1.img"
>trusty-server-cloudimg-amd64-disk1.img</link>.<note>
<para>In an Ubuntu cloud image, the login account is
<literal>ubuntu</literal>.</para>
</note></para>

274
doc/image-guide/section_ubuntu-example.xml
View File

@ -1,152 +1,120 @@
<?xml version="1.0" encoding="UTF-8"?>
<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="ubuntu-image">
<section xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="ubuntu-image">
<title>Example: Ubuntu image</title>
<para>We'll run through an example of installing an Ubuntu image.
This will focus mainly on Ubuntu 12.04 (Precise Pangolin)
server. Because the Ubuntu installation process may change
across versions, if you are using a different version of
Ubuntu the installer steps may differ.</para>
<para>This example installs a Ubuntu 14.04 (Trusty Tahr) image. To create an image for a
different version of Ubuntu, follow these steps with the noted differences.</para>
<simplesect>
<title>Download an Ubuntu install ISO</title>
<para>In this example, we'll use the network installation ISO,
since it's a smaller image. The 64-bit 12.04 network
installer ISO is at <link
xlink:href="http://archive.ubuntu.com/ubuntu/dists/precise/main/installer-amd64/current/images/netboot/mini.iso"
>http://archive.ubuntu.com/ubuntu/dists/precise/main/installer-amd64/current/images/netboot/mini.iso</link></para>
<para>Because the goal is to make the smallest possible base image, this example uses the
network installation ISO. The Ubuntu 64-bit 14.04 network installer ISO is at <link
xlink:href="http://archive.ubuntu.com/ubuntu/dists/trusty/main/installer-amd64/current/images/netboot/mini.iso"
>http://archive.ubuntu.com/ubuntu/dists/trusty/main/installer-amd64/current/images/netboot/mini.iso</link>.</para>
</simplesect>
<simplesect>
<title>Start the install process</title>
<para>Start the installation process using either
<command>virt-manager</command> or
<command>virt-install</command> as described in the
previous section. If using
<command>virt-install</command>, don't forget to connect
your VNC client to the virtual machine.</para>
<para>We will assume the name of your virtual machine image is
<literal>ubuntu-12.04</literal>, which we need to know
when using <command>virsh</command> commands to manipulate
the state of the image.</para>
<para>If you're using virt-manager, the commands should look
something like
this:<screen><prompt>#</prompt> <userinput>qemu-img create -f qcow2 /tmp/precise.qcow2 10G</userinput>
<prompt>#</prompt> <userinput>virt-install --virt-type kvm --name precise --ram 1024 \
--cdrom=/data/isos/precise-64-mini.iso \
--disk /tmp/precise.qcow2,format=qcow2 \
--network network=default \
--graphics vnc,listen=0.0.0.0 --noautoconsole \
--os-type=linux --os-variant=ubuntuprecise</userinput></screen></para>
<para>Start the installation process by using either <command>virt-manager</command> or
<command>virt-install</command> as described in the previous section. If you use
<command>virt-install</command>, do not forget to connect your VNC client to the
virtual machine.</para>
<para>Assume that the name of your virtual machine image is <literal>ubuntu-14.04</literal>,
which you need to know when you use <command>virsh</command> commands to manipulate the
state of the image.</para>
<para>If you are using <command>virt-manager</command>, the commands should look something
like this:</para>
<screen><prompt>#</prompt> <userinput>qemu-img create -f qcow2 /tmp/trusty.qcow2 10G</userinput>
<prompt>#</prompt> <userinput>virt-install --virt-type kvm --name trusty --ram 1024 \
--cdrom=/data/isos/trusty-64-mini.iso \
--disk /tmp/trusty.qcow2,format=qcow2 \
--network network=default \
--graphics vnc,listen=0.0.0.0 --noautoconsole \
--os-type=linux --os-variant=ubuntutrusty</userinput></screen>
</simplesect>
<simplesect>
<title>Step through the install</title>
<para>At the initial Installer boot menu, choose the "Install"
option. Step through the install prompts, the defaults
should be fine.</para>
<para>At the initial Installer boot menu, choose the <guilabel>Install</guilabel> option.
Step through the install prompts, the defaults should be fine.</para>
<mediaobject>
<imageobject>
<imagedata fileref="figures/ubuntu-install.png"
format="PNG" contentwidth="6in"/>
<imagedata fileref="figures/ubuntu-install.png" format="PNG" contentwidth="6in"/>
</imageobject>
</mediaobject>
</simplesect>
<simplesect>
<title>Hostname</title>
<para>The installer may ask you to choose a hostname. The
default (<literal>ubuntu</literal>) is fine. We will
install the cloud-init package later, which will set the
hostname on boot when a new instance is provisioned using
this image.</para>
<para>The installer may ask you to choose a hostname. The default
(<literal>ubuntu</literal>) is fine. We will install the cloud-init package later, which
will set the hostname on boot when a new instance is provisioned using this
image.</para>
</simplesect>
<simplesect>
<title>Select a mirror</title>
<para>The default mirror proposed by the installer should be
fine.</para>
<para>The default mirror proposed by the installer should be fine.</para>
</simplesect>
<simplesect>
<title>Step through the install</title>
<para>Step through the install, using the default options.
When prompted for a user name, the default
(<systemitem class="username">ubuntu</systemitem>) is fine.</para>
<para>Step through the install, using the default options. When prompted for a user name,
the default (<systemitem class="username">ubuntu</systemitem>) is fine.</para>
</simplesect>
<simplesect>
<title>Partition the disks</title>
<para>There are different options for partitioning the disks.
The default installation will use LVM partitions, and will
create three partitions (<filename>/boot</filename>,
<filename>/</filename>, swap), and this will work
fine. Alternatively, you may wish to create a single ext4
partition, mounted to "<literal>/</literal>", should also
work fine.</para>
<para>If unsure, we recommend you use the installer's default
partition scheme, since there is no clear advantage to one
scheme or another.</para>
<para>There are different options for partitioning the disks. The default installation will
use LVM partitions, and will create three partitions (<filename>/boot</filename>,
<filename>/</filename>, swap), and this will work fine. Alternatively, you may wish
to create a single ext4 partition, mounted to "<literal>/</literal>", should also work
fine.</para>
<para>If unsure, we recommend you use the installer's default partition scheme, since there
is no clear advantage to one scheme or another.</para>
</simplesect>
<simplesect>
<title>Automatic updates</title>
<para>The Ubuntu installer will ask how you want to manage
upgrades on your system. This option depends on your
specific use case. If your virtual machine instances will
be connected to the internet, we recommend "Install
security updates automatically".</para>
<para>The Ubuntu installer will ask how you want to manage upgrades on your system. This
option depends on your specific use case. If your virtual machine instances will be
connected to the internet, we recommend "Install security updates automatically".</para>
</simplesect>
<simplesect>
<title>Software selection: OpenSSH server</title>
<para>Choose "OpenSSH server"so that you will be able to SSH
into the virtual machine when it launches inside of an
OpenStack cloud.</para>
<para>Choose "OpenSSH server"so that you will be able to SSH into the virtual machine when
it launches inside of an OpenStack cloud.</para>
<mediaobject>
<imageobject>
<imagedata
fileref="figures/ubuntu-software-selection.png"
format="PNG" contentwidth="6in"/>
<imagedata fileref="figures/ubuntu-software-selection.png" format="PNG"
contentwidth="6in"/>
</imageobject>
</mediaobject>
</simplesect>
<simplesect>
<title>Install GRUB boot loader</title>
<para>Select "Yes" when asked about installing the GRUB boot
loader to the master boot record.</para>
<para>Select "Yes" when asked about installing the GRUB boot loader to the master boot
record.</para>
<mediaobject>
<imageobject>
<imagedata fileref="figures/ubuntu-grub.png"
format="PNG" contentwidth="6in"/>
<imagedata fileref="figures/ubuntu-grub.png" format="PNG" contentwidth="6in"/>
</imageobject>
</mediaobject>
</simplesect>
<simplesect>
<title>Detach the CD-ROM and reboot</title>
<para>Select the defaults for all of the remaining options.
When the installation is complete, you will be prompted to
remove the CD-ROM.</para>
<para>Select the defaults for all of the remaining options. When the installation is
complete, you will be prompted to remove the CD-ROM.</para>
<mediaobject>
<imageobject>
<imagedata fileref="figures/ubuntu-finished.png"
format="PNG" contentwidth="6in"/>
<imagedata fileref="figures/ubuntu-finished.png" format="PNG" contentwidth="6in"/>
</imageobject>
</mediaobject>
<para>
<note>
<para>When you hit "Continue" the virtual machine will
shut down, even though it says it will
reboot.</para>
</note>
</para>
<para>To eject a disk using <command>virsh</command>, libvirt
requires that you attach an empty disk at the same target
that the CDROM was previously attached, which should be
<literal>hdc</literal>. You can confirm the
appropriate target using the <command>dom dumpxml
<replaceable>vm-image</replaceable></command>
command.</para>
<screen><prompt>#</prompt> <userinput>virsh dumpxml precise</userinput>
<note>
<para>When you hit "Continue" the virtual machine will shut down, even though it says it
will reboot.</para>
</note>
<para>To eject a disk using <command>virsh</command>, libvirt requires that you attach an
empty disk at the same target that the CDROM was previously attached, which should be
<literal>hdc</literal>. You can confirm the appropriate target using the
<command>dom dumpxml <replaceable>vm-image</replaceable></command> command.</para>
<screen><prompt>#</prompt> <userinput>virsh dumpxml trusty</userinput>
<computeroutput>&lt;domain type='kvm'>
&lt;name>precise&lt;/name>
&lt;name>trusty&lt;/name>
...
&lt;disk type='block' device='cdrom'>
&lt;driver name='qemu' type='raw'/>
@ -157,94 +125,78 @@
...
&lt;/domain>
</computeroutput></screen>
<para>Run the following commands in the host as root to start
up the machine again as paused, eject the disk and resume.
If you are using virt-manager, you may use the GUI
instead.<screen><prompt>#</prompt> <userinput>virsh start precise --paused</userinput>
<prompt>#</prompt> <userinput>virsh attach-disk --type cdrom --mode readonly precise "" hdc</userinput>
<prompt>#</prompt> <userinput>virsh resume precise</userinput></screen></para>
<para>Run the following commands in the host as root to start up the machine again as
paused, eject the disk and resume. If you are using virt-manager, you may use the GUI
instead.</para>
<screen><prompt>#</prompt> <userinput>virsh start trusty --paused</userinput>
<prompt>#</prompt> <userinput>virsh attach-disk --type cdrom --mode readonly trusty "" hdc</userinput>
<prompt>#</prompt> <userinput>virsh resume trusty</userinput></screen>
<note>
<para>In the example above, we start the instance paused,
eject the disk, and then unpause. In theory, we could
have ejected the disk at the "Installation complete"
screen. However, our testing indicates that the Ubuntu
installer locks the drive so that it cannot be ejected
at that point.</para>
<para>In the previous example, you paused the instance paused, ejected the disk, and
unpaused the instance. In theory, you could have ejected the disk at the
<guilabel>Installation complete</guilabel> screen. However, our testing
indicates that the Ubuntu installer locks the drive so that it cannot be ejected at
that point.</para>
</note>
</simplesect>
<simplesect>
<title>Log in to newly created image</title>
<para>When you boot for the first time after install, it may ask
you about authentication tools, you can just choose
'Exit'. Then, log in as root using the root password you
<para>When you boot for the first time after install, it may ask you about authentication
tools, you can just choose 'Exit'. Then, log in as root using the root password you
specified.</para>
</simplesect>
<simplesect>
<title>Install cloud-init</title>
<para>The <command>cloud-init</command> script starts on
instance boot and will search for a metadata provider to
fetch a public key from. The public key will be placed in
the default user account for the image.</para>
<para>The <command>cloud-init</command> script starts on instance boot and will search for a
metadata provider to fetch a public key from. The public key will be placed in the
default user account for the image.</para>
<para>Install the <package>cloud-init</package> package:</para>
<screen><prompt>#</prompt> <userinput>apt-get install cloud-init</userinput></screen>
<para>When building Ubuntu images
<command>cloud-init</command> must be explicitly
configured for the metadata source in use. The OpenStack
metadata server emulates the EC2 metadata service used by
images in Amazon EC2.</para>
<para>To set the metadata source to be used by the image run
the <command>dpkg-reconfigure</command> command against
the <package>cloud-init</package> package. When prompted
select the <literal>EC2</literal> data source:
<screen><prompt>#</prompt> <userinput>dpkg-reconfigure cloud-init</userinput></screen>
</para>
<para>The account varies by distribution. On Ubuntu-based
virtual machines, the account is called "ubuntu". On
Fedora-based virtual machines, the account is called
<para>When building Ubuntu images <command>cloud-init</command> must be explicitly
configured for the metadata source in use. The OpenStack metadata server emulates the
EC2 metadata service used by images in Amazon EC2.</para>
<para>To set the metadata source to be used by the image run the
<command>dpkg-reconfigure</command> command against the
<package>cloud-init</package> package. When prompted select the
<literal>EC2</literal> data source:</para>
<screen><prompt>#</prompt> <userinput>dpkg-reconfigure cloud-init</userinput></screen>
<para>The account varies by distribution. On Ubuntu-based virtual machines, the account is
called "ubuntu". On Fedora-based virtual machines, the account is called
"ec2-user".</para>
<para>You can change the name of the account used by
cloud-init by editing the
<filename>/etc/cloud/cloud.cfg</filename> file and
adding a line with a different user. For example, to
configure cloud-init to put the key in an account named
"admin", edit the config file so it has the
line:<programlisting>user: admin</programlisting></para>
<para>You can change the name of the account used by cloud-init by editing the
<filename>/etc/cloud/cloud.cfg</filename> file and adding a line with a different
user. For example, to configure cloud-init to put the key in an account named "admin",
edit the config file so it has the line:</para>
<programlisting>user: admin</programlisting>
</simplesect>
<simplesect>
<title>Shut down the instance</title>
<para>From inside the instance, as
root:<screen><prompt>#</prompt> <userinput>/sbin/shutdown -h now</userinput></screen></para>
<para>From inside the instance, as root:</para>
<screen><prompt>#</prompt> <userinput>/sbin/shutdown -h now</userinput></screen>
</simplesect>
<simplesect>
<title>Clean up (remove MAC address details)</title>
<para>The operating system records the MAC address of the
virtual ethernet card in locations such as
<filename>/etc/udev/rules.d/70-persistent-net.rules</filename>
during the instance process. However, each time the image
boots up, the virtual ethernet card will have a different
MAC address, so this information must be deleted from the
configuration file.</para>
<para>There is a utility called
<command>virt-sysprep</command>, that performs various
cleanup tasks such as removing the MAC address references.
It will clean up a virtual machine image in
place:<screen><prompt>#</prompt> <userinput>virt-sysprep -d precise</userinput></screen></para>
<para>The operating system records the MAC address of the virtual ethernet card in locations
such as <filename>/etc/udev/rules.d/70-persistent-net.rules</filename> during the
instance process. However, each time the image boots up, the virtual ethernet card will
have a different MAC address, so this information must be deleted from the configuration
file.</para>
<para>There is a utility called <command>virt-sysprep</command>, that performs various
cleanup tasks such as removing the MAC address references. It will clean up a virtual
machine image in place:</para>
<screen><prompt>#</prompt> <userinput>virt-sysprep -d trusty</userinput></screen>
</simplesect>
<simplesect>
<title>Undefine the libvirt domain</title>
<para>Now that the image is ready to be uploaded to the Image
Service, we no longer need to have this virtual machine
image managed by libvirt. Use the <command>virsh undefine
<replaceable>vm-image</replaceable></command>
command to inform
libvirt<screen><prompt>#</prompt> <userinput>virsh undefine precise</userinput></screen></para>
<para>Now that the image is ready to be uploaded to the Image Service, you no longer need to
have this virtual machine image managed by libvirt. Use the <command>virsh undefine
<replaceable>vm-image</replaceable></command> command to inform libvirt:</para>
<screen><prompt>#</prompt> <userinput>virsh undefine trusty</userinput></screen>
</simplesect>
<simplesect>
<title>Image is complete</title>
<para>The underlying image file that you created with
<command>qemu-img create</command>, such as
<filename>/tmp/precise.qcow2</filename>, is now ready
for uploading to the OpenStack Image Service.</para>
<para>The underlying image file that you created with <command>qemu-img create</command>,
such as <filename>/tmp/trusty.qcow2</filename>, is now ready for uploading to the
OpenStack Image Service.</para>
</simplesect>
</section>

6
doc/install-guide/bk-openstack-install-guide.xml
View File

@ -7,7 +7,7 @@
status="draft">
<title>OpenStack Installation Guide for
<phrase os="rhel;centos;fedora">Red Hat Enterprise Linux, CentOS, and Fedora</phrase>
<phrase os="ubuntu">Ubuntu 12.04/14.04 (LTS)</phrase>
<phrase os="ubuntu">Ubuntu 14.04 (LTS)</phrase>
<phrase os="debian">Debian 7.0 (Wheezy)</phrase>
<phrase os="opensuse">openSUSE and SUSE Linux Enterprise Server</phrase>
</title>
@ -17,7 +17,7 @@
<?rax subtitle.font.size="17px" title.font.size="32px"?>
<titleabbrev>OpenStack Installation Guide for
<phrase os="rhel;centos;fedora">Red Hat Enterprise Linux, CentOS, and Fedora</phrase>
<phrase os="ubuntu">Ubuntu 12.04/14.04 (LTS)</phrase>
<phrase os="ubuntu">Ubuntu 14.04 (LTS)</phrase>
<phrase os="opensuse">openSUSE and SUSE Linux Enterprise Server</phrase>
<phrase os="debian">Debian 7.0 (Wheezy)</phrase>
</titleabbrev>
@ -60,7 +60,7 @@
Debian 7.0 (code name: Wheezy).</phrase>
<phrase os="ubuntu">This guide walks through an
installation by using packages available through
Ubuntu 12.04 (LTS) or 14.04 (LTS).</phrase>
Ubuntu 14.04 (LTS).</phrase>
<phrase os="rhel;centos;fedora">This guide shows you
how to install OpenStack by using packages
available through Fedora 20 as well as on Red Hat

8
doc/install-guide/section_basics-packages.xml
View File

@ -110,14 +110,6 @@ Key Expires: Thu Dec 17 13:34:21 2015</programlisting>
<screen><prompt>#</prompt> <userinput>apt-get update</userinput>
<prompt>#</prompt> <userinput>apt-get dist-upgrade</userinput></screen>
</step>
<step>
<para>If you intend to use OpenStack Networking with Ubuntu 12.04,
you should install a backported Linux kernel to improve the
stability of your system. This installation is not needed if you
intend to use the legacy networking service.</para>
<para>Install the Ubuntu 13.10 backported kernel:</para>
<screen><prompt>#</prompt> <userinput>apt-get install linux-image-generic-lts-saucy linux-headers-generic-lts-saucy</userinput></screen>
</step>
<step>
<para>Reboot the system for all changes to take effect:</para>
<screen><prompt>#</prompt> <userinput>reboot</userinput></screen>

15
doc/install-guide/section_nova-compute-install.xml
View File

@ -159,21 +159,6 @@ glance_host = <replaceable>controller</replaceable></programlisting>
<programlisting language="ini">[libvirt]
...
virt_type = qemu</programlisting>
<warning os="ubuntu">
<para>On Ubuntu 12.04, kernels backported from newer releases may
not automatically load the KVM modules for hardware acceleration
when the compute node boots. In this case, launching an instance
will fail with the following message in the
<filename>/var/log/nova/nova-compute.log</filename> file:</para>
<screen><computeroutput>libvirtError: internal error: no supported architecture for os type 'hvm'</computeroutput></screen>
<para>As a workaround for this issue, you must add the appropriate
module for your compute node to the
<filename>/etc/modules</filename> file.</para>
<para>For systems with Intel processors:</para>
<screen><prompt>#</prompt> <userinput>echo 'kvm_intel' >> /etc/modules</userinput></screen>
<para>For systems with AMD processors:</para>
<screen><prompt>#</prompt> <userinput>echo 'kvm_amd' >> /etc/modules</userinput></screen>
</warning>
</step>
</substeps>
</step>

6
doc/install-guide/section_trove-install.xml
View File

@ -13,12 +13,6 @@
OpenStack environment with at least the following components
installed: Compute, Image Service, Identity.</para>
</formalpara>
<note os="ubuntu">
<title>Ubuntu 14.04 Only</title>
<para>The Database module is only available under Ubuntu 14.04.
Packages are not available for 12.04, or via the Ubuntu Cloud
Archive.</para>
</note>
<para>To install the Database module on the controller:</para>
<procedure>
<step>

2
doc/local-files.html
View File

@ -63,7 +63,7 @@
</dd>
<dd>
<a href="install-guide/target/docbkx/webhelp/local/install-guide/install/apt/content/index.html">
Installation Guide for Ubuntu 12.04 (LTS)
Installation Guide for Ubuntu 14.04 (LTS)
</a>
<br/>
Note: build locally with "<code>mvn generate-sources -Doperating.system=apt -Dprofile.os=ubuntu</code>".

2
www/trunk/index.html
View File

@ -234,7 +234,7 @@
</dd>
<dd>
<a href="http://docs.openstack.org/trunk/install-guide/install/apt/content/">
Installation Guide for Ubuntu 12.04/14.04 (LTS)
Installation Guide for Ubuntu 14.04 (LTS)
</a>
</dd>
</dl>