Create new destination
Users who have editing privileges can create new destinations. Do the following:
- Click the button.
- The Destination Properties dialog will open.
- Specify the basic properties:
- Destination name: Enter a destination name which contains maximum 80 characters.
- Type: At the moment, only File Exchange is supported.
- Notification e-mail: It is possible to request e-mail notification of log entries related to the destination. In the Notification e-mail input text one or more e-mail addresses can be entered separated by comma. Notification level combo box allows selection of minimal severity. If Info severity is chosen all destination related log entries will be delivered to the specified e-mail address(es). If Warning level is chosen, messages with Info level won't be send to the e-mail address(es).
- Specify the properties on the tabs:
- Transport tab:
- Protocol: Select the protocol type. The following types are supported: SFTP, FTP, SCP, HTTP, HTTPS or E-mail. The other specifications on this tab depend on the selected protocol.
- Host name and Port: the name or IP address and the port number of the intended host, e.g. myftphost.de
- Directory: the path to the upload directory on the FTP host, e.g. /incoming/myftpdirectory
- Login: the name of a valid FTP account on the given FTP host, e.g. myftpuser
- Password: the password of the given FTP account
- Login retry count: Specify the maximum allowed number of repeats in case of unsuccessful login. This is useful in cases if the destination server blocks access after a certain number of unsuccessful logins. For example, if the destination gets blocked after 3 unsuccessful logins, specify this number as 1 or 2.
- Stay connected checkbox:
- : Disconnected after the products are sent.
- : Keep the connection open permanently.
- Delay disconnection spin-box: if "Stay connected" is unchecked In case that connection is terminated after the product is sent, specify how long after sending the product the connection should be terminated. This is useful in case that the products are sent often: for example if a product is sent each 5 seconds and you want to avoid constant connections and disconnections, specify a longer delay.
- Output directory: Specify the directory where the products should be stored on the destination server.
- Parallel transfers spin-box: Used for simultaneous transfer of a large number of products. Specify the number of allowed parallel transfer connections.
In addition to the above properties also the following can be specified:
- Mode list-box: Select the transfer mode. The following modes are available:
- active: The connection is established in both directions, i.e. the client connects to the server and requests data and the server connects to the client to provide the data.
- passive: The connection is established in one direction, i.e. the client connects to the server and requests data. The server informs him about a port to which the client should connect. This mode is used for clients that have restrictive firewalls which disables the connection from external servers.
- Use IPv6 extensions check-box: Only relevant if server is accessed via IPv6/IPv4 protocol. Usually check, leave unchecked in case of firewall issues. Enables special FTP commands such as EPRT and EPSV which are required for IPv6 networks. Most FTP servers can use it in IPv4 too, but some firewalls are known to have problems with it.
- Subject: text which will appear in the Subject: of the e-mails.
- Originator: this is the default e-mail address of the Discover Weather system.
- Recipents: Enter the e-mail address of the intended recipient of products sent via this destination and click . Several addresses can be specified.
- File assembling tab:
- File name: Enter the name format which should be used for the assembled file in case the the products are messages that are assembled to files before sending. The name can include regular characters and format identifiers (indicated by %). See section File name formats for description of format identifiers.
- If the sent products are files not messages, the original file name will remain.
- File Format list-box: Select the file format that will be allowed to be received to this destination. Allowed formats are: GRIB/BUFR, Heading Separated, One Message One file, WMO Standard 00, and WMO Standard 01. See detailed description in File formats.
- Close the file and send it when: Specify at least one condition for closing the file by checking the corresponding checkbox. It is possible to specify more conditions. The file will be closed if any of the specified conditions applies.
- Message count reaches checkbox: Specify the maximum number of messages that can be placed in one file before it is closed. If this number is set to 1, then the other options for closing conditions will be disabled (the file will be closed after one message is included in it).
- Total file size reaches checkbox: Specify the maximum number of characters allowed for one file. After the size is reached, the file will be closed.
- Collection time reaches checkbox: Specify the maximum time during which the message collection into one file will continue. Measurement starts when first message is assembled. When the given time runs out, the file will be closed.
- Message with priority ... checkbox: Specify the message priority which will trigger closing of the file. This is useful to decrease delivery delay for high priority messages.
- File relay tab:
Products which are distributed as files can be renamed before being delivered. The renaming can use regular expressions or wild cards.
- Create New: Create a new output file renaming rule.
- Rename from: Enter pattern to match the original file name.
- Rename to: Enter formatting string to create the new file name. The string may include regular characters, references to sub-matches (e.g. \1) and date/time format identifiers (indicated by %). More details on RegEx formatting strings can be found in http://www.boost.org/doc/libs/1_52_0/libs/regex/doc/html/boost_regex/format/perl_format.html; more information on date/time format identifiers can be found in section Common specifiers in File name formats.
The renaming rule can be tested directly in the dialog in the following way.
- Original name: Enter the original file name to test the renaming on.
- Press ENTER or click the
- Renamed name: This box will display the result of the test renaming.
- File Packing tab:
- Enable packing of files: Allows to pack multiple files into one TAR ball or zip archive before they are sent to the destination.
- : No packing is done, each file is sent separately.
- : Files are packed together and the pack is closed and sent only if one of the closing conditions is met (see below).
- Pack name format text-box: Enter the name format which should be used for the file pack. The pack name can include regular characters and format identifiers (indicated by %). See section File name formats for description of format identifiers.
- File pack format list-box: Select the format for the packed file. The following options are available:
| gz (gzip compressed file)
| bz2 (bzip2 compressed file)
| tar (uncompressed TAR ball)
| tar.gz (gzip compressed TAR ball)
| tar.bz2 (bzip2 compressed TAR ball)
| zip (zip compressed file pack)
- Close file pack and send it when: Specify when one pack of files should be closed and sent. You can use a combination of several conditions - if one of the conditions is fulfilled, the pack will be closed.
- File count reaches checkbox: Specify the maximum number of files that can be packed in one pack before it is closed. If this number is set to 1, then the other options for closing conditions will be disabled (the file will be closed after one file is included in it).
- Total pack size reaches checkbox: Specify the maximum number of bytes allowed for one pack. The size is checked after each file and considers possible compression. When the size is reached (exceeded), the file will be closed.
- Collection time reaches checkbox: Specify the maximum time during which the file collection into one pack will continue. Measurement starts when first file is packed. When the given time runs out, the file will be closed.
- File with priority ... checkbox: Specify the message priority which will trigger closing of the pack. This is useful to decrease delivery delay for high priority files. The pack which has been closed due to file priority will be prioritised in the upload queue as well.
. The destination will appear in the list of specified destinations.