Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

6.3.0 release documentation #676

Merged
merged 134 commits into from
Sep 30, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
134 commits
Select commit Hold shift + click to select a range
5729103
adding DNAT
Chr1st0ph3rTurn3r Feb 20, 2024
c532baf
adding Dynamic Source NAT info and reorganizing the NAT section of th…
Chr1st0ph3rTurn3r Feb 21, 2024
7c8c84a
updating CLI reference docs, and linking to them from NAT docs.
Chr1st0ph3rTurn3r Feb 21, 2024
e711c1c
fixing broken links
Chr1st0ph3rTurn3r Feb 21, 2024
4c4adc6
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Feb 22, 2024
040f663
updates per review
Chr1st0ph3rTurn3r Feb 26, 2024
6f47217
adding net interf traffic engineering info, breaking out all of TE to…
Chr1st0ph3rTurn3r Mar 5, 2024
ab545ac
adding content for Traffic engineering - improving existing content, …
Chr1st0ph3rTurn3r Mar 5, 2024
d38bde1
forgot the graphic that will need to be updated anyway.
Chr1st0ph3rTurn3r Mar 5, 2024
d4196e3
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Mar 6, 2024
ab8e876
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Mar 6, 2024
fabab2f
links and new screenshots
Chr1st0ph3rTurn3r Mar 7, 2024
7039d52
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Mar 11, 2024
259dca4
updates
Chr1st0ph3rTurn3r Mar 12, 2024
8d5efbe
updates per scotts review - not complete yet - and attempt to fix bui…
Chr1st0ph3rTurn3r Mar 13, 2024
996e889
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Mar 18, 2024
c9d9e84
escaping the curly braces.
Chr1st0ph3rTurn3r Mar 18, 2024
9b80ac9
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Mar 18, 2024
b308df3
adding TE output, some of it anyway.
Chr1st0ph3rTurn3r Mar 18, 2024
6c1a072
adding TE show stats output, and fixing the files that I incorrectly …
Chr1st0ph3rTurn3r Mar 20, 2024
bf73d22
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Mar 20, 2024
13dd313
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Mar 22, 2024
330ab5e
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Mar 22, 2024
81adfd8
escaping curly braces
Chr1st0ph3rTurn3r Mar 22, 2024
7784635
escaping curly braces
Chr1st0ph3rTurn3r Mar 22, 2024
d1d2fc4
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Mar 22, 2024
cd713fc
adding new doc for install steps and new graphics.
Chr1st0ph3rTurn3r Mar 26, 2024
0cf60d9
merging other 6.3 docs in to collect updates and enable local builds…
Chr1st0ph3rTurn3r Mar 26, 2024
17d36b5
adding u-iso install topic.
Chr1st0ph3rTurn3r Mar 26, 2024
c747a3f
additional images, text updates.
Chr1st0ph3rTurn3r Mar 26, 2024
a675407
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Mar 27, 2024
3a9ffa5
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Mar 27, 2024
a9b5bfc
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Mar 27, 2024
49bc874
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Apr 1, 2024
97d8e61
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Apr 1, 2024
a4063f8
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Apr 1, 2024
c62c414
move install doc on the sidebar, some edits for clarity in the doc.
Chr1st0ph3rTurn3r Apr 1, 2024
7259a90
rewording to be more accurate
Chr1st0ph3rTurn3r Apr 2, 2024
9e1d248
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Apr 2, 2024
ce5c752
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Apr 4, 2024
ddf2aaf
Merge branch 'master' into 6.3.0-traffic-engineering
Chr1st0ph3rTurn3r Apr 4, 2024
f60e701
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Apr 4, 2024
c465a5c
adding traffic engineering info to the main docs branch Merge branch…
Chr1st0ph3rTurn3r Apr 4, 2024
6e38852
adding release notes and some other edits.
Chr1st0ph3rTurn3r Apr 4, 2024
1f44728
adding new feature info to the release notes.
Chr1st0ph3rTurn3r Apr 4, 2024
00394a6
minor text edits
Chr1st0ph3rTurn3r Apr 10, 2024
cc038e0
adding some upgrade text
Chr1st0ph3rTurn3r Apr 11, 2024
1de439f
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Apr 15, 2024
7c932e7
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Apr 15, 2024
94101cf
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Apr 16, 2024
f451fe5
revising and updaing upgrade procdess for 6.3
Chr1st0ph3rTurn3r Apr 23, 2024
47e97cc
added some info about ha upgrades.
Chr1st0ph3rTurn3r Apr 23, 2024
af12f77
clarifying rollback info for 6.3
Chr1st0ph3rTurn3r Apr 24, 2024
a5929e8
fixing broken links
Chr1st0ph3rTurn3r Apr 24, 2024
5c77750
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Apr 25, 2024
0c502ac
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Apr 29, 2024
9bc9fbb
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Apr 29, 2024
779d2e3
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Apr 29, 2024
d40a746
updating new features list, adding force-up for LACP
Chr1st0ph3rTurn3r Apr 30, 2024
ccf3664
disabling link checker for slow wireguard links
Chr1st0ph3rTurn3r May 1, 2024
6d5203a
updates to the new feature list and documentation.
Chr1st0ph3rTurn3r May 1, 2024
d6e1a19
updating with the release notes docMerge branch '6.3.0-release-docum…
Chr1st0ph3rTurn3r May 1, 2024
dab3ad6
beginning of tylers edits
Chr1st0ph3rTurn3r May 2, 2024
f562265
intrim commit
Chr1st0ph3rTurn3r May 3, 2024
0f3504b
upgrade process edits
Chr1st0ph3rTurn3r May 7, 2024
15c5c8e
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r May 13, 2024
a7cea92
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r May 13, 2024
8b6dfd8
starting ISO updates as needed
Chr1st0ph3rTurn3r Jun 11, 2024
0fcb946
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Jul 1, 2024
bd75cf3
merging latest Merge branch '6.3.0-install-updates' of github.com:12…
Chr1st0ph3rTurn3r Jul 1, 2024
7c92f63
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Jul 3, 2024
883eb64
starting alarm filtering work
Chr1st0ph3rTurn3r Jul 3, 2024
c638a24
adding Alarm Supression info
Chr1st0ph3rTurn3r Jul 8, 2024
05929e5
adding config steps, images, etc for Alarm suppression.
Chr1st0ph3rTurn3r Jul 9, 2024
77d02dd
revising the TOC for Alarms and Events
Chr1st0ph3rTurn3r Jul 9, 2024
fc20a56
fixed some typos, and hopefully resized an image that was too big.
Chr1st0ph3rTurn3r Jul 9, 2024
5935b0f
updating the command config guide for 6.3
Chr1st0ph3rTurn3r Jul 10, 2024
c6013f2
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Jul 10, 2024
e78bc1b
updating cli docs for 6.3
Chr1st0ph3rTurn3r Jul 12, 2024
c4c2541
fix links
Chr1st0ph3rTurn3r Jul 12, 2024
16c989a
fixing acorn issue.
Chr1st0ph3rTurn3r Jul 12, 2024
f988fed
resolving link issues
Chr1st0ph3rTurn3r Jul 18, 2024
ffa492e
changes to dest-nat doc
Chr1st0ph3rTurn3r Jul 18, 2024
c56d38f
adding info for I95-56640. More coming, have to break to post docs to…
Chr1st0ph3rTurn3r Jul 19, 2024
ae4e797
adding info for I95-56640
Chr1st0ph3rTurn3r Jul 19, 2024
d39e2a4
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Jul 22, 2024
7ee4e6e
adding show system software top level command.
Chr1st0ph3rTurn3r Jul 22, 2024
6b161d8
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Jul 22, 2024
db195cd
merging master updates into local - hoping for the best.
Chr1st0ph3rTurn3r Jul 22, 2024
bf09def
adding strict hostkey checking info to the 6.3.0 docs
Chr1st0ph3rTurn3r Jul 29, 2024
b33d856
adding kb article and caveat for I95-56628
Chr1st0ph3rTurn3r Aug 8, 2024
bed33e6
adding limitiations wording to TE Concepts topic.
Chr1st0ph3rTurn3r Aug 8, 2024
aa757ba
fix link
Chr1st0ph3rTurn3r Aug 8, 2024
f338f27
fix link to KB article
Chr1st0ph3rTurn3r Aug 9, 2024
f4a5b1d
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Aug 9, 2024
2cdb360
adding a clear Air-Gap network install/upgrade procedure.
Chr1st0ph3rTurn3r Aug 13, 2024
47f8505
updates to rib commands
Chr1st0ph3rTurn3r Aug 28, 2024
809663e
merging conflicts
Chr1st0ph3rTurn3r Sep 4, 2024
e6692b3
cleanup of merge
Chr1st0ph3rTurn3r Sep 4, 2024
60d9376
updated with recent 6.3 changes
Chr1st0ph3rTurn3r Sep 9, 2024
550d7af
merge conflicts resolution I hope
Chr1st0ph3rTurn3r Sep 9, 2024
8530fd3
cleaning up install and upgrade docs
Chr1st0ph3rTurn3r Sep 9, 2024
d1b5dfc
additional minor edits.
Chr1st0ph3rTurn3r Sep 9, 2024
ae1b36f
Merge branch 'master' into 6.3.0-install-updates
Chr1st0ph3rTurn3r Sep 10, 2024
e7c2a40
removing unnecessary section for upgrade info.
Chr1st0ph3rTurn3r Sep 10, 2024
1c77272
updating U-ISO screens and steps
Chr1st0ph3rTurn3r Sep 10, 2024
0dbd2e9
adding mist reg code steps
Chr1st0ph3rTurn3r Sep 11, 2024
049f394
resolving conflicts
Chr1st0ph3rTurn3r Sep 11, 2024
e0947f0
updating install info, clarification, etc, to make it clearer.
Chr1st0ph3rTurn3r Sep 11, 2024
72e3cdb
beginning some RN edits
Chr1st0ph3rTurn3r Sep 11, 2024
7bdfe54
lacp update
Chr1st0ph3rTurn3r Sep 13, 2024
cfea1de
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Sep 17, 2024
6c1682f
release notes and some topic updates. need a few finishing touches to…
Chr1st0ph3rTurn3r Sep 23, 2024
a124663
updating universal iso install docs to include non web interface inst…
Chr1st0ph3rTurn3r Sep 24, 2024
3f18257
rearrange TOC, fix broken link, add missing link, and one quick name …
Chr1st0ph3rTurn3r Sep 24, 2024
bea94dc
fixing broken links for the build
Chr1st0ph3rTurn3r Sep 25, 2024
60c5cc9
Update docs/initialize_u-iso_other.md
Chr1st0ph3rTurn3r Sep 25, 2024
d691ef3
Update docs/initialize_u-iso_other.md
Chr1st0ph3rTurn3r Sep 25, 2024
2beec41
Update docs/initialize_u-iso_other.md
Chr1st0ph3rTurn3r Sep 25, 2024
ea23084
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Sep 25, 2024
6080d07
updates to u-iso advanced workflows per kaushik and sam's review
Chr1st0ph3rTurn3r Sep 25, 2024
c8a7b70
Merge branch '6.3.0-release-documentation' of github.com:128technolog…
Chr1st0ph3rTurn3r Sep 25, 2024
67d7710
final u-iso edits.
Chr1st0ph3rTurn3r Sep 25, 2024
177c21b
Added RADSEC topic and linked to release notes
Chr1st0ph3rTurn3r Sep 25, 2024
bb566ad
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Sep 26, 2024
a67d360
address all review comments except Initializer Advanced Workflow. Wil…
Chr1st0ph3rTurn3r Sep 26, 2024
6fa71ba
fix conflict
Chr1st0ph3rTurn3r Sep 26, 2024
74ee859
revised u-iso advanced workflows.
Chr1st0ph3rTurn3r Sep 27, 2024
1c09a39
revise layout of Adv workflows
Chr1st0ph3rTurn3r Sep 27, 2024
20d752d
final review comments
Chr1st0ph3rTurn3r Sep 27, 2024
9952b5b
adding release numbers, correct designations, update links, spelling.
Chr1st0ph3rTurn3r Sep 30, 2024
94d195e
Merge branch 'master' into 6.3.0-release-documentation
Chr1st0ph3rTurn3r Sep 30, 2024
f728d9e
fix broken links
Chr1st0ph3rTurn3r Sep 30, 2024
245b4a2
fix links/release names
Chr1st0ph3rTurn3r Sep 30, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions docs/about_releases.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,8 +38,9 @@ However, issues resolved in `4.3.12`, which was released on 3/12/2021 are not ad

| Version | Initial GA Version | First Release Shipping Date | Latest GA Version | End of Software Engineering support | End of Support |
| --| -- | -- | -- | -- | -- |
| Release 6.2 | [6.2.0](release_notes_128t_6.2.md#release-620-39) | November 16, 2023 | [6.2.6](release_notes_128t_6.2.md#release-626-15-sts) | September 6, 2026 | March 6, 2027 |
| Release 6.1 | [6.1.0](release_notes_128t_6.1.md#release-610-55) | April 14, 2023 | [6.1.10](release_notes_128t_6.1.md#release-6110-8) | July 14, 2025 | January 14, 2026 |
| Release 6.3 | [6.3.0](release_notes_128t_6.3.md#release-630-107r1) | September 30, 2024 | [6.3.0](release_notes_128t_6.3.md#release-630-107r1) | June 30, 2025 | March 30, 2026 |
| Release 6.2 | [6.2.0](release_notes_128t_6.2.md#release-620-39r1) | November 16, 2023 | [6.2.6](release_notes_128t_6.2.md#release-626-15-sts) | September 6, 2026 | March 6, 2027 |
| Release 6.1 | [6.1.0](release_notes_128t_6.1.md#release-610-55r1) | April 14, 2023 | [6.1.10](release_notes_128t_6.1.md#release-6110-8-lts) | July 14, 2025 | January 14, 2026 |
| Release 5.6 | [5.6.7](release_notes_128t_5.6.md#release-567-4) | March 16, 2023 | [5.6.15](release_notes_128t_5.6.md#release-5615-1) | June 16, 2024 | December 16, 2024 |

## Out of Support
Expand Down
50 changes: 44 additions & 6 deletions docs/bcp_per-adjacency_traffic_engineering.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: Per Adjacency Traffic Engineering
sidebar_label: Per Adjacency Traffic Engineering
title: Adjacency Traffic Engineering
sidebar_label: Adjacency Traffic Engineering
---

Packet loss due to congestion in networks, particularly over WAN links, is inevitable. Depending on where drops occur, it can have a major impact on perceived quality of experience. Packet loss due to exceeding transmit caps between instances of SSR should be avoided. Per-adjacency traffic engineering can be enabled to regulate the upload and download rates between peers.
Adjacency traffic engineering can be enabled to regulate the upload and download rates between peers.

## Overview

Per-adjacency traffic engineering provides targeted traffic engineering for both directions on a bandwidth restricted link between two SSR instances. Traffic engineering on the device interface continues to be associated with the upload rate of a connected link; the `transmit-cap`. Traffic engineering at the adjacency level is associated with the download limit of the adjacent SSR instance; the `receive-cap`.
Adjacency traffic engineering provides targeted traffic engineering for both directions on a bandwidth restricted link between two SSR instances. While device interface traffic engineering is associated with the upload rate (`transmit-cap`) of a connected link, traffic engineering at the adjacency level is associated with the download limit of the adjacent SSR instance; the `receive-cap`.

For example, in the following hub and spoke diagram the Datacenter router has 5 adjacencies off of the individual device interface with a `transmit-cap` upload speed configured at 50Mb. The adjacent branch routers have 10Mb, 5Mb, 1Mb, 5Mb, and 2.5Mb configured as their device interface transmit caps. With such a large `transmit-cap` at the Datacenter, traffic rates exceeding the allowed download speeds (10Mb, 5Mb, 1Mb, 5Mb, and 2.5Mb) on each of the paths to the branch routers will result in traffic being dropped by the ISP.

Expand Down Expand Up @@ -64,12 +64,50 @@ network-interface foo
exit
exit
```

### Limitations

Enabling traffic engineering will introduce a performance impact to the packet-per-second processing rate as the QoS engine works to ensure fairness of packet distribution under congestion scenarios. When used in conjunction with other traffic engineering settings (e.g., adjacency traffic engineering configured alongside device interface traffic engineering), performance may be further impacted.

### Gathering Statistics

To gather information about Per-Adjacency Traffic Engineering, query the following statistics using the `show stats traffic-eng device-interface peer-path` command within the CLI. These statistics are specific to the peer-path and provide insight into how the adjacency schedulers are operating.

- `enqueue-cycle-count`: The current enqueue cycle count in traffic engineering for this peer path.
- `dequeue-cycle-count`: The current dequeue cycle count in traffic engineering for this peer path.
```
admin@combo-east-a.combo-east# show stats traffic-eng device-interface peer-path
Tue 2024-03-19 13:39:58 UTC
Retrieving statistics...

Peer Path Traffic Engineering Stats
-----------------------------------

==================================================== ============== ============ ============== ============= ====== ==================
Metric Node Peer-name Peer-host Device-name Vlan Value
==================================================== ============== ============ ============== ============= ====== ==================
dequeue-cycle-count combo-east-a combo-west 172.16.102.2 11-red 0 61474020
enqueue-cycle-count combo-east-a combo-west 172.16.102.2 11-red 0 61474020
packets-queued combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class buffer-capacity-exceeded-bytes combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class buffer-capacity-exceeded-packets combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class dequeue-aqm-drop-bytes combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class dequeue-aqm-drop-packets combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class dequeue-max-latency-drop-bytes combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class dequeue-max-latency-drop-packets combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class dequeue-success-bytes combo-east-a combo-west 172.16.102.2 11-red 0 94918726
per-traffic-class dequeue-success-packets combo-east-a combo-west 172.16.102.2 11-red 0 244021
per-traffic-class schedule-failure-bandwidth combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class schedule-failure-bytes combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class schedule-failure-packets combo-east-a combo-west 172.16.102.2 11-red 0 0
per-traffic-class schedule-success-bandwidth combo-east-a combo-west 172.16.102.2 11-red 0 1201245
per-traffic-class schedule-success-bytes combo-east-a combo-west 172.16.102.2 11-red 0 94918726
per-traffic-class schedule-success-packets combo-east-a combo-west 172.16.102.2 11-red 0 244021
scheduler-reset combo-east-a combo-west 172.16.102.2 11-red 0 0
```

### Statistics Descriptions

- `enqueue-cycle-count`: The current enqueue cycle count in traffic engineering for this peer path. This value is helpful when debugging.
- `dequeue-cycle-count`: The current dequeue cycle count in traffic engineering for this peer path. This value is helpful when debugging.
- `packets-queued`: The current number of packets queued in traffic engineering for this peer path.
- `per-traffic-class schedule-success-bytes`: The number of bytes successfully scheduled for transmission for this peer path.
- `per-traffic-class schedule-success-packets`: The number of packets successfully scheduled for transmission for this peer path.
Expand Down
67 changes: 62 additions & 5 deletions docs/cc_fips_otp_router_install.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ Upon boot, the following screen is displayed. The default selection is booting t

2. Press the TAB key to edit the configuration.

To enable FIPS Enforcement for SSR software version 6.2.5-5r2, add the `fips=1` kernel option to the kernel command line during system installation as shown in the steps below. This ensures that key generation is done with FIPS approved algorithms and continuous monitoring tests in place.
To enable FIPS Enforcement for SSR software version 6.2.5-5-sts, add the `fips=1` kernel option to the kernel command line during system installation as shown in the steps below. This ensures that key generation is done with FIPS approved algorithms and continuous monitoring tests in place.

:::important
FIPS mode is required for Common Criteria compliance. Failure to configure FIPS mode, or the use of any other cryptographic engine nullifies compliance.
Expand All @@ -108,6 +108,63 @@ When you modify the GRUB kernel behavior by editing the GRUB menu at boot time,

This installation process is an automated workflow which does not require user interaction after selecting and initiating the OTP menu option. The system will power off after installation.

### Enable Strict Host Key Checking

Enabling strict `host-key-checking` provides secure communication between the conductor and a router.
Similar to SSH, there are two `host-key-checking` options; `yes` which requires the host key to be provisioned manually, or `accept-new` which accepts the key on first connection.

There are two configuration parameters where `host-key-checking` can be set:

- **[`inter-router host-key-checking`](config_command_guide.md#configure-authority-router-node-ssh-settings-inter-router-host-key-checking)** controls host key verification between a router and the conductor. When set to `yes`, strict host key checking is enabled between the router and the conductor. However, the host keys must be manually provisioned on each router.

```
config authority router RTR_EAST_COMBO node combo-east-1 ssh-settings inter-router host-key-checking yes
config authority router RTR_EAST_COMBO node combo-east-2 ssh-settings inter-router host-key-checking yes
```

- **[`inter-node host-key-checking`](config_command_guide.md#configure-authority-router-node-ssh-settings-inter-node-host-key-checking)** controls host key verification between redundant HA nodes. When set to `yes`, strict host key checking is enabled between the router and the conductor **between each node** of an HA router. However, the host keys must be manually provisioned on each router.

```
config authority router RTR_EAST_COMBO node combo-east-1 ssh-settings inter-node host-key-checking yes
config authority router RTR_EAST_COMBO node combo-east-2 ssh-settings inter-node host-key-checking yes
```

To configure a new authorized key for ssh inter-node communication, use the [`create system connectivity authorized-keys`](cli_reference.md#create-system-connectivity-authorized-keys) command. This command adds an entry to the ssh authorized keys file.

Use the following show commands to display additional key information:

- [`show system connectivity authorized-keys`](cli_reference.md#show-system-connectivity-authorized-keys) displays the authorized keys for ssh inter-node communication and tunneling.

- [`show system connectivity key-checking-mode`](cli_reference.md#show-system-connectivity-key-checking-mode) displays the key checking mode (Inter-Asset, Inter-Node, Inter-Router) across specified nodes.

To save the work of manually provisioning the host key on the router, set the `accept-new` parameter. This automatically loads the host key on first connection.

```
config authority router RTR_EAST_COMBO node combo-east-1 ssh-settings inter-router host-key-checking accept-new
```

Use the [`show system connectivity known-hosts`](cli_reference.md#show-system-connectivity-known-hosts) to view the accepted host keys for the current node.

#### Manual Provisioning of the Conductor Key

If a router is configured for strict `inter-router host-key-checking` (set to `yes`), but **does not** have `accept-new` configured, it will be necessary to manually provision the conductor key **prior** to onboarding the router to the conductor. This will require the administrator to retrieve the host key of each node of the conductor and configure this in the router.

On the conductor, identify the `key` for each node using the command [`show system connectivity host-keys node all`](cli_reference.md#show-system-connectivity-host-keys).

From the router PCLI, provision each conductor key using the following command:
`create system connectivity known-hosts node <node> <conductor address> ssh-rsa <key> <comment>`

- `<node>` is the router node. The key should be added on each router node in an HA pair.
- `<conductor address>` is the conductor address. This should be added for each conductor address of an HA conductor pair.
- `<key>` is the `Key` retrieved from the previous step.
- `<comment>` is an option that can be used to identify the key; for example `Conductor1`.

The following example manually configures the key to the conductor node `192.168.1.13`:

`create system connectivity known-hosts router RTR_EAST_COMBO node combo-east-1 [192.168.1.13]:930 ssh-rsa <public key contents>`

For additional information, see [`create system connectivity known-hosts`](cli_reference.md#create-system-connectivity-known-hosts).

### Root Access
To permit root access to the SSR system, ensure that there is at least one user configured on each system with super user (sudo) privileges. Failure to do so may result in the loss of management connectivity to the router.
**Logging in as `root` over SSH is not permitted.**
Expand Down Expand Up @@ -158,7 +215,7 @@ The root account will not be used for day-to-day access, but the root account pa

### Software Compliance Validation

After installing the SSR Software, it is important to verify that the installation successfully completed and that the system is running in the FIPS enforcememt mode required for Common Criteria compliance. After starting the SSR router or conductor, the login screen appears on the console. Alternatively you may `ssh` to the SSR management IP address using the admin account.
After installing the SSR Software, it is important to verify that the installation successfully completed and that the system is running in the FIPS enforcement mode required for Common Criteria compliance. After starting the SSR router or conductor, the login screen appears on the console. Alternatively you may `ssh` to the SSR management IP address using the admin account.

1. Login using the admin credentials.
2. Use `show system version` to verify the correct software release is running:
Expand Down Expand Up @@ -195,7 +252,7 @@ admin@conductor.conductor#

- Execute the self-test scan `sudo systemctl start 128T-rpm-verify`

The self-test scan is intiated and takes approximately two minutes to complete. Upon completion, run:
The self-test scan is initiated and takes approximately two minutes to complete. Upon completion, run:

`systemctl status 128T-rpm-verify`

Expand All @@ -217,7 +274,7 @@ admin@conductor.conductor#

The self-test is enabled on every subsequent reboot. If the self-test fails, the 128T service will not start.

6. Perform the following steps to verify that FIPS security enforcment mode is enabled in the OS:
6. Perform the following steps to verify that FIPS security enforcement mode is enabled in the OS:
`openssl md5 /dev/null`
Expected result: `digital envelope routines … Disabled for fips`

Expand Down Expand Up @@ -249,4 +306,4 @@ To terminate an active session:

- If using an account other than admin, type `exit` to end the login session.

Common Criteria certification does not require any restrictions on executing commands. See the [Configuration Command Reference Guide](https://www.juniper.net/documentation/us/en/software/session-smart-router/docs/config_command_guide) for command information and usage.
Common Criteria certification does not require any restrictions on executing commands. See the [Configuration Command Reference Guide](https://www.juniper.net/documentation/us/en/software/session-smart-router/docs/config_command_guide) for command information and usage.
Loading
Loading