Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • If there is an attempt to upgrade to the same ConnectionInfo while an upgrade is already in progress, then that attempt will fail, the ResultConsumer callback will be called with an error, and the CompletableFuture shall return a Status.FAILED immediately.
  • This method is non-blocking.
  • This method is not thread-safe.

@param callback Result, progress, and errors are propagated here.

@return CompletableFuture<Status> where {@link Future#get()} and {@link Future#get(long, TimeUnit)} return * a {@link com.mmbnetworks.gatewayapi.entity.Status}. The {@link com.mmbnetworks.gatewayapi.entity.Status#FAILED} * almost always means something went wrong with the serial upgrade process. * * @throws IllegalArgumentException If connectionInfo is null, upgradeFile is null or is a directory * @see ResultConsumer * @see Future

Parameters

TypeDescription
ConnectionInfoConnectionInfo of the network interface being upgraded (see getConnectionInfo() API).
FileUpgrade file for the specified network interface.
ResultConsumer<SerialUploadResult>User-provided callback in order to receive notifications regarding upgrade progress.

...