Upgrade legacy persistent volumes for capacity enforcement
Last updated
Last updated
Capacity enforcement and integration with the WEKA filesystem directory quotas require the following prerequisites:
WEKA CSI Plugin version 0.7.0 and up.
WEKA software version v3.13.0 and up.
WEKA CSI Plugin can communicate with the WEKA filesystem using REST API and correlate between a specific persistent volume and the WEKA cluster serving this volume.
In the , Kubernetes StorageClass refers to a secret that specifies all the required parameters for API calls to the WEKA cluster. However, this is different from the situation in the legacy communication model, where the storage class doesn't specify the API credentials.
Kubernetes does not allow modifying the StorageClass parameters; hence every volume created with the legacy-model storage class never reports its credentials.
WEKA CSI Plugin 0.7.0 provides a unique configuration mode in which legacy volumes can be bound to a single secret, referring to a single WEKA cluster API connection parameters. In this configuration mode, every request to serve, such as create, delete, and expand, a legacy Persistent Volume (or Persistent Volume Claim) that originates from a Legacy Storage Class (without reference to an API secret) communicates to that cluster.
To bind legacy volumes to a single secret, perform the following:
Create a Kubernetes secret that describes the API communication parameters for legacy volumes. Adhere to the following:
The format of the secret is identical to the secret defined in the section.
This secret must be located in the same Kubernetes namespace of the WEKA CSI Plugin.
Set the legacyVolumeSecretName parameter to match the secret's name above during the plugin upgrade or installation. Do one of the following:
You can modify the values.yaml directly.
Create the Kubernetes secret and only then set the legacyVolumeSecretName parameter during the Helm upgrade as follows:
If you do not create the Kubernetes secret before executing the helm upgrade, the CSI Plugin components remain Pending after the upgrade.
Once you bind legacy volumes to a single secret procedure, you can migrate the volumes by binding a new WEKA filesystem directory quota object to an existing persistent volume.
WEKA provides a migration script that automates the process.
Run the migration procedure only once from any Linux server connected to the same WEKA cluster. Additional script runs migrate only those volumes created in legacy mode after migration. It is safe to run the migration script multiple times, although usually, this is not required.
The migration process might take significant time and depends on the number of persistent volumes and their capacity. The migration process is transparent and does not require downtime.
The migration script requires several dependencies, which must be installed in advance: jq, xattr, getfattr, and setfattr.
Refer to the specific OS package management documentation to install the necessary packages.
Check the csi-wekafs repository from any server connected to the WEKA cluster:
Run the migration script using the following command line (for multiple filesystems, run the command line for each filesystem):
Where:
<filesystem_name>: Specifies the filesystem name on which the CSI volumes are located.
<csi_volumes_dir>: Optional parameter. Specifies the directory in the filesystem where the CSI volumes are stored. Set this parameter only if the directory differs from default values.
Example: