Session修改:Mutex死锁修复+AGENTS更新
This commit is contained in:
168
docs/FUSE_INSTALLATION.md
Normal file
168
docs/FUSE_INSTALLATION.md
Normal file
@@ -0,0 +1,168 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user