From e3a5d7957f91b7f877e763abefa234ba560847a8 Mon Sep 17 00:00:00 2001 From: Chris Date: Mon, 2 Feb 2026 14:08:18 -0500 Subject: [PATCH 1/3] for DOCS-468 --- docs/upgrade_restricted_access.md | 38 ++++++++++++------------------- 1 file changed, 14 insertions(+), 24 deletions(-) diff --git a/docs/upgrade_restricted_access.md b/docs/upgrade_restricted_access.md index 07b028061d..777cbc0a75 100644 --- a/docs/upgrade_restricted_access.md +++ b/docs/upgrade_restricted_access.md @@ -84,21 +84,17 @@ When using the `import iso` and `import rpm` commands to install plugins necessa The following process is used to upgrade a Conductor and Conductor-managed Routers to **version 6.3.0** of the SSR software. Beginning with SSR software version 6.3.0, a conductor can manage routers running image-based software installations. -1. On a system that has internet access, use the [ISO Download procedure](intro_downloading_iso.md#downloading-an-iso) to download the `128T-6.3.0-107.r1.el7.OTP.v1.x86_64.iso` from the [6.3 Package Based ISO Download](https://software.128technology.com/artifactory/list/generic-128t-isos-release-local/6.3/) page. +1. On a system that has internet access, use the [ISO Download procedure](intro_downloading_iso.md#downloading-an-iso) to download the `128T-6.3.0-107.r1.el7.OTP.v1.x86_64.iso` from the [6.3 Package Based ISO Download](https://software.128technology.com/artifactory/list/generic-128t-isos-release-local/6.3/) page to your device. -2. [Create a bootable USB](intro_creating_bootable_usb.md) drive from the downloaded ISO. +2. Import the `128T-6.3.0-107.r1.el7.OTP.v1.x86_64.iso` ISO onto the conductor using the [`import iso`](#import-iso) command. -3. Import the `128T-6.3.0-107.r1.el7.OTP.v1.x86_64.iso` ISO onto the conductor using the [`import iso`](#import-iso) command. +3. Upgrade the conductor using the [Conductor Upgrade procedure](upgrade_ibu_conductor.md). -4. Upgrade the conductor using the [Conductor Upgrade procedure](upgrade_ibu_conductor.md). +4. Download the `SSR-6.3.0-107.r1.el7.x86_64.ibu-v1.iso` from the [SSR Software Images](https://software.128technology.com/artifactory/list/generic-128t-install-images-release-local) page to your device. -5. Download the `SSR-6.3.0-107.r1.el7.x86_64.ibu-v1.iso` from the [SSR Software Images](https://software.128technology.com/artifactory/list/generic-128t-install-images-release-local) page. +5. Import the `SSR-6.3.0-xx.r1.el7.x86_64.ibu-v1.iso` ISO onto the conductor. The conductor will act as the software repository for the subsequent router upgrades. Do **not** install this package onto the conductor, only import it. -6. [Create a bootable USB](intro_creating_bootable_usb.md) drive from the SSR ISO. - -7. Import the `SSR-6.3.0-xx.r1.el7.x86_64.ibu-v1.iso` ISO onto the conductor. The conductor will act as the software repository for the subsequent router upgrades. Do **not** install this package onto the conductor, only import it. - -8. Upgrade individual routers using the [Router Upgrade](upgrade_router.md) procedure. +6. Upgrade individual routers using the [Router Upgrade](upgrade_router.md) procedure. :::note The process to upgrade a **conductor from a version less than 6.3.0 to 6.3.0 or greater** requires the use of the `128T-6.3.X-XX.r1.el7.OTP.v1.x86_64.iso` package based 128T ISO. After the initial upgrade to 6.3.X, all future upgrades will only require the import of the image-based SSR ISO; for example, `SSR-6.3.3-1.r1.el7.x86_64.ibu-v1.iso`. @@ -115,25 +111,21 @@ The process to upgrade a **conductor to 6.3.0** requires the use of the `128T-6. ::: -1. On a system that has internet access, use the [ISO Download procedure](intro_downloading_iso.md#downloading-an-iso) to download the `128T-6.3.0-107.r1.el7.OTP.v1.x86_64.iso` from the [SSR ISO Download](https://software.128technology.com/artifactory/list/generic-128t-isos-release-local) page. +1. On a system that has internet access, use the [ISO Download procedure](intro_downloading_iso.md#downloading-an-iso) to download the `128T-6.3.0-107.r1.el7.OTP.v1.x86_64.iso` from the [SSR ISO Download](https://software.128technology.com/artifactory/list/generic-128t-isos-release-local) page to your device. -2. [Create a bootable USB](intro_creating_bootable_usb.md) drive from the SSR ISO. +2. Import the `128T-6.3.0-107.r1.el7.OTP.v1.x86_64.iso` ISO onto the conductor using the [`import iso`](#import-iso) command. -3. Import the `128T-6.3.0-107.r1.el7.OTP.v1.x86_64.iso` ISO onto the conductor using the [`import iso`](#import-iso) command. +3. Upgrade the conductor using the [Conductor Upgrade procedure](upgrade_ibu_conductor.md). -4. Upgrade the conductor using the [Conductor Upgrade procedure](upgrade_ibu_conductor.md). - -5. Navigate to the [SSR Software Images](https://software.128technology.com/artifactory/list/generic-128t-install-images-release-local) page, identify the software image version you will use to upgrade the target router or routers, and download it. +5. Navigate to the [SSR Software Images](https://software.128technology.com/artifactory/list/generic-128t-install-images-release-local) page, identify the software image version you will use to upgrade the target router or routers, and download it to your device. For example, if you are upgrading a router to SSR Version 6.1.10, you will need to download the following files: - `SSR-6.1.10-8.lts.el7.x86_64.ibu-v1.iso` -6. [Create a bootable USB](intro_creating_bootable_usb.md) drive from the SSR ISO. - -7. Import the `SSR-6.1.10-8.lts.el7.x86_64.ibu-v1.iso` ISO onto the conductor. The conductor will act as the software repository for the subsequent router upgrades. Do **not** install this package onto the conductor, only import it. +6. Import the `SSR-6.1.10-8.lts.el7.x86_64.ibu-v1.iso` ISO onto the conductor. The conductor will act as the software repository for the subsequent router upgrades. Do **not** install this package onto the conductor, only import it. -8. Upgrade individual routers using the [Router Upgrade](upgrade_router.md) procedure. +7. Upgrade individual routers using the [Router Upgrade](upgrade_router.md) procedure. :::note In an HA setup, when using offline-mode for routers to access the software from the conductors, the ISO must be imported to both conductors before performing the upgrade. @@ -145,9 +137,7 @@ For upgrades of Conductor and Conductor-managed routers to software versions pri In this example workflow, the conductor will be upgraded to 6.2.6, and the routers to 6.1.10. -1. On a system that has internet access, use the [ISO Download procedure](intro_downloading_iso.md#downloading-an-iso) to download the `128T-6.2.6-15.sts.el7.OTP.v1.x86_64.iso` software package from the [128T package-based ISO Download](https://software.128technology.com/artifactory/list/generic-128t-isos-release-local) page. - -2. [Create a bootable USB](intro_creating_bootable_usb.md) drive from the SSR ISO. +1. On a system that has internet access, use the [ISO Download procedure](intro_downloading_iso.md#downloading-an-iso) to download the `128T-6.2.6-15.sts.el7.OTP.v1.x86_64.iso` software package from the [128T package-based ISO Download](https://software.128technology.com/artifactory/list/generic-128t-isos-release-local) page to your device. 3. Plug the USB into your device. @@ -155,7 +145,7 @@ In this example workflow, the conductor will be upgraded to 6.2.6, and the route 5. Upgrade the conductor using the [Conductor Upgrade procedure](upgrade_ibu_conductor.md). -6. Download the `128T-6.1.10-8.lts.el7.OTP.v1.x86_64.iso` software package from the [SSR ISO Download](https://software.128technology.com/artifactory/list/generic-128t-isos-release-local) page. +6. Download the `128T-6.1.10-8.lts.el7.OTP.v1.x86_64.iso` software package from the [SSR ISO Download](https://software.128technology.com/artifactory/list/generic-128t-isos-release-local) page to your device. 7. Import the `128T-6.1.10-8.lts.el7.OTP.v1.x86_64.iso` package onto the conductor using the [`import iso`](#import-iso) command. The conductor will act as the software repository for the subsequent router upgrades. You do **not** install this package onto the conductor, only import it. From 3403c00703fa27b4f564ece88f32f909c4a0d909 Mon Sep 17 00:00:00 2001 From: Chris Date: Tue, 3 Feb 2026 09:17:34 -0500 Subject: [PATCH 2/3] updates per DOCS498/I95-58622 --- docs/concepts_ssr_idp.md | 8 ++++++++ docs/release_notes_128t_6.3.md | 5 +++++ 2 files changed, 13 insertions(+) diff --git a/docs/concepts_ssr_idp.md b/docs/concepts_ssr_idp.md index 6508588d40..8e915f9980 100644 --- a/docs/concepts_ssr_idp.md +++ b/docs/concepts_ssr_idp.md @@ -99,6 +99,14 @@ When the router is configured with `forwarding-core-mode` as manual, the adminis The system requires a reboot for the IDP core allocation; after upgrading to SSR 6.x for the first time, an additional reboot is required to enable the IDP engine. ::: +Software version 6.3.3-R2 introduces the support of multi-core capabilities for IDP for image-based routers. For customers running IDP on older image-based firmware versions (6.3.0-R1 and under) on the SSR1300, SSR1400, and SSR1500, IDP multicore will be automatically enabled when upgrading to 6.3.3-R2. In some cases, after an upgrade the IDP engine can fail to start as it transitions from single-core to multi-core mode. When the IDP engine fails to start, the following alarm will be generated on the system: `IDP engine unable to start; reboot-required`. In this situation, it is recommended to reboot the system post-upgrade to ensure future reliable reboots with IDP multi-core enabled. + +For legacy package-based routers, multi-core IDP capability is not supported, and those systems will continue to operate in the single-core mode. + +:::note +Multi-core IDP is not supported on the following SSR devices: SSR120, SSR130, and SSR1200. +::: + ## Limitations The following is a list of the current limitations of the IDP solution. diff --git a/docs/release_notes_128t_6.3.md b/docs/release_notes_128t_6.3.md index bdd4448308..119a0031f6 100644 --- a/docs/release_notes_128t_6.3.md +++ b/docs/release_notes_128t_6.3.md @@ -394,6 +394,11 @@ Beginning with SSR-6.3.5, conductor-managed **routers** running SSR-6.3.5 must b ### Caveats - **I95-58622 IDP Engine Intermittent Start-up:** 6.3.3-R2 introduces the support of multi-core capabilities for IDP for image-based routers. For legacy package-based routers, multi-core IDP capability is not supported, and those systems will continue to operate in the single-core mode. For customers running IDP on older image-based firmware versions (6.3.0-R1 and under) on the SSR1300, SSR1400, and SSR1500, IDP multicore will be automatically enabled when upgrading to 6.3.3-R2. In some cases, after an upgrade the IDP engine can fail to start as it transitions from single-core to multi-core mode. When the IDP engine fails to start, the following alarm will be generated on the system: `IDP engine unable to start; reboot-required`. In this situation, it is recommended to reboot the system post-upgrade to ensure future reliable reboots with IDP multi-core enabled. + +:::note +Multi-core IDP is not supported on the following SSR devices: SSR120, SSR130, and SSR1200. +::: + ------ - **I95-58782 `node.js` process may crash on SSR120, SSR130, and other branch router devices while generating Swagger documentation:** The `node.js` process may crash on SSR120, SSR130, and other branch router devices during SSR application startup while generating Swagger documentation. This is due to an internal error, and will generate a `node.js` coredump, but has **no impact** on the SSR. Swagger documentation is generated on a subsequent restart of the SSR. This is not service impacting. ------ From 0f74ca70f7bf4d11e4dbb656a59e19bc8574cf5c Mon Sep 17 00:00:00 2001 From: Chris Date: Tue, 3 Feb 2026 10:09:59 -0500 Subject: [PATCH 3/3] updates per James' first comment. No change made for second one. --- docs/concepts_ssr_idp.md | 2 +- docs/release_notes_128t_6.3.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/concepts_ssr_idp.md b/docs/concepts_ssr_idp.md index 8e915f9980..172056040f 100644 --- a/docs/concepts_ssr_idp.md +++ b/docs/concepts_ssr_idp.md @@ -99,7 +99,7 @@ When the router is configured with `forwarding-core-mode` as manual, the adminis The system requires a reboot for the IDP core allocation; after upgrading to SSR 6.x for the first time, an additional reboot is required to enable the IDP engine. ::: -Software version 6.3.3-R2 introduces the support of multi-core capabilities for IDP for image-based routers. For customers running IDP on older image-based firmware versions (6.3.0-R1 and under) on the SSR1300, SSR1400, and SSR1500, IDP multicore will be automatically enabled when upgrading to 6.3.3-R2. In some cases, after an upgrade the IDP engine can fail to start as it transitions from single-core to multi-core mode. When the IDP engine fails to start, the following alarm will be generated on the system: `IDP engine unable to start; reboot-required`. In this situation, it is recommended to reboot the system post-upgrade to ensure future reliable reboots with IDP multi-core enabled. +Software version 6.3.3-R2 introduces the support of multi-core capabilities for IDP for image-based routers. For customers running IDP on older image-based firmware versions (6.3.0-R1 and under) on the SSR1300, SSR1400, and SSR1500, IDP multicore will be automatically enabled when upgrading to 6.3.3-R2. In some cases, after an upgrade the IDP engine can fail to start as it transitions from single-core to multi-core mode. When the IDP engine fails to start, the following alarm will be generated on the system: `IDP engine unable to start; reboot-required`. In this situation, it is required to reboot the system post-upgrade allocate system resources with IDP multi-core enabled. A reboot is required for any subsequent disable/enable actions. For legacy package-based routers, multi-core IDP capability is not supported, and those systems will continue to operate in the single-core mode. diff --git a/docs/release_notes_128t_6.3.md b/docs/release_notes_128t_6.3.md index 119a0031f6..e256a79084 100644 --- a/docs/release_notes_128t_6.3.md +++ b/docs/release_notes_128t_6.3.md @@ -393,7 +393,7 @@ Beginning with SSR-6.3.5, conductor-managed **routers** running SSR-6.3.5 must b ### Caveats -- **I95-58622 IDP Engine Intermittent Start-up:** 6.3.3-R2 introduces the support of multi-core capabilities for IDP for image-based routers. For legacy package-based routers, multi-core IDP capability is not supported, and those systems will continue to operate in the single-core mode. For customers running IDP on older image-based firmware versions (6.3.0-R1 and under) on the SSR1300, SSR1400, and SSR1500, IDP multicore will be automatically enabled when upgrading to 6.3.3-R2. In some cases, after an upgrade the IDP engine can fail to start as it transitions from single-core to multi-core mode. When the IDP engine fails to start, the following alarm will be generated on the system: `IDP engine unable to start; reboot-required`. In this situation, it is recommended to reboot the system post-upgrade to ensure future reliable reboots with IDP multi-core enabled. +- **I95-58622 IDP Engine Intermittent Start-up:** 6.3.3-R2 introduces the support of multi-core capabilities for IDP for image-based routers. For legacy package-based routers, multi-core IDP capability is not supported, and those systems will continue to operate in the single-core mode. For customers running IDP on older image-based firmware versions (6.3.0-R1 and under) on the SSR1300, SSR1400, and SSR1500, IDP multicore will be automatically enabled when upgrading to 6.3.3-R2. In some cases, after an upgrade the IDP engine can fail to start as it transitions from single-core to multi-core mode. When the IDP engine fails to start, the following alarm will be generated on the system: `IDP engine unable to start; reboot-required`. In this situation, it is required to reboot the system post-upgrade allocate system resources with IDP multi-core enabled. A reboot is required for any subsequent disable/enable actions. :::note Multi-core IDP is not supported on the following SSR devices: SSR120, SSR130, and SSR1200.