Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Upload a Software Image

You must be either a Super User or a Network Admin to upload a software image to Paragon Automation.

Before you upload a software image, ensure that you have downloaded the required software image from the Juniper Software Download page to your local system.

To upload a software image:

  1. Click Inventory > Devices > Software Images in the left navigation menu.

    The Software Images page appears.

  2. Click the Add (+) icon.

    The Upload Image page appears.

  3. To upload the image from your local system, click Browse provided in the Image File field and select the image file that is saved on your computer in the explorer that opens.

    To upload files larger than 2.5 GB, use the Upload Image REST API, instead of the GUI, See Sample Script for a sample of the script that you can use to upload a software image by using the Upload Image REST API.

    Note:

    If you get a message indicating that an error has occurred while uploading an image, see Increase VM Disk Space for Software Image Upload for resolution.

  4. Enter values by referring to Table 1.
  5. Click OK.

    The image is uploaded to the Paragon Automation database and listed on the Software Images page.

    A message indicating that the upload is successful is displayed with a link to the Audit Logs (Systems Menu > Audit Logs present on the GUI banner) page. You can view the progress of the upload in the Audit Logs page.

Table 1: Fields on the Upload Images Page
Field Description

Display Name

Enter or modify the software image name.

The Display Name field is automatically populated with the name of the file you uploaded. If the name of the software image file uploaded does not meet the naming criteria, you can modify or enter a name.

The name can contain only alphanumeric characters, hyphen, period, underscore, and the maximum length allowed is 254 characters.

Description

Enter the description for the software image file.

Vendor

Select the vendor of the device from the drop-down list.

Paragon Automation supports only Juniper Networks devices.

Device Series

Select the model of the device from the drop-down list.

Release

Enter the release number of the OS. Release number indicates the minor software update that addresses bugs and performance issues within a version.

For example, Junos OS Evolved 22.3R1.

Version

Enter the version number of the OS. Version number indicates the major software update that is released every quarter of a year.

For example, Junos OS 23.1.

Expected SHA256

Provide the expected checksum SHA256 to validate the uploaded data.

The images and their SHA256 can be obtained from the Juniper Software Download page.

On the Software Download page, select the device from the Find a Product box. Click and expand the Install Package section, and select the software package and checksums for the release.

Release Notes Link

Provide the link to the release notes.

You can find the link to the release notes on the Juniper Software Download page.

On the Software Download page, select the device from the Find a Product box. Click and expand the Documentation and Release Notes section, and find the release notes link for the release.

Sample Script to Upload a Software Image to Paragon Automation

The following is a sample script to upload a software image to Paragon Automation. Enter appropriate values for:

  • host—The hostname of the server from where the software image is to be uploaded to Paragon Automation.

  • user—The username to access the server.

  • password—The password to access the server.

  • image-filename—The name of the software image to be uploaded.

  • path—The path where the software image is stored on the server.

This requirements file can be used to install any dependencies necessary-

requests==2.28.1

Increase VM Disk Space for Software Image Upload

The default quota for image upload is limited to 25% of the total Ceph disk size divided by 3. For example, if you are using minimum recommended 50G Ceph disk space per VM, then the quota for image upload is around 16GB.

If you get a message stating that an error has occurred while uploading an image, increase the maximum size of the Ceph object Storage daemon (OSD) pool to a higher value (for example 20G ) by executing the following command in the installer node of the Paragon Automation cluster:

To confirm that the Ceph OSD pool size is increased to 20GiB, execute the following command:

The max bytes indicates the Ceph OSD pool size in GiB and bytes.

You can use the software uploaded to Paragon Automation to upgrade the image installed on devices. See Upgrade Software or Upgrade Device Image.