docs(cli): the EtherChannel receipts are two sessions, not one #2037

Merged
jaylouisw merged 1 commit from docs/1118-2117 into main 2026-11-18 23:08:38 +00:00
Owner

A drift hunt over docs/CLI.md's EtherChannel section.

What was untrue: the block in A bundle carries eight links; the rest wait as (H) showed

sw1(config-if)#channel-group 1 mode active
Interface Gi1/0/9 added to channel group 1 (mode active)
  Gi1/0/9 is hot-standby: ...

sw1(config-if)#channel-group 1 mode on
% Gi1/0/9 not added: channel group 1 already holds 8 members, ...

which reads as one session on one port. Replayed on a C2960X-24TS-L (test/etherchannel-member-limit.test.js's own switch), the second line on Gi1/0/9 prints

Channel group 1 mode changed from active to on for every member: Gi1/0/1, ... Gi1/0/8
Interface Gi1/0/9 added to channel group 1 (mode on)
  Gi1/0/9 is hot-standby: the bundle already has 8 active links, ...

because engine/cli.js:3361 refuses only when !alreadyIn && existing.members.length >= cap, and cap for LACP is 16 (engine/lag.js:82-89). The refusal itself is real, but only from a ninth port on a group already holding eight mode on members.

The fix: split the block into the two sessions that really produce the two receipts, label each, and add the group-wide mode-change line the single-session reading would have printed.

Not fixed here (docs-only stream): re-moding a nine-member LACP group with channel-group 1 mode on leaves nine members in a static bundle whose own message says it "carries at most 8 links", and still prints the LACP-only (H) hot-standby receipt. That is a code question for its own ticket, not a docs edit.

Gates: scripts/syntax-check.js 423 files OK; docs-cli-transcript 4/0, docs-show-commands 7/0 (59 forms, 118 commands), help-completeness 8/0, help-key-is-not-a-value 40/0, no-form-help-key 81/0, help-key-works-in-every-prompt 10/0, doc-catalog-counts 43/0 - identical before and after. scripts/check-control-bytes.js clean.

A drift hunt over `docs/CLI.md`'s EtherChannel section. **What was untrue**: the block in *A bundle carries eight links; the rest wait as `(H)`* showed ``` sw1(config-if)#channel-group 1 mode active Interface Gi1/0/9 added to channel group 1 (mode active) Gi1/0/9 is hot-standby: ... sw1(config-if)#channel-group 1 mode on % Gi1/0/9 not added: channel group 1 already holds 8 members, ... ``` which reads as one session on one port. Replayed on a `C2960X-24TS-L` (`test/etherchannel-member-limit.test.js`'s own switch), the second line on Gi1/0/9 prints ``` Channel group 1 mode changed from active to on for every member: Gi1/0/1, ... Gi1/0/8 Interface Gi1/0/9 added to channel group 1 (mode on) Gi1/0/9 is hot-standby: the bundle already has 8 active links, ... ``` because `engine/cli.js:3361` refuses only when `!alreadyIn && existing.members.length >= cap`, and `cap` for LACP is 16 (`engine/lag.js:82-89`). The refusal itself is real, but only from a ninth port on a group already holding eight `mode on` members. **The fix**: split the block into the two sessions that really produce the two receipts, label each, and add the group-wide mode-change line the single-session reading would have printed. **Not fixed here (docs-only stream)**: re-moding a nine-member LACP group with `channel-group 1 mode on` leaves nine members in a static bundle whose own message says it "carries at most 8 links", and still prints the LACP-only `(H)` hot-standby receipt. That is a code question for its own ticket, not a docs edit. **Gates**: `scripts/syntax-check.js` 423 files OK; docs-cli-transcript 4/0, docs-show-commands 7/0 (59 forms, 118 commands), help-completeness 8/0, help-key-is-not-a-value 40/0, no-form-help-key 81/0, help-key-works-in-every-prompt 10/0, doc-catalog-counts 43/0 - identical before and after. `scripts/check-control-bytes.js` clean.
docs(cli): the EtherChannel receipts are two sessions, not one
All checks were successful
CI / Classify the change (pull_request) Successful in 7s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 8s
CI / Server smoke test (pull_request) Successful in 8s
CI / Docker build (pull_request) Successful in 20s
CI / Test (Node 20) (pull_request) Successful in 51s
CI / Test (Node 22) (pull_request) Successful in 54s
CI / Test (Node 18) (pull_request) Successful in 57s
CI / Arm auto-merge (pull_request) Successful in 3s
63ae112379
The `mode on` refusal line sat under the same `sw1(config-if)#` prompt as a
`channel-group 1 mode active` on Gi1/0/9, so the page read as one session on one port.
Replayed, the second line on that port is not a refusal at all: the port is already in
the group, so the console re-modes every member and keeps it
(`Channel group 1 mode changed from active to on for every member: Gi1/0/1, ... Gi1/0/8`),
and the cap is only checked when a port joins. The refusal is real, but only on a group
built from eight `mode on` members - engine/cli.js:3361 reads
`existing.members.length >= cap` with `cap = lagLib.maxMembers(mode)` (8 for `on`, 16
for LACP, engine/lag.js:82-89).

Split the block into the two sessions that produce the two receipts, say which session
each belongs to, and name the group-wide mode change the single-session reading would
actually have printed.
forgejo-actions force-pushed docs/1118-2117 from 63ae112379
All checks were successful
CI / Classify the change (pull_request) Successful in 7s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 8s
CI / Server smoke test (pull_request) Successful in 8s
CI / Docker build (pull_request) Successful in 20s
CI / Test (Node 20) (pull_request) Successful in 51s
CI / Test (Node 22) (pull_request) Successful in 54s
CI / Test (Node 18) (pull_request) Successful in 57s
CI / Arm auto-merge (pull_request) Successful in 3s
to c88d38ca96 2026-11-18 21:23:02 +00:00
Compare
jaylouisw force-pushed docs/1118-2117 from 061f7adc71 to 50d2fed113
Some checks failed
CI / Classify the change (pull_request) Successful in 7s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 6s
CI / Server smoke test (pull_request) Has been skipped
CI / Docker build (pull_request) Has been skipped
CI / Test (Node 20) (pull_request) Successful in 1m12s
CI / Test (Node 18) (pull_request) Failing after 1m15s
CI / Test (Node 22) (pull_request) Successful in 1m16s
CI / Arm auto-merge (pull_request) Successful in 3s
2026-11-18 22:47:17 +00:00
Compare
jaylouisw force-pushed docs/1118-2117 from 50d2fed113
Some checks failed
CI / Classify the change (pull_request) Successful in 7s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 6s
CI / Server smoke test (pull_request) Has been skipped
CI / Docker build (pull_request) Has been skipped
CI / Test (Node 20) (pull_request) Successful in 1m12s
CI / Test (Node 18) (pull_request) Failing after 1m15s
CI / Test (Node 22) (pull_request) Successful in 1m16s
CI / Arm auto-merge (pull_request) Successful in 3s
to c4df2a8751
All checks were successful
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 4s
CI / Classify the change (pull_request) Successful in 6s
CI / Server smoke test (pull_request) Has been skipped
CI / Docker build (pull_request) Has been skipped
CI / Test (Node 20) (pull_request) Successful in 1m0s
CI / Test (Node 18) (pull_request) Successful in 1m10s
CI / Test (Node 22) (pull_request) Successful in 1m6s
CI / Arm auto-merge (pull_request) Successful in 4s
2026-11-18 23:04:53 +00:00
Compare
jaylouisw deleted branch docs/1118-2117 2026-11-18 23:08:39 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
jaylouisw/packetforge!2037
No description provided.