# 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

```bash
# 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:**
```bash
# 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

```bash
# 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:**
```bash
# 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:**
```bash
# 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:**
```bash
# 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` | Mount entry |

## 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