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_id> - Attach storage to a cluster
  • tp nfs detach <storage_id> <cluster_id> - Detach storage from a cluster
  • 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 a cluster: 
tp nfs attach <storage_id> <cluster_id>
Detach when you’re done: 
tp nfs detach <storage_id> <cluster_id>
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

​
Next Steps