Manual Chapter : Download and Import Software

Applies To:

Show Versions Show Versions

F5OS-C

  • 1.3.2, 1.3.1, 1.3.0, 1.2.2, 1.2.1, 1.2.0
Manual Chapter

Download and Import Software

F5OS software download and import

Before you upgrade or install your system, you need to download the latest F5OS software image files from the F5 downloads site at downloads.f5.com.
If your VELOS system is running F5OS-C software version 1.2.0, F5 strongly recommends that you upgrade to F5OS-C version 1.2.1 or later.
If your VELOS system is running F5OS-C software version 1.1.3 or earlier, you must first upgrade to F5OS-C version 1.1.4 before you can install version 1.2.1 or later.
After you have downloaded the image files, you can use either the CLI or webUI to import the image files onto your
VELOS
system.

Download F5OS-C image files from F5

F5 recommends that you have a web server in your infrastructure that supports HTTPS, has PUT/POST enabled, and has a valid CA-signed certificate.
F5 recommends that you download the latest F5OS-C software image files from the F5 downloads site (downloads.f5.com).
  1. On your management workstation, log in to downloads.f5.com and click
    Find a Download
    .
  2. In the
    F5OS
    area, click
    F5OS (for VELOS)
    .
  3. Select a software version from the list.
  4. Click the name of the release with the most recent date.
    You must accept the software terms and conditions before you can proceed.
  5. Click the file name <
    file-name
    >.<
    extension>
    to start the download.
    The
    file-name
    consists of the platform family (-C indicates that this image is used for chassis-based VELOS systems) and the build number. The
    extension
    depends on the file image type (for example, .iso, .os, .img).
  6. Transfer the image files to a web server in your infrastructure that supports HTTPS.
    If you download a tar file containing multiple images (rather than an iso, os, or img file), you need to extract the images first before you can import them onto the VELOS system.

Download tenant image files from F5

F5 recommends that you have a web server in your infrastructure that supports HTTPS, has PUT/POST enabled, and has a valid CA-signed certificate.
F5 recommends that you download the latest tenant software image files from the F5 downloads site (downloads.f5.com).
  1. On your management workstation, log in to downloads.f5.com and click
    Find a Download
    .
  2. Select the F5 tenant software that you want to download.
    For BIG-IP
    In the
    BIG-IP
    area, click
    BIG-IP v15.1.x TMOS F5OS
  3. From the list, select the product container that includes VELOS tenant images.
    F5OS-C software version 1.2.0 on VELOS supports only BIG-IP software version 15.1.5.
  4. Click the name of the release with the most recent date.
    You must accept the software terms and conditions before you can proceed.
  5. Click the file name
    BIGIP-
    1x.x.x-x.x.x
    .<
    disk-size-tag
    >-VELOS.qcow2.zip.bundle
    to start the download.
    The file name consists of the platform family, build number, and disk size tag (ALL, T1, T2, T3, or T4).
  6. Transfer the image file to a web server that supports HTTPS.

File import from the CLI

You can import a file from an external server into the system controller or chassis partition from the CLI. HTTPS is the supported protocol. The remote host should be an HTTPS server with PUT/POST enabled, and a valid CA-signed certificate is recommended.
If you want to import the contents of a tar file, you need to extract the contents first before you can import them onto the VELOS system.
Folders into which you can import files on the system controller:
  • images/staging
  • images/import
  • diags/shared/
  • configs/
Folders into which you can import files on the chassis partition:
  • diags/shared
  • configs
  • images

Import files from the CLI

You can import files onto your system from either the system controller or chassis partition CLI.
  1. Log in to the command line interface (CLI) of the system controller or chassis partition using an account with admin access.
    When you log in to the system, you are in user (operational) mode.
  2. Import a file.
    file import [ remote-port <
    port-number
    > ] username <
    user
    > password <
    password
    > remote-host <
    ip-address-or-fqdn
    > remote-file <
    remote-file-path
    > local-file <
    local-file-path
    > [insecure]
    The
    insecure
    option ignores certificate warnings during the transfer.
    This example shows how to import a file to the system controller:
    file import username admin password xxxxxxxx remote-host files.company.com remote-file /tmp/BIGIP-bigip14.1.x-miro-14.1.x.xx.x.xxx.ALL-VELOS.qcow2.zip local-file images/staging
    This example shows how to import a file to the chassis partition:
    file import username admin password remote-host files.company.com remote-file /tmp/BIGIP-bigip14.1.x-miro-14.1.x.x-x.x.xxx.ALL-VELOS.qcow2.zip local-file images
  3. Return to user (operational) mode.
    end
  4. Optionally, you can check the file transfer status.
    file transfer-status file-name <
    local-file-path
    >

Import tenant image files

F5 recommends that you have a web server in your infrastructure that supports HTTPS, has PUT/POST enabled, and has a valid CA-signed certificate. Then you can securely download the tenant image files to the web server and import the image files onto your
VELOS
system.
F5 recommends that you download the latest tenant software image files from the F5 downloads site (downloads.f5.com).
  1. On your management workstation, log in to downloads.f5.com and click
    Find a Download
    .
  2. Select the F5 tenant software that you want to download.
    For BIG-IP
    In the
    BIG-IP
    area, click
    BIG-IP v15.1.x TMOS F5OS
  3. From the list, select the product container that includes VELOS tenant images.
    F5OS-C software version 1.2.0 on VELOS supports only BIG-IP software version 15.1.5.
  4. Click the name of the release with the most recent date.
    You must accept the software terms and conditions before you can proceed.
  5. Click the file name
    BIGIP-
    1x.x.x-x.x.x
    .<
    disk-size-tag
    >-VELOS.qcow2.zip.bundle
    to start the download.
    The file name consists of the platform family, build number, and disk size tag (ALL, T1, T2, T3, or T4).
  6. Transfer the image file to a web server that supports HTTPS.
  7. Log in to the command line interface (CLI) of the chassis partition using an account with admin access.
    When you log in to the system, you are in user (operational) mode.
  8. Import the tenant image file to the chassis partition.
    The remote host should be an HTTPS server with PUT/POST enabled, and a valid CA-signed certificate is recommended. To ignore the certificate warnings, you can use the
    insecure
    option.
    file import remote-port <
    port-number
    > username <
    user
    > password <
    password
    > protocol [ https | scp | sftp ] remote-host <
    ip-address-or-fqdn
    > remote-file <
    remote-file-path
    > local-file images insecure
    You can use the downloaded image file when deploying a tenant in this partition.
    If the file import doesn't work, you can also log in as a root user and using SCP to copy the tenant image file to the images directory of the chassis partition. For example:
    scp BIGIP-1
    x.x.x-x.x.x
    .-VELOS.qcow2.zip.bundle admin@<
    partition-management-ip
    >:images
  9. Return to user (operational) mode.
    end
  10. Optionally, you can check the status of the file import with this command.
    file transfer-status
    When the file transfer completes, the
    Status
    displays
    Complete
    .

File import using the webUI

You can import a file from an external server into the system controller or chassis partition using the webUI. The remote host should be an HTTPS server with PUT/POST enabled, and a valid CA-signed certificate is recommended.
If you want to import the contents of a tar file, you need to extract the contents first before you can import them onto the VELOS system.
You can import files into these directories on a system controller:
  • images/staging
  • images/import
  • diags/shared/
  • configs/
You can import files into these directories on a chassis partition:
  • diags/shared
  • configs
  • images

Import system controller image files from the webUI

You can use Software Management to add or delete system controller software images from the system controller webUI.
You must use HTTPS for image import.
  1. Log in to the VELOS system controller webUI using an account with admin access.
  2. On the left, click
    SOFTWARE MANAGEMENT
    Controller Images
    .
  3. To add a system controller image, click
    Add
    .
    The Add Controller Image pop-up displays.
  4. Add the image:
    1. For
      URL
      , type the URL of the remote image server.
      F5 recommends that the remote host be an HTTPS server with PUT/POST enabled and have a valid CA-signed certificate. You can opt to select the
      Ignore Certificate Warnings
      check box if you want to skip the certificate check.
    2. For
      Username
      , type the user name for an account on the remote image server, if required.
    3. For
      Password
      , type the password for the account, if required.
    4. Select
      Ignore Certificate Warnings
      to skip the certificate check.
    5. Click
      Add Image
      .
    Depending on the image file size and network availability, the import might take a few minutes. When the import is successful, the software image is listed in the webUI.
The
Image Import Status
area of the screen shows the progress of the image import and enables you to confirm when the image import is successful. If an operation fails, hover over the warning icon to see the error that occurred.
A runtime error is displayed in the File Transfer status area, if an invalid operation is performed.

Import chassis partition image files from the webUI

You can use Software Management to add or delete chassis partition image files from the system controller webUI.
You must use HTTPS for image import.
  1. Log in to the VELOS system controller webUI using an account with admin access.
  2. On the left, click
    SOFTWARE MANAGEMENT
    Controller Images
    .
  3. To add a system controller image, click
    Add
    .
    The Add Controller Image pop-up displays.
  4. Add the image:
    1. For
      URL
      , type the URL of the remote image server.
      F5 recommends that the remote host be an HTTPS server with PUT/POST enabled and have a valid CA-signed certificate. You can opt to select the
      Ignore Certificate Warnings
      check box if you want to skip the certificate check.
    2. For
      Username
      , type the user name for an account on the remote image server, if required.
    3. For
      Password
      , type the password for the account, if required.
    4. Select
      Ignore Certificate Warnings
      to skip the certificate check.
    5. Click
      Add Image
      .
    Depending on the image file size and network availability, the import might take a few minutes. When the import is successful, the software image is listed in the webUI.
The
Image Import Status
area of the screen shows the progress of the image import and enables you to confirm when the image import is successful. If an operation fails, hover over the warning icon to see the error that occurred.
If an invalid operation is performed, a runtime error displays in the File Transfer status area, .
In the case of DNS errors or other more critical errors, a pop-up might appear with options to
Dismiss
or
Retry
.