mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
OCPBUGS-27913: Updated lvms installation procs
This commit is contained in:
srir
committed by
openshift-cherrypick-robot
openshift-cherrypick-robot
parent
a8d2f12981
commit
e9a8011a31
32
modules/lvms-about-lvm-storage-installation.adoc
Normal file
32
modules/lvms-about-lvm-storage-installation.adoc
Normal file
@@ -0,0 +1,32 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc
|
||||
|
||||
:_mod-docs-content-type: CONCEPT
|
||||
[id="lvms-about-lvm-storage-installation_{context}"]
|
||||
= Installing Logical Volume Manager Storage
|
||||
|
||||
You can install Logical Volume Manager (LVM) Storage on a bare metal or user-provisioned infrastructure cluster and configure it to dynamically provision storage for your workloads.
|
||||
|
||||
You can install {lvms} by using the {product-title} CLI (`oc`), {product-title} web console, or {rh-rhacm-first}.
|
||||
|
||||
[WARNING]
|
||||
====
|
||||
When using {lvms} on multi-node clusters, {lvms} only supports provisioning local storage. {lvms} does not support storage data replication mechanisms across nodes. You must ensure storage data replication through active or passive replication mechanisms to avoid a single point of failure.
|
||||
====
|
||||
|
||||
[id="lvms-deployment-requirements-for-sno-ran_{context}"]
|
||||
== Prerequisites to install LVM Storage
|
||||
|
||||
The prerequisites to install {lvms} are as follows:
|
||||
|
||||
* Before deploying {lvms}, ensure that every managed cluster has dedicated disks that are used to provision storage.
|
||||
|
||||
* Before deploying {lvms} in a private CI environment where you can reuse the storage devices that you configured in the previous {lvms} installation, ensure that you have wiped the disks that are not in use. If you do not wipe the disks before installing {lvms}, you cannot reuse the disks without manual intervention.
|
||||
+
|
||||
[NOTE]
|
||||
====
|
||||
You cannot wipe the disks that are in use.
|
||||
====
|
||||
|
||||
* If you want to install {lvms} by using {rh-rhacm-first}, ensure that you have installed {rh-rhacm} on an {product-title} cluster. See the _Installing LVM Storage using RHACM_ section.
|
||||
@@ -6,7 +6,7 @@
|
||||
[id="lvms-installing-lvms-disconnected-env_{context}"]
|
||||
= Installing {lvms} in a disconnected environment
|
||||
|
||||
You can install {lvms} on {product-title} {product-version} in a disconnected environment. All sections referenced in this procedure are linked in _Additional resources_.
|
||||
You can install {lvms} on {product-title} in a disconnected environment. All sections referenced in this procedure are linked in _Additional resources_.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
@@ -16,7 +16,7 @@ You can install {lvms} on {product-title} {product-version} in a disconnected en
|
||||
|
||||
.Procedure
|
||||
|
||||
. Follow the steps in the _Creating the image set configuration_ procedure. To create an `ImageSetConfiguration` resource for {lvms}, you can use the following example YAML file:
|
||||
. Follow the steps in the _Creating the image set configuration_ procedure. To create an `ImageSetConfiguration` custom resource (CR) for {lvms}, you can use the following example `ImageSetConfiguration` CR configuration:
|
||||
+
|
||||
include::snippets/lvms-disconnected-ImageSetConfig.adoc[]
|
||||
|
||||
|
||||
@@ -4,22 +4,20 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="install-lvms-operator-cli_{context}"]
|
||||
= Installing {lvms} with the CLI
|
||||
= Installing {lvms} by using the CLI
|
||||
|
||||
As a cluster administrator, you can install {lvms-first} by using the CLI.
|
||||
As a cluster administrator, you can install {lvms} by using the OpenShift CLI.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You have installed the OpenShift CLI (`oc`).
|
||||
|
||||
* You have logged in as a user with `cluster-admin` privileges.
|
||||
* You have logged in to {product-title} as a user with `cluster-admin` and Operator installation permissions.
|
||||
|
||||
.Procedure
|
||||
|
||||
. Create a namespace for the {lvms} Operator.
|
||||
|
||||
.. Save the following YAML in the `lvms-namespace.yaml` file:
|
||||
. Create a YAML file with the configuration for creating a namespace:
|
||||
+
|
||||
.Example YAML configuration for creating a namespace
|
||||
[source,yaml]
|
||||
----
|
||||
apiVersion: v1
|
||||
@@ -33,17 +31,16 @@ metadata:
|
||||
name: openshift-storage
|
||||
----
|
||||
|
||||
.. Create the `Namespace` CR:
|
||||
. Create the namespace by running the following command:
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
$ oc create -f lvms-namespace.yaml
|
||||
----
|
||||
$ oc create -f <file_name>
|
||||
----
|
||||
|
||||
. Create an Operator group for the {lvms} Operator.
|
||||
|
||||
.. Save the following YAML in the `lvms-operatorgroup.yaml` file:
|
||||
. Create an `OperatorGroup` CR YAML file:
|
||||
+
|
||||
.Example `OperatorGroup` CR
|
||||
[source,yaml]
|
||||
----
|
||||
apiVersion: operators.coreos.com/v1
|
||||
@@ -56,17 +53,16 @@ spec:
|
||||
- openshift-storage
|
||||
----
|
||||
|
||||
.. Create the `OperatorGroup` CR:
|
||||
. Create the `OperatorGroup` CR by running the following command:
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
$ oc create -f lvms-operatorgroup.yaml
|
||||
$ oc create -f <file_name>
|
||||
----
|
||||
|
||||
. Subscribe to the {lvms} Operator.
|
||||
|
||||
.. Save the following YAML in the `lvms-sub.yaml` file:
|
||||
. Create a `Subscription` CR YAML file:
|
||||
+
|
||||
.Example `Subscription` CR
|
||||
[source,yaml]
|
||||
----
|
||||
apiVersion: operators.coreos.com/v1alpha1
|
||||
@@ -81,14 +77,16 @@ spec:
|
||||
sourceNamespace: openshift-marketplace
|
||||
----
|
||||
|
||||
.. Create the `Subscription` CR:
|
||||
. Create the `Subscription` CR by running the following command:
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
$ oc create -f lvms-sub.yaml
|
||||
$ oc create -f <file_name>
|
||||
----
|
||||
|
||||
. To verify that the Operator is installed, enter the following command:
|
||||
.Verification
|
||||
|
||||
. To verify that {lvms} is installed, run the following command:
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
|
||||
@@ -4,33 +4,35 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="lvms-installing-lvms-with-web-console_{context}"]
|
||||
= Installing {lvms} with the web console
|
||||
= Installing {lvms} by using the web console
|
||||
|
||||
You can install {lvms-first} by using the Red Hat {product-title} OperatorHub.
|
||||
You can install {lvms} by using the {product-title} web console.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You have access to the cluster.
|
||||
* You are using an account with the `cluster-admin` and Operator installation permissions.
|
||||
* You have access to {product-title} with `cluster-admin` and Operator installation permissions.
|
||||
|
||||
.Procedure
|
||||
|
||||
. Log in to the {product-title} Web Console.
|
||||
. Log in to the {product-title} web console.
|
||||
. Click *Operators -> OperatorHub*.
|
||||
. Scroll or type `LVM Storage` into the *Filter by keyword* box to find {lvms}.
|
||||
. Click *Install*.
|
||||
. Set the following options on the *Install Operator* page:
|
||||
. Click *LVM Storage* on the *OperatorHub* page.
|
||||
. Set the following options on the *Operator Installation* page:
|
||||
.. *Update Channel* as *stable-{product-version}*.
|
||||
.. *Installation Mode* as *A specific namespace on the cluster*.
|
||||
.. *Installed Namespace* as *Operator recommended namespace openshift-storage*.
|
||||
If the `openshift-storage` namespace does not exist, it is created during the operator installation.
|
||||
.. *Approval Strategy* as *Automatic* or *Manual*.
|
||||
.. *Update approval* as *Automatic* or *Manual*.
|
||||
+
|
||||
If you select *Automatic* updates, then the Operator Lifecycle Manager (OLM) automatically updates the running instance of your Operator without any intervention.
|
||||
+
|
||||
If you select *Manual* updates, then the OLM creates an update request.
|
||||
As a cluster administrator, you must then manually approve that update request to update the Operator to a newer version.
|
||||
[NOTE]
|
||||
====
|
||||
If you select *Automatic* updates, the Operator Lifecycle Manager (OLM) automatically updates the running instance of {lvms} without any intervention.
|
||||
|
||||
If you select *Manual* updates, the OLM creates an update request.
|
||||
As a cluster administrator, you must manually approve the update request to update {lvms} to a newer version.
|
||||
====
|
||||
. Optional: Select the *Enable Operator recommended cluster monitoring on this Namespace* checkbox.
|
||||
. Click *Install*.
|
||||
|
||||
.Verification steps
|
||||
|
||||
48
modules/lvms-limitations-to-configure-size-of-devices.adoc
Normal file
48
modules/lvms-limitations-to-configure-size-of-devices.adoc
Normal file
@@ -0,0 +1,48 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc
|
||||
|
||||
:_mod-docs-content-type: CONCEPT
|
||||
[id="limitations-to-configure-size-of-devices_{context}"]
|
||||
= Limitations to configure the size of the devices to be used in LVM Storage
|
||||
|
||||
The limitations to configure the size of the devices that you can use to provision storage using {lvms} are as follows:
|
||||
|
||||
* The total storage size that you can provision is limited by the size of the underlying Logical Volume Manager (LVM) thin pool and the over-provisioning factor.
|
||||
* The size of the logical volume depends on the size of the Physical Extent (PE) and the Logical Extent (LE).
|
||||
** You can define the size of PE and LE during the physical and logical device creation.
|
||||
** The default PE and LE size is 4 MB.
|
||||
** If the size of the PE is increased, the maximum size of the LVM is determined by the kernel limits and your disk space.
|
||||
|
||||
.Size limits for different architectures using the default PE and LE size
|
||||
[cols="1,1,1,1,1", width="100%", options="header"]
|
||||
|====
|
||||
|Architecture
|
||||
|RHEL 6
|
||||
|RHEL 7
|
||||
|RHEL 8
|
||||
|RHEL 9
|
||||
|
||||
|32-bit
|
||||
|16 TB
|
||||
|-
|
||||
|-
|
||||
|-
|
||||
|
||||
|64-bit
|
||||
|
||||
|8 EB ^[1]^
|
||||
|
||||
100 TB ^[2]^
|
||||
|8 EB ^[1]^
|
||||
|
||||
500 TB ^[2]^
|
||||
|8 EB
|
||||
|8 EB
|
||||
|
||||
|====
|
||||
[.small]
|
||||
--
|
||||
1. Theoretical size.
|
||||
2. Tested size.
|
||||
--
|
||||
@@ -1,5 +1,5 @@
|
||||
:_mod-docs-content-type: SNIPPET
|
||||
.Example ImageSetConfiguration file for {lvms}
|
||||
.Example `ImageSetConfiguration` CR for {lvms}
|
||||
[source,yaml,subs="attributes+"]
|
||||
----
|
||||
kind: ImageSetConfiguration
|
||||
@@ -25,12 +25,12 @@ mirror:
|
||||
- name: registry.redhat.io/ubi9/ubi:latest <9>
|
||||
helm: {}
|
||||
----
|
||||
<1> Add `archiveSize` to set the maximum size, in GiB, of each file within the image set.
|
||||
<2> Set the back-end location to save the image set metadata to. This location can be a registry or local directory. It is required to specify `storageConfig` values, unless you are using the Technology Preview OCI feature.
|
||||
<3> Set the registry URL for the storage backend.
|
||||
<4> Set the channel to retrieve the {product-title} images from.
|
||||
<5> Add `graph: true` to generate the OpenShift Update Service (OSUS) graph image to allow for an improved cluster update experience when using the web console. For more information, see _About the OpenShift Update Service_.
|
||||
<6> Set the Operator catalog to retrieve the {product-title} images from.
|
||||
<7> Specify only certain Operator packages to include in the image set. Remove this field to retrieve all packages in the catalog.
|
||||
<8> Specify only certain channels of the Operator packages to include in the image set. You must always include the default channel for the Operator package even if you do not use the bundles in that channel. You can find the default channel by running the following command: `oc mirror list operators --catalog=<catalog_name> --package=<package_name>`.
|
||||
<9> Specify any additional images to include in image set.
|
||||
<1> Set the the maximum size (in GiB) of each file within the image set.
|
||||
<2> Specify the location in which you want to save the image set. This location can be a registry or a local directory. You must configure the `storageConfig` field unless you are using the Technology Preview OCI feature.
|
||||
<3> Specify the storage URL for the image stream when using a registry. For more information, see _Why use imagestreams_.
|
||||
<4> Specify the channel from which you want to retrieve the {product-title} images.
|
||||
<5> Set this field to `true` to generate the OpenShift Update Service (OSUS) graph image. For more information, see _About the OpenShift Update Service_.
|
||||
<6> Specify the Operator catalog from which you want to retrieve the {product-title} images.
|
||||
<7> Specify the Operator packages to include in the image set. If this field is empty, all packages in the catalog are retrieved.
|
||||
<8> Specify the channels of the Operator packages to include in the image set. You must include the default channel for the Operator package even if you do not use the bundles in that channel. You can find the default channel by running the following command: `$ oc mirror list operators --catalog=<catalog_name> --package=<package_name>`.
|
||||
<9> Specify any additional images to include in the image set.
|
||||
@@ -1,17 +1,19 @@
|
||||
:_mod-docs-content-type: ASSEMBLY
|
||||
[id="persistent-storage-using-lvms"]
|
||||
= Persistent storage using logical volume manager storage
|
||||
= Persistent storage using Logical Volume Manager Storage
|
||||
include::_attributes/common-attributes.adoc[]
|
||||
:context: logical-volume-manager-storage
|
||||
|
||||
toc::[]
|
||||
|
||||
{lvms-first} uses the TopoLVM CSI driver to dynamically provision local storage on the clusters.
|
||||
Logical Volume Manager Storage uses the TopoLVM CSI driver to dynamically provision local storage on the {product-title} clusters.
|
||||
|
||||
{lvms} creates thin-provisioned volumes using Logical Volume Manager and provides dynamic provisioning of block storage on a limited resources cluster.
|
||||
|
||||
You can create volume groups, persistent volume claims (PVCs), volume snapshots, and volume clones by using {lvms}.
|
||||
|
||||
//deploying/requirements with RHACM
|
||||
include::modules/deploying-lvms-on-sno-cluster.adoc[leveloffset=+1]
|
||||
include::modules/lvms-about-lvm-storage-installation.adoc[leveloffset=+1]
|
||||
|
||||
[role="_additional-resources"]
|
||||
.Additional resources
|
||||
@@ -39,13 +41,16 @@ include::modules/lvms-installing-logical-volume-manager-operator-disconnected-en
|
||||
|
||||
* xref:../../../openshift_images/image-configuration.adoc#images-configuration-registry-mirror_image-configuration[Configuring image registry repository mirroring]
|
||||
|
||||
* xref:../../../openshift_images/image-streams-manage.adoc#images-imagestream-use_image-configuration[Why use imagestreams]
|
||||
|
||||
include::modules/lvms-installing-logical-volume-manager-operator-using-rhacm.adoc[leveloffset=+2]
|
||||
|
||||
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/{rh-rhacm-version}/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online]
|
||||
|
||||
* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#about-lvmcluster_logical-volume-manager-storage[About the LVMCluster custom resource]
|
||||
|
||||
// Creating an LVMCluster custom resource
|
||||
// Limitations to configure the size of the devices to be used in LVM Storage
|
||||
include::modules/lvms-limitations-to-configure-size-of-devices.adoc[leveloffset=+1]
|
||||
|
||||
include::modules/lvms-about-lvmcluster-cr.adoc[leveloffset=+1]
|
||||
|
||||
@@ -115,7 +120,7 @@ include::modules/lvms-scaling-storage-of-single-node-openshift-cluster-using-rha
|
||||
[role="_additional-resources"]
|
||||
.Additional resources
|
||||
|
||||
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/{rh-rhacm-version}/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online]
|
||||
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.6/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online]
|
||||
|
||||
* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#about-lvmcluster_logical-volume-manager-storage[About the `LVMCluster` custom resource]
|
||||
|
||||
|
||||
Reference in New Issue
Block a user