# Manage filesystems using the GUI

Using the GUI, you can perform the following actions:

* [View filesystems](#view-filesystems)
* [Create a filesystem](#create-a-filesystem)
* [Edit a filesystem](#edit-a-filesystem)
* [Delete a filesystem](#delete-a-filesystem)

## View filesystems

The filesystems are displayed on the **Filesystems** page. Each filesystem indicates the status, tiering, remote backup, encryption, SDD capacity, total capacity, filesystem group, and data reduction details.

**Procedure**

1. From the menu, select **Manage > Filesystems**.

![View filesystems example](https://1970823310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNqDzxyFrTFrLD641p0iH%2Fuploads%2FolIkQ7ZD5B1kFVyx3T12%2Fwmng_view_filesystems.png?alt=media\&token=02db23ba-0d55-4df8-a0a9-f2ca1055c0b4)

## Create a filesystem

When deploying a WEKA system on-premises, no filesystem is initially provided. You must create the filesystem and configure its properties, including capacity, group, tiering, thin provisioning, encryption, and required authentication during mounting.

When deploying a WEKA system on a cloud platform (AWS, Azure, or GCP) using Terraform or AWS CloudFormation, the WEKA system includes a default filesystem configured to maximum capacity. If your deployment necessitates additional filesystems with varied settings, reduce the provisioned capacity of the default filesystem and create a new filesystem with the desired properties to meet your specific requirements.

**Before you begin**

* Verify that the system has free capacity.
* Verify that a filesystem group is already set.
* If tiering is required, verify that an object store bucket is set.
* If encryption is required, verify that a KMS is configured.

**Procedure**

1. From the menu, select **Manage > Filesystems**.
2. Select the **+Create** button.

![Create filesystem](https://1970823310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNqDzxyFrTFrLD641p0iH%2Fuploads%2Frt7iiqX71PgqAsHEpJcu%2Fwmng_create_fs_button.png?alt=media\&token=948dd135-693e-4626-8423-c03379de1577)

3. In the **Create Filesystem** dialog, set the following:
   * **Name**: Enter a descriptive label for the filesystem, limited to 32 characters and excluding slashes (`/`) or backslashes (`\`).
   * **Group**: Select the filesystem group that fits your filesystem.
   * **Capacity**: Enter the storage size to provision, or select **Use All** to provision all the free capacity.

<figure><img src="https://1970823310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNqDzxyFrTFrLD641p0iH%2Fuploads%2FfRj8XRHtwh1RlCmRQXlT%2Fwmng_create_fs.png?alt=media&#x26;token=9d9d34e3-b769-4f76-8641-2b6e537a58bc" alt=""><figcaption><p>Create filesystem</p></figcaption></figure>

4. Optional: [**Tiering**](https://docs.weka.io/4.2/tiering/advanced-time-based-policies-for-data-storage-location#tiering-cue-policy).\
   If tiering is required, an object store bucket is already defined, and data reduction is not enabled, select the toggle button and set the details of the object store bucket:

   * **Object Store Bucket:** Select a predefined object store bucket from the list.
   * **Drive Capacity**: Enter the capacity to provision on the SSD, or select **Use All** to use all free capacity.
   * **Total Capacity**: Enter the total capacity of the object store bucket, including the drive capacity.

   When you set tiering, you can create the filesystem from an uploaded snapshot. See the related topics below.

![Tiering](https://1970823310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNqDzxyFrTFrLD641p0iH%2Fuploads%2FQcHeB7uqXgPJaHWe32OQ%2Fwmng_fs_tiering.png?alt=media\&token=aee8604d-9e44-45fb-8473-c7b6a6ba3f8b)

5. Optional: **Thin Provision**.\
   If Thin Provision is required, select the toggle button, and set the minimum (guaranteed) and the maximum capacity for the thin provisioned filesystem.\
   The minimum capacity must be less or equal to the available SSD capacity.\
   You can set any maximum capacity, but the available capacity depends on the actual free space of the SSD capacity.\
   Thin provisioning is mandatory when enabling data reduction.

![Thin provisioning](https://1970823310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNqDzxyFrTFrLD641p0iH%2Fuploads%2F3YF0JT7dmoK6sFqFctuf%2Fwmng_fs_thin_provisioning.png?alt=media\&token=0c481cc0-f871-4bc6-9a8a-160a6e6dc6ab)

6. Optional: **Data Reduction**.\
   Data reduction can be enabled only on thin provision, non-tiered, and unencrypted filesystems on a cluster with a valid data reduction license (you can verify the data reduction license in the cluster settings). For more details, see the related topics below. \
   To enable the Data Reduction, select the toggle button.

<figure><img src="https://1970823310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNqDzxyFrTFrLD641p0iH%2Fuploads%2FDHWdLEGYGPPYv7f4OGXx%2Fwmng_fs_data_reduction.png?alt=media&#x26;token=0650d3c4-d8f2-4204-841d-e2e6bfec2af3" alt=""><figcaption><p>Data reduction</p></figcaption></figure>

7. Optional: If **Encryption** is required and your WEKA system is deployed with a KMS, select the toggle button.
8. Optional: **Required Authentication**.\
   When ON, user authentication is required when mounting to the filesystem. This option is only relevant to a filesystem created in the root organization.\
   Enabling authentication is not allowed for a filesystem hosting NFS client permissions or SMB shares.\
   To authenticate during mount, the user must run the `weka user login` command or use the `auth_token_path` parameter.
9. Select **Save**.

**Related topics**

[managing-filesystem-groups](https://docs.weka.io/4.2/fs/managing-filesystem-groups "mention")

[managing-object-stores](https://docs.weka.io/4.2/fs/managing-object-stores "mention")

[kms-management](https://docs.weka.io/4.2/usage/security/kms-management "mention")

[overview](https://docs.weka.io/4.2/licensing/overview "mention")

[#data-reduction](https://docs.weka.io/4.2/overview/filesystems#data-reduction "mention")

[#create-a-filesystem-from-an-uploaded-snapshot](https://docs.weka.io/4.2/snap-to-obj/snap-to-obj#create-a-filesystem-from-an-uploaded-snapshot "mention")

## Edit a filesystem

You can modify the filesystem parameters according to your demand changes over time. The parameters you can modify include filesystem name, capacity, tiering, thin provisioning, and required authentication (but not encryption).

**Procedure**

1. From the menu, select **Manage > Filesystems**.
2. Select the three dots on the right of the filesystem you want to modify, and select **Edit**.

![Filesystem menu](https://1970823310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNqDzxyFrTFrLD641p0iH%2Fuploads%2F0E1SGuizOUpxJP6aUPWn%2Fwmng_edit_fs_menu.png?alt=media\&token=6371fd85-468d-45b1-9ad6-9596a90b7fb2)

3. In the **Edit Filesystem** dialog, modify the parameters according to your requirements. (See the parameter descriptions in the [Add a filesystem](#add-a-filesystem) topic.)

<figure><img src="https://1970823310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNqDzxyFrTFrLD641p0iH%2Fuploads%2FNPiDGAaFk6XPLJnxWb3U%2Fwmng_edit_fs.png?alt=media&#x26;token=52e5e344-1fcb-482c-a4b9-badd83c4ad7c" alt=""><figcaption><p>Edit a filesystem</p></figcaption></figure>

4. Select **Save**.

## Delete a filesystem

You can delete a filesystem if its data is no longer required. Deleting a filesystem does not delete the data in the tiered object store bucket.

{% hint style="info" %}
If you must also delete the data in the tiered object store bucket, see the [Delete a filesystem](https://docs.weka.io/4.2/fs/managing-filesystems-1#delete-a-filesystem) topic in the CLI section.
{% endhint %}

**Procedure**

1. From the menu, select **Manage > Filesystems**.
2. Select the three dots on the right of the filesystem you want to delete, and select **Remove**.
3. To confirm the filesystem deletion, enter the filesystem name and select **Confirm**.

![Delete a filesystem](https://1970823310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNqDzxyFrTFrLD641p0iH%2Fuploads%2FawgLhkEKlAjoAsKjXq6h%2Fwmng_delete_fs_animated.gif?alt=media\&token=b9f075a7-5c32-4ac1-b98a-bff7c15699a6)
