Manual Chapter : Software Management

Applies To:

Show Versions Show Versions

F5OS

  • 1.0.0
Manual Chapter

Software Management

Overview of software management

Software management enables an administrator to upload ISO images to the active system controller and perform software updates on the system controllers and chassis partitions. The ISO images include the following:
  • Bundled BaseOS ISO for the system controllers.
  • Individual or unbundled service level package for the system controllers that can be leveraged in conjunction with the controller BaseOS ISO.
  • Bundled BaseOS ISO for the partitions.
  • Individual or unbundled service level package for the partitions that can be leveraged in conjunction with the partition BaseOS ISO.
Use
Tenant Management
in the chassis partition GUI to manage tenant software images.
You can download software images and files from F5 Downloads, save the downloads to a remote server available on your network and upload them to the VELOS system.

Manage system controller software images from the webUI

Use the following procedure to add or delete system controller software images. Note that you must use HTTPS for image import.
  1. Log in to the 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. Remote Host
      : Type the IP address of the remote image server.
      The remote host needs to be an HTTPS server with PUT/POST enabled and a valid CA signed certificate (not self-signed).
    2. Remote File Path
      : Type the path to the ISO image.
    3. Username
      : Type the user name for an account on the remote image server, if required.
    4. Password
      : Type the password for the account, if required.
    5. Click
      Add Image
      .
    Depending on the image file size and network availability, the import may take a few minutes. When the import is successful, the software image is listed in the webUI.
  5. To delete a system controller image, select the image and click
    Delete
    .
    The software images that are in use cannot be deleted.

Manage chassis partition software images from the webUI

Use the following procedure to add or delete chassis partition software images. Note that you must use HTTPS for image import.
  1. Log in to the system controller webUI using an account with admin access.
  2. On the left, click
    SOFTWARE MANAGEMENT
    Partition Images
    .
  3. To add a chassis partition image, click
    Add
    .
    The
    Add Partition Image
    pop-up displays.
  4. Add the image:
    1. Remote Host
      : Type the IP address of the remote image server.
      The remote host needs to be an HTTPS server with PUT/POST enabled and a valid CA signed certificate (not self-signed).
    2. Remote File Path
      : Type the path to the ISO image.
    3. Username
      : Type the user name for an account on the remote image server, if required.
    4. Password
      : Type the password for the account, if required.
    5. Click
      Add Image
      .
    Depending on the image file size and network availability, the import may take a few minutes. When the import is successful, the software image is listed in the webUI.
  5. To delete a chassis partition image, select the image and click
    Delete
    .
    The software images that are in use cannot be deleted.

Import files from the CLI

You can import a file from an external server into the system controller or chassis partition using the CLI. HTTPS is the supported protocol. The remote host has to be an HTTPS server with PUT/POST enabled and have a valid CA signed certificate
Folders into which you can import files on the system controller:
  • /var/import/staging/
  • /var/export/chassis/import/
  • /var/shared/
  • /mnt/var/confd/configs
Folders into which you can import files on the chassis partition:
  • /var/F5/partition/shared/
  • /var/F5/partition/configs
  • /var/F5/partition/IMAGES
  1. Log in to the command line interface (CLI) of the system controller or the partition using an account with admin access.
    When you log in to the system, you are in user mode.
  2. Import the file using this command:
    file import [port
    port-number
    ] username
    user
    password
    password
    remote-host
    IP-address or FQDN
    remote-file
    remote-file-path
    local-file
    local-file-path
    For example, import to system controller:
    file import username admin password Vx#28439 remote-host artifactory.company.com remote-file /tmp/BIGIP-bigip14.1.x-miro-14.1.2.6-0.0.356.ALL-VELOS.qcow2.zip local-file /var/import/staging/
    For example, import to chassis partition:
    file import username admin password Vx#28439 remote-host artifactory.company.com remote-file /tmp/BIGIP-bigip14.1.x-miro-14.1.2.6-0.0.356.ALL-VELOS.qcow2.zip local-file /var/F5/partition/IMAGES
  3. To check the file transfer status:
    file transfer-status file-name
    local-file-path

Export files from the CLI

You can export a file from the system controller or chassis partition to an external server using the CLI. HTTPS is the supported protocol. The remote host has to be an HTTPS server with PUT/POST enabled and have a valid CA signed certificate
Folders from which you can export files on the system controller:
  • /var/log/
  • /var/log_controller/
  • /var/confd/log
  • /var/crash
  • /var/core
  • /var/import/staging/
  • /var/export/chassis/import/
  • /var/shared/
  • /mnt/var/confd/configs
Folders from which you can export files on the chassis partition:
  • /var/F5/partition/log/
  • /var/F5/partition/core/
  • /var/F5/partition/shared/
  • /var/F5/partition/configs
  • /var/F5/partition/IMAGES
  1. Log in to the command line interface (CLI) of the system controller or the partition using an account with admin access.
    When you log in to the system, you are in user mode.
  2. Export the file using this command:
    file export [port
    port-number
    ] username
    user
    password
    password
    remote-host
    IP-address or FQDN
    remote-file
    remote-file-path
    local-file
    local-file-path

Delete files from the CLI

You can delete files (to which you have file permissions) from specific folders on the VELOS system.
Folder from which you can delete files on the system controller:
  • /var/shared/
Folder from which you can delete files on the chassis partition:
  • /var/F5/partition/shared/
  1. Log in to the command line interface (CLI) of the system controller or the partition using an account with admin access.
    When you log in to the system, you are in user mode.
  2. Delete the file using this command:
    file delete file-name
    local-file-path