azcomputerguru/claudetools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
925a76978680c4f1784931444e6ead59df302a0d
claudetools/NWTOC_INDEX.md
Mike Swanson 3faf09c111 feat: Complete DOS update system with test data routing fix 
Implemented comprehensive DOS 6.22 update system for ~30 test stations with
critical fix for test data database import routing.

## Major Changes

### DOS Batch Files (7 files)
- NWTOC.BAT: Download updates from network to DOS machines
- CTONW.BAT v1.2: Upload with separate ProdSW/LOGS routing (CRITICAL FIX)
- UPDATE.BAT: Full system backup to network
- STAGE.BAT: System file staging for safe updates
- REBOOT.BAT: Apply staged updates on reboot
- CHECKUPD.BAT: Check for available updates
- DEPLOY.BAT: One-time deployment installer for DOS machines

### CTONW v1.2 Critical Fix
Fixed test data routing to match AD2 sync script expectations:
- Software distribution: C:\ATE\*.EXE -> T:\TS-4R\ProdSW\ (bidirectional)
- Test data logging: C:\ATE\8BDATA\*.DAT -> T:\TS-4R\LOGS\8BLOG\ (upload only)
- Subdirectory mapping: 8BDATA->8BLOG, DSCDATA->DSCLOG, HVDATA->HVLOG, etc.
- Test data now correctly imported to AD2 database via Sync-FromNAS.ps1

### Deployment Infrastructure
- copy-to-ad2.ps1: Automated deployment to AD2 server
- DOS_DEPLOYMENT_GUIDE.md: Complete deployment documentation
- DEPLOYMENT_GUIDE.md: Technical workflow documentation
- credentials.md: Centralized credentials (AD2, NAS, Gitea)

### Analysis & Documentation (15 files)
- CTONW_ANALYSIS.md: Comprehensive compliance analysis
- CTONW_V1.2_CHANGELOG.md: Detailed v1.2 changes
- NWTOC_ANALYSIS.md: Download workflow analysis
- DOS_BATCH_ANALYSIS.md: DOS 6.22 compatibility guide
- UPDATE_WORKFLOW.md: Backup system workflow
- BEHAVIORAL_RULES_INTEGRATION_SUMMARY.md: C: drive integration

### Session Logs
- session-logs/2026-01-19-session.md: Complete session documentation

### Conversation Reorganization
- Cleaned up 156 imported conversation files
- Organized into sessions-by-date structure
- Created metadata index and large files guide

## Technical Details

### AD2 → NAS → DOS Sync Flow
1. Admin copies files to AD2: \192.168.0.6\C$\Shares\test\
2. Sync-FromNAS.ps1 runs every 15 minutes (AD2 → NAS)
3. DOS machines access via T: drive (\D2TESTNAS\test)
4. NWTOC downloads updates, CTONW uploads test data
5. Sync imports test data to AD2 database

### DOS 6.22 Compatibility
- No %COMPUTERNAME%, uses %MACHINE% variable
- No IF /I, uses multiple case-specific checks
- Proper ERRORLEVEL checking (highest values first)
- XCOPY /S for subdirectory support
- ASCII markers ([OK], [ERROR], [WARNING]) instead of emojis

### File Locations
- AD2: C:\Shares\test\COMMON\ProdSW\ (deployed)
- NAS: T:\COMMON\ProdSW\ (synced)
- DOS: C:\BAT\ (installed)
- Logs: T:\TS-4R\LOGS\8BLOG\ (test data for database import)

## Deployment Status

✅ All 7 batch files deployed to AD2 (both COMMON and _COMMON)
⏳ Pending sync to NAS (within 15 minutes)
⏳ Pending pilot deployment on TS-4R
📋 Ready for rollout to ~30 DOS machines

## Breaking Changes

CTONW v1.1 → v1.2: Test data now uploads to LOGS folder instead of ProdSW.
Existing machines must download v1.2 via NWTOC for proper database import.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-19 12:49:54 -07:00

7.1 KiB
Raw 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