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
Before Width: | Height: | Size: 98 KiB After Width: | Height: | Size: 6.2 KiB |
Before Width: | Height: | Size: 42 KiB |
Before Width: | Height: | Size: 35 KiB |
After Width: | Height: | Size: 7.5 KiB |
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 8.6 KiB |
Before Width: | Height: | Size: 48 KiB |
Before Width: | Height: | Size: 19 KiB After Width: | Height: | Size: 8.2 KiB |
Before Width: | Height: | Size: 120 KiB After Width: | Height: | Size: 8.6 KiB |
After Width: | Height: | Size: 5.8 KiB |
Before Width: | Height: | Size: 45 KiB |
After Width: | Height: | Size: 8.3 KiB |
Before Width: | Height: | Size: 409 KiB After Width: | Height: | Size: 366 KiB |
|
@ -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.
|
||||
|
|