Dell EMC SmartFabric OS10 User Guide Release 10.5.0

PDF

Lifecycle Management using SmartFabric Director

The lifecycle management using SmartFabric Director is available with OS10 release 10.5.0.1 and later. The gNMI agent also processes image upgrade or downgrade requests from the SmartFabric Director server. SmartFabric Director can send these requests to the gNMI agent using Google Network Operating Interface (gNOI) API calls.

The following tables describe the gNOI APIs that are supported:

Table 1. download_and_install APIdownload_and_install API
API Name	Description
download_and_install	Downloads the OS10 binary image from the specified image-url path location. The following image-url paths are supported: Remote FTP server Remote HTTP or HTTPS server Remote TFTP file system After you download the OS10 binary image, the gNMI agent installs the image at specified location based on the image type. For example, if the image type is OS10 NOS, the agent installs the image on the standby partition of the flash drive. If the image download or install operation fails, the system sends an appropriate error message. As a reboot is not required, this remote image-install process does not affect the current service. NOTE This remote upgrade or downgrade capability is supported only for the OS10 binary images. Firmware upgrades including ONIE, CLPD, and FPGA are not be supported.

Table 2. activate APIactivate API
API Name	Description
activate	Activates the newly installed OS10 image. Activation is a two stage process. In the first stage, the boot partition is set to standby for subsequent boot cycles. In the second stage, a system reload is issued to boot the newly installed OS10 image from the standby partition. The activate-image operation requires a system reload. As a result, the current services are affected.

Table 3. cancel_upgrade APIcancel_upgrade API
API Name	Description
cancel_upgrade	Cancels an active OS10 image download process. The cancel_upgrade process uses a best effort mechanism that attempts to cancel an active image file download. This operation cancels the image file transfer and the upgrade operation is terminated. The image installation process starts immediately after the image file transfer is complete. As a result, the cancel upgrade operation cannot stop an installation that is already in progress.

Table 4. get_upgrade_status APIget_upgrade_status API
API Name	Description
get_upgrade_status	Monitors status of the image file transfer and installation operations. This operation returns the following details to the SmartFabric Director server: File transfer state Transfer progress percentage Image installation state File transfer progress File size File transfer bytes File transfer rate Transfer task end time Transfer task start time Transfer task state download Transfer task detail Installation global state Install task end time Install task start time Install task state Install task state detail