diff --git a/doc/source/deploy_install_guides/r7_release/bare_metal/adding-hosts-using-the-host-add-command.rst b/doc/source/deploy_install_guides/r7_release/bare_metal/adding-hosts-using-the-host-add-command.rst index f4f7fc80b..cad3d1131 100644 --- a/doc/source/deploy_install_guides/r7_release/bare_metal/adding-hosts-using-the-host-add-command.rst +++ b/doc/source/deploy_install_guides/r7_release/bare_metal/adding-hosts-using-the-host-add-command.rst @@ -111,8 +111,8 @@ scripting an initial setup. sda. **** - is the host device for rootfs partition, relative to/dev. The default - is sda. + is a logical volume cgts-vg/root-lv. The default is sda, it should be + the same value as specified for the boot_device. **** is the |MAC| address of the port connected to the internal management diff --git a/doc/source/deploy_install_guides/r7_release/bare_metal/aio_duplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/bare_metal/aio_duplex_install_kubernetes.rst index 2e4079be9..f1b4dfa55 100644 --- a/doc/source/deploy_install_guides/r7_release/bare_metal/aio_duplex_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/bare_metal/aio_duplex_install_kubernetes.rst @@ -62,7 +62,7 @@ Install Software on Controller-0 .. .. figure:: /shared/figures/deploy_install_guides/starlingx-deployment-options-duplex.png .. :width: 800 - + .. All-in-one Duplex deployment configuration .. _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 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 partition to cgts-vg. - # There must be at least 20GB of available space after the docker - # filesystem is increased. + # 80G, you will need to add a new disk to cgts-vg. - # Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. - # ( if not use another unused disk ) - - # Get device path of ROOT DISK - system host-show controller-0 --nowrap | fgrep rootfs + # Get device path of BOOT DISK + system host-show controller-0 | fgrep rootfs # Get UUID of ROOT DISK by listing disks system host-disk-list controller-0 - # 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 ${NODE} ${PARTITION_SIZE} + # Add new disk to 'cgts-vg' local volume group + system host-pv-add controller-0 cgts-vg + sleep 10 # wait for disk to be added - # Add new partition to 'cgts-vg' local volume group - system host-pv-add controller-0 cgts-vg - sleep 2 # wait for partition to be added + # Confirm the available space and increased number of physical + # volumes added to the cgts-vg colume group + system host-lvg-list controller-0 - # Increase docker filesystem to 60G - system host-fs-modify controller-0 docker=60 + # Increase docker filesystem to 60G + system host-fs-modify controller-0 docker=60 #. **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. - #. **For OpenStack only:** Set up disk partition for nova-local volume - group, which is needed for |prefix|-openstack nova ephemeral disks. + #. **For OpenStack only:** Add an instances filesystem OR Set up a disk + 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= + + OR add a 'nova-local' volume group .. code-block:: bash @@ -578,29 +588,13 @@ Configure controller-0 # 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 - # CEPH OSD Disks can NOT be used - # For best performance, do NOT use system/root disk, use a separate physical disk. + # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume + # group. CEPH OSD Disks can NOT be used # List host’s disks and take note of UUID of disk to be used 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 - # 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} ${PARTITION_SIZE} - - # Add new partition to ‘nova-local’ local volume group - system host-pv-add ${NODE} nova-local - sleep 2 + # Add the unused disk to the ‘nova-local’ volume group + system host-pv-add ${NODE} nova-local #. **For OpenStack only:** Configure data interfaces for controller-0. Data class interfaces are vswitch interfaces used by vswitch to provide @@ -783,37 +777,29 @@ Unlock controller-0 .. code-block:: bash - # check existing size of docker fs - system host-fs-list controller-0 + # check existing size of docker fs + 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 - system host-lvg-list controller-0 + # Get device path of BOOT DISK + system host-show controller-0 | fgrep rootfs - # 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. - # There must be at least 20GB of available space after the docker - # filesystem is increased. + # Get UUID of ROOT DISK by listing disks + system host-disk-list controller-0 - # Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. - # ( if not use another unused disk ) + # Add new disk to 'cgts-vg' local volume group + system host-pv-add controller-0 cgts-vg + sleep 10 # wait for disk to be added - # Get device path of ROOT DISK - system host-show controller-0 | grep rootfs + # Confirm the available space and increased number of physical + # volumes added to the cgts-vg colume group + system host-lvg-list controller-0 - # Get UUID of ROOT DISK by listing disks - system host-disk-list controller-0 - - # 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 ${PARTITION_SIZE} - - # Add new partition to 'cgts-vg' local volume group - system host-pv-add controller-0 cgts-vg - sleep 2 # wait for partition to be added - - # Increase docker filesystem to 60G - system host-fs-modify controller-0 docker=60 + # Increase docker filesystem to 60G + system host-fs-modify controller-0 docker=60 ------------------------------------- Install software on controller-1 node @@ -946,34 +932,28 @@ Configure controller-1 .. code-block:: bash # 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 - system host-lvg-list controller-0 + 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 partition to cgts-vg. - # There must be at least 20GB of available space after the docker - # filesystem is increased. + # 80G, you will need to add a new disk to cgts-vg. - # Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. - # ( if not use another unused disk ) - - # Get device path of ROOT DISK - system host-show controller-0 --nowrap | fgrep rootfs + # Get device path of BOOT DISK + system host-show controller-1 | fgrep rootfs # 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 - # 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 ${NODE} ${PARTITION_SIZE} + # Add new disk to 'cgts-vg' local volume group + system host-pv-add controller-1 cgts-vg + sleep 10 # wait for disk to be added - # Add new partition to 'cgts-vg' local volume group - system host-pv-add controller-0 cgts-vg - sleep 2 # wait for partition to be added + # Confirm the available space and increased number of physical + # volumes added to the cgts-vg colume group + system host-lvg-list controller-1 # 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. @@ -1028,39 +1008,40 @@ Configure controller-1 system host-memory-modify -f application -1G 10 controller-1 1 - #. **For OpenStack only:** Set up disk partition for nova-local volume group, - which is needed for |prefix|-openstack nova ephemeral disks. + #. **For OpenStack only:** Add an instances filesystem OR Set up a disk + 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-1 - # Create 'nova-local' local volume group + # Create ‘instances’ filesystem + system host-fs-add ${NODE} instances= + + 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 - # Get UUID of DISK to create PARTITION to be added to 'nova-local' local volume group - # CEPH OSD Disks can NOT be used - # For best performance, do NOT use system/root disk, use a separate physical disk. + # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume + # group. CEPH OSD Disks can NOT be used # List host’s disks and take note of UUID of disk to be used 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 - # 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} ${PARTITION_SIZE} - - # Add new partition to 'nova-local' local volume group - system host-pv-add ${NODE} nova-local - sleep 2 + # Add the unused disk to the ‘nova-local’ volume group + system host-pv-add ${NODE} nova-local #. **For OpenStack only:** Configure data interfaces for controller-1. Data class interfaces are vswitch interfaces used by vswitch to provide diff --git a/doc/source/deploy_install_guides/r7_release/bare_metal/aio_simplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/bare_metal/aio_simplex_install_kubernetes.rst index 025536131..739d19e26 100644 --- a/doc/source/deploy_install_guides/r7_release/bare_metal/aio_simplex_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/bare_metal/aio_simplex_install_kubernetes.rst @@ -29,7 +29,7 @@ Overview ----------------------------- Minimum hardware requirements ----------------------------- - + .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest :start-after: begin-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 - # check existing size of docker fs - ~(keystone_admin)$ system host-fs-list controller-0 - # check available space (Avail Size (GiB)) in cgts-vg LVG where docker fs is located - ~(keystone_admin)$ 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 partition to cgts-vg. - # There must be at least 20GB of available space after the docker - # filesystem is increased. + # check existing size of docker fs + 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. - # Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. - # ( if not use another unused disk ) + # Get device path of BOOT DISK + system host-show controller-0 | fgrep rootfs - # Get device path of ROOT DISK - ~(keystone_admin)$ system host-show controller-0 | fgrep rootfs + # Get UUID of ROOT DISK by listing disks + system host-disk-list controller-0 - # Get UUID of ROOT DISK by listing disks - ~(keystone_admin)$ system host-disk-list controller-0 + # Add new disk to 'cgts-vg' local volume group + system host-pv-add controller-0 cgts-vg + sleep 10 # wait for disk to be added - # 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 - ~(keystone_admin)$ PARTITION_SIZE=30 - ~(keystone_admin)$ system host-disk-partition-add -t lvm_phys_vol controller-0 ${PARTITION_SIZE} + # Confirm the available space and increased number of physical + # volumes added to the cgts-vg colume group + system host-lvg-list controller-0 - # Add new partition to ‘cgts-vg’ local volume group - ~(keystone_admin)$ system host-pv-add controller-0 cgts-vg - ~(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 + # Increase docker filesystem to 60G + system host-fs-modify controller-0 docker=60 #. **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 locking and unlocking controller-0 to apply the change. - #. **For OpenStack only:** Set up disk partition for nova-local volume - group, which is needed for |prefix|-openstack nova ephemeral disks. + #. **For OpenStack only:** Add an instances filesystem OR Set up a disk + 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 - ~(keystone_admin)$ export NODE=controller-0 + export NODE=controller-0 + + # Create ‘instances’ filesystem + system host-fs-add ${NODE} instances= + + OR add a 'nova-local' volume group + + .. code-block:: bash + + export NODE=controller-0 # 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 - # CEPH OSD Disks can NOT be used - # For best performance, do NOT use system/root disk, use a separate physical disk. + # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume + # group. CEPH OSD Disks can NOT be used # List host’s disks and take note of UUID of disk to be used - ~(keystone_admin)$ 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} ${PARTITION_SIZE} - - # Add new partition to ‘nova-local’ local volume group - ~(keystone_admin)$ system host-pv-add ${NODE} nova-local - ~(keystone_admin)$ sleep 2 + system host-disk-list ${NODE} + # Add the unused disk to the ‘nova-local’ volume group + system host-pv-add ${NODE} nova-local #. **For OpenStack only:** Configure data interfaces for controller-0. Data class interfaces are vSwitch interfaces used by vSwitch to provide diff --git a/doc/source/deploy_install_guides/r7_release/bare_metal/bulk-host-xml-file-format.rst b/doc/source/deploy_install_guides/r7_release/bare_metal/bulk-host-xml-file-format.rst index 66b2e7a24..2f0f50b08 100644 --- a/doc/source/deploy_install_guides/r7_release/bare_metal/bulk-host-xml-file-format.rst +++ b/doc/source/deploy_install_guides/r7_release/bare_metal/bulk-host-xml-file-format.rst @@ -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. | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | 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. | +-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ diff --git a/doc/source/deploy_install_guides/r7_release/bare_metal/controller_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/bare_metal/controller_storage_install_kubernetes.rst index 19494b606..a6cba369f 100644 --- a/doc/source/deploy_install_guides/r7_release/bare_metal/controller_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/bare_metal/controller_storage_install_kubernetes.rst @@ -69,52 +69,52 @@ Install Software on Controller-0 .. .. only:: starlingx -.. +.. .. .. -------- .. .. Overview .. .. -------- -.. +.. .. .. .. include:: /shared/_includes/installation-prereqs.rest .. .. :start-after: begin-install-prereqs-std .. .. :end-before: end-install-prereqs-std -.. +.. .. --------------------- .. Hardware Requirements .. --------------------- -.. +.. .. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest .. :start-after: begin-min-hw-reqs-common-intro .. :end-before: end-min-hw-reqs-common-intro -.. +.. .. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest .. :start-after: begin-min-hw-reqs-std .. :end-before: end-min-hw-reqs-std -.. +.. .. The following requirements must be met for worker nodes. -.. +.. .. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest .. :start-after: begin-worker-hw-reqs .. :end-before: end-worker-hw-reqs -.. +.. .. .. include:: /shared/_includes/prepare-servers-for-installation-91baad307173.rest .. :start-after: start-prepare-servers-common .. :end-before: end-prepare-servers-common -.. +.. .. This section describes the steps to install the StarlingX Kubernetes .. platform on a **StarlingX R7.0 Standard with Controller Storage** .. deployment configuration. -.. +.. .. ------------------- .. Create bootable USB .. ------------------- -.. +.. .. Refer to :ref:`Bootable USB ` for instructions on how to .. create a bootable USB with the StarlingX ISO on your system. -.. +.. .. -------------------------------- .. Install software on controller-0 .. -------------------------------- -.. +.. .. .. include:: /shared/_includes/inc-install-software-on-controller.rest .. :start-after: incl-install-software-controller-0-standard-start .. :end-before: incl-install-software-controller-0-standard-end @@ -460,35 +460,29 @@ machine. .. code-block:: bash - # check existing size of docker fs - system host-fs-list controller-0 + # check existing size of docker fs + 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 - system host-lvg-list controller-0 + # Get device path of BOOT DISK + system host-show controller-0 | fgrep rootfs - # if existing docker fs size + cgts-vg available space is less than - # 60G, you will need to add a new disk partition to cgts-vg. + # Get UUID of ROOT DISK by listing disks + system host-disk-list controller-0 - # Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. - # ( if not use another unused disk ) + # Add new disk to 'cgts-vg' local volume group + system host-pv-add controller-0 cgts-vg + sleep 10 # wait for disk to be added - # Get device path of ROOT DISK - system host-show controller-0 | fgrep rootfs + # Confirm the available space and increased number of physical + # volumes added to the cgts-vg colume group + system host-lvg-list controller-0 - # Get UUID of ROOT DISK by listing disks - system host-disk-list controller-0 - - # 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 ${PARTITION_SIZE} - - # Add new partition to ‘cgts-vg’ local volume group - system host-pv-add controller-0 cgts-vg - sleep 2 # wait for partition to be added - - # Increase docker filesystem to 60G - system host-fs-modify controller-0 docker=60 + # Increase docker filesystem to 60G + system host-fs-modify controller-0 docker=60 ------------------------------------------------- Install software on controller-1 and worker nodes @@ -641,35 +635,29 @@ machine. .. code-block:: bash - # check existing size of docker fs - system host-fs-list controller-1 + # check existing size of docker fs + 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 - system host-lvg-list controller-1 + # Get device path of BOOT DISK + system host-show controller-1 | fgrep rootfs - # if existing docker fs size + cgts-vg available space is less than - # 60G, you will need to add a new disk partition to cgts-vg. + # Get UUID of ROOT DISK by listing disks + system host-disk-list controller-1 - # Assuming you have unused space on ROOT DISK, add partition to ROOT DISK. - # ( if not use another unused disk ) + # Add new disk to 'cgts-vg' local volume group + system host-pv-add controller-1 cgts-vg + sleep 10 # wait for disk to be added - # Get device path of ROOT DISK - system host-show controller-1 | fgrep rootfs + # Confirm the available space and increased number of physical + # volumes added to the cgts-vg colume group + system host-lvg-list controller-1 - # Get UUID of ROOT DISK by listing disks - system host-disk-list controller-1 - - # 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 ${PARTITION_SIZE} - - # Add new partition to ‘cgts-vg’ local volume group - system host-pv-add controller-1 cgts-vg - sleep 2 # wait for partition to be added - - # Increase docker filesystem to 60G - system host-fs-modify controller-1 docker=60 + # Increase docker filesystem to 60G + system host-fs-modify controller-1 docker=60 .. incl-unlock-controller-1-end: @@ -808,37 +796,38 @@ Configure worker nodes done - #. **For OpenStack only:** Setup disk partition for nova-local volume group, - needed for |prefix|-openstack nova ephemeral disks. + #. **For OpenStack only:** Add an instances filesystem OR Set up a disk + 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= + done + + OR add a 'nova-local' volume group .. code-block:: bash 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 - # CEPH OSD Disks can NOT be used - # For best performance, do NOT use system/root disk, use a separate physical disk. + # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume + # group. CEPH OSD Disks can NOT be used. Assume /dev/sdb is unused + # 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 - system host-disk-list ${NODE} - # ( 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} ${PARTITION_SIZE} - - # Add new partition to ‘nova-local’ local volume group - system host-pv-add ${NODE} nova-local - sleep 2 + # Add the unused disk to the ‘nova-local’ volume group + system host-pv-add ${NODE} nova-local ${DISK_UUID} done #. **For OpenStack only:** Configure data interfaces for worker nodes. diff --git a/doc/source/deploy_install_guides/r7_release/bare_metal/dedicated_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/bare_metal/dedicated_storage_install_kubernetes.rst index 49f71d41b..e435f4489 100644 --- a/doc/source/deploy_install_guides/r7_release/bare_metal/dedicated_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/bare_metal/dedicated_storage_install_kubernetes.rst @@ -436,37 +436,34 @@ Configure worker nodes done - #. **For OpenStack only:** Setup disk partition for nova-local volume group, - needed for |prefix|-openstack nova ephemeral disks. + #. **For OpenStack only:** Add an instances filesystem OR Set up a disk + 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= + done + + OR add a 'nova-local' volume group .. code-block:: bash 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 - # CEPH OSD Disks can NOT be used - # For best performance, do NOT use system/root disk, use a separate physical disk. + # Get UUID of an unused DISK to to be added to the ‘nova-local’ volume + # group. CEPH OSD Disks can NOT be used. Assume /dev/sdb is unused + # 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 - system host-disk-list ${NODE} - # ( 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} ${PARTITION_SIZE} - - # Add new partition to ‘nova-local’ local volume group - system host-pv-add ${NODE} nova-local - sleep 2 + # Add the unused disk to the ‘nova-local’ volume group + system host-pv-add ${NODE} nova-local ${DISK_UUID} done #. **For OpenStack only:** Configure data interfaces for worker nodes. diff --git a/doc/source/deploy_install_guides/r7_release/bare_metal/rook_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/bare_metal/rook_storage_install_kubernetes.rst index dffd00a86..1468b633c 100644 --- a/doc/source/deploy_install_guides/r7_release/bare_metal/rook_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/bare_metal/rook_storage_install_kubernetes.rst @@ -614,20 +614,14 @@ OpenStack-specific host configuration :start-after: ref1-begin :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. :: for NODE in worker-0 worker-1; do - echo "Configuring Nova local for: $NODE" - 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}') - 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} + echo "Configuring 'instances' for Nova ephemeral storage: $NODE" + system host-fs-add ${NODE} instances=10 done -------------------- diff --git a/doc/source/deploy_install_guides/r7_release/virtual/aio_duplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/virtual/aio_duplex_install_kubernetes.rst index ab55ef9c0..ee5b86be6 100644 --- a/doc/source/deploy_install_guides/r7_release/virtual/aio_duplex_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/virtual/aio_duplex_install_kubernetes.rst @@ -475,24 +475,13 @@ OpenStack-specific host configuration system host-label-assign controller-0 sriov=enabled -#. **For OpenStack only:** Set up disk partition for nova-local volume group, - which is needed for |prefix|-openstack nova ephemeral disks: +#. **For OpenStack only:** Set up a 'instances' filesystem, + which is needed for |prefix|-openstack nova ephemeral disks. :: export NODE=controller-1 - - 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} + system host-fs-add ${NODE} instances=34 ------------------- Unlock controller-1 diff --git a/doc/source/deploy_install_guides/r7_release/virtual/aio_simplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/virtual/aio_simplex_install_kubernetes.rst index 7604d276f..6f949c303 100644 --- a/doc/source/deploy_install_guides/r7_release/virtual/aio_simplex_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/virtual/aio_simplex_install_kubernetes.rst @@ -319,25 +319,13 @@ OpenStack-specific host configuration NOT supported, only |OVS| is supported. Therefore, simply use the default |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. :: export NODE=controller-0 - - 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 + system host-fs-add ${NODE} instances=34 .. incl-config-controller-0-openstack-specific-aio-simplex-end: diff --git a/doc/source/deploy_install_guides/r7_release/virtual/controller_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/virtual/controller_storage_install_kubernetes.rst index abd9a99e2..a73d3d2eb 100644 --- a/doc/source/deploy_install_guides/r7_release/virtual/controller_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/virtual/controller_storage_install_kubernetes.rst @@ -523,21 +523,15 @@ OpenStack-specific host configuration system host-label-assign controller-0 sriov=enabled -#. **For OpenStack only:** Set up disk partition for nova-local volume group, - which is needed for |prefix|-openstack nova ephemeral disks: +#. **For OpenStack only:** Set up a 'instances' filesystem, + which is needed for |prefix|-openstack nova ephemeral disks. :: - for NODE in worker-0 worker-1; do - echo "Configuring Nova local for: $NODE" - 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}') - 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 + for NODE in worker-0 worker-1; do + echo "Configuring 'instances' for Nova ephemeral storage: $NODE" + system host-fs-add ${NODE} instances=10 + done ------------------- Unlock worker nodes diff --git a/doc/source/deploy_install_guides/r7_release/virtual/dedicated_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/virtual/dedicated_storage_install_kubernetes.rst index 0335f7710..f44ed4f05 100644 --- a/doc/source/deploy_install_guides/r7_release/virtual/dedicated_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/virtual/dedicated_storage_install_kubernetes.rst @@ -372,21 +372,15 @@ OpenStack-specific host configuration system host-label-assign $NODE sriov=enabled done -#. **For OpenStack only:** Set up disk partition for nova-local volume group, - which is needed for |prefix|-openstack nova ephemeral disks: +#. **For OpenStack only:** Set up a 'instances' filesystem, + which is needed for |prefix|-openstack nova ephemeral disks. :: - for NODE in worker-0 worker-1; do - echo "Configuring Nova local for: $NODE" - 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}') - 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 + for NODE in worker-0 worker-1; do + echo "Configuring 'instances' for Nova ephemeral storage: $NODE" + system host-fs-add ${NODE} instances=10 + done ------------------- Unlock worker nodes diff --git a/doc/source/deploy_install_guides/r7_release/virtual/install_virtualbox.rst b/doc/source/deploy_install_guides/r7_release/virtual/install_virtualbox.rst index eaeedfb72..99e527e01 100644 --- a/doc/source/deploy_install_guides/r7_release/virtual/install_virtualbox.rst +++ b/doc/source/deploy_install_guides/r7_release/virtual/install_virtualbox.rst @@ -302,9 +302,8 @@ installation: supports using a different disk for the boot partition. This is specified with the ``boot_device`` option. -* Rootfs device: This is the device that is to be used for the rootfs and - various platform partitions. The default is ``sda``. This is specified with - the ``rootfs_device`` option. +* Rootfs device: The root filesystem is now a logical volume ``cgts-vg/root-lv``. + This value should be the same as the boot_device. * Install output: Text mode vs graphical. The default is ``text``. This is specified with the ``install_output`` option. diff --git a/doc/source/deploy_install_guides/r7_release/virtual/rook_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r7_release/virtual/rook_storage_install_kubernetes.rst index d7fa0d499..1738d1e12 100644 --- a/doc/source/deploy_install_guides/r7_release/virtual/rook_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r7_release/virtual/rook_storage_install_kubernetes.rst @@ -440,21 +440,15 @@ OpenStack-specific host configuration system host-label-assign $NODE sriov=enabled done -#. **For OpenStack only:** Set up disk partition for nova-local volume group, - which is needed for |prefix|-openstack nova ephemeral disks: +#. **For OpenStack only:** Set up a 'instances' filesystem, + which is needed for |prefix|-openstack nova ephemeral disks. :: - for NODE in worker-0 worker-1; do - echo "Configuring Nova local for: $NODE" - 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}') - 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 + for NODE in worker-0 worker-1; do + echo "Configuring 'instances' for Nova ephemeral storage: $NODE" + system host-fs-add ${NODE} instances=10 + done ------------------- Unlock worker nodes diff --git a/doc/source/storage/openstack/create-or-change-the-size-of-nova-local-storage.rst b/doc/source/storage/openstack/create-or-change-the-size-of-nova-local-storage.rst index 019e85ec5..9617fa58d 100644 --- a/doc/source/storage/openstack/create-or-change-the-size-of-nova-local-storage.rst +++ b/doc/source/storage/openstack/create-or-change-the-size-of-nova-local-storage.rst @@ -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 **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 -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:: - If a root-disk partition on *any* compute host is used for local storage, - then for performance reasons, *all* VMs on the system must be booted from + If an 'instances' filesystem is used on *any* compute host then for + performance reasons, *all* VMs on the system must be booted from Cinder volumes, and must not use ephemeral or swap disks. For more information, see :ref:`Storage on Compute Hosts `.