Skip to content

Commit 89d2b98

Browse files
authored
Merge pull request #52097 from SNiemann15/lso_bypathid
[BZ2115693] Add LSO note to add serial number for IBM Z
2 parents e365f81 + f23c09b commit 89d2b98

File tree

1 file changed

+14
-3
lines changed

1 file changed

+14
-3
lines changed

modules/persistent-storage-local-create-cr.adoc

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ Local volumes cannot be created by dynamic provisioning. Instead, persistent vol
2525
Do not use different storage class names for the same device. Doing so will create multiple persistent volumes (PVs).
2626
====
2727
+
28+
--
2829
.Example: Filesystem
2930
[source,yaml]
3031
----
@@ -54,14 +55,20 @@ spec:
5455
<2> Optional: A node selector containing a list of nodes where the local storage volumes are attached. This example uses the node hostnames, obtained from `oc get node`. If a value is not defined, then the Local Storage Operator will attempt to find matching disks on all available nodes.
5556
<3> The name of the storage class to use when creating persistent volume objects. The Local Storage Operator automatically creates the storage class if it does not exist. Be sure to use a storage class that uniquely identifies this set of local volumes.
5657
<4> The volume mode, either `Filesystem` or `Block`, that defines the type of local volumes.
58+
+
59+
[NOTE]
60+
====
61+
A raw block volume (`volumeMode: Block`) is not formatted with a file system. Use this mode only if any application running on the pod can use raw block devices.
62+
====
5763
<5> The file system that is created when the local volume is mounted for the first time.
5864
<6> The path containing a list of local storage devices to choose from.
5965
<7> Replace this value with your actual local disks filepath to the `LocalVolume` resource `by-id`, such as `/dev/disk/by-id/wwn`. PVs are created for these local disks when the provisioner is deployed successfully.
6066
+
6167
[NOTE]
6268
====
63-
A raw block volume (`volumeMode: block`) is not formatted with a file system. You should use this mode only if any application running on the pod can use raw block devices.
69+
If you are running {product-title} on {ibmzProductName} with {op-system-base} KVM, you must assign a serial number to your VM disk. Otherwise, the VM disk can not be identified after reboot. You can use the `virsh edit <VM>` command to add the `<serial>mydisk</serial>` definition.
6470
====
71+
--
6572
+
6673
.Example: Block
6774
[source,yaml]
@@ -83,7 +90,7 @@ spec:
8390
- ip-10-0-144-180
8491
storageClassDevices:
8592
- storageClassName: "localblock-sc" <3>
86-
volumeMode: Block <4>
93+
volumeMode: Block <4>
8794
devicePaths: <5>
8895
- /path/to/device <6>
8996
----
@@ -93,7 +100,11 @@ spec:
93100
<4> The volume mode, either `Filesystem` or `Block`, that defines the type of local volumes.
94101
<5> The path containing a list of local storage devices to choose from.
95102
<6> Replace this value with your actual local disks filepath to the `LocalVolume` resource `by-id`, such as `dev/disk/by-id/wwn`. PVs are created for these local disks when the provisioner is deployed successfully.
96-
103+
+
104+
[NOTE]
105+
====
106+
If you are running {product-title} on {ibmzProductName} with {op-system-base} KVM, you must assign a serial number to your VM disk. Otherwise, the VM disk can not be identified after reboot. You can use the `virsh edit <VM>` command to add the `<serial>mydisk</serial>` definition.
107+
====
97108

98109
. Create the local volume resource in your {product-title} cluster. Specify the file you just created:
99110
+

0 commit comments

Comments
 (0)