Preparing for Software Installation and Upgrade (Junos OS)
Before you install or upgrade Junos OS, you must ensure some basic checks such as sufficient disk space availability and backing up configurations in place.
Upgrade or Reinstall Junos OS
- Checklist for Reinstalling Junos OS
- Log the Software Version Information (Junos OS)
- Log the Hardware Version Information (Junos OS)
- Log the Chassis Environment Information (Junos OS)
- Log the System Boot-Message Information (Junos OS)
- Log the Active Configuration (Junos OS)
- Log the Interfaces on the Router (Junos OS)
- Log the BGP, IS-IS, and OSPF Adjacency Information (Junos OS)
- Log the System Storage Information (Junos OS)
Checklist for Reinstalling Junos OS
Table 1 provides links and commands for reinstalling Junos OS.
Tasks |
Command or Action |
---|---|
Before You Reinstall Junos OS | |
|
|
|
|
|
|
|
|
|
|
|
|
Log the BGP, IS-IS, and OSPF Adjacency Information (Junos OS) |
|
|
|
|
|
Reinstall Junos OS | Insert your removable medium and reboot the system. |
Reconfigure Junos OS | |
Configure Host Names, Domain Names, and IP Addresses |
Log in as root.Start the CLI.Enter configuration mode: |
Protect Network Security by Configuring the Root Password |
|
Check Network Connectivity |
|
|
|
After You Reinstall Junos OS | |
|
|
|
Log the Software Version Information (Junos OS)
Purpose
The purpose of this action is to log the Junos OS version information.
Action
Use the following Junos OS CLI operational mode command:
user@host> show version | save filename
Sample Output
user@host> show version | save test Wrote 39 lines of output to ‘test’ user@host> show version Hostname: my-router.net Model: m10 JUNOS Base OS boot [5.0R5] JUNOS Base OS Software Suite [5.0R5] JUNOS Kernel Software Suite [5.0R5] JUNOS Routing Software Suite [5.0R5] JUNOS Packet Forwarding Engine Support [5.0R5] JUNOS Crypto Software Suite [5.0R5] JUNOS Online Documentation [5.0R5] KERNEL 5.0R5 #0 built by builder on 2002-03-02 05:10:28 UTC MGD release 5.0R5 built by builder on 2002-03-02 04:45:32 UTC CLI release 5.0R5 built by builder on 2002-03-02 04:44:22 UTC CHASSISD release 5.0R5 built by builder on 2002-03-02 04:43:37 UTC DCD release 5.0R5 built by builder on 2002-03-02 04:42:47 UTC RPD release 5.0R5 built by builder on 2002-03-02 04:46:17 UTC SNMPD release 5.0R5 built by builder on 2002-03-02 04:52:26 UTC MIB2D release 5.0R5 built by builder on 2002-03-02 04:45:37 UTC APSD release 5.0R5 built by builder on 2002-03-02 04:43:31 UTC VRRPD release 5.0R5 built by builder on 2002-03-02 04:52:34 UTC ALARMD release 5.0R5 built by builder on 2002-03-02 04:43:24 UTC PFED release 5.0R5 built by builder on 2002-03-02 04:46:06 UTC CRAFTD release 5.0R5 built by builder on 2002-03-02 04:44:30 UTC SAMPLED release 5.0R5 built by builder on 2002-03-02 04:52:20 UTC ILMID release 5.0R5 built by builder on 2002-03-02 04:45:21 UTC BPRELAYD release 5.0R5 built by builder on 2002-03-02 04:42:41 UTC RMOPD release 5.0R5 built by builder on 2002-03-02 04:46:11 UTC jkernel-dd release 5.0R5 built by builder on 2002-03-02 04:41:07 UTC jroute-dd release 5.0R5 built by builder on 2002-03-02 04:41:21 UTC jdocs-dd release 5.0R5 built by builder on 2002-03-02 04:39:11 UTC
Meaning
The sample output shows the hostname, router model, and the different Junos OS packages, processes, and documents.
Log the Hardware Version Information (Junos OS)
Purpose
You should log hardware version information in the rare event that a router cannot successfully reboot and you cannot obtain the Routing Engine serial number. The Routing Engine serial number is necessary for Juniper Networks Technical Assistance Center (JTAC) to issue a return to manufacturing authorization (RMA). Without the Routing Engine serial number, an onsite technician must be dispatched to issue the RMA.
Action
To log the router chassis hardware version information, use the following Junos OS CLI operational mode command:
user@host> show chassis hardware | save filename
Sample Output
The output for the M-series routers varies depending on the chassis components of each router. All routers have a chassis, midplanes or backplanes, power supplies, and Flexible PIC Concentrators (FPCs). Refer to the hardware guides for information about the different chassis components.
user@host> show chassis hardware | save test Wrote 43 lines of output to ‘test’ user@host> show chassis hardware Item Version Part number Serial number Description Chassis 101 M160 Midplane REV 02 710-001245 S/N AB4107 FPM CMB REV 01 710-001642 S/N AA2911 FPM Display REV 01 710-001647 S/N AA2999 CIP REV 02 710-001593 S/N AA9563 PEM 0 Rev 01 740-001243 S/N KJ35769 DC PEM 1 Rev 01 740-001243 S/N KJ35765 DC PCG 0 REV 01 710-001568 S/N AA9794 PCG 1 REV 01 710-001568 S/N AA9804 Host 1 da000004f8d57001 teknor MCS 1 REV 03 710-001226 S/N AA9777 SFM 0 SPP REV 04 710-001228 S/N AA2975 SFM 0 SPR REV 02 710-001224 S/N AA9838 Internet Processor I SFM 1 SPP REV 04 710-001228 S/N AA2860 SFM 1 SPR REV 01 710-001224 S/N AB0139 Internet Processor I FPC 0 REV 03 710-001255 S/N AA9806 FPC Type 1 CPU REV 02 710-001217 S/N AA9590 PIC 1 REV 05 750-000616 S/N AA1527 1x OC-12 ATM, MM PIC 2 REV 05 750-000616 S/N AA1535 1x OC-12 ATM, MM PIC 3 REV 01 750-000616 S/N AA1519 1x OC-12 ATM, MM FPC 1 REV 02 710-001611 S/N AA9523 FPC Type 2 CPU REV 02 710-001217 S/N AA9571 PIC 0 REV 03 750-001900 S/N AA9626 1x STM-16 SDH, SMIR PIC 1 REV 01 710-002381 S/N AD3633 2x G/E, 1000 BASE-SX FPC 2 FPC Type OC192 CPU REV 03 710-001217 S/N AB3329 PIC 0 REV 01 1x OC-192 SM SR-2
Meaning
The sample output shows the hardware inventory for an M160 router with a chassis serial number of 101. For each component, the output shows the version number, part number, serial number, and description.
Log the Chassis Environment Information (Junos OS)
Action
To log the router chassis environment information, use the following Junos OS CLI operational mode command:
user@host> show chassis environment | save filename
Sample Output
The following example shows output from the show chassis
environment
command for an M5 router:
user@m5-host> show chassis environment | save test Wrote 14 lines of output to ‘test’ user@m5-host> show chassis environment Class Item Status Measurement Power Power Supply A OK Power Supply B OK Temp FPC Slot 0 OK 32 degrees C / 89 degrees F FEB OK 31 degrees C / 87 degrees F PS Intake OK 26 degrees C / 78 degrees F PS Exhaust OK 31 degrees C / 87 degrees F Fans Left Fan 1 OK Spinning at normal speed Left Fan 2 OK Spinning at normal speed Left Fan 3 OK Spinning at normal speed Left Fan 4 OK Spinning at normal speed
Meaning
The sample output shows the environmental information about the router chassis, including the temperature and information about the fans, power supplies, and Routing Engine.
Log the System Boot-Message Information (Junos OS)
Action
To log the system boot-message information, use the following Junos OS CLI operational mode command:
user@host> show system boot-messages | save filename
Sample Output
user@host> show system boot-messages | save test Wrote 80 lines of output to ‘test’ user@host> show system boot-messages Copyright (c) 1992-1998 FreeBSD Inc. Copyright (c) 1996-2000 Juniper Networks, Inc. All rights reserved. Copyright (c) 1982, 1986, 1989, 1991, 1993 The Regents of the University of California. All rights reserved. JUNOS 4.1-20000216-Zf8469 #0: 2000-02-16 12:57:28 UTC tlim@device1.example.com:/p/build/20000216-0905/4.1/release_kernel/sys/compile/GENERIC CPU: Pentium Pro (332.55-MHz 686-class CPU) Origin = "GenuineIntel" Id = 0x66a Stepping=10 Features=0x183f9ff<FPU,VME,DE,PSE,TSC,MSR,PAE,MCE,CX8,SEP,MTRR,PGE,MCA,CMOV,<b16>,<b17>,MMX,<b24>> Teknor CPU Card Recognized real memory = 805306368 (786432K bytes) avail memory = 786280448 (767852K bytes) Probing for devices on PCI bus 0: chip0 <generic PCI bridge (vendor=8086 device=7192 subclass=0)> rev 3 class 60000 on pci0:0:0 chip1 <Intel 82371AB PCI-ISA bridge> rev 1 class 60100 on pci0:7:0 chip2 <Intel 82371AB IDE interface> rev 1 class 10180 on pci0:7:1 chip3 <Intel 82371AB USB interface> rev 1 class c0300 int d irq 11 on pci0:7:2 smb0 <Intel 82371AB SMB controller> rev 1 class 68000 on pci0:7:3 pcic0 <TI PCI-1131 PCI-CardBus Bridge> rev 1 class 60700 int a irq 15 on pci0:13:0 TI1131 PCI Config Reg: [pci only][FUNC0 pci int] pcic1 <TI PCI-1131 PCI-CardBus Bridge> rev 1 class 60700 int b irq 12 on pci0:13:1 TI1131 PCI Config Reg: [pci only][FUNC1 pci int] fxp0 <Intel EtherExpress Pro 10/100B Ethernet> rev 8 class 20000 int a irq 12 on pci0:16:0 chip4 <generic PCI bridge (vendor=1011 device=0022 subclass=4)> rev 4 class 60400 on pci0:17:0 fxp1 <Intel EtherExpress Pro 10/100B Ethernet> rev 8 class 20000 int a irq 10 on pci0:19:0 Probing for devices on PCI bus 1:mcs0 <Miscellaneous Control Subsystem> rev 12 class ff0000 int a irq 12 on pci1:13:0 fxp2 <Intel EtherExpress Pro 10/100B Ethernet> rev 8 class 20000 int a irq 10 on pci1:14:0 Probing for devices on the ISA bus: sc0 at 0x60-0x6f irq 1 on motherboard sc0: EGA color <16 virtual consoles, flags=0x0> ed0 not found at 0x300 ed1 not found at 0x280 ed2 not found at 0x340 psm0 not found at 0x60 sio0 at 0x3f8-0x3ff irq 4 flags 0x20010 on isa sio0: type 16550A, console sio1 at 0x3e8-0x3ef irq 5 flags 0x20000 on isa sio1: type 16550A sio2 at 0x2f8-0x2ff irq 3 flags 0x20000 on isa sio2: type 16550A pcic0 at 0x3e0-0x3e1 on isa PC-Card ctlr(0) TI PCI-1131 [CardBus bridge mode] (5 mem & 2 I/O windows) pcic0: slot 0 controller I/O address 0x3e0 npx0 flags 0x1 on motherboard npx0: INT 16 interface fdc0: direction bit not set fdc0: cmd 3 failed at out byte 1 of 3 fdc0 not found at 0x3f0 wdc0 at 0x1f0-0x1f7 irq 14 on isa wdc0: unit 0 (wd0): <SunDisk SDCFB-80>, single-sector-i/o wd0: 76MB (156672 sectors), 612 cyls, 8 heads, 32 S/T, 512 B/S wdc0: unit 1 (wd1): <IBM-DCXA-210000> wd1: 8063MB (16514064 sectors), 16383 cyls, 16 heads, 63 S/T, 512 B/S wdc1 not found at 0x170 wdc2 not found at 0x180 ep0 not found at 0x300 fxp0: Ethernet address 00:a0:a5:12:05:5a fxp1: Ethernet address 00:a0:a5:12:05:59 fxp2: Ethernet address 02:00:00:00:00:01 swapon: adding /dev/wd1s1b as swap device Automatic reboot in progress... /dev/rwd0s1a: clean, 16599 free (95 frags, 2063 blocks, 0.1% fragmentation) /dev/rwd0s1e: clean, 9233 free (9 frags, 1153 blocks, 0.1% fragmentation) /dev/rwd0s1a: clean, 16599 free (95 frags, 2063 blocks, 0.1% fragmentation) /dev/rwd1s1f: clean, 4301055 free (335 frags, 537590 blocks, 0.0% fragmentation)
Meaning
The sample output shows the initial messages generated by the system kernel upon boot. This is the content of the /var/run/dmesg.boot file.
Log the Active Configuration (Junos OS)
Action
To log the active configuration on the router, use the following Junos OS CLI operational mode command:
user@host> show configuration | save filename
Sample Output
user@host> show configuration | save test Wrote 4076 lines of output to ‘test’ user@host> show configuration system { host-name lab8; domain-name device1.example.com; backup-router 10.1.1.254; time-zone America/Los_Angeles; default-address-selection; dump-on-panic; name-server { [...Output truncated...]
Meaning
The sample output shows the configuration currently running on the router, which is the last committed configuration.
Log the Interfaces on the Router (Junos OS)
Action
To log the interfaces on the router, use the following Junos OS CLI operational mode command:
user@host> show interface terse | save filename
Sample Output
user@host> show interfaces terse | save test Wrote 81 lines of output to ‘test’ user@host> show interfaces terse Interface Admin Link Proto Local Remote at-1/3/0 up up at-1/3/0.0 up up inet 203.0.113.1 --> 203.0.113.2 iso fxp0 up up fxp0.0 up up inet 10.168.5.59/24 gre down up ipip down up lo0 up up lo0.0 up up inet 127.0.0.1 --> 0/0 iso 47.0005.80ff.f800.0000.0108.0001.1921.6800.5059.00 so-1/2/0 up down so-1/2/1 down down so-1/2/2 down down so-1/2/3 down down so-2/0/0 up up so-2/0/0.0 up up inet 192.2.3.4 --> 192.2.3.5 iso [...Output truncated...]
Meaning
The sample output displays summary information about the physical and logical interfaces on the router.
Log the BGP, IS-IS, and OSPF Adjacency Information (Junos OS)
Purpose
The following commands log useful information about Border Gateway Protocol (BGP), Intermediate System-to-Intermediate System (IS-IS), and Open Shortest Path First (OSPF) protocols. If you have other protocols installed, such as Multiprotocol Label Switching (MPLS), Resource Reservation Protocol (RSVP), or Protocol Independent Multicast (PIM), you also might log summary information for them.
Action
To log the protocol peer information, use the following Junos OS CLI operational mode commands:
user@host> show bgp summary | savefilename
user@host> show isis adjacency brief | savefilename
user@host> show ospf neighbor brief | savefilename
Sample Output 1
user@host> show bgp summary | save test Wrote 45 lines of output to ‘test’ user@host> show bgp summary Groups: 1 Peers: 1 Down peers: 0 Table Tot Paths Act Paths Suppressed History Damp State Pending inet.0 4 4 0 0 0 0 Peer AS InPkt OutPkt OutQ Flaps Last Up/Dwn State|#Active/Received/Damped.. 9.9.3.1 2 2627 2628 0 0 21:50:12 4/4/0 0/0/0
Sample Output 2
user@host> show isis adjacency brief | save test Wrote 7 lines of output to ‘test’ user@host> show isis adjacency brief IS-IS adjacency database: Interface System L State Hold (secs) SNPA so-1/0/0.0 1921.6800.5067 2 Up 13 so-1/1/0.0 1921.6800.5067 2 Up 25 so-1/2/0.0 1921.6800.5067 2 Up 20 so-1/3/0.0 1921.6800.5067 2 Up 19 so-2/0/0.0 1921.6800.5066 2 Up 19 so-2/1/0.0 1921.6800.5066 2 Up 17 so-2/2/0.0 1921.6800.5066 2 Up 20 so-2/3/0.0 1921.6800.5066 2 Up 20 so-5/0/0.0 ranier 2 Up 17
Sample Output 3
user@host> show ospf neighbor brief | save test Wrote 10 lines of output to ‘test’ user@host> show ospf neighbor brief Address Intf State ID Pri Dead 10.168.254.225 fxp3.0 2Way 10.250.240.32 128 36 10.168.254.230 fxp3.0 Full 10.250.240.8 128 38 10.168.254.229 fxp3.0 Full 10.250.240.35 128 33 10.1.1.129 fxp2.0 Full 10.250.240.12 128 37 10.1.1.131 fxp2.0 Full 10.250.240.11 128 38 10.1.2.1 fxp1.0 Full 10.250.240.9 128 32 10.1.2.81 fxp0.0 Full 10.250.240.10 128 33
Meaning
Sample output 1 displays summary information about BGP and its neighbors. Sample output 2 displays information about IS-IS neighbors. Sample output 3 displays information about all OSPF neighbors.
Log the System Storage Information (Junos OS)
Action
To log the system storage statistics for the amount of free disk space in the router’s file system, use the following Junos OS CLI operational mode command:
user@host> show system storage | save filename
Sample Output
user@host> show system storage | save test Wrote 14 lines of output to ‘test’ user@host> show system storage Filesystem 1K-blocks Used Avail Capacity Mounted on /dev/ad0s1a 65687 26700 33733 44% / devfs 16 16 0 100% /dev/ /dev/vn1 9310 9310 0 100% /packages/mnt/jbase /dev/vn2 8442 8442 0 100% /packages/mnt/jkernel-5.0R5.1 /dev/vn3 11486 11486 0 100% /packages/mnt/jpfe-5.0R5.1 /dev/vn4 5742 5742 0 100% /packages/mnt/jroute-5.0R5.1 /dev/vn5 1488 1488 0 100% /packages/mnt/jcrypto-5.0R5.1 /dev/vn6 792 792 0 100% /packages/mnt/jdocs-5.0R5.1 mfs:2373 1015815 3 934547 0% /tmp /dev/ad0s1e 25263 11 23231 0% /config procfs 4 4 0 100% /proc /dev/ad1s1f 9825963 1811085 7228801 20% /var
Meaning
The sample output displays statistics about the amount of free disk space in the router’s file system. Values are displayed in 1024-byte (1-KB) blocks.
Validating the Configuration Image Before Upgrading or Downgrading the Software (Junos OS)
Here are some validation guidelines to keep in mind:
Validation is set to on by default. You do not need to configure it or issue any command to start it on a switch that supports image validation. You can disable validation (the procedure is given below) and then re-enable it.
Validation slows down the upgrade or downgrade process by as much as 7 minutes.
Image validation is supported only on the jinstall package.
If you invoke validation from an image that does not support validation, the new image is loaded but validation does not occur.
Validation does not work in a downgrade to an image that does not support validation if your system is configured for graceful routing switchover (GRES) or if you run image loading without nonstop software upgrade (NSSU). See the procedure below for steps to use validation in this type of scenario.
If you upgrade or downgrade the Junos OS image on a switch that supports configuration image validation (see Feature Explorer for feature support per EX Series switch), the system validates that the existing configuration is compatible with the new image before the actual upgrade or downgrade commences.
Benefits of image validation—If validation fails, the new image is not loaded, and an error message provides information about the failure. If you upgrade or downgrade the software on a system that does not support validation, configuration incompatibilities between the existing and new image or insufficient memory to load the new image might cause the system to lose its current configuration or go offline.
To disable validation, re-enable or invoke validation manually, or use validation when downgrading to an image that does not support it:
Ensuring Sufficient Disk Space for Junos OS Upgrades on SRX Series Firewalls
Before you begin upgrading Junos OS on an SRX Series Firewall, perform the following tasks:
Verifying Available Disk Space on SRX Series Devices
The amount of free disk space necessary to upgrade a device with a new version of Junos OS can vary from one release to another. Check the Junos OS software version you are installing to determine the free disk space requirements.
If the amount of free disk space on a device is insufficient for installing Junos OS, you might receive a warning similar to the following messages, that the /var filesystem is low on free disk space:
WARNING: The /var filesystem is low on free disk space.
WARNING: This package requires 1075136k free, but there is only 666502k available.
To determine the amount of free disk space on the device, issue
the show system storage detail
command. The command output
displays statistics about the amount of free disk space in the device
file systems.
A sample of the show system storage detail
command
output is shown below:
user@host> show system storage detail Filesystem 1024-blocks Used Avail Capacity Mounted on /dev/da0s2a 300196 154410 121772 56% / devfs 1 1 0 100% /dev /dev/md0 409000 409000 0 100% /junos /cf 300196 154410 121772 56% /junos/cf devfs 1 1 0 100% /junos/dev/ procfs 4 4 0 100% /proc /dev/bo0s3e 25004 52 22952 0% /config /dev/bo0s3f 350628 178450 144128 55% /cf/var /dev/md1 171860 16804 141308 11% /mfs /cf/var/jail 350628 178450 144128 55% /jail/var /cf/var/log 350628 178450 144128 55% /jail/var/log devfs 1 1 0 100% /jail/dev /dev/md2 40172 4 36956 0% /mfs/var/run/utm /dev/md3 1884 138 1596 8% /jail/mfs
Cleaning Up the System File Storage Space
When the system file storage space on the device is full, rebooting the device does not solve the problem. The following error message is displayed during a typical operation on the device after the file storage space is full.
user@host% cli
user@host> configure/var: write failed, filesystem is full
You can clean up the file storage on the device by deleting
system files using the request system storage cleanup
command
as shown in following procedure:
Verifying Junos OS and Boot Loader Software Versions on an EX Series Switch
Before or after upgrading or downgrading Junos OS, you might need to verify the Junos OS version. You might also need to verify the boot loader software version if you are upgrading to or downgrading from a release that supports resilient dual-root partitions (Junos OS Release 10.4R3 and later).
This topic includes:
- Verifying the Number of Partitions and File System Mountings
- Verifying the Loader Software Version
- Verifying Which Root Partition Is Active
- Verifying the Junos OS Version in Each Root Partition
Verifying the Number of Partitions and File System Mountings
Purpose
Between Junos OS Release 10.4R2 and Release 10.4R3, upgrades were made to further increase resiliency of root partitions, which required reformatting the disk from three partitions to four partitions. If your switch is running Release 10.4R2 or earlier, it has three partitions, and if it is running Release 10.4R3 or later, it has four partitions.
Action
Verify how many partitions the disk has, as well as where each file system is mounted, by using the following command:
user@switch> show system storage fpc0: ----------------------------------------------------------------------- Filesystem Size Used Avail Capacity Mounted on /dev/da0s1a 184M 124M 45M 73% / devfs 1.0K 1.0K 0B 100% /dev /dev/md0 37M 37M 0B 100% /packages/mnt/jbase /dev/md1 18M 18M 0B 100% /packages/mnt/jcrypto-ex-10.4I20110121_0509_hbRPSRLI15184421081 /dev/md2 6.1M 6.1M 0B 100% /packages/mnt/jdocs-ex-10.4I20110121_0509_hbRPSRLI15184421081 /dev/md3 154M 154M 0B 100% /packages/mnt/jkernel-ex-10.4I20110121_0509_hbRPSRLI15184421081 /dev/md4 23M 23M 0B 100% /packages/mnt/jpfe-ex42x-10.4I20110121_0509_hbRPSRLI15184421081 /dev/md5 46M 46M 0B 100% /packages/mnt/jroute-ex-10.4I20110121_0509_hbRPSRLI15184421081 /dev/md6 28M 28M 0B 100% /packages/mnt/jswitch-ex-10.4I20110121_0509_hbRPSRLI15184421081 /dev/md7 22M 22M 0B 100% /packages/mnt/jweb-ex-10.4I20110121_0509_hbRPSRLI15184421081 /dev/md8 126M 10.0K 116M 0% /tmp /dev/da0s3e 123M 632K 112M 1% /var /dev/da0s3d 369M 20K 339M 0% /var/tmp /dev/da0s4d 62M 62K 57M 0% /config /dev/md9 118M 12M 96M 11% /var/rundb procfs 4.0K 4.0K 0B 100% /proc /var/jail/etc 123M 632K 112M 1% /packages/mnt/jweb-ex-10.4I20110121_0509_hbRPSRLI15184421081/jail/var/etc /var/jail/run 123M 632K 112M 1% /packages/mnt/jweb-ex-10.4I20110121_0509_hbRPSRLI15184421081/jail/var/run /var/jail/tmp 123M 632K 112M 1% /packages/mnt/jweb-ex-10.4I20110121_0509_hbRPSRLI15184421081/jail/var/tmp /var/tmp 369M 20K 339M 0% /packages/mnt/jweb-ex-10.4I20110121_0509_hbRPSRLI15184421081/jail/var/tmp/uploads devfs 1.0K 1.0K 0B 100% /packages/mnt/jweb-ex-10.4I20110121_0509_hbRPSRLI15184421081/jail/dev
Meaning
The presence of the partition name containing s4d
indicates that there is a fourth slice. If this were a
three-slice partition scheme, in place of s1a
, s3e
, s3d
, and s4d
, you would see s1a
, s1f
, s2a
, s2f
, s3d
,
and s3e
, and you would not see s4d
.
Verifying the Loader Software Version
Purpose
For the special case of upgrading from Junos OS Release 10.4R2 or earlier to Release 10.4R3 or later, you must upgrade the loader software.
Action
For EX Series switches except EX8200 switches:
user@switch> show chassis firmware Part Type Version FPC 0 uboot U-Boot 1.1.6 (Jan 3 2011 - 16:14:58) 1.0.0 loader FreeBSD/PowerPC U-Boot bootstrap loader 2.4
For EX8200 switches:
user@switch> show chassis firmware Part Type Version FPC 0 uboot U-Boot 1.1.6 (Jan 3 2011 - 16:14:58) 3.5.0 loader FreeBSD/PowerPC U-Boot bootstrap loader 2.4
Meaning
For EX Series switches other than EX8200 switches, with Junos OS Release 10.4R3 or later installed:
If there is version information following the timestamp for
U-Boot
(1.0.0
in the preceding example), then the loader software does not require upgrading.If there is no version number following the timestamp for
U-boot
, then the loader software requires upgrading.
If the software version is Release 10.4R2 or earlier,
no version number is displayed following the timestamp for U-boot
, regardless of the loader software version installed. If you do
not know whether you have installed the new loader software, we recommend
that you upgrade the loader software when you upgrade the software
version.
For EX8200 switches, if the version number following the timestamp
for U-Boot
is earlier than 3.5.0
, you must upgrade
the loader software when you upgrade the software version.
Verifying Which Root Partition Is Active
Purpose
Switches running Release 10.4R3 or later have resilient dual-root partition functionality, which includes the ability to boot transparently from the inactive partition if the system fails to boot from the primary root partition.
You can verify which root partition is active using the following command:
Action
user@switch> show system storage partitions
fpc0:
--------------------------------------------------------------------------
Boot Media: internal (da0)
Active Partition: da0s1a
Backup Partition: da0s2a
Currently booted from: active (da0s1a)
Partitions information:
Partition Size Mountpoint
s1a 184M /
s2a 184M altroot
s3d 369M /var/tmp
s3e 123M /var
s4d 62M /config
s4e unused (backup config)
Meaning
The Currently booted from:
field shows which
root partition is active.
Verifying the Junos OS Version in Each Root Partition
Purpose
Each switch contains two root partitions. We recommend that you copy the same Junos OS version in each partition when you upgrade. In Junos OS Release 10.4R2 and earlier, you might choose to have different Junos OS release versions in each partition. You might have different versions during a software upgrade and before you have finished verifying the new software installation. To enable a smooth reboot if corruption is found in the primary root file system, ensure that the identical Junos OS images are in each root partition. For Release 10.4R2 and earlier, you must manually reboot the switch from the backup root partition. However, for Release 10.4R3 and later, the switch reboots automatically from the backup root partition if it fails to reboot from the active root partition.
Action
Verify whether both root partitions contain the same image by using the following command:
user@switch> show system snapshot media internal Information for snapshot on internal (/dev/da0s1a) (backup) Creation date: Jan 11 03:02:59 2012 JUNOS version on snapshot: jbase : ex-12.2I20120305_2240_user jcrypto-ex: 12.2I20120305_2240_user jdocs-ex: 12.2I20120305_2240_user jroute-ex: 12.2I20120305_2240_user jswitch-ex: 12.2I20120305_2240_user jweb-ex: 12.2I20120305_2240_user Information for snapshot on internal (/dev/da0s2a) (primary) Creation date: Mar 6 02:24:08 2012 JUNOS version on snapshot: jbase : ex-12.2I20120305_2240_user jcrypto-ex: 12.2I20120305_2240_user jdocs-ex: 12.2I20120305_2240_user jroute-ex: 12.2I20120305_2240_user jswitch-ex: 12.2I20120305_2240_user jweb-ex: 12.2I20120305_2240_user
Meaning
The command shows which Junos OS version is installed on each media partition. Verify that the same version is installed on both partitions.
Access Juniper Support
This topic provides an overview on how you can access the software package downloads and support tools.
Existing Users—How to Log In
If you are an existing user with an active Juniper Networks® profile, contact Global support. The global support team sends an access token to your registered e-mail ID.
New Users—How to Create an Account
See Also
Downloading Software (Junos OS)
- Downloading Software Using a Browser (Junos OS)
- Downloading Software Using the Command-Line Interface (Junos OS)
- Downloading Software Using Download Manager (SRX Series Only)
Downloading Software Using a Browser (Junos OS)
You download the software package you need from the Juniper Networks Downloads page at https://support.juniper.net/support/downloads/.
To access the download section, you must have a service contract and an access account. If you require assistance in acquiring an account, refer to the instructions on how to Access Juniper Support and fill out the registration form found on the Juniper Networks website: https://userregistration.juniper.net/entitlement/setupAccountInfo.do.
To download the software image:
Using a Web browser, navigate to https://support.juniper.net/support/downloads/.
The Download Results page appears.
Find the software package that you want to download and click the item in the Downloads column.
A login screen appears.
Log in with your username and password.
On the Download Software page that appears, the following options are available:
-
If you want to download the software on your local host, click the CLICK HERE link and save the file to your system. If you want to place the file on a remote system, you must make sure that the file can be accessible by the router, switch, or services gateway by using HTTP, FTP, or SCP. Proceed with the installation. See Downloading Software (Junos OS) for more details.
If you want to download the software on your device, use the following procedure to download and install the software on the device.
Click Copy to copy the generated URL to the clipboard.
Note:The URL string generated remains active only for 15 minutes.
Log in to your device.
-
In operational mode, enter the
file copy “URL” destination
command.In the command, paste the copied URL string (for URL) and then enter /var/tmp (as the destination on your hard disk).
Example:
user@host> file copy "URL" /var/tmp
Note:Ensure that the URL string is enclosed within quotation marks. Also ensure that there is sufficient free space available on the device.
The software image is downloaded on your device.
(Optional) Validate the software image by using the
request system software validate package-name
command.Example:
user@host> request system software validate /var/tmp/junos-install-mx-x86-32-17.3R1.10.tgz
For more details, see request system software validate.
Install the software by using the
request system software add package-name
command.Example:
user@host> request system software add /var/tmp/junos-install-mx-x86-32-17.3R1.10.tgz
Your software is installed on the device.
-
Downloading Software Using the Command-Line Interface (Junos OS)
Download the software package you need from the Juniper Networks Downloads page athttps://support.juniper.net/support/downloads/, and place the package on a local system. You can then transfer the downloaded package to the device using either the router or switch command-line interface, or the local system command-line interface.
To access the download section, you must have a service contract and an access account. If you need help obtaining an account, complete the registration form at the Juniper Networks website: https://userregistration.juniper.net/entitlement/setupAccountInfo.do.
Before you transfer the software package, ensure that the FTP
service is enabled on the device.Enable the FTP service
using the set system services ftp
command:
user@host# set system services ftp
To transfer the software package using the device command-line interface:
To transfer the package by using the local system command-line interface:
From the local system command line, initiate an FTP session with the device using the
ftp
command:user@host> ftp host
host is the hostname or address of the router or switch.
Log in with your customer support–supplied username and password:
User Name: username 331 Password required for username. Password: password
After your credentials are validated, the FTP session opens.
Navigate to the software package location on the local system, and transfer the package by using the
put
command:user@host> put installation-package
Following is an example of an installation-package name: junos-install-mx-x86-32-17.3R1.10.tgz
Close the FTP session by using the
bye
command:user@host> bye Goodbye
Downloading Software Using Download Manager (SRX Series Only)
This download manager feature facilitates download of large files over low-bandwidth links. It enables you to download large Junos OS packages over low-bandwidth/flaky links so that the system can be upgraded. This feature allows you to download multiple files while monitoring their status and progress individually. It takes automatic action when required and displays status information when requested.
The download manager is supported on SRX300, SRX320, SRX340, SRX345, and SRX380 devices.
Be aware of the following considerations when using the download manager:
When no download limit is specified for a specific download or for all downloads, a download uses all available network bandwidth.
Because the download limit that you set indicates an average bandwidth limit, it is possible that certain bursts might exceed the specified limit.
When a download from an HTTP server fails, the server returns an HTML page. Occasionally, the error page is not recognized as an error page and is downloaded in place of the Junos image file.
Remote server logins and passwords are stored by the download manager for the duration of a download. To encrypt these credentials provided along with the login keyword, define an encryption key with the
request system set-encryption-key
command. Any changes to encryption settings while download is in progress can cause the download to fail.A download command issued on a particular node in a chassis cluster takes place only on that node and is not propagated to the other nodes in the cluster. Downloads on different nodes are completely independent of each other. In the event of a failover, a download continues only if the server remains reachable from the node from which the command was issued. If the server is no longer reachable on that node, the download stops and returns an error.
The download manager supports only the FTP and HTTP protocols.
The download manager acts as a substitute for the FTP utility. You can use the download manager CLI commands for all the functions where you previously used the FTP utility.
Before you begin, you must have the following:
An FTP or HTTP server with a Junos OS image
A server that is reachable from the device being upgraded
To download the Junos OS image to your device:
Table 2 lists
the output fields for the show system download
command.
Use this information to diagnose problems. Output fields are listed
in the approximate order in which they appear.
Output Field |
Description |
---|---|
Status |
State of the download. |
Creation Time |
Time the |
Scheduled Time |
Time the download was scheduled to start. |
Start Time |
Time the download actually started (if it has already started). |
Retry Time |
Time for next retry (if the download is in the error state). |
Error Count |
Number of times an error was encountered by this download. |
Retries Left |
Number of times the system will retry the download automatically before stopping. |
Most Recent Error |
Message indicating the cause of the most recent error. |
Reinstall Junos OS
Action
To reinstall Junos OS, follow these steps:
Insert the removable medium (boot floppy) into the router.
Reboot the router, either by power-cycling it or by issuing the
request system reboot
command from the CLI.At the following prompt, type y:
WARNING: The installation will erase the contents of your disk. Do you wish to continue (y/n)?
The router copies the software from the removable medium onto your system, occasionally displaying status messages. This can take up to 10 minutes.
Remove the removable medium when prompted.
The router reboots from the primary boot device on which the software is installed. When the reboot is complete, the router displays the login prompt.
Reconfigure Junos OS
After you have reinstalled the software, you must copy the router’s configuration files back to the router. (You also can configure the router from scratch, as described in Junos System Basics Configuration Guide) However, before you can copy the configuration files, you must establish network connectivity.
To reconfigure the software, follow these steps:
- Configure Host Names, Domain Names, and IP Addresses (Junos OS)
- Protect Network Security by Configuring the Root Password
- Check Network Connectivity (Junos OS)
Configure Host Names, Domain Names, and IP Addresses (Junos OS)
To configure the machine name, domain name, and various addresses, follow these steps:
Log in as
root
. There is no password.Start the CLI:
root# cli root@>
Enter configuration mode:
root@> configure [edit] root@#
Configure the name of the machine. If the name includes spaces, enclose the entire name in quotation marks (" "):
[edit] root@# set system host-name host-name
Configure the machine’s domain name:
[edit] root@# set system domain-name domain-name
Configure the IP address and prefix length for the router’s management Ethernet interface:
[edit] root@# set interfaces fxp0 unit 0 family inet address address | prefix-length
Configure the IP address of a default router. This system is called the backup router because it is used only while the routing protocol process is not running.
[edit] root@# set system backup-router address
Configure the IP address of a Domain Name Server (DNS) server:
[edit] root@# set system name-server address
Protect Network Security by Configuring the Root Password
Configure the root password on your Juniper Networks device to help prevent unauthorized users from making changes to your network. The root user (also referred to as superuser) has unrestricted access and full permissions within the system, so it is crucial that you protect this account by setting a strong password when setting up a new device.
After you initially power on a new device, you log in as the user
root
with no password. The software requires you to configure
the root password before it accepts a commit operation.
To set the root password, you have three options:
-
Enter a plain-text password that the software encrypts.
-
Enter a password that is already encrypted.
-
Enter a Secure Shell (SSH) public key string.
Among these options, using a pre-encrypted password or an SSH public key string is the most secure. If you use one of these methods, then the plain-text version of your password will never be transferred over the Internet, protecting it from being intercepted by a man-in-the-middle attack.
Optionally, instead of configuring the root password at the [edit
system]
hierarchy level, you can use a configuration group to
strengthen security.
To set the root password:
Check Network Connectivity (Junos OS)
Purpose
Establish that the router has network connectivity.
Action
To check that the router has network connectivity, issue
a ping
command to a system on the network:
root@> ping address
If there is no response, verify that there is a route to the address
using the show route
command. If the address is outside your fxp0
subnet,
add a static route. Once the backup configuration is loaded and committed,
the static route is no longer needed and should be deleted.
Change History Table
Feature support is determined by the platform and release you are using. Use Feature Explorer to determine if a feature is supported on your platform.