ip2net

ip2net

IP2NET is used to send files to other Unixboxes via the ethernet using the
FIPNET protocol (qv IPXNET for a description).

It scans its input directory and each file is sent to a single destination
which is the data of the FIP header field DP or, for redundant incoming wire
services, the SZ field. The latter has the two systems used; IP2NET sends to
the one that is NOT the this hostname.

If the remote system has failed, the connection times out and an error is
logged.

If Destination Redundancy is being used (ie 'tables/sys/DEST_REDUN' exists and
has valid entries), this is searched first in case the actual host is one of
our Pseudo-Hosts.

For those systems with dirty ethernets or very slow systems, a tuning switch is
supplied to give details of the time in microsecs for the remote system to
reply. These are given in 3 averages for the first packets, intermediate
packets and last packets.  Note that in order to run this option, the ethernet
is set to 'block' and so any unacknowledged packet will hang the program ! The
user should use the user interface IP to manually kill and reactivate to cure
the problem.

Environment variable FIP_NET_TIME is the max time to wait for a reply in 0.5
sec chuncks(set to 8 by default which is a maximum of 4 seconds for the turn
around). Try stretching it to 12 or 15 for Old Slow Suns or rs6000s.

File for failed or offline systems are shuffled to 'spool/offline' so that they
do NOT interfere with or delay transmissions for other systems.
When the remote system returns, the files are sent from spool/offline. If they
are redundant wires, the XT FipHdr field is added to let the wheel (ipwheel) on
the remote system know that this file has been sent from this machine.

All traffic may be forced to a particular host regardless of SZ or DP fields
using the '-f' flag. This is used where files may not have any header info and
are on the wrong box.

FipHdr field 2NET_LOG:yes/no can be used to override the '-l log input switch
for those cases where a bit of logging would come in handy!
There is also a FipHdr field 'CL' whose contents are stuffed on the end of a
normal file-sent log message. CL is purely to add a bit more information and is
normally added by a Fip program beforehand (such as iproute and the ADDHDR:
parameter).

If the remote hostname/IP address is invalid (ie misspelt, no address, does not
resolve), then files are normally deleted unless the '-e errorfolder' is
specified.

Input parameters (all optional) are :
    -A : allow sends to localhost       default: ignore
    -e : error folder for files which error DURING transmission (ie ignoring host
downs etc)
        As files are automatically retried; this just gives an list of the
        problem files.          default: none
    -f : force all files to this host   default: no
        Note this uses an offline queue in spool called
        offline_(hostname) where the hostname is lowercase.
    -h : for multi-ethernet systems     default: system hostname
        hostname if not bootname (ie if 2nd ethernet adapter)
    -l : log every new file pls     default: do NOT log
    -m : interval for error messages flagging offline systems. default: 60 secs
    -M : interval for warning messages flagging offline systems. default: 0 for
disabled
    -o : offline queue under /fip/spool default: spool/offline
        default if NO -q : spool/offline
        default if -q   : spool/offline_(input folder name)
    -p : port to use on the remote systems  default: IP_NET_NO (9001)
    -q : queue to scan          default: spool/2net
    -Q : Do NOT msg when a remote system is down. default: msg every minute
    -R : do NOT resolve hostnames for each file default: do
        This will resolve any hostnames in the DEST_REDUN file (if there is one)
        The dependency is that ALL hostnames in the USERS file are in /etc/hosts.
    -t : scan time for the directory    default: 1 sec
    -w : extended wait (in secs) at end of file for the remote to respond   default:
none
    -W : 10 ths of a second - MUST wait if nothing processed    default: 0 for Unix/1
for Winnt
    -z : give tuning details        default: no
        The parameter is the no of files between each message.
        see note above
    -v : print version no and exit

Version Control
;021w9  12jun02 Redid DEST_REDUN code for more than 2 hosts in SZ
    ;a/b/c 08aug02 added -R and new fipredun
    ;d 10sep02 added -W
    ;e 29mar03 BUG if offline for long period..
    ;f 17jun03 check if the reply is really just an echo !
    ;g-k 05sep03 added error queue for logging problems
    ;l-n 26feb04 winnt bug with persmissions
    ;o-p 17sep04 speedy and timings
    ;q-v 14jul06 bugette with long filenames in offline plus new DR
    ;w1-6 31jan08 new REDUN ;4 21mar09 added -A allowlocalhost ;5 better offline
support ;6 added -M for warnings
        ;7 added -w extendedEndWait ;8 parse ;9 file-trace

(copyright) 2017 and previous years FingerPost Ltd.