# Configure storage class mount options

## **Overview**

The CSI Plugin exposes mount options that control how WEKA volumes are presented to pods. These options provide fine-grained control over storage behavior, enabling performance tuning and predictable data management for containerized workloads.

Mount options are `key–value` pairs and flags specified at volume mount time. They override default filesystem behavior and affect caching, data integrity, and filesystem limits.

Use mount options to:

* **Optimize performance:** Adjust caching and access semantics for read-heavy or write-intensive workloads (for example, `noatime`, `readcache`).
* **Enforce data integrity:** Apply stricter consistency and reliability guarantees (for example, `sync`).
* **Resolve issues:** Tune mount behavior to address performance bottlenecks or compatibility constraints.

#### Supported mount options

The CSI Plugin supports standard mount options except for the read-only (ro) option. Use the following table to identify appropriate settings for your workload.

<table><thead><tr><th width="167">Name</th><th>Description</th><th>Use case</th></tr></thead><tbody><tr><td><code>sync</code></td><td>Forces data writes to disk before the mount completes.</td><td>Databases requiring high integrity.</td></tr><tr><td><code>noatime</code></td><td>Disables access timestamp updates.</td><td>Reduces write amplification.</td></tr><tr><td><code>nodev</code></td><td>Prevents the use of device nodes.</td><td>Security-sensitive environments.</td></tr><tr><td><code>noexec</code></td><td>Disallows program execution on the volume.</td><td>Security-focused deployments.</td></tr><tr><td><code>atime</code></td><td>Enables access time recording.</td><td>Monitoring file access patterns.</td></tr><tr><td><code>diratime</code></td><td>Enables directory access time recording.</td><td>Tracking directory access.</td></tr><tr><td><code>relatime</code></td><td>Updates access times relative to modification times.</td><td>Improved performance.</td></tr><tr><td><code>data=ordered</code></td><td>Ensures sequential writes flush to disk immediately.</td><td>Strict write ordering.</td></tr></tbody></table>

## Apply custom mount options using the CSI Plugin

Define and apply custom mount options to optimize storage behavior for specific applications.

**Before you begin**

* Ensure the Kubernetes environment is accessible.
* Install and configure the kubectl command-line tool.

**Procedure**

1. Create the StorageClass:
   * Create a YAML file named `storageclass-wekafs-mountoptions.yaml`.
   * Add the following configuration:

     ```yaml
     apiVersion: storage.k8s.io/v1
     kind: StorageClass
     metadata:
       name: storageclass-wekafs-mountoptions
     provisioner: csi.weka.io
     parameters:
       mountOptions: "rw,relatime,readcache,noatime,readahead_kb=32768,dentry_max_age_positive=1000,dentry_max_age_negative=0"
     ```
   * Apply the StorageClass:

     ```bash
     kubectl apply -f storageclass-wekafs-mountoptions.yaml
     ```
2. Create the CSI secret:
   * Apply the secret to provide credentials for the CSI Plugin (example: [../common/csi-wekafs-api-secret.yaml](https://github.com/weka/csi-wekafs/blob/main/examples/common/csi-wekafs-api-secret.yaml)):

     ```bash
     kubectl apply -f ../common/csi-wekafs-api-secret.yaml
     ```
3. Provision a new volume:
   * Apply your Persistent Volume Claim (PVC) manifest that references the new StorageClass:

     ```bash
     kubectl apply -f <FILE>.yaml
     ```
4. Deploy the application:
   * Create a deployment manifest file named `csi-app-fs-mountoptions.yaml`.
   * Define the container and reference the PVC:

     ```yaml
     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: csi-app-fs-mountoptions
     spec:
       replicas: 1
       selector:
         matchLabels:
           app: csi-app-fs-mountoptions
       template:
         metadata:
           labels:
             app: csi-app-fs-mountoptions
         spec:
           containers:
           - name: csi-app-fs-mountoptions
             image: <YOUR_IMAGE>
             volumeMounts:
             - mountPath: "/data"
               name: wekafs-volume
           volumes:
           - name: wekafs-volume
             persistentVolumeClaim:
               claimName: pvc-wekafs-fs-mountoptions
     ```
   * Deploy the application:

     ```bash
     kubectl apply -f csi-app-fs-mountoptions.yaml
     ```
5. Validate the mount settings:
   * Access the application pod to check the mount status:

     ```bash
     kubectl exec csi-app-fs-mountoptions -- mount -t wekafs
     ```
   * Verify the output displays the configured options:

     ```bash
     csivol-pvc-15a45f20-Z72GJXDCEWQ5 on /data type wekafs (rw,relatime,readcache,noatime,readahead_kb=32768,dentry_max_age_positive=1000,dentry_max_age_negative=0)
     ```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.weka.io/appendices/weka-csi-plugin/tailor-your-storage-class-configuration-with-mount-options.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.