Installing Software on ACX Series Routers (Junos OS)
ACX Series routers are delivered with preinstalled Junos operating system (Junos OS). Before you start this procedure, decide which software package you need and download it. For information on which packages to use for which upgrades, see Junos OS Installation Package Names.
Installing Junos OS Using a USB Storage Device on ACX Series Routers
You can install the Junos OS image on ACX Series routers using a bootable USB storage device.
Before you begin, ensure the following requirements are met:
-
For ACX710 USB upgrades, the USB brand is Transcend or Kingston.
-
The USB storage device has enough capacity to accommodate the size of the desired Junos OS image.
-
The USB storage device is empty and formatted as FAT32.
-
On the device running Junos OS, you have physical access to the USB port and console access to the device.
The following sections outline how to download the software image, create a bootable USB storage device, and install the software image on the device running Junos OS.
Download the Software Image
To download the Junos OS install media image to your router:
Access the Juniper Networks downloads site at https://support.juniper.net/support/downloads/.
Select your product.
In the drop-down menus, select the OS and version.
Expand the Install Media section.
In the Downloads column, click the link for the USB Install Image file.
Review and accept the End User License Agreement.
Follow the instructions on the download page to download the file and save it to the /var/tmp directory on the router.
Create a Bootable USB Storage Device
To create a bootable USB using a router running Junos OS:
On the router, enter the shell as the root user:
user@router> start shell user root Password:
Decompress the Junos OS image that you downloaded to the router.
root@router:~ # gunzip /path/to/image.img.gz
For example:
root@router:~ # gunzip /var/tmp/junos-install-media-usb-acx-arm-64-24.2R1.17.img.gz
On devices where Junos OS runs as a VM over a Linux-based host (VM host), log in to the VM host shell to see the USB activity.
root@router:~ # vhclient -s root@router-node:~#
Before inserting the USB device, list the contents of /dev/, for example:
root@router:~ # ls /dev/da* /dev/da0 /dev/da0s1c /dev/da0s2a /dev/da0s3 /dev/da0s3e /dev/da0s1 /dev/da0s1f /dev/da0s2c /dev/da0s3c /dev/da0s1a /dev/da0s2 /dev/da0s2f /dev/da0s3d root@router-node:~ # ls /dev/sd* /dev/sda /dev/sda1 /dev/sda2 /dev/sda3 /dev/sda4 /dev/sda5 /dev/sda6 /dev/sdb /dev/sdb1 /dev/sdb2 /dev/sdb3 /dev/sdb4 /dev/sdb5 /dev/sdb6
Note:Your output might differ based on the device you are using. Connect to the device using the console before inserting the USB to see the name given to the USB storage device.
Insert the USB storage device into the USB port on the router.
Determine the device ID of the USB by using one or more of the following methods.
Review the console messages, which should show the device ID when you insert the USB storage device. The messages and device ID can vary based on the platform, for example:
da2 at router-sim1 bus 1 target 0 lun 0 da2: <TOSHIBA TransMemory 5.00> Removable Direct Access SCSI-0 device
List the contents of /dev/ and compare it to the list of device IDs from Step 4 to identify the newly added device. The device name can vary by platform, for example:
root@router# ls /dev/da* /dev/da0 /dev/da0s1c /dev/da0s2a /dev/da0s3 /dev/da0s3e /dev/da0s1 /dev/da0s1f /dev/da0s2c /dev/da0s3c /dev/da2 /dev/da0s1a /dev/da0s2 /dev/da0s2f /dev/da0s3d /dev/da2s1
or
root@router-node:~# ls /dev/sd* /dev/sda /dev/sda1 /dev/sda2 /dev/sda3 /dev/sda4 /dev/sda5 /dev/sda6 /dev/sdb /dev/sdb1 /dev/sdb2 /dev/sdb3 /dev/sdb4 /dev/sdb5 /dev/sdb6 /dev/sdc /dev/sdc1
Issue the
show log messagesoperational mode command or thedmesgshell command to check the log files for messages related to the USB device name. For example:root@router-node:~# dmesg | tail ... [ 493.244240] scsi 6:0:0:0: Direct-Access JetFlash Transcend 16GB 1100 PQ: 0 ANSI: 6 [ 493.244468] sd 6:0:0:0: Attached scsi generic sg2 type 0 [ 493.245149] sd 6:0:0:0: [sdc] 30197760 512-byte logical blocks: (15.5 GB/14.4 GiB) [ 493.245876] sd 6:0:0:0: [sdc] Write Protect is off [ 493.245879] sd 6:0:0:0: [sdc] Mode Sense: 43 00 00 00 [ 493.246653] sd 6:0:0:0: [sdc] Write cache: enabled, read cache: enabled, doesn't support DPO or FUA [ 493.251845] sdc: sdc1 [ 493.254346] sd 6:0:0:0: [sdc] Attached SCSI removable disk
(ACX710 only) Clear the USB storage device by writing zeroes to the device. Ensure that you specify the device ID of the USB storage device as identified in the previous steps. This process might take some time, so do not kill the session.
root@router:~# dd if=/dev/zero of=/dev/device-id bs=1m
For example, if the device ID is
/dev/da2, then you would issue the following command:root@router:~# dd if=/dev/zero of=/dev/da2 bs=1m dd: /dev/da2: end of device 29164+0 records in 29163+0 records out 30579621888 bytes transferred in 2402.249018 secs (12729580 bytes/sec)
Use the
ddcommand to copy the Junos OS image to the USB storage device.root@router:~# dd if=/path/to/image.img of=/dev/device-id bs=1m
For example, the following command copies the Junos OS image from the /var/tmp directory to the USB with device ID
/dev/da2.root@router:~# dd if=/var/tmp/junos-install-media-usb-acx-arm-64-24.2R1.17.img of=/dev/da2 bs=1m
Install the Junos OS Image
Perform the following steps to install the Junos OS image from the USB storage device:
Insert the USB storage device into the USB port.
Reboot the router by doing one of the following:
Press the power button on the chassis.
Switch off and turn on the power button behind the Routing Engine.
Enter the
request system rebootcommand from the CLI.
The system LED starts blinking in green.
On the console, a message is displayed stating that your flash memory device (NAND Flash device) will be formatted and you will lose all the data. You are prompted to confirm the formatting of the flash memory device.
Press y to confirm and proceed with the formatting process. The flash memory device is formatted and the image is installed on both the partitions.
After the installation is completed, the console displays a message prompting you to eject the USB storage device and to press Enter to reboot the device.
After you remove the USB storage device and press Enter, the reboot begins. After the router reboots, the new Junos OS version is loaded and functional. The LED glows steadily in green.
If an installation error occurs, the LEDs turn red. You must have console access to the router to troubleshoot an installation error.
Installing Junos OS Upgrades from a Remote Server on ACX Series Routers
You can use the CLI to install Junos OS packages that are downloaded with FTP or HTTP from the specified location on internal media, such as the NAND Flash device.
Before you begin:
Verify the available space on the NAND Flash device.
Download the Junos OS package.
To install Junos OS upgrades from a remote server, enter the following command from operational mode:
user@host> request system software add junos-juniper-12.2R1.9-domestic.tgz no-copy no-validate reboot
The new Junos OS image is installed on the router and the device is rebooted.
On ACX5048 and ACX5096 routers, use the force-host option to force installing the latest version of the Host OS.
user@host> request system software jinstall-acx5k-15.1X54-D20.6-domestic-signed.tgz force-host add validate reboot