Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 12 additions & 9 deletions modules/installation-disk-partitioning-upi-templates.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ $ ls $HOME/clusterconfig/openshift/
...
----

. Create a Butane config that configures the additional partition. For example, name the file `$HOME/clusterconfig/98-var-partition.bu`, change the disk device name to the name of the storage device on the `worker` systems, and set the storage size as appropriate. This example places the `/var` directory on a separate partition:
. Create a Butane config that configures the additional partition. For example, name the file `$HOME/clusterconfig/98-var-partition.bu`, and set the storage size as appropriate. This example places the `/var` directory on a separate partition on the boot disk:
+
[source,yaml,subs="attributes+"]
----
Expand All @@ -95,24 +95,27 @@ metadata:
name: 98-var-partition
storage:
disks:
- device: /dev/disk/by-id/<device_name> <1>
- device: /dev/disk/by-id/coreos-boot-disk
partitions:
- label: var
start_mib: <partition_start_offset> <2>
size_mib: <partition_size> <3>
start_mib: <partition_start_offset>
size_mib: <partition_size>
number: 5
filesystems:
- device: /dev/disk/by-partlabel/var
path: /var
format: xfs
mount_options: [defaults, prjquota] <4>
mount_options: [defaults, prjquota]
with_mount_unit: true
----
+
<1> The storage device name of the disk that you want to partition.
<2> When adding a data partition to the boot disk, a minimum value of 25000 MiB (Mebibytes) is recommended. The root file system is automatically resized to fill all available space up to the specified offset. If no value is specified, or if the specified value is smaller than the recommended minimum, the resulting root file system will be too small, and future reinstalls of {op-system} might overwrite the beginning of the data partition.
<3> The size of the data partition in mebibytes.
<4> The `prjquota` mount option must be enabled for filesystems used for container storage.
where:
+
--
`start_mib`:: Specifies the starting offset of a disk partition in mebibytes (MiB). When adding a data partition to the boot disk, a minimum value of 25000 MiB is recommended. The root file system is automatically resized to fill all available space up to the specified offset. If no value is specified, or if the specified value is smaller than the recommended minimum, the resulting root file system will be too small, and future reinstalls of {op-system} might overwrite the beginning of the data partition.
`size_mib`:: Specifies the size of the data partition in mebibytes (MiB).
`mount_options`:: Specifies the configurable mount options available. The `prjquota` mount option must be enabled for filesystems used for container storage.
--
+
[NOTE]
====
Expand Down
21 changes: 12 additions & 9 deletions modules/installation-disk-partitioning.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ $ ls $HOME/clusterconfig/openshift/
...
----

. Create a Butane config that configures the additional partition. For example, name the file `$HOME/clusterconfig/98-var-partition.bu`, change the disk device name to the name of the storage device on the `worker` systems, and set the storage size as appropriate. This example places the `/var` directory on a separate partition:
. Create a Butane config that configures the additional partition. For example, name the file `$HOME/clusterconfig/98-var-partition.bu`, and set the storage size as appropriate. This example places the `/var` directory on a separate partition on the boot disk:
+
[source,yaml,subs="attributes+"]
----
Expand All @@ -93,24 +93,27 @@ metadata:
name: 98-var-partition
storage:
disks:
- device: /dev/disk/by-id/<device_name> <1>
- device: /dev/disk/by-id/coreos-boot-disk
partitions:
- label: var
start_mib: <partition_start_offset> <2>
size_mib: <partition_size> <3>
start_mib: <partition_start_offset>
size_mib: <partition_size>
number: 5
filesystems:
- device: /dev/disk/by-partlabel/var
path: /var
format: xfs
mount_options: [defaults, prjquota] <4>
mount_options: [defaults, prjquota]
with_mount_unit: true
----
+
<1> The storage device name of the disk that you want to partition.
<2> When adding a data partition to the boot disk, a minimum value of 25000 mebibytes is recommended. The root file system is automatically resized to fill all available space up to the specified offset. If no value is specified, or if the specified value is smaller than the recommended minimum, the resulting root file system will be too small, and future reinstalls of {op-system} might overwrite the beginning of the data partition.
<3> The size of the data partition in mebibytes.
<4> The `prjquota` mount option must be enabled for filesystems used for container storage.
where:
+
--
`start_mib`:: Specifies the starting offset of a disk partition in mebibytes (MiB). When adding a data partition to the boot disk, a minimum value of 25000 MiB is recommended. The root file system is automatically resized to fill all available space up to the specified offset. If no value is specified, or if the specified value is smaller than the recommended minimum, the resulting root file system will be too small, and future reinstalls of {op-system} might overwrite the beginning of the data partition.
`size_mib`:: Specifies the size of the data partition in mebibytes (MiB).
`mount_options`:: Specifies the configurable mount options available. The `prjquota` mount option must be enabled for filesystems used for container storage.
--
+
[NOTE]
====
Expand Down
5 changes: 2 additions & 3 deletions modules/installation-user-infra-machines-advanced-disk.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ metadata:
name: 98-var-partition
storage:
disks:
- device: /dev/disk/by-id/<device_name>
- device: /dev/disk/by-id/coreos-boot-disk
partitions:
- label: var
start_mib: <partition_start_offset>
Expand All @@ -108,7 +108,6 @@ storage:
+
where:
+
`<device_name>`:: Specifies the storage device name of the disk that you want to partition.
`<partition_start_offset>`:: Specifies the minimum offset value for the boot disk. For best performance, specify a minimum offset value of 25000 mebibytes. The root file system is automatically resized to fill all available space up to the specified offset. If no offset value is specified, or if the specified value is smaller than the recommended minimum, the resulting root file system will be too small, and future reinstalls of {op-system} might overwrite the beginning of the data partition.
`<partition_size>`:: Specifies the size of the data partition in mebibytes.
`mount_options`:: The `prjquota` mount option must be enabled for filesystems used for container storage.
Expand Down Expand Up @@ -160,4 +159,4 @@ ifeval::["{context}" == "installing-with-agent-based-installer"]
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:!restricted:
endif::[]
endif::[]
2 changes: 1 addition & 1 deletion modules/installation-user-infra-machines-advanced.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,4 @@ The advanced configuration topics for manual {op-system-first} installations det

ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:!restricted:
endif::[]
endif::[]