Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Uploading an Image File to the Central Server

    You use the Image Management Service API on the central server to upload the image files that regional servers send to remote devices for initial provisioning. Upload images when you:

    • First set up Network Activator.
    • Receive new or updated image files.

    This procedure uses the following Image Management Service API:
    https://server-IP-address/ims-central/upload_image_file

    Table 1 shows the fields that you must specify for this procedure.

    Table 1: Required Fields for Uploading Images for Devices

    Field

    Description

    Example

    imagefile

    Filename of the image

    jinstall-nfx-2-15.1-20160202_upt2.2-domestic-signed.tgz

    cname

    Name that you use for the image; the name does not need to be unique or to match the filename.

    nfx-image

    description

    Additional information about the image

    Composite image

    device-family

    Product family for this image

    srx

    vendor

    Vendor of the image

    juniper

    major_version

    Component of release number that specifies the major release of the image file. For example, if the release number is x.y, the number x specifies the major release.

    16

    minor_version

    Component of release number that specifies the minor release of the image . For example, if the release number is x.y, the number y specifies the minor release.

    1

    build_num

    Build number of the release for the image

    1.1.1

    supported_platform (optional)

    Product for the image

    srx100

    To upload the image:

    1. On the central server, issue a REST call to upload the image.

      The API returns identifiers for the image file.
      For example:

      user@host:~$ curl -v -k -F "imagefile=@jinstall-nfx-2-15.1-20160202_upt2.2-domestic-signed.tgz"
      -F "cname=nfx-image" -F "description=composite image" -F "device_family=srx" -F
      "vendor=juniper" -F "major_version=16" -F "minor_version=1" -F build_num="1.1.1" -F "supported_platform=srx100"
      -F "supported_platform=srx200" -H "X-AUTH-TOKEN:$OS_TOKEN" https://10.155.90.203/ims-central/upload_image_file
      {"output": {"imagefile_uuid": "f0a044a0-48f9-4de4-b125-9da6ea1006cb", "imagefile_uri": "/v1/AUTH_0b372a0338a743c1b127fbd99d90b95c/images/jinstall-nfx-2-15.1-20160202_upt2.2-domestic-signed.tgz"}}
    2. Record the universally unique identifier (UUID) for the image file, which you need when you specify this image for a remote device that the regional server initially provisions.

    Modified: 2016-10-19