starlingx/docs
Code Issues Proposed changes

Fix Install link

Browse Source 
Fix circular r8 install link.
Replace version number with substitution

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I5e4a9c3a4a5f764f2c10fe4087407460e3e715bb
This commit is contained in:
Ron Stone
2023-03-02 18:09:26 +00:00
parent 7e14a16c94
commit 8f82f3c36f
22 changed files with 144 additions and 124 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
doc/source/_this.txt
View File

@@ -1,3 +1,3 @@
.. |this-prod| replace:: |prod-long|
.. |this-ver| replace:: r7.0
.. |this-ver| replace:: r8.0

11
doc/source/deploy_install_guides/index-install-e083ca818006.rst
View File

@@ -13,16 +13,19 @@ Each guide provides instruction on a specific StarlingX configuration
Upcoming release
----------------
The next release will be R9.0. Use the installation procedures in the
`R8 Installation Guide <https://docs.starlingx.io/deploy_install_guides/index-install-e083ca818006.html>`_
The next release will be R9.0. We recommend using the installation procedures
in the current release.
To try the next release, see the `upcoming Installation Guide
<https://docs.starlingx.io/deploy_install_guides/release/index-install-r7-8966076f0e81.html>`_
---------------
Current release
---------------
R8.0 is the current release of StarlingX.
|this-ver| is the current release of StarlingX.
Use the :ref:`index-install-e083ca818006` to install R8.0.
Use the :ref:`index-install-r7-8966076f0e81` to install |this-ver|.
------------------

14
doc/source/deploy_install_guides/release/bare_metal/ironic_install.rst
View File

@@ -1,6 +1,6 @@
================================
Install Ironic on StarlingX R7.0
================================
===========================
Install Ironic on StarlingX
===========================
.. include:: /_includes/ironic.rest
@@ -9,10 +9,10 @@ Install Ironic on StarlingX R7.0
This section describes the steps to install Ironic on a standard configuration,
either:
* **StarlingX R7.0 bare metal Standard with Controller Storage** deployment
* StarlingX |this-ver| bare metal Standard with Controller Storage deployment
configuration
* **StarlingX R7.0 bare metal Standard with Dedicated Storage** deployment
* StarlingX |this-ver| bare metal Standard with Dedicated Storage deployment
configuration
.. contents::
@@ -23,8 +23,8 @@ either:
Enable Ironic service
---------------------
This section describes the pre-configuration required to enable the Ironic service.
All the commands in this section are for the StarlingX platform.
This section describes the pre-configuration required to enable the Ironic
service. All the commands in this section are for the StarlingX platform.
First acquire administrative privileges:

6
doc/source/deploy_install_guides/release/kubernetes_access.rst
View File

@@ -1,8 +1,8 @@
.. _kubernetes_access_r7:
================================
Access StarlingX Kubernetes R7.0
================================
===========================
Access StarlingX Kubernetes
===========================
This section describes how to use local/remote CLIs, GUIs, and/or REST APIs to
access and manage StarlingX Kubernetes and hosted containerized applications.

6
doc/source/deploy_install_guides/release/virtual/aio_duplex.rst
View File

@@ -1,6 +1,6 @@
===========================================
Virtual All-in-one Duplex Installation R7.0
===========================================
======================================
Virtual All-in-one Duplex Installation
======================================
--------
Overview

13
doc/source/deploy_install_guides/release/virtual/aio_duplex_environ.rst
View File

@@ -3,7 +3,7 @@ Prepare Host and Environment
============================
This section describes how to prepare the physical host and virtual environment
for a **StarlingX R7.0 virtual All-in-one Duplex** deployment configuration.
for a StarlingX |this-ver| virtual All-in-one Duplex deployment configuration.
.. contents::
:local:
@@ -22,7 +22,7 @@ Prepare virtual environment and servers
.. note::
The following commands for host, virtual environment setup, and host
power-on use KVM / virsh for virtual machine and VM management
power-on use KVM / virsh for virtual machine and |VM| management
technology. For an alternative virtualization environment, see:
:doc:`Install StarlingX in VirtualBox <install_virtualbox>`.
@@ -37,7 +37,8 @@ Prepare virtual environment and servers
#. Prepare virtual servers.
Create the XML definitions for the virtual servers required by this
configuration option. This will create the XML virtual server definition for:
configuration option. This will create the XML virtual server definition
for:
* duplex-controller-0
* duplex-controller-1
@@ -51,7 +52,7 @@ Prepare virtual environment and servers
bash setup_configuration.sh -c duplex -i ./bootimage.iso
If there is no X-server present errors will occur and the X-based GUI for the
virt-manager application will not start. The virt-manager GUI is not absolutely
required and you can safely ignore errors and continue.
If there is no X-server present errors will occur and the X-based GUI for
the virt-manager application will not start. The virt-manager GUI is not
absolutely required and you can safely ignore errors and continue.

10
doc/source/deploy_install_guides/release/virtual/aio_duplex_install_kubernetes.rst
View File

@@ -3,7 +3,7 @@ Install StarlingX Kubernetes on Virtual AIO-DX
==============================================
This section describes the steps to install the StarlingX Kubernetes platform
on a **StarlingX R7.0 virtual All-in-one Duplex** deployment configuration.
on a StarlingX |this-ver| virtual All-in-one Duplex deployment configuration.
.. contents::
:local:
@@ -13,10 +13,12 @@ on a **StarlingX R7.0 virtual All-in-one Duplex** deployment configuration.
Install software on controller-0
--------------------------------
In the last step of :doc:`aio_duplex_environ`, the controller-0 virtual server 'duplex-controller-0' was started by the :command:`setup_configuration.sh` command.
In the last step of :doc:`aio_duplex_environ`, the controller-0 virtual server
'duplex-controller-0' was started by the :command:`setup_configuration.sh`
command.
On the host, attach to the console of virtual controller-0 and select the appropriate
installer menu options to start the non-interactive install of
On the host, attach to the console of virtual controller-0 and select the
appropriate installer menu options to start the non-interactive install of
StarlingX software on controller-0.
.. note::

2
doc/source/deploy_install_guides/release/virtual/aio_simplex.rst
View File

@@ -1,6 +1,6 @@
.. _virtual-aio-simplex:
=======================================
=======================================
Virtual All-in-one Simplex Installation
=======================================

13
doc/source/deploy_install_guides/release/virtual/aio_simplex_environ.rst
View File

@@ -3,7 +3,7 @@ Prepare Host and Environment
============================
This section describes how to prepare the physical host and virtual environment
for a **StarlingX R7.0 virtual All-in-one Simplex** deployment configuration.
for a StarlingX |this-ver| virtual All-in-one Simplex deployment configuration.
.. contents::
:local:
@@ -22,7 +22,7 @@ Prepare virtual environment and servers
.. note::
The following commands for host, virtual environment setup, and host
power-on use KVM / virsh for virtual machine and VM management
power-on use KVM / virsh for virtual machine and |VM| management
technology. For an alternative virtualization environment, see:
:doc:`Install StarlingX in VirtualBox <install_virtualbox>`.
@@ -37,7 +37,8 @@ Prepare virtual environment and servers
#. Prepare virtual servers.
Create the XML definitions for the virtual servers required by this
configuration option. This will create the XML virtual server definition for:
configuration option. This will create the XML virtual server definition
for:
* simplex-controller-0
@@ -50,6 +51,6 @@ Prepare virtual environment and servers
bash setup_configuration.sh -c simplex -i ./bootimage.iso
If there is no X-server present errors will occur and the X-based GUI for the
virt-manager application will not start. The virt-manager GUI is not absolutely
required and you can safely ignore errors and continue.
If there is no X-server present errors will occur and the X-based GUI for
the virt-manager application will not start. The virt-manager GUI is not
absolutely required and you can safely ignore errors and continue.

32
doc/source/deploy_install_guides/release/virtual/aio_simplex_install_kubernetes.rst
View File

@@ -3,7 +3,7 @@ Install StarlingX Kubernetes on Virtual AIO-SX
==============================================
This section describes the steps to install the StarlingX Kubernetes platform
on a **StarlingX R7.0 virtual All-in-one Simplex** deployment configuration.
on a St|this-ver|arlingX virtual All-in-one Simplex deployment configuration.
.. contents::
:local:
@@ -13,8 +13,9 @@ on a **StarlingX R7.0 virtual All-in-one Simplex** deployment configuration.
Install software on controller-0
--------------------------------
In the last step of :doc:`aio_simplex_environ`, the controller-0 virtual server 'simplex-controller-0'
was started by the :command:`setup_configuration.sh` command.
In the last step of :doc:`aio_simplex_environ`, the controller-0 virtual server
'simplex-controller-0' was started by the :command:`setup_configuration.sh`
command.
On the host, attach to the console of virtual controller-0 and select the
appropriate installer menu options to start the non-interactive install of
@@ -90,8 +91,8 @@ On virtual controller-0:
Specify the user configuration override file for the Ansible bootstrap
playbook using one of the following methods:
* Copy the default.yml file listed above to ``$HOME/localhost.yml`` and edit
the configurable values as desired (use the commented instructions in
* Copy the ``default.yml`` file listed above to ``$HOME/localhost.yml`` and
edit the configurable values as desired (use the commented instructions in
the file).
or
@@ -125,11 +126,12 @@ On virtual controller-0:
EOF
Refer to :ref:`Ansible Bootstrap Configurations <ansible_bootstrap_configs_r7>`
for information on additional Ansible bootstrap configurations for advanced
Ansible bootstrap scenarios, such as Docker proxies when deploying behind a
firewall, etc. Refer to :ref:`Docker Proxy Configuration <docker_proxy_config>`
for details about Docker proxy settings.
Refer to :ref:`Ansible Bootstrap Configurations
<ansible_bootstrap_configs_r7>` for information on additional Ansible
bootstrap configurations for advanced Ansible bootstrap scenarios, such as
Docker proxies when deploying behind a firewall, etc. Refer to :ref:`Docker
Proxy Configuration <docker_proxy_config>` for details about Docker proxy
settings.
#. Run the Ansible bootstrap playbook:
@@ -137,8 +139,8 @@ On virtual controller-0:
ansible-playbook /usr/share/ansible/stx-ansible/playbooks/bootstrap.yml
Wait for Ansible bootstrap playbook to complete.
This can take 5-10 minutes, depending on the performance of the host machine.
Wait for Ansible bootstrap playbook to complete. This can take 5-10 minutes,
depending on the performance of the host machine.
----------------------
Configure controller-0
@@ -152,9 +154,9 @@ On virtual controller-0:
source /etc/platform/openrc
#. Configure the OAM interface of controller-0 and specify the attached network
as "oam". Use the OAM port name, for example eth0, that is applicable to your
deployment environment:
#. Configure the |OAM| interface of controller-0 and specify the attached
network as "oam". Use the |OAM| port name, for example eth0, that is
applicable to your deployment environment:
::

2
doc/source/deploy_install_guides/release/virtual/config_virtualbox_netwk.rst
View File

@@ -3,7 +3,7 @@ Configure VirtualBox Network Access
===================================
This guide describes two alternatives for providing external network access
to the controller :abbr:`VMs (Virtual Machines)` for VirtualBox:
to the controller |VMs| for VirtualBox:
.. contents::
:local:

6
doc/source/deploy_install_guides/release/virtual/controller_storage.rst
View File

@@ -1,6 +1,6 @@
==========================================================
Virtual Standard with Controller Storage Installation R7.0
==========================================================
=====================================================
Virtual Standard with Controller Storage Installation
=====================================================
--------
Overview

11
doc/source/deploy_install_guides/release/virtual/controller_storage_environ.rst
View File

@@ -3,7 +3,7 @@ Prepare Host and Environment
============================
This section describes how to prepare the physical host and virtual environment
for a **StarlingX R7.0 virtual Standard with Controller Storage** deployment
for a StarlingX |this-ver| virtual Standard with Controller Storage deployment
configuration.
.. contents::
@@ -38,7 +38,8 @@ Prepare virtual environment and servers
#. Prepare virtual servers.
Create the XML definitions for the virtual servers required by this
configuration option. This will create the XML virtual server definition for:
configuration option. This will create the XML virtual server definition
for:
* controllerstorage-controller-0
* controllerstorage-controller-1
@@ -54,6 +55,6 @@ Prepare virtual environment and servers
bash setup_configuration.sh -c controllerstorage -i ./bootimage.iso
If there is no X-server present errors will occur and the X-based GUI for the
virt-manager application will not start. The virt-manager GUI is not absolutely
required and you can safely ignore errors and continue.
If there is no X-server present errors will occur and the X-based GUI for
the virt-manager application will not start. The virt-manager GUI is not
absolutely required and you can safely ignore errors and continue.

6
doc/source/deploy_install_guides/release/virtual/controller_storage_install_kubernetes.rst
View File

@@ -3,7 +3,7 @@ Install StarlingX Kubernetes on Virtual Standard with Controller Storage
========================================================================
This section describes the steps to install the StarlingX Kubernetes platform
on a **StarlingX R7.0 virtual Standard with Controller Storage** deployment
on a StarlingX |this-ver| virtual Standard with Controller Storage deployment
configuration.
.. contents::
@@ -18,8 +18,8 @@ In the last step of :doc:`controller_storage_environ`, the controller-0 virtual
server 'controllerstorage-controller-0' was started by the
:command:`setup_configuration.sh` command.
On the host, attach to the console of virtual controller-0 and select the appropriate
installer menu options to start the non-interactive install of
On the host, attach to the console of virtual controller-0 and select the
appropriate installer menu options to start the non-interactive install of
StarlingX software on controller-0.
.. note::

6
doc/source/deploy_install_guides/release/virtual/dedicated_storage.rst
View File

@@ -1,6 +1,6 @@
=========================================================
Virtual Standard with Dedicated Storage Installation R7.0
=========================================================
====================================================
Virtual Standard with Dedicated Storage Installation
====================================================
--------
Overview

11
doc/source/deploy_install_guides/release/virtual/dedicated_storage_environ.rst
View File

@@ -3,7 +3,7 @@ Prepare Host and Environment
============================
This section describes how to prepare the physical host and virtual environment
for a **StarlingX R7.0 virtual Standard with Dedicated Storage** deployment
for a StarlingX |this-ver| virtual Standard with Dedicated Storage deployment
configuration.
.. contents::
@@ -38,7 +38,8 @@ Prepare virtual environment and servers
#. Prepare virtual servers.
Create the XML definitions for the virtual servers required by this
configuration option. This will create the XML virtual server definition for:
configuration option. This will create the XML virtual server definition
for:
* dedicatedstorage-controller-0
* dedicatedstorage-controller-1
@@ -56,6 +57,6 @@ Prepare virtual environment and servers
bash setup_configuration.sh -c dedicatedstorage -i ./bootimage.iso
If there is no X-server present errors will occur and the X-based GUI for the
virt-manager application will not start. The virt-manager GUI is not absolutely
required and you can safely ignore errors and continue.
If there is no X-server present errors will occur and the X-based GUI for
the virt-manager application will not start. The virt-manager GUI is not
absolutely required and you can safely ignore errors and continue.

40
doc/source/deploy_install_guides/release/virtual/dedicated_storage_install_kubernetes.rst
View File

@@ -3,7 +3,7 @@ Install StarlingX Kubernetes on Virtual Standard with Dedicated Storage
=======================================================================
This section describes the steps to install the StarlingX Kubernetes platform
on a **StarlingX R7.0 virtual Standard with Dedicated Storage** deployment
on a StarlingX |this-ver| virtual Standard with Dedicated Storage deployment
configuration.
.. contents::
@@ -18,8 +18,8 @@ In the last step of :doc:`dedicated_storage_environ`, the controller-0 virtual
server 'dedicatedstorage-controller-0' was started by the
:command:`setup_configuration.sh` command.
On the host, attach to the console of virtual controller-0 and select the appropriate
installer menu options to start the non-interactive install of
On the host, attach to the console of virtual controller-0 and select the
appropriate installer menu options to start the non-interactive install of
StarlingX software on controller-0.
.. note::
@@ -74,7 +74,8 @@ Unlock virtual controller-0 in order to bring it into service:
system host-unlock controller-0
Controller-0 will reboot in order to apply configuration changes and come into
service. This can take 5-10 minutes, depending on the performance of the host machine.
service. This can take 5-10 minutes, depending on the performance of the host
machine.
-----------------------------------------------------------------
Install software on controller-1, storage nodes, and worker nodes
@@ -94,8 +95,8 @@ Install software on controller-1, storage nodes, and worker nodes
virsh console dedicatedstorage-controller-1
#. As controller-1 VM boots, a message appears on its console instructing you to
configure the personality of the node.
#. As controller-1 |VM| boots, a message appears on its console instructing you
to configure the personality of the node.
#. On the console of controller-0, list hosts to see newly discovered
controller-1 host (hostname=None):
@@ -119,9 +120,10 @@ Install software on controller-1, storage nodes, and worker nodes
This initiates software installation on controller-1.
This can take 5-10 minutes, depending on the performance of the host machine.
#. While waiting on the previous step to complete, start up and set the personality
for 'dedicatedstorage-storage-0' and 'dedicatedstorage-storage-1'. Set the
personality to 'storage' and assign a unique hostname for each.
#. While waiting on the previous step to complete, start up and set the
personality for 'dedicatedstorage-storage-0' and
'dedicatedstorage-storage-1'. Set the personality to 'storage' and assign a
unique hostname for each.
For example, start 'dedicatedstorage-storage-0' from the host:
@@ -152,9 +154,9 @@ Install software on controller-1, storage nodes, and worker nodes
This initiates software installation on storage-0 and storage-1.
This can take 5-10 minutes, depending on the performance of the host machine.
#. While waiting on the previous step to complete, start up and set the personality
for 'dedicatedstorage-worker-0' and 'dedicatedstorage-worker-1'. Set the
personality to 'worker' and assign a unique hostname for each.
#. While waiting on the previous step to complete, start up and set the
personality for 'dedicatedstorage-worker-0' and 'dedicatedstorage-worker-1'.
Set the personality to 'worker' and assign a unique hostname for each.
For example, start 'dedicatedstorage-worker-0' from the host:
@@ -192,8 +194,8 @@ Install software on controller-1, storage nodes, and worker nodes
:ref:`deploy-edgeworker-nodes` for details.
#. Wait for the software installation on controller-1, storage-0, storage-1,
worker-0, and worker-1 to complete, for all virtual servers to reboot, and for all
to show as locked/disabled/online in 'system host-list'.
worker-0, and worker-1 to complete, for all virtual servers to reboot, and
for all to show as locked/disabled/online in 'system host-list'.
::
@@ -233,7 +235,8 @@ On virtual controller-0:
#. Assign the cluster-host network to the MGMT interface for the storage nodes.
Note that the MGMT interfaces are partially set up by the network install procedure.
Note that the MGMT interfaces are partially set up by the network install
procedure.
::
@@ -282,7 +285,8 @@ Unlock virtual storage nodes in order to bring them into service:
done
The storage nodes will reboot in order to apply configuration changes and come
into service. This can take 5-10 minutes, depending on the performance of the host machine.
into service. This can take 5-10 minutes, depending on the performance of the
host machine.
----------------------
Configure worker nodes
@@ -308,8 +312,8 @@ On virtual controller-0:
This step is required only if the StarlingX OpenStack application
(|prefix|-openstack) will be installed.
1G Huge Pages are not supported in the virtual environment and there is no
virtual NIC supporting SRIOV. For that reason, data interfaces are not
1G Huge Pages are not supported in the virtual environment and there is
no virtual NIC supporting SRIOV. For that reason, data interfaces are not
applicable in the virtual environment for the Kubernetes-only scenario.
For OpenStack only:

4
doc/source/deploy_install_guides/release/virtual/install_virtualbox.rst
View File

@@ -19,7 +19,7 @@ Prerequisites
5.2.22. Download from: http://www.virtualbox.org/wiki/Downloads
* VirtualBox Extension Pack is installed.
To boot worker nodes via the controller, you must install the
VirtualBox Extension Pack to add support for PXE boot of Intel cards. Download
VirtualBox Extension Pack to add support for |PXE| boot of Intel cards. Download
the extension pack from: https://www.virtualbox.org/wiki/Downloads
.. note::
@@ -34,7 +34,7 @@ Prerequisites
Create VMs for controller, worker and storage hosts
---------------------------------------------------
For each StarlingX host, configure a VirtualBox VM with the following settings.
For each StarlingX host, configure a VirtualBox |VM| with the following settings.
.. note::

6
doc/source/deploy_install_guides/release/virtual/rook_storage.rst
View File

@@ -1,6 +1,6 @@
====================================================
Virtual Standard with Rook Storage Installation R7.0
====================================================
===============================================
Virtual Standard with Rook Storage Installation
===============================================
--------
Overview

10
doc/source/deploy_install_guides/release/virtual/rook_storage_environ.rst
View File

@@ -3,7 +3,7 @@ Prepare Host and Environment
============================
This section describes how to prepare the physical host and virtual environment
for a **StarlingX R7.0 virtual Standard with Rook Storage** deployment
for a StarlingX |this-ver| virtual Standard with Rook Storage deployment
configuration.
.. contents::
@@ -23,7 +23,7 @@ Prepare virtual environment and servers
.. note::
The following commands for host, virtual environment setup, and host
power-on use KVM / virsh for virtual machine and VM management
power-on use KVM / virsh for virtual machine and |VM| management
technology. For an alternative virtualization environment, see:
:doc:`Install StarlingX in VirtualBox <install_virtualbox>`.
@@ -56,6 +56,6 @@ Prepare virtual environment and servers
export WORKER_NODES_NUMBER=4 ; bash setup_configuration.sh -c controllerstorage -i ./bootimage.iso
If there is no X-server present errors will occur and the X-based GUI for the
virt-manager application will not start. The virt-manager GUI is not absolutely
required and you can safely ignore errors and continue.
If there is no X-server present errors will occur and the X-based GUI for
the virt-manager application will not start. The virt-manager GUI is not
absolutely required and you can safely ignore errors and continue.

52
doc/source/deploy_install_guides/release/virtual/rook_storage_install_kubernetes.rst
View File

@@ -3,8 +3,8 @@ Install StarlingX Kubernetes on Virtual Standard with Rook Storage
==================================================================
This section describes the steps to install the StarlingX Kubernetes platform
on a **StarlingX R7.0 virtual Standard with Rook Storage** deployment configuration,
deploy rook ceph cluster replacing default native ceph cluster.
on a StarlingX |this-ver| virtual Standard with Rook Storage deployment
configuration, deploy rook ceph cluster replacing default native ceph cluster.
.. contents::
:local:
@@ -18,8 +18,8 @@ In the last step of :doc:`rook_storage_environ`, the controller-0 virtual
server 'rookstorage-controller-0' was started by the
:command:`setup_configuration.sh` command.
On the host, attach to the console of virtual controller-0 and select the appropriate
installer menu options to start the non-interactive install of
On the host, attach to the console of virtual controller-0 and select the
appropriate installer menu options to start the non-interactive install of
StarlingX software on controller-0.
.. note::
@@ -111,9 +111,9 @@ OpenStack-specific host configuration
#. **For OpenStack only:** A vSwitch is required.
The default vSwitch is containerized OVS that is packaged with the
|prefix|-openstack manifest/helm-charts. StarlingX provides the option to use
OVS-DPDK on the host, however, in the virtual environment OVS-DPDK is NOT
supported, only OVS is supported. Therefore, simply use the default OVS
|prefix|-openstack manifest/helm-charts. StarlingX provides the option to
use OVS-DPDK on the host, however, in the virtual environment OVS-DPDK is
NOT supported, only OVS is supported. Therefore, simply use the default OVS
vSwitch here.
********************************
@@ -146,7 +146,8 @@ Unlock virtual controller-0 in order to bring it into service:
system host-unlock controller-0
Controller-0 will reboot in order to apply configuration changes and come into
service. This can take 5-10 minutes, depending on the performance of the host machine.
service. This can take 5-10 minutes, depending on the performance of the host
machine.
-----------------------------------------------------------------
Install software on controller-1 and worker nodes
@@ -166,8 +167,8 @@ Install software on controller-1 and worker nodes
virsh console rookstorage-controller-1
#. As controller-1 VM boots, a message appears on its console instructing you to
configure the personality of the node.
#. As controller-1 VM boots, a message appears on its console instructing you
to configure the personality of the node.
#. On the console of controller-0, list hosts to see newly discovered
controller-1 host (hostname=None):
@@ -191,8 +192,8 @@ Install software on controller-1 and worker nodes
This initiates software installation on controller-1.
This can take 5-10 minutes, depending on the performance of the host machine.
#. While waiting on the previous step to complete, start up and set the personality
for 'rookstorage-worker-0' and 'rookstorage-worker-1'. Set the
#. While waiting on the previous step to complete, start up and set the
personality for 'rookstorage-worker-0' and 'rookstorage-worker-1'. Set the
personality to 'worker' and assign a unique hostname for each.
For example, start 'rookstorage-worker-0' from the host:
@@ -221,11 +222,11 @@ Install software on controller-1 and worker nodes
system host-update 4 personality=worker hostname=rook-storage-1
This initiates software installation on storage-0 and storage-1.
This can take 5-10 minutes, depending on the performance of the host machine.
This initiates software installation on storage-0 and storage-1. This can
take 5-10 minutes, depending on the performance of the host machine.
#. While waiting on the previous step to complete, start up and set the personality
for 'rookstorage-worker-2' and 'rookstorage-worker-3'. Set the
#. While waiting on the previous step to complete, start up and set the
personality for 'rookstorage-worker-2' and 'rookstorage-worker-3'. Set the
personality to 'worker' and assign a unique hostname for each.
For example, start 'rookstorage-worker-2' from the host:
@@ -264,8 +265,8 @@ Install software on controller-1 and worker nodes
:ref:`deploy-edgeworker-nodes` for details.
#. Wait for the software installation on controller-1, storage-0, storage-1,
worker-0, and worker-1 to complete, for all virtual servers to reboot, and for all
to show as locked/disabled/online in 'system host-list'.
worker-0, and worker-1 to complete, for all virtual servers to reboot, and
for all to show as locked/disabled/online in 'system host-list'.
::
@@ -322,7 +323,8 @@ On virtual controller-0:
#. Assign the cluster-host network to the MGMT interface for the storage nodes.
Note that the MGMT interfaces are partially set up by the network install procedure.
Note that the MGMT interfaces are partially set up by the network install
procedure.
::
@@ -350,7 +352,8 @@ Unlock virtual storage nodes in order to bring them into service:
done
The storage nodes will reboot in order to apply configuration changes and come
into service. This can take 5-10 minutes, depending on the performance of the host machine.
into service. This can take 5-10 minutes, depending on the performance of the
host machine.
----------------------
Configure worker nodes
@@ -376,8 +379,8 @@ On virtual controller-0:
This step is required only if the StarlingX OpenStack application
(|prefix|-openstack) will be installed.
1G Huge Pages are not supported in the virtual environment and there is no
virtual NIC supporting SRIOV. For that reason, data interfaces are not
1G Huge Pages are not supported in the virtual environment and there is
no virtual NIC supporting SRIOV. For that reason, data interfaces are not
applicable in the virtual environment for the Kubernetes-only scenario.
For OpenStack only:
@@ -462,8 +465,9 @@ Unlock virtual worker nodes to bring them into service:
system host-unlock $NODE
done
The worker nodes will reboot in order to apply configuration changes and come into
service. This can take 5-10 minutes, depending on the performance of the host machine.
The worker nodes will reboot in order to apply configuration changes and come
into service. This can take 5-10 minutes, depending on the performance of the
host machine.
-------------------------------------------------
Install Rook application manifest and helm-charts

5
doc/source/index.rst
View File

@@ -5,11 +5,12 @@ Welcome to the StarlingX Documentation
StarlingX is a fully integrated edge cloud software stack that provides
everything needed to deploy an edge cloud on one, two, or up to 100 servers.
**The most recent supported release is StarlingX R8.0.**
The most recent supported release is StarlingX |this-ver|.
* See the :ref:`release-notes`.
* Download the pre-built ISO (CentOS and Debian) and Docker images for
StarlingX release 8.0 that are located at the ``CENGN StarlingX mirror`` repos:
StarlingX |this-ver| that are located at the ``CENGN StarlingX mirror``
repos:
- https://mirror.starlingx.cengn.ca/mirror/starlingx/release/8.0.0/debian/monolithic/outputs/iso/