diff --git a/doc/source/storage/openstack/increase-the-size-of-raw-image-uploads-in-openstack-2170f501d2e7.rst b/doc/source/storage/openstack/increase-the-size-of-raw-image-uploads-in-openstack-2170f501d2e7.rst new file mode 100644 index 000000000..4bf8c42e3 --- /dev/null +++ b/doc/source/storage/openstack/increase-the-size-of-raw-image-uploads-in-openstack-2170f501d2e7.rst @@ -0,0 +1,136 @@ + +.. _increase-the-size-of-raw-image-uploads-in-openstack-2170f501d2e7: + +=================================================== +Increase the Size of Raw Image Uploads in OpenStack +=================================================== + + +You can increase the size of raw image uploads for both **Kubelet** and/or +**Docker's Filesystem** in OpenStack, using the procedure below. + +.. rubric:: |prereq| + +- Ensure you have configured the Docker filesystem with at least 60 GB. + If not, use the following commands: + + .. code-block:: none + + # 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 partition 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 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 hostdisk-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 + +- Ensure you have configured the **Kubelet** filesystem with sufficient disk + space for the size of images you want to upload. + + The **Kubelet** filesystem size is at least 25% larger than the largest + image you need to upload. For example, to upload a 100 GB image, increase it + to 125 GB, using the following commands: + + .. code-block:: none + + # check existing size of kubelet fs + system host-fs-list controller-0 + + # check available space (Avail Size (GiB)) in cgts-vg LVG where kubelet fs is located + system host-lvg-list controller-0 + + # if existing kubelet fs size + cgts-vg available space is less than + # 125GB (or what you determined you need from above), + # you will need to add a new disk partition 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 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 kubelet fs size from 10G to 125G (example) + PARTITION_SIZE=115 + system hostdisk-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 kubelet filesystem to 125G (example) + system host-fs-modify controller-0 kubelet=125 + + +.. rubric:: |proc| + +#. When uploading an image file to OpenStack, Glance's API sets a default + timeout of 600 seconds for the upload to be completed. You cannot change + the timeout using the OpenStack :command:`image create` command. If the raw + image requires more than 10 minutes to be uploaded, for example, for a file + larger than 50 GB, use the :command:`glance image-create` command to set + the timeout. For example: + + .. code-block:: none + + ~(keystone_admin)$ glance --timeout image-create --name --file --progress --visibility