markbase/docs/FUSE_INSTALLATION.md

FUSE-T Installation Guide

Prerequisites

Downloaded Files:

• ~/Downloads/fuse-t-1.2.6.pkg (23MB) ✅
• AJA System Test DMG ⚠️ (Need manual download)

Installation Steps

Step 1: Install FUSE-T

# Install from downloaded PKG
sudo installer -pkg ~/Downloads/fuse-t-1.2.6.pkg -target /

# Verify installation
ls -la /usr/local/bin/fuse-t
ls -la /usr/local/bin/nfs-t

# Check version
fuse-t --version  # Expected: 1.2.6
nfs-t --version

Expected Results:

• /usr/local/bin/fuse-t exists
• /usr/local/bin/nfs-t exists
• Version: 1.2.6

Step 2: Download AJA System Test

Manual Download Required:

1. Open browser: https://www.aja.com/en/products/aja-system-test
2. Click "Download" button
3. Save to ~/Downloads/AJA_System_Test.dmg
4. Verify file size: ~50-100MB (not 457KB HTML)

Installation:

# Mount DMG
hdiutil attach ~/Downloads/AJA_System_Test.dmg

# Copy to Applications
cp -R /Volumes/AJA\ System\ Test/*.app /Applications/

# Unmount
hdiutil detach /Volumes/AJA\ System\ Test

# Verify
ls -la /Applications/AJA\ System\ Test.app

Step 3: Test FUSE-T

# Test mount capability (use sshfs as example)
brew install macos-fuse-t/homebrew-cask/sshfs-fuse-t

# Mount test directory
sshfs user@localhost:/tmp /tmp/sshfs_test

# Verify
mount | grep fuse

# Unmount
umount /tmp/sshfs_test

Step 4: Permission Setup

System Settings:

1. Open System Settings → Privacy & Security
2. Files and Folders → Network Volumes → Enable
3. Full Disk Access → Add fuse-t (if needed)

Verify Permissions:

# Check if Network Volumes permission is enabled
ls -la /Network

# Test NFS mount
mount -t nfs localhost:/tmp /tmp/nfs_test
umount /tmp/nfs_test

Troubleshooting

Installation Fails

Symptom: installer: package not recognized

Solution:

# Re-download PKG
curl -L -o ~/Downloads/fuse-t-1.2.6.pkg \
  https://github.com/macos-fuse-t/fuse-t/releases/download/1.2.6/fuse-t-macos-installer-1.2.6.pkg

# Retry installation
sudo installer -pkg ~/Downloads/fuse-t-1.2.6.pkg -target /

Permission Denied

Symptom: Operation not permitted

Solution:

1. System Settings → Privacy & Security → Files and Folders
2. Enable "Network Volumes" for Terminal.app
3. Restart Terminal

Mount Fails

Symptom: mount: exec /usr/local/bin/fuse-t for /tmp/test: No such file or directory

Solution:

# Check fuse-t binary
ls -la /usr/local/bin/fuse-t

# If missing, reinstall
sudo installer -pkg ~/Downloads/fuse-t-1.2.6.pkg -target /

# Add to PATH
export PATH="/usr/local/bin:$PATH"

AJA System Test Not Found

Symptom: hdiutil: attach failed - image not recognized

Cause: Downloaded HTML page, not DMG

Solution:

1. Visit AJA website manually
2. Click actual download button
3. Verify file size >50MB

Verification Checklist

Check	Command	Expected
fuse-t binary	ls /usr/local/bin/fuse-t	File exists
fuse-t version	fuse-t --version	1.2.6
nfs-t binary	ls /usr/local/bin/nfs-t	File exists
Network Volumes	System Settings	Enabled
AJA System Test	ls /Applications/AJA\ System\ Test.app	App exists
FUSE mount works	`mount	grep fuse`

Next Steps After Installation

1. Phase 2: Implement Real FUSE

   • Add fuse crate to Cargo.toml
   • Implement MarkBaseFs operations
   • Test with warren user (12,659 nodes)

2. Phase 3: Multi-user Mount

   • MountManager implementation
   • 10 user concurrent test

3. Phase 4: Performance Test

   • AJA System Test 4K ProRes
   • 600MB/s target validation

---

Last Updated: 2026-05-17 Status: Ready for Manual Installation