Replace screenshots in User Guide

Replaces the following screenshots in user guide with new ones:
- for Install Fuel Master Node
- for Fuel Setup
- for Network Setup
- for PXE Setup
- for DNS & Hostname
- for Time sync with NTP
- for Fuel login
Removes the screenshot and info for docker0.
Removes the text (and screenshot accordingly) about
the showmenu option as now it's showmenu=yes
by default.
Adds a screenshot for Quit Setup.

Change-Id: I5956aef7a7d8965c64447cfe06942ffcba64f2a5
Closes-Bug: #1469141
Closes-Bug: #1469146
This commit is contained in:
Maria Zlatkova 2015-07-02 18:57:58 +03:00
parent efbf923fa2
commit 22df058ac6
13 changed files with 19 additions and 48 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 98 KiB

After

Width:  |  Height:  |  Size: 6.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 35 KiB

BIN
_images/fuelmenu_DNS.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 8.6 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 19 KiB

After

Width:  |  Height:  |  Size: 8.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 120 KiB

After

Width:  |  Height:  |  Size: 8.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.3 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 409 KiB

After

Width:  |  Height:  |  Size: 366 KiB

View File

@ -57,19 +57,10 @@ for your particular networking environment,
while helping to detect errors early
so you do not need to troubleshoot individual configuration files.
In order to get to the Fuel Setup, press the <TAB> key on the very first installation screen
(the one that says "Welcome to Fuel Installer!") and update the kernel option
``showmenu=no`` to ``showmenu=yes``. Alternatively, you can press a key to
start Fuel Setup during the first boot after installation.
.. image:: /_images/fuel_welcome_customized_settings.jpg
:width: 50%
Within Fuel Setup, you can configure the following parameters:
* DHCP/Static configuration for each network interface
* Docker internal network configuration
* Select interface for Fuel Admin network
* Define DHCP pool (bootstrap) and static range (installed nodes)
* Set NTP servers for Time settings
@ -79,7 +70,7 @@ Within Fuel Setup, you can configure the following parameters:
* Launch shell for optional pre-deployment tasks
.. image:: /_images/fuelmenu_Network_Setup.png
:width: 50%
Use the arrow keys to navigate through the tool and Space or Enter key to select
an item.
@ -87,17 +78,11 @@ an item.
Network Setup
-------------
.. Warning::
This section must be configured only in scope of Fuel Master node first boot!
Setting new network settings for the already installed master node requires
that all Docker containers be rebuilt and possibly further manual reconfiguration!
This section is used to set network interface settings. It shows all network
interfaces currently available. During the first boot, it shows only available
ethX NICs and docker0 bridge; if you run Fuel Setup on already deployed master
node it will additionally present you vethXXX interfaces.
You may set configuration for each interface, enable or disable particular NICs.
ethX NICs; if you run Fuel Setup on already deployed Fuel Master node it will
additionally present you vethXXX interfaces. You may set configuration for
each interface, enable or disable particular NICs.
Unlike the other tabs, this tab has the ability to immediately apply only changes
related to this tab.
@ -111,21 +96,6 @@ related to this tab.
during the first boot, perform necessary network settings with proper care,
return back to the Fuel Setup and continue with master node installation.
About the Docker0 bridge.
.. image:: /_images/fuelmenu_Network_Docker.jpg
:width: 50%
This virtual bridge connects external physical
interfaces with the internal Docker virtual network.
It has default 172.17.42.0/16 CIDR but, as Docker chooses this network automatically,
this CIDR may vary from installation to installation. This virtual network
exists inside the master node only.
Be sure this CIDR does not intersect with Admin(PXE) one in case you are going to
customize this network.
Configuring Network settings
Network settings has 2 parts - editable Network settings and non-editable
@ -157,9 +127,8 @@ Network Setup includes the following configurable sections:
* Button Apply - Validates the unsaved settings on the Network Setup section
and makes the new settings effective.
.. image:: /_images/fuelmenu_Network_Setup.png
:width: 50%
Assume you are going to change PXE NIC from eth0 to eth1. eth0 is already up and
its IP address is 10.20.0.2, set via kernel options. You want eth1 to use
@ -227,11 +196,6 @@ PXE setup includes the following options:
IP addresses. These addresses should be located inside the CIDR that is configured
for the currently selected NIC.
.. note:: In Fuel versions 5.1 and earlier, there was
a separate Static Pool, and docker0 would incorrectly show
up in the list of available PXE interfaces, this is no longer
relevant in current version.
* Check button - verifies the current unsaved settings against the currently
selected NIC without applying.
@ -246,11 +210,15 @@ Let us continue the example we started in the Network Settings section:
#. As usual, use Check button to verify the current unsaved settings.
.. warning::
Setting the PXE NIC with Fuel Setup when the Fuel Master node is already deployed
may lead to non-working PXE boot functionality. In order to get PXE working,
one must rebuild all Docker containers and set the remaining related settings
manually.
.. warning::
Modifying the PXE NIC with Fuel Setup when the Fuel Master node is
already deployed will break Fuel's ability to PXE boot and manage
OpenStack environments. If you wish to modify PXE NIC configuration,
you should only do so by destroying all OpenStack environments,
and then run the following commands: :command:`dockerctl shell nailgun`,
:command:`manage.py dropdb`, :command:`dockerctl destroy all`,
:command:`dockerctl start all`.
.. image:: /_images/fuelmenu_PXE_Setup.png
:width: 50%
@ -262,7 +230,7 @@ DNS & Hostname
Use this section to configure the remained master node network settings.
These settings may be reconfigured after the master node has been deployed.
.. image:: /_images/fuelmenu_DNS.jpg
.. image:: /_images/fuelmenu_DNS.png
:width: 50%
Details on settings:
@ -292,7 +260,7 @@ Use this section to set NTP server names
in order to get proper time synchronization.
Synchronized time is mandatory for OpenStack services.
.. image:: /_images/fuelmenu_TimeSync.jpg
.. image:: /_images/fuelmenu_TimeSync.png
:width: 50%
If you have access from master node to the external or corporate network -
@ -372,6 +340,9 @@ Options:
Once you have made your changes,
go to Save & Quit.
.. image:: /_images/fuelmenu_Quit_Setup.png
:width: 50%
You can run ``fuelmenu`` from a root shell on the Fuel Master node
after deployment to make minor changes
to network interfaces, DNS, Time Sync and the gateway.