Mike Swanson
3faf09c111
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>
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**
|