azcomputerguru/claudetools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
claudetools/projects/wrightstown-smarthome/docs/NWTOC_INDEX.md
Mike Swanson 5cbd49ce24 Reorganize repo: compartmentalize scripts by client/project 
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>
2026-03-20 17:15:07 -07:00

7.1 KiB
Raw Permalink Blame History

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

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)

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)

# 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

Reference in New Issue View Git Blame Copy Permalink