Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Announcement: Try the Ask AI chatbot for answers to your technical questions about Juniper products and solutions.

close
header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

Installing Software on ACX Series Routers (Junos OS)

date_range 20-Dec-24

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:

  1. Access the Juniper Networks downloads site at https://support.juniper.net/support/downloads/.

  2. Select your product.

  3. In the drop-down menus, select the OS and version.

  4. Expand the Install Media section.

  5. In the Downloads column, click the link for the USB Install Image file.

  6. Review and accept the End User License Agreement.

  7. 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:

  1. On the router, enter the shell as the root user:

    content_copy zoom_out_map
    user@router> start shell user root
    Password:
    
  2. Decompress the Junos OS image that you downloaded to the router.

    content_copy zoom_out_map
    root@router:~ # gunzip /path/to/image.img.gz

    For example:

    content_copy zoom_out_map
    root@router:~ # gunzip /var/tmp/junos-install-media-usb-acx-arm-64-24.2R1.17.img.gz
  3. 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.

    content_copy zoom_out_map
    root@router:~ # vhclient -s
    root@router-node:~#
  4. Before inserting the USB device, list the contents of /dev/, for example:

    content_copy zoom_out_map
    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.

  5. Insert the USB storage device into the USB port on the router.

  6. 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:

      content_copy zoom_out_map
      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:

      content_copy zoom_out_map
      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

      content_copy zoom_out_map
      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 messages operational mode command or the dmesg shell command to check the log files for messages related to the USB device name. For example:

      content_copy zoom_out_map
      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  
  7. (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.

    content_copy zoom_out_map
    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:

    content_copy zoom_out_map
    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)
  8. Use the dd command to copy the Junos OS image to the USB storage device.

    content_copy zoom_out_map
    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.

    content_copy zoom_out_map
    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:

  1. Insert the USB storage device into the USB port.

  2. 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 reboot command 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.

  3. 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.

  4. 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.

  5. 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.

Note:

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:

content_copy zoom_out_map
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.

Note:

On ACX5048 and ACX5096 routers, use the force-host option to force installing the latest version of the Host OS.

content_copy zoom_out_map
user@host> request system software jinstall-acx5k-15.1X54-D20.6-domestic-signed.tgz force-host add validate reboot
footer-navigation