azcomputerguru/claudetools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Reorganize repo: compartmentalize scripts by client/project

Browse Source 
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>
This commit is contained in:
Mike Swanson
2026-03-20 17:15:07 -07:00
parent 98ea867d2c
commit 5cbd49ce24
207 changed files with 49 additions and 547 deletions
Download Patch File Download Diff File Expand all files Collapse all files

258
projects/wrightstown-smarthome/docs/NWTOC_INDEX.md Normal file
View File

@@ -0,0 +1,258 @@
# 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**