||In this list widget, all host alias names found in the DIR_CONFIG
are listed in the order that they are found there. In order to make a
change for any host it must first be selected by clicking on it. By
dragging the host name with the middle mouse button, one can change
the ordering in the afd_ctrl dialog. When dragging the cursor will
turn into a ,
the feelers at the top left are the hot spot of the cursor. The
changes will only become effective when the update button was
||When the toggle button for Host switching is turned on (inserted)
it is possible to have two addresses for a single host. The
second host is always regarded as the secondary host. The user
may can change to the secondary host or main host by pressing
the Switch host button.
In the Host 1 and Host 2 fields characters can be entered that
distinguish the two hosts from each other. The character will
be appended to the end of the alias host name.
||Here you may specify the real host name or IP number. This has the
advantage that you can give remote hosts names that are not in
the local /etc/hosts file or the name server. If a secondary host
is available, the second host field will be active. When the toggle
button at the bottom of this boxed is set and the active real hostname
matches that of the current (ie. the host where AFD is running) or if
it matches any of the entries in
$AFD_WORK_DIR/etc/local_interface.list it will use scheme
'file' to deliver the data.
||The time how long the AFD should wait for a reply from the
||If an error occurs, this is the delay (in seconds) before
another transfer is initiated.
||If set, errors and warnings for this host will be set to
offline. If the value of 'Maximum errors' is reached the
host will turn 'blue'.
||If max. errors is reached the destination identifier turns
'red'. If error retries reaches twice max. errors the queue
of this host will be paused.
||This is only used when there is a secondary host and automatic
switch over is active. It is the number of successful transfers
to the secondary host, before it tries to switch back to the
main host to see if it is alive again. If this is set to 0
it will NOT automatically switch back to the original host
after a failover.
||The number of seconds that the connection should be kept
open for retrieving and sending files, when the toggle
button 'Both' is set. If the toggle button 'Fetch' is set,
this value is only set when retrieving files. When 'Send'
is set the value is only valid for sending files.
||Transfer rate limit
||With this option the transfer rate to the given host can be
limited. The Value is in Kilobytes per second. See also
file, if you want to group several hosts to one limit.
||Socket send buffer size
||Changes the socket send buffer size. This can improve throughput
on high bandwith connections or when the RTT (round-trip time)
gets large. Ensure that you understand how to determine this
value otherwise you will be wasting memory and can increase
latency with small files.
||Socket receive buffer size
||Changes the socket receive buffer size. See description above.
||Check for duplicates
||Performs a duplicate on files that are send to this host. The
options have the following meaning:
||What type of check is to be performed, the following values
||Perform check only on the filename.
|Name no suffix
||Perform check only on the filename without last suffix.
||Creates the checksum on the file content only.
|Name + content
||Creates checksum from file name and content.
||What action is to be taken when we find a duplicate. The
following values are possible:
||Delete the file.
||Store the duplicate file in the following directory:
$AFD_WORK_DIR/files/store/<id>. Where <id>
is the directoy id.
||Only warn in SYSTEM_LOG.
||Time in seconds when this CRC value is to be discarded
from the database.
|Max. parallel transfers
||The maximum number of parallel transfers for this host.
||The size of the blocks being used to send files to the
remote host (in Bytes).
|File size offset
||When transmitting large files and the transfer gets interrupted,
the AFD can append a file on the remote site. For this it needs
to know the file size on the remote site. And to get the size it
does a dir 'filename' at the remote site. Due to different
replies of the FTP servers, the position of the file size is
needed. You can easily determine this value simply doing an FTP
to the remote site and a dir and count the spaces to the file size.
-rw-r--r-- 1 afd mts-soft 14971 Jan 3 17:16
^^^ ^ ^^^^^^ ^^^
| | | |
| | | |
1 2 3 4
i.e. the file size offset is 4.
|Number of no bursts
||The number of connections that may not burst. This is useful
for connections where there is lots of files which are being
send with the same low priority and only a few files that do
have a very high priority. Without this option (ie. it is
set to zero), files with lower priority are constantly
appended to current jobs (bursting) without the higher
priority jobs ever getting a chance.
||Protocol specific options. Currently these are only for FTP and FTPS,
except for Fast cd which can also be used for SFTP.
||The mode to use when transfering or receiving files. Can
be either active, passive, extended active or extended
pasive. If you experience problems with the data connection
you might try passive, since firewalls only allow passive
connections. When using passive (NOT extended passive) it
is possible to enable redirecting of the data part to
another system. This is however very uncommon and should
best be left disabled.
|Set idle time
||The idle time will be set to the value that is set in the
Transfer timeout field. Note not all FTP servers support
||Some firewalls timeout the control connection when there
is no activety on it. This can happen transfering large
files over a slow connection. This option, if set, will
send keepalive commands over the control connection
||This will send the RNFR (rename from) and RNTO (rename to)
commands in one go, not as two separate commands. It reduces
latency of renaming, but note that some FTP-servers do not
support this, especially those from M$soft.
||If set no CWD (change working directory) command is sent. This
reduces latency, but does not always work (eg. VAX systems).
|Ignore type I
||By default AFD will always send a type I command for
binary mode during connection initialization. Since some
FTP-servers have this set by default, it is not required
to send this. Note however that this option is very
dangerous and only works with few FTP-servers (vsftpd),
it can easily corrupt data, because some FTP-servers use
ASCII mode as default.
||AFD by default tries to append a new job to an existing
sending job, to reduce the number of connections and the
overall latency. It can however happen that some servers
have problems with this. So with this option it is possible
to disable bursting.
||If the remote server is a proxy, enter the sequence on how to
enter the proxy here. Currently you can only specify the order of
the user name and the password. To enter the user name just enter
$U<user name> and the password is entered with $P<password>.
You may specify as many user and password elments as you want, each one
must however be separated by a ;. If you only put a $U followed
directly by a ; it will take the user name from the recipient
entry. The same goes for the password. If the remote server
requires the ACCT (account) directive instead of the USER
to enter the login name you may also use $A instead of $U.
||Reports what edit_hc did when the user presses the update button.
||Pressing the update button will activate all changes made. You
may change several hosts befor pressing the update button, the
dialog will remeber all the changes. With the remove button
a host can be removed, but only if it is not in the DIR_CONFIG.