Manual Chapter :
Download and Import Software
Applies To:
Show Versions
F5OS-C
- 1.6.0
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 F5 Downloads. VELOS systems run F5OS-C software packages.
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 software files, you can use either the CLI or
webUI to import the files onto your
VELOS
system.Download software 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 system software or tenant software files
from F5 Downloads.- On your management workstation, log in to my.f5.com/manage/s/downloads.
- Read the End User License Agreement and Program Terms and select the check box.You must accept the license agreement and program terms before you can proceed.
- ClickNext.
- UnderSelect a product family, select a group:For F5OS system softwareSelectF5OS.For tenant softwareSelect a tenant type, such asBIG-IPor.BIG-IP_Next
- UnderTell us more about your product, select a product line:For F5OS system softwareSelectF5OS Platform Software for VELOS.For BIG-IP tenant softwareSelect a product family. For example,BIG-IP v17.x / Virtual Edition with Traffic Management Operating System (TMOS).For information on compatibility betweenF5OSand tenant software versions, see K9476: The F5 hardware/software compatibility matrix.For BIG-IP Next tenant softwareDownload the beta version of BIG-IP Next from the F5 beta portal.
- ForProduct Version, select the version to download.
- UnderSelect a product container, select the software that you want to download.
- UnderSelect a download file, select a file name.For F5OS system softwareThefile-nameconsists of the platform family(-C indicates chassis-based VELOS systems), and the build number. Theextensiondepends on the file type (for example, .iso, .os, .img).For tenant softwareThe file name consists of the platform family, build number, and disk size tag (ALL, T1, T2, T3, or T4).
- ForDownload locations, select a download location.
- ClickDownload.
- Download the corresponding checksum file.The corresponding checksum file has the same name, except that.md5is the file extension. After the download completes, verify the integrity of the file by checking the MD5 checksum.
- Transfer the files to a web server in your infrastructure that supports HTTPS.If you download a.tarfile containing multiple files, you need to extract the images before you can import them onto the system.
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.You can import files into these directories on the 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 files from the CLI
You can import a file from an external serve onto your system from either the system controller or chassis partition CLI.
- 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.
- Import a file.file import [ remote-port <port-number> } username <user> password <password> remote-host <ip-address-or-fqdn> remote-file <remote-file-path> remote-url <full-remote-url> local-file <local-file-path> [insecure] web-token <remote-system-token>Theinsecureoption ignores certificate warnings during the transfer.This example shows how to import a file to the system controller:file import username admin password remote-url https://files.company.com/images/BIGIP-1x.x.x.x-x.x.xxx.ALL-F5OS.qcow2.zip local-file images/stagingThis example shows how to import a file to the chassis partition:file import username admin password remote-url https://files.company.com/images/BIGIP-1x.x.x.x-x.x.xxx.ALL-F5OS.qcow2.zip local-file images
- Return to user (operational) mode.end
- Optionally, you can check the file transfer status.file transfer-status file-name <local-file-path>
Import tenant image files from the CLI
Before you can import a tenant image
file, be sure to download the tenant image file to a web server in your
infrastructure that supports HTTPS, has PUT/POST enabled, and has a valid
CA-signed certificate.
You can import tenant image files
onto your
VELOS
system from the
CLI.- 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.
- Import the tenant image file.The remote host should be an HTTPS server with PUT/POST enabled and have a valid CA-signed certificate. To ignore the certificate warnings, you can use the insecure option.file import remote-url <ip-address-and-file-path> local-file <local-file-path> username <user> password [ remote-port <port-number> ] [ protocol [ https | scp | sftp ]] [insecure]This example shows how to import a tenant ISO to the system:
You can use the downloaded image file when deploying a tenant.syscon-1-active# file import remote-url https://files.company.com/images/BIGIP-15.x.x-x.x.x.ALL-F5OS.qcow2.zip.bundle local-file images/staging username admin password Enter the password at the prompt: Value for 'password' (<string>): ******** result File transfer is initiated.(images/staging)If the file import doesn't work, you can alternatively log in as a root user and use secure copy (SCP) to copy the tenant image file to theimages/stagingdirectory of the system. - Return to user (operational) mode.end
- Optionally, you can check the status of the file import with this command.syscon-1-active# file transfer-statusWhen the file transfer completes, theStatusdisplaysComplete.
File import from the webUI
You can import a file from an external server into the
system
controller or chassis partition
from 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 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
Manage system controller image files from the webUI
You can manage system controller software
images from the system controller webUI.
You must use HTTPS for image
import.
- Log in to the VELOS system controller webUI using an account with admin access.
- On the left, click.
- To upload an image, clickUploadand browse to the image location.
- To import an image:
- ClickImport.A popup opens.
- ForURL, enter 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 theIgnore Certificate Warningscheck box if you want to skip the certificate check.
- ForUsername, type the user name for an account on the remote image server, if required.
- ForPassword, type the password for the account, if required.
- SelectIgnore Certificate Warningsto skip the certificate check.
- ClickImport 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.
Manage chassis partition image files from the webUI
You can manage chassis partition image
files from the system controller webUI.
You must use HTTPS for image
import.
- Log in to the VELOS system controller webUI using an account with admin access.
- On the left, click.
- To upload an image, clickUploadand browse to the image location.
- To import an image:
- ClickImport.A popup opens.
- ForURL, enter 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 theIgnore Certificate Warningscheck box if you want to skip the certificate check.
- ForUsername, type the user name for an account on the remote image server, if required.
- ForPassword, type the password for the account, if required.
- SelectIgnore Certificate Warningsto skip the certificate check.
- ClickImport 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
.Manage tenant images from the webUI
You can add or delete tenant images within a
chassis partition from the chassis partition webUI. You must use HTTPS image import or
export. Note that tenant images are specific to the
VELOS
system,
and the software version must be compatible with it. - Log in to the VELOS chassis partition webUI using an account with admin access.
- On the left, click.
- To upload an image, clickUploadand browse to the image location.
- To import an image:
- ClickImport.A popup opens.
- ForURL, enter 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 theIgnore Certificate Warningscheck box if you want to skip the certificate check.
- ForUsername, type the user name for an account on the remote image server, if required.
- ForPassword, type the password for the account, if required.
- SelectIgnore Certificate Warningsto skip the certificate check.
- ClickImport 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. - To delete a tenant image, select the image and clickDelete. It is recommended that you wait 5-10 minutes after deleting a tenant before deploying another tenant.
After you have added the tenant images that you want
to use to the chassis partition, you can create and deploy tenants that will use that
software image. The tenant image must be one that is listed as compatible with the
VELOS
system.