# ecaccess-association-put - Update/Create an Association

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

# NAME

ecaccess-association-put - Update/Create an Association

# SYNOPSIS

ecaccess-association-put -version|-help|-manual

ecaccess-association-put [-debug] [-gateway name] [-password] source-file

# DESCRIPTION

Allow updating or creating an ECtrans Association. If the name exists then the Association is updated. If it does not exists then a new Association is created. In order to get a template for a new Association please use the following command:

ecaccess-association-get -template association-name target-file

The target-file for the Association Descriptive File does not have to be the name of the Association itself. The name for the Association is specified in the association-name parameter.

When creating a new Association the -password option should be used to set the password (it can not be set in the Association Descriptive File as this would not be secure).

# ARGUMENTS

source-file

  The name of the Association Descriptive File to upload.

# OPTIONS

-gateway name

  This is the name of the ECaccess Gateway where the Association should be installed. It is by default the Gateway you are connected to. In order to get the name of your current Gateway you can use the ecaccess-gateway-name command. When using the commands at ECMWF the default Gateway is always "ecaccess.ecmwf.int".

-password

  Allow prompting for a new password for the Association.

-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-association-put -password ./test

Push the Association described in the ./test file of your current directory on your default Gateway. You will be also prompted for a new password.

ecaccess-association-put -gateway ecaccess.ecmwf.int ./test

Push the Association described in the ./test file of your current directory on the ecaccess.ecmwf.int Gateway.

# SEE ALSO

ecaccess-association-delete, ecaccess-association-get, ecaccess-association-list, ecaccess-association-protocol and ecaccess.