# ecaccess-ectrans-restart - Restart an existing ECtrans transfer

- NAME
- SYNOPSIS
- DESCRIPTION
- ARGUMENTS
- OPTIONS
- EXAMPLES
- SEE ALSO

# NAME

ecaccess-ectrans-restart - Restart an existing ECtrans transfer

# SYNOPSIS

ecaccess-ectrans-restart -version|-help|-manual

ecaccess-ectrans-restart [-debug] [-gateway name] [-remote location] [-target file-name] [-retryCount number] [-retryFrequency frequency] [-priority priority] [-lifeTime duration] [-mailTo email] [-onSuccess] [-onFailure] [-onRetry] [-keep] [-reject|-append|-resume|-overwrite] [-maximumDuration duration] [-minimumDuration duration] [-minimumRate rate] ectrans-id

# DESCRIPTION

Allow restarting the ECtrans transfer with the ectrans-id identifier.

In order to get the list of ECtrans transfers and the corresponding ectrans-id please use the ecaccess-ectrans-list command. If you want to setup an ECtrans transfer then use the ecaccess-ectrans-request command which will give you an ectrans-id (this one can be kept for a later restart).

# ARGUMENTS

ectrans-id

  The identifier of the ECtrans transfer to restart.

# OPTIONS

-gateway name

  Update the name of the ECaccess Gateway.

-remote location

  Update the target location in the format association-name[@protocol].

-target file-name

  Update the target file-name.

-retryCount number

  Update the number of retries.

-retryFrequency frequency

  Update the frequency of retries in seconds.

-priority priority

  Update the transmission priority 0-99.

-lifeTime duration

  Update the lifetime of the transfer request. The duration is specified in [w]eeks, [d]ays, [h]ours, [m]inutes or [s]econds (e.g. 1w or 2d).

-mailTo email

  Update the target email address.

-onSuccess

  Allow sending a mail when the transfer is successful.

-onFailure

  Allow sending a mail when the transfer has failed.

-onRetry

  Allow sending a mail when the transfer is retried.

-keep

  Allow keeping the request in the spool until the duration specified in the -lifeTime option has passed. By default a successful transfer is removed from the spool.

-reject

  Allow failing if there is an existing target file.

-append

  Allow appending if there is an existing target file.

-resume

  Allow resuming if there is an existing target file.

-overwrite

  Allow overwriting if there is an existing target file.

-maximumDuration duration

  Allow updating the maximum transfer duration. The duration is specified in [w]eeks, [d]ays, [h]ours, [m]inutes or [s]econds (e.g. 10m or 1h). A value <=0 will deactivate the feature.

-minimumDuration duration

  Allow updating the duration before to control a transmission (e.g. for the first 10 minutes ECtrans don't try to check the transfer rate, which allow not to enforce some minimum transfer rates for very small files). The duration is specified in [w]eeks, [d]ays, [h]ours, [m]inutes or [s]econds (e.g. 30s or 10m). A value <=0 will deactivate the feature.

-minimumRate rate

  Allow updating the minimum transfer rate for a transmission (expressed in bytes/s). This is an average value, not the transmission rate at one particular moment in time (e.g. if a big file is stuck for 5 minutes but then transmit much faster later on then it will not be interrupted as long as the overall transfer rate is above the minimum). A value <=0 will deactivate the feature.

-version

  Display version number and exits.

-help

  Print a brief help message and exits.

-manual

  Prints the manual page and exits.

-retry count

  Number of SSL connection retries per 5s to ECMWF. This parameter only apply to the initial SSL connection initiated by the command to the ECMWF server. It does not apply to all the subsequent requests made afteward as it is mainly targeting errors that can happen from time to time during the SSL handshake. Default is no retry.

-debug

  Display the SOAP and SSL messages exchanged.

# EXAMPLES

ecaccess-ectrans-restart 124356

Restart the ECtrans transfer with the identifier 124356.

# SEE ALSO

ecaccess-ectrans-delete, ecaccess-ectrans-list, ecaccess-ectrans-request and ecaccess.