Mike Swanson
5cbd49ce24
Move 150+ scripts from root and scripts/ into client/project directories: - clients/dataforth/scripts/ (110 files: AD2, sync, SSH, DB, DOS scripts) - clients/bg-builders/scripts/ (14 files: Lesley mgmt, Exchange, termination) - clients/internal-infrastructure/scripts/ (10 files: GDAP, Gitea, backups) - projects/msp-tools/scripts/ (9 files: CIPP, MSP onboarding, Datto) - projects/gururmm-agent/scripts/ (3 files: API test, JWT, record counts) - clients/glaztech/scripts/ (1 file: CentraStage removal) Also reorganized: - VPN scripts → infrastructure/vpn-configs/ - Retrieved API/JS files → api/ - Forum posts → projects/community-forum/forum-posts/ - SSH docs → clients/internal-infrastructure/docs/ - NWTOC/CTONW docs → projects/wrightstown-smarthome/docs/ - ACG website files → projects/internal/acg-website-2025/ - Dataforth docs → clients/dataforth/docs/ - schema-retrieved.sql → docs/database/ Deleted 24 tmp_*.ps1 one-off debug scripts (preserved in git history). Root reduced from 220+ files to 62 items (docs + directories only). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
259 lines
7.1 KiB
Markdown
259 lines
7.1 KiB
Markdown
# NWTOC System - Document Index
|
|
|
|
**Date:** 2026-01-19
|
|
**System:** Dataforth DOS Machine Update Workflow
|
|
**Status:** COMPLETE
|
|
|
|
---
|
|
|
|
## Quick Start
|
|
|
|
**New to this system? Start here:**
|
|
|
|
1. Read **NWTOC_COMPLETE_SUMMARY.md** (5 min overview)
|
|
2. Read **UPDATE_WORKFLOW.md** (complete guide with examples)
|
|
3. Follow **DEPLOYMENT_GUIDE.md** (step-by-step instructions)
|
|
|
|
---
|
|
|
|
## Batch Files (Production-Ready)
|
|
|
|
All files in `D:\ClaudeTools\`:
|
|
|
|
| File | Purpose | Usage |
|
|
|------|---------|-------|
|
|
| **NWTOC.BAT** | Download updates from network | `NWTOC` |
|
|
| **CTONW.BAT** | Upload local changes to network | `CTONW` or `CTONW COMMON` |
|
|
| **UPDATE.BAT** | Backup entire C:\ to network | `UPDATE` |
|
|
| **STAGE.BAT** | Stage system file updates | Called by NWTOC automatically |
|
|
| **REBOOT.BAT** | Apply system updates after reboot | Auto-generated by STAGE.BAT |
|
|
| **CHECKUPD.BAT** | Check for available updates | `CHECKUPD` |
|
|
| **STARTNET.BAT** | Start network client (existing) | Called by AUTOEXEC.BAT |
|
|
| **AUTOEXEC.BAT** | System startup (existing, template) | Runs on boot |
|
|
|
|
---
|
|
|
|
## Documentation Files
|
|
|
|
### Primary Documentation
|
|
|
|
| Document | Purpose | Read This If... |
|
|
|----------|---------|-----------------|
|
|
| **NWTOC_COMPLETE_SUMMARY.md** | Executive summary and quick reference | You want a 5-minute overview |
|
|
| **UPDATE_WORKFLOW.md** | Complete workflow guide | You want detailed examples and scenarios |
|
|
| **DEPLOYMENT_GUIDE.md** | Step-by-step deployment | You're deploying the system |
|
|
| **NWTOC_ANALYSIS.md** | Technical analysis and design | You want to understand the architecture |
|
|
|
|
### Supporting Documentation
|
|
|
|
| Document | Purpose | Read This If... |
|
|
|----------|---------|-----------------|
|
|
| **DOS_BATCH_ANALYSIS.md** | DOS 6.22 limitations and workarounds | You're debugging batch file issues |
|
|
| **NWTOC_INDEX.md** | This file - document index | You need to find something |
|
|
|
|
---
|
|
|
|
## Common Scenarios - Quick Links
|
|
|
|
### I want to...
|
|
|
|
**...understand the system**
|
|
→ Read: NWTOC_COMPLETE_SUMMARY.md
|
|
|
|
**...deploy the system**
|
|
→ Follow: DEPLOYMENT_GUIDE.md
|
|
|
|
**...learn how to use the commands**
|
|
→ Read: UPDATE_WORKFLOW.md - "Batch File Reference"
|
|
|
|
**...troubleshoot network issues**
|
|
→ Read: UPDATE_WORKFLOW.md - "Troubleshooting" section
|
|
|
|
**...rollback an update**
|
|
→ Read: UPDATE_WORKFLOW.md - "Rollback Procedures"
|
|
|
|
**...deploy a new batch file to all machines**
|
|
→ Read: UPDATE_WORKFLOW.md - "Scenario 1: Update All Machines"
|
|
|
|
**...deploy system file updates**
|
|
→ Read: UPDATE_WORKFLOW.md - "Scenario 3: Deploy New AUTOEXEC.BAT"
|
|
|
|
**...understand why something was designed this way**
|
|
→ Read: NWTOC_ANALYSIS.md - "Critical Problems to Solve"
|
|
|
|
**...know DOS 6.22 limitations**
|
|
→ Read: DOS_BATCH_ANALYSIS.md or NWTOC_ANALYSIS.md - "DOS 6.22 Limitations"
|
|
|
|
---
|
|
|
|
## File Locations
|
|
|
|
### Source Files (This Directory)
|
|
|
|
```
|
|
D:\ClaudeTools\
|
|
├── NWTOC.BAT # Network to Computer update
|
|
├── CTONW.BAT # Computer to Network upload
|
|
├── UPDATE.BAT # Full system backup
|
|
├── STAGE.BAT # System file staging
|
|
├── REBOOT.BAT # System file update (standalone version)
|
|
├── CHECKUPD.BAT # Update checker
|
|
├── STARTNET.BAT # Network startup
|
|
├── AUTOEXEC.BAT # System startup template
|
|
├── NWTOC_COMPLETE_SUMMARY.md # Executive summary
|
|
├── UPDATE_WORKFLOW.md # Complete workflow guide
|
|
├── DEPLOYMENT_GUIDE.md # Deployment instructions
|
|
├── NWTOC_ANALYSIS.md # Technical analysis
|
|
├── DOS_BATCH_ANALYSIS.md # DOS 6.22 analysis
|
|
└── NWTOC_INDEX.md # This file
|
|
```
|
|
|
|
### Deployment Targets
|
|
|
|
**AD2 Workstation:**
|
|
```
|
|
\\AD2\test\
|
|
├── COMMON\ProdSW\ # Copy all .BAT files here
|
|
├── COMMON\DOS\ # Place *.NEW files here
|
|
└── TS-*\ProdSW\ # Machine-specific files
|
|
```
|
|
|
|
**D2TESTNAS:**
|
|
```
|
|
/mnt/test/ # Same structure as AD2
|
|
T:\ (from DOS machines) # SMB share of /mnt/test
|
|
```
|
|
|
|
**DOS Machines:**
|
|
```
|
|
C:\BAT\ # NWTOC installs files here
|
|
C:\ATE\ # Machine-specific programs
|
|
C:\NET\ # Network client
|
|
```
|
|
|
|
---
|
|
|
|
## Update Path Flow
|
|
|
|
```
|
|
Admin Workstation (AD2)
|
|
↓ Place files in \\AD2\test\
|
|
D2TESTNAS (NAS)
|
|
↓ Sync every 15 min (sync-to-ad2.sh)
|
|
Network Share (T:\)
|
|
↓ User runs NWTOC
|
|
DOS Machine (C:\)
|
|
↓ System files? → STAGE.BAT
|
|
User Reboots
|
|
↓ AUTOEXEC.BAT calls REBOOT.BAT
|
|
System Updated
|
|
```
|
|
|
|
---
|
|
|
|
## Quick Command Reference
|
|
|
|
### On DOS Machine
|
|
|
|
```bat
|
|
NWTOC # Download and install updates from network
|
|
CTONW # Upload local changes to T:\TS-4R\ProdSW
|
|
CTONW COMMON # Upload local changes to T:\COMMON\ProdSW (all machines)
|
|
UPDATE # Backup C:\ to T:\TS-4R\BACKUP
|
|
CHECKUPD # Check for updates without downloading
|
|
```
|
|
|
|
### On NAS (SSH)
|
|
|
|
```bash
|
|
sudo /root/sync-to-ad2.sh # Force sync now
|
|
cat /mnt/test/_SYNC_STATUS.txt # Check sync status
|
|
tail -f /var/log/sync-to-ad2.log # Watch sync log
|
|
ls -la /mnt/test/COMMON/ProdSW # List common files
|
|
ls -la /mnt/test/TS-4R # List machine files
|
|
```
|
|
|
|
### On AD2 (PowerShell)
|
|
|
|
```powershell
|
|
# Deploy batch file to all machines
|
|
Copy-Item "D:\ClaudeTools\NWTOC.BAT" "\\AD2\test\COMMON\ProdSW\" -Force
|
|
|
|
# Deploy system file update
|
|
Copy-Item "C:\Temp\AUTOEXEC.BAT" "\\AD2\test\COMMON\DOS\AUTOEXEC.NEW" -Force
|
|
|
|
# Check sync status
|
|
Get-Content "\\AD2\test\_SYNC_STATUS.txt"
|
|
|
|
# List deployed files
|
|
Get-ChildItem "\\AD2\test\COMMON\ProdSW" -Filter *.BAT
|
|
```
|
|
|
|
---
|
|
|
|
## Testing Checklist
|
|
|
|
### Quick Test (5 minutes)
|
|
|
|
- [ ] Run `CHECKUPD` - should show current status
|
|
- [ ] Run `NWTOC` - should update files
|
|
- [ ] Verify `C:\BAT\NWTOC.BAT` exists
|
|
- [ ] Run `UPDATE` - should backup to network
|
|
|
|
### Full Test (30 minutes)
|
|
|
|
- [ ] All quick tests
|
|
- [ ] Test CTONW MACHINE upload
|
|
- [ ] Test CTONW COMMON upload
|
|
- [ ] Test system file update (AUTOEXEC.NEW)
|
|
- [ ] Verify STAGE.BAT creates backups
|
|
- [ ] Verify REBOOT.BAT runs on boot
|
|
- [ ] Test rollback from .SAV files
|
|
- [ ] Verify network backup exists
|
|
|
|
---
|
|
|
|
## Support Contact
|
|
|
|
**For questions about:**
|
|
|
|
- **System design:** See NWTOC_ANALYSIS.md
|
|
- **Deployment:** See DEPLOYMENT_GUIDE.md
|
|
- **Usage:** See UPDATE_WORKFLOW.md
|
|
- **Troubleshooting:** See UPDATE_WORKFLOW.md - "Troubleshooting" section
|
|
- **DOS 6.22 issues:** See DOS_BATCH_ANALYSIS.md
|
|
|
|
---
|
|
|
|
## Version History
|
|
|
|
| Date | Version | Changes |
|
|
|------|---------|---------|
|
|
| 2026-01-19 | 1.0 | Initial release - Complete system implementation |
|
|
|
|
---
|
|
|
|
## Document Statistics
|
|
|
|
**Total batch files:** 8 (6 new, 2 existing)
|
|
**Total documentation files:** 6
|
|
**Total pages (approx):** 100+
|
|
**Lines of code (batch files):** ~1,500
|
|
**Lines of documentation:** ~3,500
|
|
|
|
---
|
|
|
|
**Quick Navigation:**
|
|
|
|
- **Start Here:** NWTOC_COMPLETE_SUMMARY.md
|
|
- **Workflow Guide:** UPDATE_WORKFLOW.md
|
|
- **Deploy System:** DEPLOYMENT_GUIDE.md
|
|
- **Technical Details:** NWTOC_ANALYSIS.md
|
|
- **DOS 6.22 Info:** DOS_BATCH_ANALYSIS.md
|
|
- **This Index:** NWTOC_INDEX.md
|
|
|
|
---
|
|
|
|
**Status: COMPLETE - Ready for Deployment**
|
|
**Date: 2026-01-19**
|