168 lines
3.7 KiB
Markdown
168 lines
3.7 KiB
Markdown
# 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 |