starlingx
/
docs
Code Issues Proposed changes

Debian Miscellaneous Updates 

- Minor editorial updates.
- New filesystem partition layout on root disks.

Signed-off-by: Elaine Fonaro <elaine.fonaro@windriver.com>
Change-Id: Ica32bf7a5fce81a3f5ec77f777f83b4321d60502
This commit is contained in:
Elaine Fonaro 2022-12-16 22:30:17 -03:00
parent 4f341795bf
commit 5dc5d567ba
14 changed files with 266 additions and 350 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/source/deploy_install_guides/r7_release/bare_metal/adding-hosts-using-the-host-add-command.rst
View File

@ -111,8 +111,8 @@ scripting an initial setup.
sda. sda.
**<rootfs\_device>** **<rootfs\_device>**
is the host device for rootfs partition, relative to/dev. The default is a logical volume cgts-vg/root-lv. The default is sda, it should be
is sda. the same value as specified for the boot_device.
**<mgmt\_mac>** **<mgmt\_mac>**
is the |MAC| address of the port connected to the internal management is the |MAC| address of the port connected to the internal management

195
doc/source/deploy_install_guides/r7_release/bare_metal/aio_duplex_install_kubernetes.rst
View File

@ -62,7 +62,7 @@ Install Software on Controller-0
.. .. figure:: /shared/figures/deploy_install_guides/starlingx-deployment-options-duplex.png .. .. figure:: /shared/figures/deploy_install_guides/starlingx-deployment-options-duplex.png
.. :width: 800 .. :width: 800
.. All-in-one Duplex deployment configuration .. All-in-one Duplex deployment configuration
.. _installation-prereqs-duplex: .. _installation-prereqs-duplex:
@ -449,30 +449,24 @@ Configure controller-0
# check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located # check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located
system host-lvg-list controller-0 system host-lvg-list controller-0
# if existing docker fs size + cgts-vg available space is less than # if existing docker fs size + cgts-vg available space is less than
# 80G, you will need to add a new disk partition to cgts-vg. # 80G, you will need to add a new disk to cgts-vg.
# There must be at least 20GB of available space after the docker
# filesystem is increased.
# Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. # Get device path of BOOT DISK
# ( if not use another unused disk ) system host-show controller-0 | fgrep rootfs
# Get device path of ROOT DISK
system host-show controller-0 --nowrap | fgrep rootfs
# Get UUID of ROOT DISK by listing disks # Get UUID of ROOT DISK by listing disks
system host-disk-list controller-0 system host-disk-list controller-0
# Create new PARTITION on ROOT DISK, and take note of new partition's 'uuid' in response # Add new disk to 'cgts-vg' local volume group
# Use a partition size such that you'll be able to increase docker fs size from 30G to 60G system host-pv-add controller-0 cgts-vg <DISK_UUID>
PARTITION_SIZE=30 sleep 10 # wait for disk to be added
system host-disk-partition-add -t lvm_phys_vol ${NODE} <disk-uuid> ${PARTITION_SIZE}
# Add new partition to 'cgts-vg' local volume group # Confirm the available space and increased number of physical
system host-pv-add controller-0 cgts-vg <NEW_PARTITION_UUID> # volumes added to the cgts-vg colume group
sleep 2 # wait for partition to be added system host-lvg-list controller-0
# Increase docker filesystem to 60G # Increase docker filesystem to 60G
system host-fs-modify controller-0 docker=60 system host-fs-modify controller-0 docker=60
#. **For OpenStack only:** Configure the system setting for the vSwitch. #. **For OpenStack only:** Configure the system setting for the vSwitch.
@ -568,8 +562,24 @@ Configure controller-0
locking and unlocking controller-0 to apply the change. locking and unlocking controller-0 to apply the change.
#. **For OpenStack only:** Set up disk partition for nova-local volume #. **For OpenStack only:** Add an instances filesystem OR Set up a disk
group, which is needed for |prefix|-openstack nova ephemeral disks. based nova-local volume group, which is needed for |prefix|-openstack
nova ephemeral disks.
.. note::
Both cannot exist at the same time.
Add an 'instances' filesystem
.. code-block:: bash
export NODE=controller-0
# Create ‘instances’ filesystem
system host-fs-add ${NODE} instances=<size>
OR add a 'nova-local' volume group
.. code-block:: bash .. code-block:: bash
@ -578,29 +588,13 @@ Configure controller-0
# Create ‘nova-local’ local volume group # Create ‘nova-local’ local volume group
system host-lvg-add ${NODE} nova-local system host-lvg-add ${NODE} nova-local
# Get UUID of DISK to create PARTITION to be added to ‘nova-local’ local volume group # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume
# CEPH OSD Disks can NOT be used # group. CEPH OSD Disks can NOT be used
# For best performance, do NOT use system/root disk, use a separate physical disk.
# List host’s disks and take note of UUID of disk to be used # List host’s disks and take note of UUID of disk to be used
system host-disk-list ${NODE} system host-disk-list ${NODE}
# ( if using ROOT DISK, select disk with device_path of # Add the unused disk to the ‘nova-local’ volume group
# ‘system host-show ${NODE} | grep rootfs’ ) system host-pv-add ${NODE} nova-local <DISK_UUID>
# Create new PARTITION on selected disk, and take note of new partition’s ‘uuid’ in response
# The size of the PARTITION needs to be large enough to hold the aggregate size of
# all nova ephemeral disks of all VMs that you want to be able to host on this host,
# but is limited by the size and space available on the physical disk you chose above.
# The following example uses a small PARTITION size such that you can fit it on the
# root disk, if that is what you chose above.
# Additional PARTITION(s) from additional disks can be added later if required.
PARTITION_SIZE=30
system host-disk-partition-add -t lvm_phys_vol ${NODE} <disk-uuid> ${PARTITION_SIZE}
# Add new partition to ‘nova-local’ local volume group
system host-pv-add ${NODE} nova-local <NEW_PARTITION_UUID>
sleep 2
#. **For OpenStack only:** Configure data interfaces for controller-0. #. **For OpenStack only:** Configure data interfaces for controller-0.
Data class interfaces are vswitch interfaces used by vswitch to provide Data class interfaces are vswitch interfaces used by vswitch to provide
@ -783,37 +777,29 @@ Unlock controller-0
.. code-block:: bash .. code-block:: bash
# check existing size of docker fs # check existing size of docker fs
system host-fs-list controller-0 system host-fs-list controller-0
# check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located
system host-lvg-list controller-0
# if existing docker fs size + cgts-vg available space is less than
# 80G, you will need to add a new disk to cgts-vg.
# check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located # Get device path of BOOT DISK
system host-lvg-list controller-0 system host-show controller-0 | fgrep rootfs
# if existing docker fs size + cgts-vg available space is less than # Get UUID of ROOT DISK by listing disks
# 80G, you will need to add a new disk partition to cgts-vg. system host-disk-list controller-0
# There must be at least 20GB of available space after the docker
# filesystem is increased.
# Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. # Add new disk to 'cgts-vg' local volume group
# ( if not use another unused disk ) system host-pv-add controller-0 cgts-vg <DISK_UUID>
sleep 10 # wait for disk to be added
# Get device path of ROOT DISK # Confirm the available space and increased number of physical
system host-show controller-0 | grep rootfs # volumes added to the cgts-vg colume group
system host-lvg-list controller-0
# Get UUID of ROOT DISK by listing disks # Increase docker filesystem to 60G
system host-disk-list controller-0 system host-fs-modify controller-0 docker=60
# Create new PARTITION on ROOT DISK, and take note of new partition’s ‘uuid’ in response
# Use a partition size such that you’ll be able to increase docker fs size from 30G to 60G
PARTITION_SIZE=30
system host-disk-partition-add -t lvm_phys_vol controller-0 <root-disk-uuid> ${PARTITION_SIZE}
# Add new partition to 'cgts-vg' local volume group
system host-pv-add controller-0 cgts-vg <NEW_PARTITION_UUID>
sleep 2 # wait for partition to be added
# Increase docker filesystem to 60G
system host-fs-modify controller-0 docker=60
------------------------------------- -------------------------------------
Install software on controller-1 node Install software on controller-1 node
@ -946,34 +932,28 @@ Configure controller-1
.. code-block:: bash .. code-block:: bash
# check existing size of docker fs # check existing size of docker fs
system host-fs-list controller-0 system host-fs-list controller-1
# check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located # check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located
system host-lvg-list controller-0 system host-lvg-list controller-1
# if existing docker fs size + cgts-vg available space is less than # if existing docker fs size + cgts-vg available space is less than
# 80G, you will need to add a new disk partition to cgts-vg. # 80G, you will need to add a new disk to cgts-vg.
# There must be at least 20GB of available space after the docker
# filesystem is increased.
# Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. # Get device path of BOOT DISK
# ( if not use another unused disk ) system host-show controller-1 | fgrep rootfs
# Get device path of ROOT DISK
system host-show controller-0 --nowrap | fgrep rootfs
# Get UUID of ROOT DISK by listing disks # Get UUID of ROOT DISK by listing disks
system host-disk-list controller-0 system host-disk-list controller-1
# Create new PARTITION on ROOT DISK, and take note of new partition's 'uuid' in response # Add new disk to 'cgts-vg' local volume group
# Use a partition size such that you'll be able to increase docker fs size from 30G to 60G system host-pv-add controller-1 cgts-vg <DISK_UUID>
PARTITION_SIZE=30 sleep 10 # wait for disk to be added
system host-disk-partition-add -t lvm_phys_vol ${NODE} <disk-uuid> ${PARTITION_SIZE}
# Add new partition to 'cgts-vg' local volume group # Confirm the available space and increased number of physical
system host-pv-add controller-0 cgts-vg <NEW_PARTITION_UUID> # volumes added to the cgts-vg colume group
sleep 2 # wait for partition to be added system host-lvg-list controller-1
# Increase docker filesystem to 60G # Increase docker filesystem to 60G
system host-fs-modify controller-0 docker=60 system host-fs-modify controller-1 docker=60
#. **For OpenStack only:** Configure the host settings for the vSwitch. #. **For OpenStack only:** Configure the host settings for the vSwitch.
@ -1028,39 +1008,40 @@ Configure controller-1
system host-memory-modify -f application -1G 10 controller-1 1 system host-memory-modify -f application -1G 10 controller-1 1
#. **For OpenStack only:** Set up disk partition for nova-local volume group, #. **For OpenStack only:** Add an instances filesystem OR Set up a disk
which is needed for |prefix|-openstack nova ephemeral disks. based nova-local volume group, which is needed for |prefix|-openstack
nova ephemeral disks.
.. note::
Both cannot exist at the same time.
Add an 'instances' filesystem
.. code-block:: bash .. code-block:: bash
export NODE=controller-1 export NODE=controller-1
# Create 'nova-local' local volume group # Create ‘instances’ filesystem
system host-fs-add ${NODE} instances=<size>
OR add a 'nova-local' volume group
.. code-block:: bash
export NODE=controller-1
# Create ‘nova-local’ local volume group
system host-lvg-add ${NODE} nova-local system host-lvg-add ${NODE} nova-local
# Get UUID of DISK to create PARTITION to be added to 'nova-local' local volume group # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume
# CEPH OSD Disks can NOT be used # group. CEPH OSD Disks can NOT be used
# For best performance, do NOT use system/root disk, use a separate physical disk.
# List host’s disks and take note of UUID of disk to be used # List host’s disks and take note of UUID of disk to be used
system host-disk-list ${NODE} system host-disk-list ${NODE}
# ( if using ROOT DISK, select disk with device_path of
# ‘system host-show ${NODE} | grep rootfs’ )
# Create new PARTITION on selected disk, and take note of new partition’s ‘uuid’ in response # Add the unused disk to the ‘nova-local’ volume group
# The size of the PARTITION needs to be large enough to hold the aggregate size of system host-pv-add ${NODE} nova-local <DISK_UUID>
# all nova ephemeral disks of all VMs that you want to be able to host on this host,
# but is limited by the size and space available on the physical disk you chose above.
# The following example uses a small PARTITION size such that you can fit it on the
# root disk, if that is what you chose above.
# Additional PARTITION(s) from additional disks can be added later if required.
PARTITION_SIZE=30
system host-disk-partition-add -t lvm_phys_vol ${NODE} <disk-uuid> ${PARTITION_SIZE}
# Add new partition to 'nova-local' local volume group
system host-pv-add ${NODE} nova-local <NEW_PARTITION_UUID>
sleep 2
#. **For OpenStack only:** Configure data interfaces for controller-1. #. **For OpenStack only:** Configure data interfaces for controller-1.
Data class interfaces are vswitch interfaces used by vswitch to provide Data class interfaces are vswitch interfaces used by vswitch to provide

94
doc/source/deploy_install_guides/r7_release/bare_metal/aio_simplex_install_kubernetes.rst
View File

@ -29,7 +29,7 @@ Overview
----------------------------- -----------------------------
Minimum hardware requirements Minimum hardware requirements
----------------------------- -----------------------------
.. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest
:start-after: begin-min-hw-reqs-sx :start-after: begin-min-hw-reqs-sx
:end-before: end-min-hw-reqs-sx :end-before: end-min-hw-reqs-sx
@ -320,35 +320,29 @@ The newly installed controller needs to be configured.
.. code-block:: bash .. code-block:: bash
# check existing size of docker fs # check existing size of docker fs
~(keystone_admin)$ system host-fs-list controller-0 system host-fs-list controller-0
# check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located # check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located
~(keystone_admin)$ system host-lvg-list controller-0 system host-lvg-list controller-0
# if existing docker fs size + cgts-vg available space is less than # if existing docker fs size + cgts-vg available space is less than
# 80G, you will need to add a new disk partition to cgts-vg. # 60G, you will need to add a new disk to cgts-vg.
# There must be at least 20GB of available space after the docker
# filesystem is increased.
# Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. # Get device path of BOOT DISK
# ( if not use another unused disk ) system host-show controller-0 | fgrep rootfs
# Get device path of ROOT DISK # Get UUID of ROOT DISK by listing disks
~(keystone_admin)$ system host-show controller-0 | fgrep rootfs system host-disk-list controller-0
# Get UUID of ROOT DISK by listing disks # Add new disk to 'cgts-vg' local volume group
~(keystone_admin)$ system host-disk-list controller-0 system host-pv-add controller-0 cgts-vg <DISK_UUID>
sleep 10 # wait for disk to be added
# Create new PARTITION on ROOT DISK, and take note of new partition's 'uuid' in response # Confirm the available space and increased number of physical
# Use a partition size such that you’ll be able to increase docker fs size from 30G to 60G # volumes added to the cgts-vg colume group
~(keystone_admin)$ PARTITION_SIZE=30 system host-lvg-list controller-0
~(keystone_admin)$ system host-disk-partition-add -t lvm_phys_vol controller-0 <root-disk-uuid> ${PARTITION_SIZE}
# Add new partition to ‘cgts-vg’ local volume group # Increase docker filesystem to 60G
~(keystone_admin)$ system host-pv-add controller-0 cgts-vg <NEW_PARTITION_UUID> system host-fs-modify controller-0 docker=60
~(keystone_admin)$ sleep 2 # wait for partition to be added
# Increase docker filesystem to 60G
~(keystone_admin)$ system host-fs-modify controller-0 docker=60
#. **For OpenStack only:** Configure the system setting for the vSwitch. #. **For OpenStack only:** Configure the system setting for the vSwitch.
@ -434,40 +428,40 @@ The newly installed controller needs to be configured.
After controller-0 is unlocked, changing vswitch_type requires After controller-0 is unlocked, changing vswitch_type requires
locking and unlocking controller-0 to apply the change. locking and unlocking controller-0 to apply the change.
#. **For OpenStack only:** Set up disk partition for nova-local volume #. **For OpenStack only:** Add an instances filesystem OR Set up a disk
group, which is needed for |prefix|-openstack nova ephemeral disks. based nova-local volume group, which is needed for |prefix|-openstack
nova ephemeral disks.
.. note::
Both cannot exist at the same time.
Add an 'instances' filesystem
.. code-block:: bash .. code-block:: bash
~(keystone_admin)$ export NODE=controller-0 export NODE=controller-0
# Create ‘instances’ filesystem
system host-fs-add ${NODE} instances=<size>
OR add a 'nova-local' volume group
.. code-block:: bash
export NODE=controller-0
# Create ‘nova-local’ local volume group # Create ‘nova-local’ local volume group
~(keystone_admin)$ system host-lvg-add ${NODE} nova-local system host-lvg-add ${NODE} nova-local
# Get UUID of DISK to create PARTITION to be added to ‘nova-local’ local volume group # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume
# CEPH OSD Disks can NOT be used # group. CEPH OSD Disks can NOT be used
# For best performance, do NOT use system/root disk, use a separate physical disk.
# List host’s disks and take note of UUID of disk to be used # List host’s disks and take note of UUID of disk to be used
~(keystone_admin)$ system host-disk-list ${NODE} system host-disk-list ${NODE}
# ( if using ROOT DISK, select disk with device_path of
# host-show ${NODE} | fgrep rootfs’ )
# Create new PARTITION on selected disk, and take note of new partition’s ‘uuid’ in response
# The size of the PARTITION needs to be large enough to hold the aggregate size of
# all nova ephemeral disks of all VMs that you want to be able to host on this host,
# but is limited by the size and space available on the physical disk you chose above.
# The following example uses a small PARTITION size such that you can fit it on the
# root disk, if that is what you chose above.
# Additional PARTITION(s) from additional disks can be added later if required.
~(keystone_admin)$ PARTITION_SIZE=30
~(keystone_admin)$ system host-disk-partition-add -t lvm_phys_vol ${NODE} <disk-uuid> ${PARTITION_SIZE}
# Add new partition to ‘nova-local’ local volume group
~(keystone_admin)$ system host-pv-add ${NODE} nova-local <NEW_PARTITION_UUID>
~(keystone_admin)$ sleep 2
# Add the unused disk to the ‘nova-local’ volume group
system host-pv-add ${NODE} nova-local <DISK_UUID>
#. **For OpenStack only:** Configure data interfaces for controller-0. #. **For OpenStack only:** Configure data interfaces for controller-0.
Data class interfaces are vSwitch interfaces used by vSwitch to provide Data class interfaces are vSwitch interfaces used by vSwitch to provide

2
doc/source/deploy_install_guides/r7_release/bare_metal/bulk-host-xml-file-format.rst
View File

@ -55,7 +55,7 @@ valid values, refer to the CLI documentation.
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| console | If present, this element specifies the port, and if applicable the baud, for displaying messages. If the element is empty or not present, the default setting **ttyS0,115200** is used. | | console | If present, this element specifies the port, and if applicable the baud, for displaying messages. If the element is empty or not present, the default setting **ttyS0,115200** is used. |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| rootfs\_device | The device to use for the rootfs partition, relative to /dev. | | rootfs\_device | The root filesystem is now a logical volume cgts-vg/root-lv. This value when shown should be the same value as the boot_device. |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| boot\_device | The device to use for the boot partition, relative to /dev. | | boot\_device | The device to use for the boot partition, relative to /dev. |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

161
doc/source/deploy_install_guides/r7_release/bare_metal/controller_storage_install_kubernetes.rst
View File

@ -69,52 +69,52 @@ Install Software on Controller-0
.. .. only:: starlingx .. .. only:: starlingx
.. ..
.. .. -------- .. .. --------
.. .. Overview .. .. Overview
.. .. -------- .. .. --------
.. ..
.. .. .. include:: /shared/_includes/installation-prereqs.rest .. .. .. include:: /shared/_includes/installation-prereqs.rest
.. .. :start-after: begin-install-prereqs-std .. .. :start-after: begin-install-prereqs-std
.. .. :end-before: end-install-prereqs-std .. .. :end-before: end-install-prereqs-std
.. ..
.. --------------------- .. ---------------------
.. Hardware Requirements .. Hardware Requirements
.. --------------------- .. ---------------------
.. ..
.. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest .. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest
.. :start-after: begin-min-hw-reqs-common-intro .. :start-after: begin-min-hw-reqs-common-intro
.. :end-before: end-min-hw-reqs-common-intro .. :end-before: end-min-hw-reqs-common-intro
.. ..
.. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest .. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest
.. :start-after: begin-min-hw-reqs-std .. :start-after: begin-min-hw-reqs-std
.. :end-before: end-min-hw-reqs-std .. :end-before: end-min-hw-reqs-std
.. ..
.. The following requirements must be met for worker nodes. .. The following requirements must be met for worker nodes.
.. ..
.. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest .. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest
.. :start-after: begin-worker-hw-reqs .. :start-after: begin-worker-hw-reqs
.. :end-before: end-worker-hw-reqs .. :end-before: end-worker-hw-reqs
.. ..
.. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest .. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest
.. :start-after: start-prepare-servers-common .. :start-after: start-prepare-servers-common
.. :end-before: end-prepare-servers-common .. :end-before: end-prepare-servers-common
.. ..
.. This section describes the steps to install the StarlingX Kubernetes .. This section describes the steps to install the StarlingX Kubernetes
.. platform on a **StarlingX R7.0 Standard with Controller Storage** .. platform on a **StarlingX R7.0 Standard with Controller Storage**
.. deployment configuration. .. deployment configuration.
.. ..
.. ------------------- .. -------------------
.. Create bootable USB .. Create bootable USB
.. ------------------- .. -------------------
.. ..
.. Refer to :ref:`Bootable USB <bootable_usb>` for instructions on how to .. Refer to :ref:`Bootable USB <bootable_usb>` for instructions on how to
.. create a bootable USB with the StarlingX ISO on your system. .. create a bootable USB with the StarlingX ISO on your system.
.. ..
.. -------------------------------- .. --------------------------------
.. Install software on controller-0 .. Install software on controller-0
.. -------------------------------- .. --------------------------------
.. ..
.. .. include:: /shared/_includes/inc-install-software-on-controller.rest .. .. include:: /shared/_includes/inc-install-software-on-controller.rest
.. :start-after: incl-install-software-controller-0-standard-start .. :start-after: incl-install-software-controller-0-standard-start
.. :end-before: incl-install-software-controller-0-standard-end .. :end-before: incl-install-software-controller-0-standard-end
@ -460,35 +460,29 @@ machine.
.. code-block:: bash .. code-block:: bash
# check existing size of docker fs # check existing size of docker fs
system host-fs-list controller-0 system host-fs-list controller-0
# check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located
system host-lvg-list controller-0
# if existing docker fs size + cgts-vg available space is less than
# 60G, you will need to add a new disk to cgts-vg.
# check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located # Get device path of BOOT DISK
system host-lvg-list controller-0 system host-show controller-0 | fgrep rootfs
# if existing docker fs size + cgts-vg available space is less than # Get UUID of ROOT DISK by listing disks
# 60G, you will need to add a new disk partition to cgts-vg. system host-disk-list controller-0
# Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. # Add new disk to 'cgts-vg' local volume group
# ( if not use another unused disk ) system host-pv-add controller-0 cgts-vg <DISK_UUID>
sleep 10 # wait for disk to be added
# Get device path of ROOT DISK # Confirm the available space and increased number of physical
system host-show controller-0 | fgrep rootfs # volumes added to the cgts-vg colume group
system host-lvg-list controller-0
# Get UUID of ROOT DISK by listing disks # Increase docker filesystem to 60G
system host-disk-list controller-0 system host-fs-modify controller-0 docker=60
# Create new PARTITION on ROOT DISK, and take note of new partition’s ‘uuid’ in response
# Use a partition size such that you’ll be able to increase docker fs size from 30G to 60G
PARTITION_SIZE=30
system system host-disk-partition-add -t lvm_phys_vol controller-0 <root-disk-uuid> ${PARTITION_SIZE}
# Add new partition to ‘cgts-vg’ local volume group
system host-pv-add controller-0 cgts-vg <NEW_PARTITION_UUID>
sleep 2 # wait for partition to be added
# Increase docker filesystem to 60G
system host-fs-modify controller-0 docker=60
------------------------------------------------- -------------------------------------------------
Install software on controller-1 and worker nodes Install software on controller-1 and worker nodes
@ -641,35 +635,29 @@ machine.
.. code-block:: bash .. code-block:: bash
# check existing size of docker fs # check existing size of docker fs
system host-fs-list controller-1 system host-fs-list controller-1
# check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located
system host-lvg-list controller-1
# if existing docker fs size + cgts-vg available space is less than
# 80G, you will need to add a new disk to cgts-vg.
# check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located # Get device path of BOOT DISK
system host-lvg-list controller-1 system host-show controller-1 | fgrep rootfs
# if existing docker fs size + cgts-vg available space is less than # Get UUID of ROOT DISK by listing disks
# 60G, you will need to add a new disk partition to cgts-vg. system host-disk-list controller-1
# Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. # Add new disk to 'cgts-vg' local volume group
# ( if not use another unused disk ) system host-pv-add controller-1 cgts-vg <DISK_UUID>
sleep 10 # wait for disk to be added
# Get device path of ROOT DISK # Confirm the available space and increased number of physical
system host-show controller-1 | fgrep rootfs # volumes added to the cgts-vg colume group
system host-lvg-list controller-1
# Get UUID of ROOT DISK by listing disks # Increase docker filesystem to 60G
system host-disk-list controller-1 system host-fs-modify controller-1 docker=60
# Create new PARTITION on ROOT DISK, and take note of new partition’s ‘uuid’ in response
# Use a partition size such that you’ll be able to increase docker fs size from 30G to 60G
PARTITION_SIZE=30
system host disk-partition-add -t lvm_phys_vol controller-1 <root-disk-uuid> ${PARTITION_SIZE}
# Add new partition to ‘cgts-vg’ local volume group
system host-pv-add controller-1 cgts-vg <NEW_PARTITION_UUID>
sleep 2 # wait for partition to be added
# Increase docker filesystem to 60G
system host-fs-modify controller-1 docker=60
.. incl-unlock-controller-1-end: .. incl-unlock-controller-1-end:
@ -808,37 +796,38 @@ Configure worker nodes
done done
#. **For OpenStack only:** Setup disk partition for nova-local volume group, #. **For OpenStack only:** Add an instances filesystem OR Set up a disk
needed for |prefix|-openstack nova ephemeral disks. based nova-local volume group, which is needed for |prefix|-openstack
nova ephemeral disks.
.. note::
Both cannot exist at the same time.
Add an 'instances' filesystem
.. code-block:: bash
# Create ‘instances’ filesystem
for NODE in worker-0 worker-1; do
system host-fs-add ${NODE} instances=<size>
done
OR add a 'nova-local' volume group
.. code-block:: bash .. code-block:: bash
for NODE in worker-0 worker-1; do for NODE in worker-0 worker-1; do
system host-lvg-add ${NODE} nova-local # Create ‘nova-local’ local volume group
system host-lvg-add ${NODE} nova-local
# Get UUID of DISK to create PARTITION to be added to ‘nova-local’ local volume group # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume
# CEPH OSD Disks can NOT be used # group. CEPH OSD Disks can NOT be used. Assume /dev/sdb is unused
# For best performance, do NOT use system/root disk, use a separate physical disk. # on all workers
DISK_UUID=$(system host-disk-list ${NODE} | awk '/sdb/{print $2}')
# List host’s disks and take note of UUID of disk to be used # Add the unused disk to the ‘nova-local’ volume group
system host-disk-list ${NODE} system host-pv-add ${NODE} nova-local ${DISK_UUID}
# ( if using ROOT DISK, select disk with device_path of
# ‘system host-show ${NODE} | fgrep rootfs’ )
# Create new PARTITION on selected disk, and take note of new partition’s ‘uuid’ in response
# The size of the PARTITION needs to be large enough to hold the aggregate size of
# all nova ephemeral disks of all VMs that you want to be able to host on this host,
# but is limited by the size and space available on the physical disk you chose above.
# The following example uses a small PARTITION size such that you can fit it on the
# root disk, if that is what you chose above.
# Additional PARTITION(s) from additional disks can be added later if required.
PARTITION_SIZE=30
system host disk-partition-add -t lvm_phys_vol ${NODE} <disk-uuid> ${PARTITION_SIZE}
# Add new partition to ‘nova-local’ local volume group
system host-pv-add ${NODE} nova-local <NEW_PARTITION_UUID>
sleep 2
done done
#. **For OpenStack only:** Configure data interfaces for worker nodes. #. **For OpenStack only:** Configure data interfaces for worker nodes.

47
doc/source/deploy_install_guides/r7_release/bare_metal/dedicated_storage_install_kubernetes.rst
View File

@ -436,37 +436,34 @@ Configure worker nodes
done done
#. **For OpenStack only:** Setup disk partition for nova-local volume group, #. **For OpenStack only:** Add an instances filesystem OR Set up a disk
needed for |prefix|-openstack nova ephemeral disks. based nova-local volume group, which is needed for |prefix|-openstack
nova ephemeral disks. NOTE: both cannot exist ast the same time
Add an 'instances' filesystem
.. code-block:: bash
# Create ‘instances’ filesystem
for NODE in worker-0 worker-1; do
system host-fs-add ${NODE} instances=<size>
done
OR add a 'nova-local' volume group
.. code-block:: bash .. code-block:: bash
for NODE in worker-0 worker-1; do for NODE in worker-0 worker-1; do
system host-lvg-add ${NODE} nova-local # Create ‘nova-local’ local volume group
system host-lvg-add ${NODE} nova-local
# Get UUID of DISK to create PARTITION to be added to ‘nova-local’ local volume group # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume
# CEPH OSD Disks can NOT be used # group. CEPH OSD Disks can NOT be used. Assume /dev/sdb is unused
# For best performance, do NOT use system/root disk, use a separate physical disk. # on all workers
DISK_UUID=$(system host-disk-list ${NODE} | awk '/sdb/{print $2}')
# List host’s disks and take note of UUID of disk to be used # Add the unused disk to the ‘nova-local’ volume group
system host-disk-list ${NODE} system host-pv-add ${NODE} nova-local ${DISK_UUID}
# ( if using ROOT DISK, select disk with device_path of
# ‘system host-show ${NODE} | fgrep rootfs’ )
# Create new PARTITION on selected disk, and take note of new partition’s ‘uuid’ in response
# The size of the PARTITION needs to be large enough to hold the aggregate size of
# all nova ephemeral disks of all VMs that you want to be able to host on this host,
# but is limited by the size and space available on the physical disk you chose above.
# The following example uses a small PARTITION size such that you can fit it on the
# root disk, if that is what you chose above.
# Additional PARTITION(s) from additional disks can be added later if required.
PARTITION_SIZE=30
system hostdisk-partition-add -t lvm_phys_vol ${NODE} <disk-uuid> ${PARTITION_SIZE}
# Add new partition to ‘nova-local’ local volume group
system host-pv-add ${NODE} nova-local <NEW_PARTITION_UUID>
sleep 2
done done
#. **For OpenStack only:** Configure data interfaces for worker nodes. #. **For OpenStack only:** Configure data interfaces for worker nodes.

12
doc/source/deploy_install_guides/r7_release/bare_metal/rook_storage_install_kubernetes.rst
View File

@ -614,20 +614,14 @@ OpenStack-specific host configuration
:start-after: ref1-begin :start-after: ref1-begin
:end-before: ref1-end :end-before: ref1-end
#. **For OpenStack only:** Set up disk partition for nova-local volume group, #. **For OpenStack only:** Set up 'instances' filesystem,
which is needed for |prefix|-openstack nova ephemeral disks. which is needed for |prefix|-openstack nova ephemeral disks.
:: ::
for NODE in worker-0 worker-1; do for NODE in worker-0 worker-1; do
echo "Configuring Nova local for: $NODE" echo "Configuring 'instances' for Nova ephemeral storage: $NODE"
ROOT_DISK=$(system host-show ${NODE} | grep rootfs | awk '{print $4}') system host-fs-add ${NODE} instances=10
ROOT_DISK_UUID=$(system host-disk-list ${NODE} --nowrap | grep ${ROOT_DISK} | awk '{print $2}')
PARTITION_SIZE=10
NOVA_PARTITION=$(system host-disk-partition-add -t lvm_phys_vol ${NODE} ${ROOT_DISK_UUID} ${PARTITION_SIZE})
NOVA_PARTITION_UUID=$(echo ${NOVA_PARTITION} | grep -ow "| uuid | [a-z0-9\-]* |" | awk '{print $4}')
system host-lvg-add ${NODE} nova-local
system host-pv-add ${NODE} nova-local ${NOVA_PARTITION_UUID}
done done
-------------------- --------------------

17
doc/source/deploy_install_guides/r7_release/virtual/aio_duplex_install_kubernetes.rst
View File

@ -475,24 +475,13 @@ OpenStack-specific host configuration
system host-label-assign controller-0 sriov=enabled system host-label-assign controller-0 sriov=enabled
#. **For OpenStack only:** Set up disk partition for nova-local volume group, #. **For OpenStack only:** Set up a 'instances' filesystem,
which is needed for |prefix|-openstack nova ephemeral disks: which is needed for |prefix|-openstack nova ephemeral disks.
:: ::
export NODE=controller-1 export NODE=controller-1
system host-fs-add ${NODE} instances=34
echo ">>> Getting root disk info"
ROOT_DISK=$(system host-show ${NODE} | grep rootfs | awk '{print $4}')
ROOT_DISK_UUID=$(system host-disk-list ${NODE} --nowrap | grep ${ROOT_DISK} | awk '{print $2}')
echo "Root disk: $ROOT_DISK, UUID: $ROOT_DISK_UUID"
echo ">>>> Configuring nova-local"
NOVA_SIZE=34
NOVA_PARTITION=$(system host-disk-partition-add -t lvm_phys_vol ${NODE} ${ROOT_DISK_UUID} ${NOVA_SIZE})
NOVA_PARTITION_UUID=$(echo ${NOVA_PARTITION} | grep -ow "| uuid | [a-z0-9\-]* |" | awk '{print $4}')
system host-lvg-add ${NODE} nova-local
system host-pv-add ${NODE} nova-local ${NOVA_PARTITION_UUID}
------------------- -------------------
Unlock controller-1 Unlock controller-1

16
doc/source/deploy_install_guides/r7_release/virtual/aio_simplex_install_kubernetes.rst
View File

@ -319,25 +319,13 @@ OpenStack-specific host configuration
NOT supported, only |OVS| is supported. Therefore, simply use the default NOT supported, only |OVS| is supported. Therefore, simply use the default
|OVS| vSwitch here. |OVS| vSwitch here.
#. **For OpenStack Only:** Set up disk partition for nova-local volume group, #. **For OpenStack only:** Set up a 'instances' filesystem,
which is needed for |prefix|-openstack nova ephemeral disks. which is needed for |prefix|-openstack nova ephemeral disks.
:: ::
export NODE=controller-0 export NODE=controller-0
system host-fs-add ${NODE} instances=34
echo ">>> Getting root disk info"
ROOT_DISK=$(system host-show ${NODE} | grep rootfs | awk '{print $4}')
ROOT_DISK_UUID=$(system host-disk-list ${NODE} --nowrap | grep ${ROOT_DISK} | awk '{print $2}')
echo "Root disk: $ROOT_DISK, UUID: $ROOT_DISK_UUID"
echo ">>>> Configuring nova-local"
NOVA_SIZE=34
NOVA_PARTITION=$(system host-disk-partition-add -t lvm_phys_vol ${NODE} ${ROOT_DISK_UUID} ${NOVA_SIZE})
NOVA_PARTITION_UUID=$(echo ${NOVA_PARTITION} | grep -ow "| uuid | [a-z0-9\-]* |" | awk '{print $4}')
system host-lvg-add ${NODE} nova-local
system host-pv-add ${NODE} nova-local ${NOVA_PARTITION_UUID}
sleep 2
.. incl-config-controller-0-openstack-specific-aio-simplex-end: .. incl-config-controller-0-openstack-specific-aio-simplex-end:

18
doc/source/deploy_install_guides/r7_release/virtual/controller_storage_install_kubernetes.rst
View File

@ -523,21 +523,15 @@ OpenStack-specific host configuration
system host-label-assign controller-0 sriov=enabled system host-label-assign controller-0 sriov=enabled
#. **For OpenStack only:** Set up disk partition for nova-local volume group, #. **For OpenStack only:** Set up a 'instances' filesystem,
which is needed for |prefix|-openstack nova ephemeral disks: which is needed for |prefix|-openstack nova ephemeral disks.
:: ::
for NODE in worker-0 worker-1; do for NODE in worker-0 worker-1; do
echo "Configuring Nova local for: $NODE" echo "Configuring 'instances' for Nova ephemeral storage: $NODE"
ROOT_DISK=$(system host-show ${NODE} | grep rootfs | awk '{print $4}') system host-fs-add ${NODE} instances=10
ROOT_DISK_UUID=$(system host-disk-list ${NODE} --nowrap | grep ${ROOT_DISK} | awk '{print $2}') done
PARTITION_SIZE=10
NOVA_PARTITION=$(system host-disk-partition-add -t lvm_phys_vol ${NODE} ${ROOT_DISK_UUID} ${PARTITION_SIZE})
NOVA_PARTITION_UUID=$(echo ${NOVA_PARTITION} | grep -ow "| uuid | [a-z0-9\-]* |" | awk '{print $4}')
system host-lvg-add ${NODE} nova-local
system host-pv-add ${NODE} nova-local ${NOVA_PARTITION_UUID}
done
------------------- -------------------
Unlock worker nodes Unlock worker nodes

18
doc/source/deploy_install_guides/r7_release/virtual/dedicated_storage_install_kubernetes.rst
View File

@ -372,21 +372,15 @@ OpenStack-specific host configuration
system host-label-assign $NODE sriov=enabled system host-label-assign $NODE sriov=enabled
done done
#. **For OpenStack only:** Set up disk partition for nova-local volume group, #. **For OpenStack only:** Set up a 'instances' filesystem,
which is needed for |prefix|-openstack nova ephemeral disks: which is needed for |prefix|-openstack nova ephemeral disks.
:: ::
for NODE in worker-0 worker-1; do for NODE in worker-0 worker-1; do
echo "Configuring Nova local for: $NODE" echo "Configuring 'instances' for Nova ephemeral storage: $NODE"
ROOT_DISK=$(system host-show ${NODE} | grep rootfs | awk '{print $4}') system host-fs-add ${NODE} instances=10
ROOT_DISK_UUID=$(system host-disk-list ${NODE} --nowrap | grep ${ROOT_DISK} | awk '{print $2}') done
PARTITION_SIZE=10
NOVA_PARTITION=$(system host-disk-partition-add -t lvm_phys_vol ${NODE} ${ROOT_DISK_UUID} ${PARTITION_SIZE})
NOVA_PARTITION_UUID=$(echo ${NOVA_PARTITION} | grep -ow "| uuid | [a-z0-9\-]* |" | awk '{print $4}')
system host-lvg-add ${NODE} nova-local
system host-pv-add ${NODE} nova-local ${NOVA_PARTITION_UUID}
done
------------------- -------------------
Unlock worker nodes Unlock worker nodes

5
doc/source/deploy_install_guides/r7_release/virtual/install_virtualbox.rst
View File

@ -302,9 +302,8 @@ installation:
supports using a different disk for the boot partition. This is specified with supports using a different disk for the boot partition. This is specified with
the ``boot_device`` option. the ``boot_device`` option.
* Rootfs device: This is the device that is to be used for the rootfs and * Rootfs device: The root filesystem is now a logical volume ``cgts-vg/root-lv``.
various platform partitions. The default is ``sda``. This is specified with This value should be the same as the boot_device.
the ``rootfs_device`` option.
* Install output: Text mode vs graphical. The default is ``text``. This is * Install output: Text mode vs graphical. The default is ``text``. This is
specified with the ``install_output`` option. specified with the ``install_output`` option.

18
doc/source/deploy_install_guides/r7_release/virtual/rook_storage_install_kubernetes.rst
View File

@ -440,21 +440,15 @@ OpenStack-specific host configuration
system host-label-assign $NODE sriov=enabled system host-label-assign $NODE sriov=enabled
done done
#. **For OpenStack only:** Set up disk partition for nova-local volume group, #. **For OpenStack only:** Set up a 'instances' filesystem,
which is needed for |prefix|-openstack nova ephemeral disks: which is needed for |prefix|-openstack nova ephemeral disks.
:: ::
for NODE in worker-0 worker-1; do for NODE in worker-0 worker-1; do
echo "Configuring Nova local for: $NODE" echo "Configuring 'instances' for Nova ephemeral storage: $NODE"
ROOT_DISK=$(system host-show ${NODE} | grep rootfs | awk '{print $4}') system host-fs-add ${NODE} instances=10
ROOT_DISK_UUID=$(system host-disk-list ${NODE} --nowrap | grep ${ROOT_DISK} | awk '{print $2}') done
PARTITION_SIZE=10
NOVA_PARTITION=$(system host-disk-partition-add -t lvm_phys_vol ${NODE} ${ROOT_DISK_UUID} ${PARTITION_SIZE})
NOVA_PARTITION_UUID=$(echo ${NOVA_PARTITION} | grep -ow "| uuid | [a-z0-9\-]* |" | awk '{print $4}')
system host-lvg-add ${NODE} nova-local
system host-pv-add ${NODE} nova-local ${NOVA_PARTITION_UUID}
done
------------------- -------------------
Unlock worker nodes Unlock worker nodes

9
doc/source/storage/openstack/create-or-change-the-size-of-nova-local-storage.rst
View File

@ -14,12 +14,15 @@ you prefer, you can use the |CLI|.
You can use entire disks or disk partitions on compute hosts for use as You can use entire disks or disk partitions on compute hosts for use as
**nova-local** storage. You can add multiple disks or disk partitions. Once a **nova-local** storage. You can add multiple disks or disk partitions. Once a
disk is added and configuration is persisted through a lock/unlock, the disk disk is added and configuration is persisted through a lock/unlock, the disk
can no longer be removed. can no longer be removed. For single-disk computes you can add the 'instances'
filesystem via the :command:`host-fs-add` command. The 'instances' filesystem OR a
'nova-local' volume group can be added. Both cannot exist at the same time as
they share a common mountpoint.
.. caution:: .. caution::
If a root-disk partition on *any* compute host is used for local storage, If an 'instances' filesystem is used on *any* compute host then for
then for performance reasons, *all* VMs on the system must be booted from performance reasons, *all* VMs on the system must be booted from
Cinder volumes, and must not use ephemeral or swap disks. For more Cinder volumes, and must not use ephemeral or swap disks. For more
information, see :ref:`Storage on Compute Hosts information, see :ref:`Storage on Compute Hosts
<storage-on-compute-hosts>`. <storage-on-compute-hosts>`.