Alert Type
PSN - Product Support Notification
Risk
Risk Description
Low/Notification
Notification for customer
Impact
Impact Description
Low/Notification
Notification for customer
Product Affected
All JUNOS
Alert Description
Customers are advised to install the latest
"os-package"
before staging the upgrade on JUNOS BSDx platforms.
A vast majority of all upgrade problems are due to limitations or bugs in the already running software that is performing the installation, rather than the new software being installed.
The
“os-package”
is designed to contain the latest version of the package system and is installable on any BSDX version (
FreeBSD 10 or later
) of Junos OS Release 15.1 or later.
Please find the JUNOS release starting with FreeBSD 10 or later for platforms
here
.
The package is architecture neutral.
Installation of
“os-package”
does not require a reboot. It takes only a few seconds to add and be immediately available for help with a planned upgrade.
When added, the
“os-package”
will check the
os-kernel
for a feature toggle, which indicates that it is safe to reboot with the
“os-package”
in the active set. If the toggle is missing, the following warning will be issued:
WARNING: do NOT reboot with os-package in 'active' set!
IMPORTANT NOTE:
The
“os-package”
is NOT bundled with JUNOS OS.
“os-package”
is needed only when the shipped JUNOS package that is running on a device needs to be updated to facilitate an upgrade.
Customer must use the latest package regardless of the ‘os-package’ installed previously on the device.
Solution
Where can I find the latest “os-package”?
For 18.X and Later
:
OS-Package Link
For 17.X and Older
:
OS-Package Link
What is the benefit of using “os-package”?
It facilitates the major BSD upgrades (e.g. 10 -> 11 or 11-> 12)
The goal of the
“os-package”
is to be backward compatible with all prior BSDx releases of JUNOS.
What will happen if customer do not upgrade the chassis after loading the “os-package”?
If the system rebooted without the upgrade,
“os-package”
will simply deactivate itself.
How the old “os-package” can be deleted?
Please run the below command to delete the older
“os-package”
>request system software delete os-package
Implementation
How to install the “os-package”?
“os-package”
installation is simple and takes only a few seconds.
1. Download the latest copy of
“
os-package”
and save it to the
/var/tmp
folder of the device,
NOTE
: Customer shall download the latest
“os-package”
when the upgrade is staged.
2. Install the package by using the
request system software add
command:
root@juniper> request system software add /var/tmp/os-package.tgz
NOTE
: It only takes a few seconds to run and does not need a reboot.
NOTE:
Do not add "os-package" when there is already a 'pending' set, else you will get no benefit from "
os-package
". Thus, if you see the following notice after adding "
os-package
", follow step #3
NOTICE: 'pending' set will be activated at next reboot...
3. If the above NOTICE is seen, perform the steps below
root@juniper> request system software rollback
4. Perform Step #1 and #2 to add
“os-package”
again.
Modification History
Initial version
Related Information
KB36647
[juniper.net]
– Internal Only
KB37712
[juniper.net]
– Internal Only
KB31198
[juniper.net]
– External specific to EX2300/EX3400
"os-package" recommendation on all JUNOS BSDx platforms in preparation for software upgrade