Nutanix Files
Nutanix Files (v5.0) is an enterprise-grade, software-defined, scale-out file storage solution built natively on the Nutanix Cloud Infrastructure (NCI) and Acropolis Distributed Storage Fabric (DSF). It provides high-performance, resilient, and multi-tenant file services supporting SMB (Server Message Block) and NFS (Network File System) protocols for enterprise workloads such as user profile disks (VDI), enterprise application data, home directories, healthcare PACS imaging, and big data analytics.
Nutanix Files combines:
- Multiprotocol Access: Simultaneous support for SMB 2.1, SMB 3.0, NFS v3, and NFS v4.1 on a single file server instance.
- Scale-Out Architecture: File Server Virtual Machines (FSVMs) running on Nutanix HCI nodes with independent compute and storage scaling.
- Data Protection & Disaster Recovery: Asynchronous replication, NearSync, Metro Availability (RPO = 0), and Self-Service Restore (SSR) snapshots.
- Smart Tiering: Automated offloading of cold data to S3-compatible endpoints (Nutanix Objects, AWS S3, Azure Blob, Wasabi).
- Security & Compliance: ICAP antivirus scanning, FIPS 140-2 encryption at rest, SMB wire encryption, Access-Based Enumeration (ABE), and file blocking.
- File Analytics & Auditing: Deep data intelligence engine providing audit logging, user activity tracking, anomaly detection, and ransomware alert rules.
Core Operations & Workflows
1. File Server & Share Management
Nutanix Files instances are created and managed via Prism Central or REST APIs. Standard shares run on a single FSVM node, while Distributed shares scale out across all FSVM nodes:
# Connect to CVM to inspect file server status via ncli
ncli file-server list
# List shares on a specific file server instance
ncli file-server list-shares name="fs-corp-01"
# Check FSVM cluster health and status
afsi file-server show-health
2. SMB & NFS Access Configuration
Client connections access file servers via dedicated Virtual IPs (VIPs) on the Client Network:
# Example Windows client mounting an SMB share
net use Z: \\fs-corp-01.domain.com\vdi-profiles /persistent:yes
# Example Linux client mounting an NFS export (NFS v4.1)
mount -t nfs -o vers=4.1,hard,timeo=600,retrans=2 fs-corp-01.domain.com:/app-data /mnt/app-data
3. Smart Tiering to S3 Targets
Automate tiering of cold files to Nutanix Objects or external S3 stores:
- Tiering Triggers: Set storage usage capacity thresholds (e.g., 70%) and file inactivity age (e.g., 30+ days).
- Stub File Access: Tiered files remain visible in share listings and are automatically recalled upon client access.
4. File Analytics & Security Alerts
Deploy Nutanix File Analytics to track file access operations and enforce security policies:
- Audit Logging: Logs all create, read, write, delete, and permission change events.
- Ransomware Prevention: Monitors mass file modification/deletion patterns and automatically isolates infected shares.
Progressive Disclosure Reference Index
When executing specific administration, deployment, network setup, or troubleshooting tasks for Nutanix Files, consult the detailed manual reference guides in resources/manual/:
| Topic / Requirement |
Reference File Pointer |
Key Content Covered |
| Architecture & High Availability |
resources/manual/overview-and-architecture.md |
Nutanix Files architecture, FSVMs, CVMs, Volume Groups, Minerva controller, and HA failover. |
| Prerequisites & Networking |
resources/manual/prerequisites-and-network.md |
AHV/ESXi prerequisites, FSVM sizing, network segmentation (Client vs Storage VLAN), and port matrix. |
| Deployment & Scale-Out |
resources/manual/deployment-and-scaling.md |
Prism file server deployment wizard, non-disruptive upgrades (NDU), scale-up, and scale-out. |
| Shares, SMB & NFS Protocols |
resources/manual/file-server-and-share-management.md |
Standard vs Distributed shares, SMB 2.1/3.0, NFS v3/v4, ABE, symlinks, quotas, and file blocking. |
| Directory Services & Users |
resources/manual/directory-services-and-user-management.md |
Active Directory, LDAP, Kerberos, disjoint domains, NFS-to-SMB user mapping, and RBAC roles. |
| Security, ICAP AV & Compliance |
resources/manual/security-antivirus-and-compliance.md |
ICAP antivirus (Symantec, McAfee, Trend Micro), FIPS encryption, SMB encryption, and audit logs. |
| Data Protection & Disaster Recovery |
resources/manual/data-protection-and-disaster-recovery.md |
DR replication, Metro Availability, Self-Service Restore (SSR), snapshot schedules, and share migration. |
| Smart Tiering & Cloud Storage |
resources/manual/smart-tiering-and-cloud-storage.md |
Smart Tiering to Nutanix Objects/AWS S3/Azure/Wasabi, tiering policies, capacity thresholds, recall. |
| Performance & Workload Optimization |
resources/manual/performance-and-workload-optimization.md |
Workload profiles (VDI, General, Enterprise), auto-rebalancing guardrails, inline/post compression. |
| File Analytics & Telemetry |
resources/manual/file-analytics-and-monitoring.md |
File Analytics dashboard, anomaly detection, ransomware alerts, Prometheus exporter, Syslog. |
| Files REST APIs & OData |
resources/manual/files-rest-apis.md |
Files REST APIs v4, OData filtering, ETag concurrency, API Explorer, Python/Curl automation. |
| Troubleshooting & Operations |
resources/manual/troubleshooting-and-operations.md |
FSVM CLI tools (ncli, afsi, minerva, allssh), log paths, logbay support bundles, fixes. |
| Master Documentation Index |
resources/manual/master-index.md |
Master overview map of all 12 documentation modules. |
1---2name: nutanix-files3description: Expert guidance, CLI commands, architecture reference, file server & share management, SMB/NFS protocols, directory services, smart tiering, disaster recovery, analytics, performance tuning, and troubleshooting for Nutanix Files (v5.0). Use when working with Nutanix Files, SMB/NFS file shares, file analytics, Smart Tiering, Metro Availability, Files REST APIs, or file server performance optimization.4---56# Nutanix Files78Nutanix Files (v5.0) is an enterprise-grade, software-defined, scale-out file storage solution built natively on the Nutanix Cloud Infrastructure (NCI) and Acropolis Distributed Storage Fabric (DSF). It provides high-performance, resilient, and multi-tenant file services supporting SMB (Server Message Block) and NFS (Network File System) protocols for enterprise workloads such as user profile disks (VDI), enterprise application data, home directories, healthcare PACS imaging, and big data analytics.910Nutanix Files combines:1112- **Multiprotocol Access**: Simultaneous support for SMB 2.1, SMB 3.0, NFS v3, and NFS v4.1 on a single file server instance.13- **Scale-Out Architecture**: File Server Virtual Machines (FSVMs) running on Nutanix HCI nodes with independent compute and storage scaling.14- **Data Protection & Disaster Recovery**: Asynchronous replication, NearSync, Metro Availability (RPO = 0), and Self-Service Restore (SSR) snapshots.15- **Smart Tiering**: Automated offloading of cold data to S3-compatible endpoints (Nutanix Objects, AWS S3, Azure Blob, Wasabi).16- **Security & Compliance**: ICAP antivirus scanning, FIPS 140-2 encryption at rest, SMB wire encryption, Access-Based Enumeration (ABE), and file blocking.17- **File Analytics & Auditing**: Deep data intelligence engine providing audit logging, user activity tracking, anomaly detection, and ransomware alert rules.1819---2021## Core Operations & Workflows2223### 1. File Server & Share Management2425Nutanix Files instances are created and managed via Prism Central or REST APIs. Standard shares run on a single FSVM node, while Distributed shares scale out across all FSVM nodes:2627```bash28# Connect to CVM to inspect file server status via ncli29ncli file-server list3031# List shares on a specific file server instance32ncli file-server list-shares name="fs-corp-01"3334# Check FSVM cluster health and status35afsi file-server show-health36```3738### 2. SMB & NFS Access Configuration3940Client connections access file servers via dedicated Virtual IPs (VIPs) on the Client Network:4142```bash43# Example Windows client mounting an SMB share44net use Z: \\fs-corp-01.domain.com\vdi-profiles /persistent:yes4546# Example Linux client mounting an NFS export (NFS v4.1)47mount -t nfs -o vers=4.1,hard,timeo=600,retrans=2 fs-corp-01.domain.com:/app-data /mnt/app-data48```4950### 3. Smart Tiering to S3 Targets5152Automate tiering of cold files to Nutanix Objects or external S3 stores:5354- **Tiering Triggers**: Set storage usage capacity thresholds (e.g., 70%) and file inactivity age (e.g., 30+ days).55- **Stub File Access**: Tiered files remain visible in share listings and are automatically recalled upon client access.5657### 4. File Analytics & Security Alerts5859Deploy Nutanix File Analytics to track file access operations and enforce security policies:6061- **Audit Logging**: Logs all create, read, write, delete, and permission change events.62- **Ransomware Prevention**: Monitors mass file modification/deletion patterns and automatically isolates infected shares.6364---6566## Progressive Disclosure Reference Index6768When executing specific administration, deployment, network setup, or troubleshooting tasks for Nutanix Files, consult the detailed manual reference guides in `resources/manual/`:6970| Topic / Requirement | Reference File Pointer | Key Content Covered |71| :-------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------- |72| **Architecture & High Availability** | [`resources/manual/overview-and-architecture.md`](resources/manual/overview-and-architecture.md) | Nutanix Files architecture, FSVMs, CVMs, Volume Groups, Minerva controller, and HA failover. |73| **Prerequisites & Networking** | [`resources/manual/prerequisites-and-network.md`](resources/manual/prerequisites-and-network.md) | AHV/ESXi prerequisites, FSVM sizing, network segmentation (Client vs Storage VLAN), and port matrix. |74| **Deployment & Scale-Out** | [`resources/manual/deployment-and-scaling.md`](resources/manual/deployment-and-scaling.md) | Prism file server deployment wizard, non-disruptive upgrades (NDU), scale-up, and scale-out. |75| **Shares, SMB & NFS Protocols** | [`resources/manual/file-server-and-share-management.md`](resources/manual/file-server-and-share-management.md) | Standard vs Distributed shares, SMB 2.1/3.0, NFS v3/v4, ABE, symlinks, quotas, and file blocking. |76| **Directory Services & Users** | [`resources/manual/directory-services-and-user-management.md`](resources/manual/directory-services-and-user-management.md) | Active Directory, LDAP, Kerberos, disjoint domains, NFS-to-SMB user mapping, and RBAC roles. |77| **Security, ICAP AV & Compliance** | [`resources/manual/security-antivirus-and-compliance.md`](resources/manual/security-antivirus-and-compliance.md) | ICAP antivirus (Symantec, McAfee, Trend Micro), FIPS encryption, SMB encryption, and audit logs. |78| **Data Protection & Disaster Recovery** | [`resources/manual/data-protection-and-disaster-recovery.md`](resources/manual/data-protection-and-disaster-recovery.md) | DR replication, Metro Availability, Self-Service Restore (SSR), snapshot schedules, and share migration. |79| **Smart Tiering & Cloud Storage** | [`resources/manual/smart-tiering-and-cloud-storage.md`](resources/manual/smart-tiering-and-cloud-storage.md) | Smart Tiering to Nutanix Objects/AWS S3/Azure/Wasabi, tiering policies, capacity thresholds, recall. |80| **Performance & Workload Optimization** | [`resources/manual/performance-and-workload-optimization.md`](resources/manual/performance-and-workload-optimization.md) | Workload profiles (VDI, General, Enterprise), auto-rebalancing guardrails, inline/post compression. |81| **File Analytics & Telemetry** | [`resources/manual/file-analytics-and-monitoring.md`](resources/manual/file-analytics-and-monitoring.md) | File Analytics dashboard, anomaly detection, ransomware alerts, Prometheus exporter, Syslog. |82| **Files REST APIs & OData** | [`resources/manual/files-rest-apis.md`](resources/manual/files-rest-apis.md) | Files REST APIs v4, OData filtering, ETag concurrency, API Explorer, Python/Curl automation. |83| **Troubleshooting & Operations** | [`resources/manual/troubleshooting-and-operations.md`](resources/manual/troubleshooting-and-operations.md) | FSVM CLI tools (`ncli`, `afsi`, `minerva`, `allssh`), log paths, logbay support bundles, fixes. |84| **Master Documentation Index** | [`resources/manual/master-index.md`](resources/manual/master-index.md) | Master overview map of all 12 documentation modules. |