diff --git a/docs/post-deploy-checklist.live.html b/docs/post-deploy-checklist.live.html new file mode 100644 index 0000000..58d48b4 --- /dev/null +++ b/docs/post-deploy-checklist.live.html @@ -0,0 +1,47 @@ + + + +Post-Deploy Verification Checklist + + + +

Post-Deploy Checklist

+

Run after first boot. Sign off when all boxes checked. Fail any step, see post-deploy-debug-flowchart.md.

+

1. Common Shop Floor

+ +

Fail: check corp network, ping WJFMS3.AE.GE.COM.

+

2. Controller (skip if standalone PC)

+ +

Fail ping, see 2B NIC. +Blank General, see 2A reg load.

+

3. UDC COM port

+ +

Fail, see Step 4.

+

4. Printers (Genspect: all nearby)

+ +

Fail, see printer-mapping.md.

+ diff --git a/docs/post-deploy-checklist.md b/docs/post-deploy-checklist.md new file mode 100644 index 0000000..007f820 --- /dev/null +++ b/docs/post-deploy-checklist.md @@ -0,0 +1,37 @@ +# Post-Deploy Checklist + +Run after first boot. Sign off when all boxes checked. Fail any step, see [post-deploy-debug-flowchart.md](post-deploy-debug-flowchart.md). + +## 1. Common Shop Floor + +- [ ] `Shopfloor Tools` then `WJ Shopfloor` opens +- [ ] Login prompt and menu screen render + +Fail: check corp network, ping `WJFMS3.AE.GE.COM`. + +## 2. Controller (skip if standalone PC) + +- [ ] `ping 192.168.1.1` returns 4 of 4 replies +- [ ] NTLARS General tab populated +- [ ] NTLARS FMS Host Primary set to `WJFMS3.AE.GE.COM` (FQDN) + +Fail ping, see [2B NIC](post-deploy-debug-flowchart.md#2b-controller-nic-has-no-static-ip). +Blank General, see [2A reg load](post-deploy-debug-flowchart.md#2a-ntlars-reg-file-never-imported-blank-general-tab-fields). + +## 3. UDC COM port + +- [ ] UDC opens with no machine-communication error dialog +- [ ] `Tools` then `Retry Connection` succeeds (no error) +- [ ] Port Name matches physical port: onboard COM1, PCIe card COM2 or COM4 +- [ ] Data lines populate after reopen + +Fail, see [Step 4](post-deploy-debug-flowchart.md#step-4-set-the-correct-com-port). + +## 4. Printers (Genspect: all nearby) + +- [ ] `Install Printers` shortcut opens +- [ ] Each nearby printer installed, status Ready +- [ ] Test page prints +- [ ] Genspect: default printer set + +Fail, see [printer-mapping.md](../printer-mapping.md). diff --git a/docs/post-deploy-checklist.static.html b/docs/post-deploy-checklist.static.html new file mode 100644 index 0000000..35b9537 --- /dev/null +++ b/docs/post-deploy-checklist.static.html @@ -0,0 +1,59 @@ + + + +Post-Deploy Verification Checklist + + +

Post-Deploy Checklist

+

Run after first boot. Sign off when all boxes checked. Fail any step, see post-deploy-debug-flowchart.md.

+

1. Common Shop Floor

+ +

Fail: check corp network, ping WJFMS3.AE.GE.COM.

+

2. Controller (skip if standalone PC)

+ +

Fail ping, see 2B NIC. +Blank General, see 2A reg load.

+

3. UDC COM port

+ +

Fail, see Step 4.

+

4. Printers (Genspect: all nearby)

+ +

Fail, see printer-mapping.md.

+ diff --git a/docs/post-deploy-debug-flowchart.md b/docs/post-deploy-debug-flowchart.md index e712464..6985a2f 100644 --- a/docs/post-deploy-debug-flowchart.md +++ b/docs/post-deploy-debug-flowchart.md @@ -24,7 +24,7 @@ flowchart TD U2 --> U3[Tools - Options - Serial tab] U3 --> U4{Which physical COM port is the cable in?} U4 -->|Intel / onboard| U5[Set Port Name = COM 1] - U4 -->|PCIe add-in card| U6[Set Port Name = COM 2] + U4 -->|PCIe add-in card| U6[Set Port Name = COM 2 or COM 4] U5 --> U7[Save - File - Exit - reopen UDC] U6 --> U7 U7 --> U8([Verify data lines populate]) @@ -51,7 +51,7 @@ flowchart TD click U3 "#step-3-open-options" "Step 3 - Options" click U4 "#step-4-set-the-correct-com-port" "Step 4 - COM port" click U5 "#step-4-set-the-correct-com-port" "Step 4 - COM 1" - click U6 "#step-4-set-the-correct-com-port" "Step 4 - COM 2" + click U6 "#step-4-set-the-correct-com-port" "Step 4 - COM 2 or COM 4" click U7 "#step-5-exit-to-apply" "Step 5 - Exit" click D2 "#2a-ntlars-reg-file-never-imported-blank-general-tab-fields" "2A - Load reg backup" @@ -113,7 +113,7 @@ Click the **Serial** tab on the left. Set **Port Name** to match the **physical* ![PC rear - onboard COM1 port](images/post-deploy/Figure_5_UDC_not_collecting_data_enable_admin_options_serial_intel_com1_physical.png) -- **COM 2** = PCIe add-in serial card +- **COM 2 or COM 4** = PCIe add-in serial card (Windows enumeration varies by hardware - check Device Manager -> Ports if unsure) Logical: @@ -138,7 +138,7 @@ Reopen UDC. Data lines should start populating as the machine runs. ### If data still does not appear Once the COM port is correct, ~~rule out~~ check these in order: -- Wrong physical cable - cable is in COM1 socket but Port Name set to COM 2 (or vice versa). Re-check Step 4. +- Wrong physical cable - cable is in COM1 socket but Port Name set to COM 2 / COM 4 (or vice versa). Re-check Step 4. - Cable / connector damaged - swap with a known-good cable. - Machine controller side not transmitting - confirm at the controller HMI.