> For the complete documentation index, see [llms.txt](https://docs.storware.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.storware.eu/protecting-storage-providers/storage-providers/nutanix-files.md).

# Nutanix Files

## Overview

Storware Backup & Recovery uses a **OS Agent-based implementation** to protect Nutanix Files shares. Backup and restore operations follow the same processing model as standard OS Agent operations.

The OS Agent runs in a **Podman container** started for each backup or restore task. When the task finishes, the container is removed.

{% hint style="danger" %}
**Note:** New OS Agent-based Nutanix Files implementation requires a full backup. The first backup after the change will be a full backup, even if an incremental backup is scheduled.
{% endhint %}

### Supported Features

| Full backup                  | Supported |
| ---------------------------- | --------- |
| Incremental backup           | Supported |
| Single-item restore          | Supported |
| Secondary backup destination | Supported |

## Protection

### Requirements

#### File Server Account

The account used to access the Nutanix File Server must:

* Be authorized as a **REST API access user** in **File Server Console → Configuration → Manage Roles**.
* Be an account other than `admin`.

For a domain account, use the format:

```
domain\username
```

#### Prism Element Account

The account used to access Prism Element must:

* Have **Cluster Admin** privileges on the cluster.
* Be an account other than `admin`.

For a domain account, use the format:

```
username@domain.local
```

#### Node and Network Access

The selected Storware Node must support running the OS Agent in a Podman container.

The Node must have network access over **TCP port 9440** to both:

* The File Server VM’s **Client Network IP**.
* The Nutanix Prism Element endpoint.

### Configure the Storage Provider

1. Go to **Storage → Infrastructure** and click **Create**.
2. Complete the required fields:

| Field                         | Description                                                                 |
| ----------------------------- | --------------------------------------------------------------------------- |
| **Type**                      | Select **Nutanix Files**.                                                   |
| **Host**                      | File Server endpoint, for example `https://<FILE_SERVER_VM_IP>:9440`.       |
| **File Server credentials**   | Login and password for the File Server account with REST API access.        |
| **Prism Element URL**         | Prism Element endpoint, for example `https://<PRISM_ELEMENT_ADDRESS>:9440`. |
| **Prism Element credentials** | Login and password for the account with Cluster Admin privileges.           |
| **Node Configuration**        | Node configuration responsible for backup and restore operations.           |

3. Click **Save**.
4. Run **inventory synchronization**.
5. Go to **Storage → Instances** and verify that the expected file systems are listed.

### Backup Operations

Full and incremental backups are supported. Backup tasks use the containerized OS Agent and follow the standard OS Agent processing model.

To configure scheduled protection:

1. Go to **Storage → Backup SLAs**.
2. Create or edit a backup SLA.
3. Assign the shares to protect.
4. Configure the backup destination, retention, and schedules.
5. Save the configuration.

Run a test backup and verify that it completes successfully.

#### Restore with Overwrite

Selecting overwrite does **not** delete or recreate the destination share.

Existing files that do not conflict with restored file names remain unchanged. When a restored file has the same name as an existing file, the **skip or overwrite option** selected in the restore wizard determines how the conflict is handled.

### Troubleshooting

OS Agent logs are included in the **Storware Node log**. Review the Node log when investigating backup or restore failures.