Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Upgrading the Personality of a Device by Using a PXE Boot Server

 

The image loaded on the device defines the personality of the device. For instance, if you have purchased a device for use as a core router, you can upgrade the personality of the device for use as an edge router or as a switch. For instance, if you have purchased a PTX10008 device, the installed personality of the device is PTX10008. When you upgrade the personality of the device to an MX10008, the new personality of the device is MX10008. Similarly, if you have purchased a MX10008 device, the installed personality of the device is MX10008 and the new personality of the device, if you upgrade the personality, is PTX10008.

You can upgrade the personality of a device by using the Preboot Execution Environment (PXE) boot server. A PXE boot prepares a client/server environment to boot devices by using a network interface that is independent of available data storage devices or installed operating systems. The image of the operating system is stored on a TFTP server. You can have a separate PXE boot server for each image.

Note

When you order a spare JNP10K-RE1 RCB, the image of the MX10008 build is installed on the RCB. The spare RCB also contains an image of the PTX10008 build at the /var/tmp location. You can upgrade an MX10008 router to an PTX10008 by using that image.

To upgrade the personality of a device from the installed personality to the new personality using the PXE boot server:

  • Copy the image you want installed on the device to the PXE boot server.

  • Reboot the device to install the image.

Note

If you have already copied the image to the PXE boot server, reboot the device to install the image.

To copy the image you want installed to the PXE boot server:

  1. Copy the downloaded installation media to the /var/tmp directory in the PXE boot server.

    For example:

    scp  /volume/build/junos/18.2/release/zyx/ship/junos-vmhost-install-net-x86-64-xyz.tgz user@host:/var/tmp/
  2. Log in to the PXE boot server and verify the installation file.

    For example:

    user@host> ls -lh junos-vmhost-install-net-x86-64-xyz.tgz
  3. Extract the junos-vmhost-install-net TAR file.

    For example:

    user@host> tar xvzf junos-vmhost-install-net-x86-64-xyz.tgz –C /var/tmp
  4. Remove the previously installed files, if any, from the /tftpboot directory.
    user@host> rm -f /tftpboot
    user@host>mkdir /tftpboot
  5. Extract the network installation package.

    For example:

    user@host> tar xvzf /var/tmp/vmhost-install-net-x86_64-xyz.tgz -C /tftpboot/
  6. Rename or delete the previously installed root file system/scripts from the /var/install directory. Create a new /var/install directory.
    user@host>mv /var/install /var/install_old
    user@host>mkdir /var/install
  7. Extract the installation package.

    For example, this sample output is specific to the ptx installation package.

    user@host>tar xvzf /var/tmp/junos-vmhost-install-ptx.tgz -C /var/install
  8. Verify that the /var/install folder contains the attributes file. If the file does not exist in the specified location, copy the attribute file. Note

    The attribute file consists of the personality information of the image. If the attributes file is not present, the device is unable to upgrade to the new personality even when the PXE boot server has the relevant image.

  9. Set permissions for the files in the /var/install and /tftpboot directories.
  10. Exit the PXE boot server.

After you copy the image to the PXE Boot Server, to install the image on the router, reboot the router to install the image. You can use the request vmhost reboot network command to install the image. The router boots from the PXE server and installs the image on both the SSDs. However, if the device fails to reboot, you can use the USB disk installation option. For more information, see Upgrading the Personality of a Device by Using a USB Flash Drive. If the router fails to reboot or is not accessible, follow these steps:

  1. Power cycle the chassis or remove the RCB (JNP10K-RE1) and plug it back in.
  2. Press the ESC button to go to the Boot Manager Menu.
  3. Select Boot Manager, and then press Enter.
  4. Select ETH00 (xx:xx:xx:xx:xx:xx) option. A warning message is displayed. At the prompt, select y to install the image on both the primary and secondary disks.
  5. In operational mode, verify that the upgrade is successful. If you have upgraded the personality of the device to an MX10008 device, the new personality of the device is mx10008. If you have upgraded the personality of the device to a PTX10008 device, the new personality of the device is ptx10008.
    user@host> show version
    user@host> show version
Note

Juniper Networks does not support using the request vmhost software rollback command to revert to the previously installed personality.