:_mod-docs-content-type: ASSEMBLY
[id="persistent-storage-using-iscsi"]
= Persistent storage using iSCSI
include::_attributes/common-attributes.adoc[]
:context: persistent-storage-iscsi

toc::[]

[role="_abstract"]
You can provision your {product-title} cluster with persistent storage by creating persistent volumes that pods can use to store and access data.

Some familiarity with Kubernetes and iSCSI is assumed.

The Kubernetes persistent volume framework allows administrators to provision a cluster with persistent storage and gives users a way to request those resources without having any knowledge of the underlying infrastructure.

[IMPORTANT]
====
High-availability of storage in the infrastructure is left to the underlying storage provider.
====

[IMPORTANT]
====
When you use iSCSI on Amazon Web Services, you must update the default security policy to include TCP traffic between nodes on the iSCSI ports. By default, they are ports `860` and `3260`.
====

[IMPORTANT]
====
Users must ensure that the iSCSI initiator is already configured on all {product-title} nodes by installing the `iscsi-initiator-utils` package and configuring their initiator name in `/etc/iscsi/initiatorname.iscsi`. The `iscsi-initiator-utils` package is already installed on deployments that use {op-system-first}. For more information, see "Managing Storage Devices".
====

[role="_additional-resources"]
.Additional resources

* link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/managing_storage_devices/index#getting-started-with-iscsi_managing-storage-devices[Getting started with iSCSI]
* link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html-single/managing_storage_devices/index#configuring-an-iscsi-initiator_managing-storage-devices[Configuring an iSCSI initiator]

include::modules/storage-persistent-storage-iscsi-provisioning.adoc[leveloffset=+1]

include::modules/storage-persistent-storage-iscsi-enforcing-disk-quota.adoc[leveloffset=+1]

include::modules/storage-persistent-storage-iscsi-volume-security.adoc[leveloffset=+1]

include::modules/storage-persistent-storage-iscsi-multipath.adoc[leveloffset=+1]

include::modules/storage-persistent-storage-iscsi-custom-initiator.adoc[leveloffset=+1]
