65 lines
2.0 KiB
Markdown
65 lines
2.0 KiB
Markdown
# Queue Retry Quick Reference
|
|
|
|
## What This Fixes
|
|
Previously: When a source becomes temporarily unavailable (e.g., P:\tv goes offline), the batch would fail with 25 "Folder not found" errors and stop without recovery.
|
|
|
|
Now: The batch will automatically detect this scenario and wait for the source to come back online, then automatically retry all failed items.
|
|
|
|
## Quick Start
|
|
|
|
**Default behavior** (10 minute checks for 60 minutes total):
|
|
```bash
|
|
python main.py --paths-file paths.txt
|
|
```
|
|
|
|
**Faster checks** (check every 1 minute for up to 30 minutes):
|
|
```bash
|
|
python main.py --paths-file paths.txt --retry-minutes 1 --retry-timeout 30
|
|
```
|
|
|
|
**Longer patience** (check every 5 minutes for up to 4 hours):
|
|
```bash
|
|
python main.py --paths-file paths.txt --retry-minutes 5 --retry-timeout 240
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Edit `config.xml` to change defaults:
|
|
```xml
|
|
<queue_retry>
|
|
<retry_minutes>10</retry_minutes> <!-- Change this -->
|
|
<retry_timeout>60</retry_timeout> <!-- Or this -->
|
|
</queue_retry>
|
|
```
|
|
|
|
## Key Features
|
|
|
|
✅ **Automatic detection** - Detects when source is down (2+ "Folder not found" errors)
|
|
✅ **Continuous monitoring** - Checks source availability at regular intervals
|
|
✅ **Immediate restart** - Restarts processing as soon as source is reachable
|
|
✅ **Smart timeout** - Gives up after configured timeout to prevent infinite loops
|
|
✅ **Full logging** - All retry attempts logged with timestamps
|
|
✅ **No manual intervention** - Runs completely automatically
|
|
|
|
## What Triggers Retry Logic
|
|
|
|
- Queue mode (`--paths-file`) only
|
|
- Failed count > 2
|
|
- All failures are "Folder not found" type
|
|
- At least one failed path exists but is unreachable
|
|
|
|
## What Gets Retried
|
|
|
|
Only the items that failed with "Folder not found" error are retried. Items that failed for other reasons are skipped.
|
|
|
|
## Monitoring
|
|
|
|
The system outputs clear progress messages:
|
|
- Attempt number and timing
|
|
- Elapsed vs remaining time
|
|
- What it's waiting for
|
|
- When source becomes reachable
|
|
- Final summary
|
|
|
|
All activity is logged to `logs/conversion.log.*` files.
|