This component synchronizes local data with data contained on a remote server by using an exchange of static data files. The specific data synchronized are determined by the profile selected. Synchronization can involve creating files to transfer to the remote end as well as downloading updated files.

Usage

da.sync.files [switches…​] [station…​]

Switches

--after=TIME

This sets the time to synchronize after. This can be used to re-synchronize data after a given time or to completely resynchronize all data.

Default: Last run time

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

--download[=BOOLEAN]

This controls if data files containing remote changes are processed. When disabled any remote files are ignored and not processed. They may still be processed later if the synchronize is run without disabling them.

Default: Enabled

--profile=STRING…​

This is the authorization profile to synchronize. The profile controls where data are read from and written to. Consult the station configuration and authorization for available profiles.

Default: All available

--quiet[=BOOLEAN]

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

Default: Disabled

--update[=BOOLEAN]

When disabled, this causes the immediate data update to be skipped. The result is that the clean and averaged data are not updated until the next time the station tasks are run at the appropriate level. This normally means that the data will not be updated until the following night when the execution tasks run automatically.

Default: Enabled

--upload[=BOOLEAN]

This controls if data files containing local changes are generated. When disabled local changes are not uploaded.

Default: Enabled

--wait=NUMBER

This is the maximum time to wait for another 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 performing an update.

Default: Thirty 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.

Examples

Run synchronization

This will run synchronization using all available profiles.

da.sync.files