Skip to main content

​
NFS Storage

TensorPool provides Network File System (NFS) storage that can be attached to your clusters for persistent data storage.

​
Core Commands

  • tp nfs create -s <size_gb> - Create a new NFS volume
  • tp nfs list - View all your NFS volumes
  • tp nfs attach <storage_id> <cluster_ids> - Attach storage to one or more clusters
  • tp nfs detach <storage_id> <cluster_ids> - Detach storage from one or more clusters
  • tp nfs destroy <storage_id> - Delete an NFS volume

​
Creating NFS Volumes

Create NFS volumes with a specified size in GB: 
# Create a 500GB volume
tp nfs create -s 500 --name training-data

# Create a 1TB volume with auto-generated name
tp nfs create -s 1000

​
Attaching and Detaching

Attach NFS volumes to one or more clusters: 
# Attach to a single cluster
tp nfs attach <storage_id> <cluster_id>

# Attach to multiple clusters
tp nfs attach <storage_id> <cluster_id_1> <cluster_id_2> <cluster_id_3>
Detach when you’re done: 
# Detach from a single cluster
tp nfs detach <storage_id> <cluster_id>

# Detach from multiple clusters
tp nfs detach <storage_id> <cluster_id_1> <cluster_id_2>
NFS volumes can only be attached to multi-node clusters (clusters with 2 or more nodes).

​
Storage Locations

​
NFS Volume Mount Points

When you attach an NFS volume to your cluster, it will be mounted at: 
/mnt/nfs-<storage_id>
For easy access, the storage locations are also symlinked in your home directory: 
~/nfs-<storage_id> → /mnt/nfs-<storage_id>
This allows you to access your NFS storage with simple paths like ~/nfs-abc123/ instead of /mnt/nfs-abc123/.

​
Example Workflow

# 1. Create a 1TB NFS volume named "shared-datasets"
tp nfs create -s 1000 --name shared-datasets

# 2. Attach the volume to a cluster
tp nfs attach <storage_id> <cluster_id>

# 3. SSH into your cluster and access the data
tp ssh connect <instance_id>
cd ~/nfs-<storage_id>

# 4. When done, detach the volume
tp nfs detach <storage_id> <cluster_id>

# 5. Destroy the volume when no longer needed
tp nfs destroy <storage_id>

​
Best Practices

  • Data Persistence: Use NFS volumes for important data that needs to persist across cluster lifecycles
  • Shared Data: Attach the same NFS volume to multiple clusters to share datasets
  • Cost Management: Destroy NFS volumes when they’re no longer needed to avoid storage costs

​
Next Steps

⌘I