This generates files of updated data and uploads them to external targets. Generation is performed by other components and all the results that they create are uploaded to their destinations.

Usage

da.output.upload [switches…​] [station…​] [times]

Switches

--after=TIME

This sets the time to re-upload after. When set, this will upload all data after the given time. This can be used to ignore the record of the last update and all prior uploaded ranges, but doing so can cause there to be updated data that does not exist in the final upload. No effect when used with an explicit time range.

Default: Last run time

Undefined values are permitted, to indicate that the option is set but not to a specific time.

--discard[=BOOLEAN]

When enabled this causes the generated files to be discarded instead of actually uploaded.

--profile=STRING

This is the profile name to perform. Multiple profiles can be defined to perform different types of uploading for a station. Consult the station configuration for available profiles.

Default: aerosol

--quiet[=BOOLEAN]

If set then no progress output is displayed and any confirmation prompts are bypassed.

Default: Disabled

--single[=BOOLEAN]

When enabled this results in only a single upload of all affected data, instead of the normal multiple segments used.

--wait=NUMBER

This is the maximum time to wait for another upload process to complete, in seconds. If there are two concurrent processes for the same station and profile, the new one will wait at most this many seconds before giving up without uploading new data. If this is set to undefined, it will wait forever for the other process to complete. This is only valid when no times are specified.

Default: 30 seconds

This option only accepts numbers greater than or equal to 0. Undefined values are permitted, to indicate that the option is set but not to a specific value.

Arguments

station

This argument is used to specify the station used to look up variables that do not include a station as part of an archive read specification. The station is the three letter GAW station code of the location, such as BND. The argument accepts multiple stations specified as regular expressions and separated by : or ; or ,. For example BND,MLO and (BND|MLO) are two ways of selecting both the BND and MLO stations.

The special value allstations may also be specified to select all stations.

times

This argument may be split into multiple actual program arguments. This full list of time arguments defines a time bounds list that sets the range of data queried. The final resulting data are clipped to the given time bounds but any values that intersect them are returned.

Examples

Upload data

This will upload data for the default "aerosol" profile.

da.output.upload 2015-05-01 2015-05-03