hiveiq-src/hiveops-guide
7
0
Fork 0
Code Issues 10 Pull Requests Actions 1 Packages Projects Releases Wiki Activity

[session 1] docs(technical.agent): correct UPDATE_AGENT auto-restart note (4.5.x) #49

Merged
hiveiq merged 1 commits from fix/agent-update-restart-note into develop 2026-07-22 09:09:59 -04:00
Conversation 1 Commits 1 Files Changed 1
+17 -2
hiveiq commented 2026-07-22 09:07:46 -04:00
Owner
Copy Link
Copy Source

Session: 1

Corrects a stale claim in the technical.agent Gotchas tab. The REBOOT section said UPDATE_AGENT swaps the JAR but does not auto-restart the JVM and needs a follow-up RESTART_AGENT.

That is wrong for agent 4.5.x. UPDATE_AGENT auto-restarts the agent process and activates the new code (UPDATE -> Restarting). Proven fleet-wide 2026-07-21 across 246 ATMs and on the BP000101 pilot (a post-update REBOOT executed the 4.5.1 code path - it would have failed at goOutOfService=-1 if the code were not live). RESTART_AGENT is only needed to bounce the agent without updating.

Also clarifies the restart is the agent process, not an ATM reboot (so fleet-wide UPDATE_AGENT is non-customer-impacting), and that agentVersion alone does not prove running code. Matches the corrected memory note from this session.

Docs-only, single tab.

Session: 1 Corrects a stale claim in the technical.agent Gotchas tab. The REBOOT section said `UPDATE_AGENT` swaps the JAR but does **not** auto-restart the JVM and needs a follow-up `RESTART_AGENT`. **That is wrong for agent 4.5.x.** `UPDATE_AGENT` auto-restarts the agent process and activates the new code (`UPDATE -> Restarting`). Proven fleet-wide 2026-07-21 across 246 ATMs and on the BP000101 pilot (a post-update REBOOT executed the 4.5.1 code path - it would have failed at `goOutOfService=-1` if the code were not live). `RESTART_AGENT` is only needed to bounce the agent *without* updating. Also clarifies the restart is the **agent process, not an ATM reboot** (so fleet-wide UPDATE_AGENT is non-customer-impacting), and that `agentVersion` alone does not prove running code. Matches the corrected memory note from this session. Docs-only, single tab.
hiveiq added 1 commit 2026-07-22 09:07:48 -04:00
docs(technical.agent): correct UPDATE_AGENT — it DOES auto-restart/activate on 4.5.x e0cbb9c010 
The REBOOT section claimed UPDATE_AGENT swaps the JAR but does not auto-restart
the JVM and needs a follow-up RESTART_AGENT. That is wrong for agent 4.5.x:
UPDATE_AGENT auto-restarts the agent process and activates the new code
(UPDATE -> Restarting), proven fleet-wide 2026-07-21 across 246 ATMs and on the
BP000101 pilot (post-update REBOOT executed the 4.5.1 code path). RESTART_AGENT
is only needed to bounce without updating.

Also clarifies: the restart is the agent process, not an ATM reboot, so a
fleet-wide UPDATE_AGENT is non-customer-impacting; and agentVersion alone does
not prove running code (verify a behavioural marker).

Session: 1

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
johannes approved these changes 2026-07-22 09:07:53 -04:00
hiveiq merged commit 20034bb95a into develop 2026-07-22 09:09:59 -04:00
hiveiq deleted branch fix/agent-update-restart-note 2026-07-22 09:09:59 -04:00
Sign in to join this conversation.
Reviewers
No Reviewers
johannes
Labels
Clear labels
Bug
Backend
Service, API, or data-layer work
 Breaking
Breaking change that won't be backward compatible
 Bug
Something is not working
 Dev Verified
Fix verified on bcos.dev by QA — cleared for production release
 Documentation
Documentation changes
 Enhancement
Improve existing functionality
 Feature
New functionality
 Frontend
UI / Svelte SPA work
 Pattern
For changes to our agent Pattern for detecting hardware faults
Priority
Critical
The priority is critical
Priority
High
The priority is high
Priority
Low
The priority is low
Priority
Medium
The priority is medium
Reopen
Fix was verified but the issue persists or regressed. Reopen and reassign for investigation.
Reviewed
Confirmed
Issue has been confirmed
Reviewed
Duplicate
This issue or pull request already exists
Reviewed
Invalid
Invalid issue
Reviewed
Won't Fix
This issue won't be fixed
Security
This is security issue
Status
Abandoned
Somebody has started to work on this but abandoned work
Status
Blocked
Something is blocking this issue or pull request
Status
Need More Info
Feedback is required to reproduce issue or to continue work
TEST
Tested
Not Fixed
Testing
Issue or pull request related to testing
 Verify Fix
Fix has been deployed to production. Verify the issue is resolved before closing.
 Verify/Production
Fix deployed to production — verify before closing
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
claude1 claude2 claude3 hiveiq hiveiq-browser johannes tristan (Tristan Smith)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: hiveiq-src/hiveops-guide#49
Delete Branch "fix/agent-update-restart-note"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?