ipnt

ipnt and ipntsvce

IPNT
----

See the Users Manual for information on commands.

IPNT is the main FIP user interface but it can also be used in batch mode
typically to start and stop processes on startup or via crontab.

IPNT can also be used to start and stop Fip programs in background.

  - for example during the nightly maintenance,
    you may wish to stop certain processes, cleanup some files and restart.

Input parameters on startup are
    -a : start this name/group/program/all      default: no
    -l : start this name/group/program/all then start the local group.  default: no
    -k : stop  this name/group/program/all      default: no
    -R : run this 'command' and exit        default: no
    -d : NT drive for /fip              default: Z:
    -J : NT drive for /fip              default: Z:
    -h : new hostname for the prompt        default: hostname
        Use this if your System Manager has given your UnixBox
        a name which is too verbose or meaningless.
    -s : FOR IPNT only : Hostname of the (local or remote) system
        where the server IPSVCE is running  default: none
        This is used to start/stop program.
    -p : port number for the server         default: 9090
    -w : wait at end time               default: 3 secs
    -t : the auto check time            default: 60 sec
    -v : print the version no and quit

IPNTSVCE
--------
IPNT can also act as the Service for Fip.

PLEASE NOTE THAT THIS IS THE COMMAND-LINE UI.

'ipnt' and 'ipntsvce' are identical programs (one is a copy of the other!) but
the service version MUST be called "ipntsvce.exe".

NORMALLY IPNTSVCE SHOULD NEVER BE RUN MANUALLY EXCEPT TO INSTALL, UPGRADE OR
REMOVE.

Input parameters on startup are
    -install    : install this service
        THIS SHOULD BE DONE ONCE ONLY ON INSTALLATION
    -remove     : remove  this service
        THIS SHOULD BE DONE ONCE ONLY WHEN FIP IS NO LONGER REQUIRED
    -?          : print out the options
    -p          : port number for the server    (default is 9090)
    -v          : Print out the current version numbers

To Install :
    - Check Control Panel/Services that "Fip Comms Manager" does NOT exist
        - if it does, REMOVE as per below.
    - Change to the correct drive/queue for Fip programs
        Cmd>f:
        Cmd>cd \fip\bin
    - Copy the program "ipnt.exe" to "ipntsvce.exe"
    - Copy the program "ipnt.exe" to "ip.exe"
    - If installing ipntsvce on win7/win2008
        - you MUST run CMD as administrator
        WinButton -> Run -> CMD (but dont click !)
            On the CMD icon that appears above..
            .. RIGHT CLICK
            .. scroll down and select 'Run As Administrator'
    - Install the service with
            Cmd>ipntsvce -install
    - Check Control Panel/Services that "Fip Comms Manager" does exist
        - start it.
        - you may also wish to make it AUTOMATICALLY start on reboot at this point.
        - if you have lots of programs in your SYSTEM file, add '-w10' to the Start
Parameters box

To Remove :
    - Check Control Panel/Services that "Fip Comms Manager" is NOT running
        - if it is STOP that Service.
    - Change to the correct drive/queue for Fip programs
        Cmd>f:
        Cmd>cd \fip\bin
    - Remove the service with
            Cmd>ipntsvce -remove
    - NOTE YOU WILL NOT BE ABLE TO STOP AND START ANYTHING ONCE THIS HAS BEEN
DONE.

To Upgrade :
    - Check Control Panel/Services that "Fip Comms Manager" is NOT running
        - if it is STOP that Service.
    - Change to the correct drive/queue for Fip programs
        Cmd>f:
        Cmd>cd \fip\bin
    - Stop and REMOVE (as above) IPNTs that may be running.
    - Copy new programs into \fip\bin.
    - Install as above

IPNTSVCE requires the following parameter files :
    - /fip/fix/fiplick.(hostname)       containing the Fip Licence string
    - /fip/tables/sys/IPNT.SVR.START    containing any programs, groups to start
        - one item per line
        - comments allowed using a preceeding semi-colon
        - each string preceded by :
            'a' for activate
            'k' for kill
            'd' for delay
        - note that spaces and tabs are ignored.
        eg
            ; startup file for ipntsvce only
            ; start local
            a local
            ; wait a couple of seconds
            d 2
            ; .. then start run
            a run
            ; wait 10 secs
            d 10
            ; .. and then STOP ipedsys
            k ipedsys
IPNTSVCE optionally can be used to check diskspace using the parameter file
/fip/tables/sys/DISKSPACE. The syntax is :
    ; comment line
    (disk)  (percent)   (script with parameters)
    ; eg
    c:\ 40  /fip/local/test.pl  disk=c
    ; data
    Z:   60 /fip/local/test.pl  disk=z

The WAIT file can access valid UNC drives - if permissioned (from version 03n)
Note the dash and forwar slashes notation :

Directory: 2go      : * /2go
     : xchg     : * /xchg
     : post     : * /post
     : 2ftp     : * /2ftp
     : Ian's B'berry: *-//10.0.0.10/c$/blackberry

-- Note that ipntsvce replies on several Windows Services including RPC and
Server (if named pipes are being used)

The registry item is
  HKEY_LOCAL_MACHINE/SYSTEM/ControlSet001/Services/FipCommMgr

-- Note if there is a file in tables/sys called MIDNIGHT_WIN.FIP then it is run
by the service within a few seconds after the change of day. The only commands
are 'script:' eg
;
; MIDNIGHT_WIN.FIP
; run this at midnight
;
script:\fip\local\zapwidget.cmd

The format/style of the script is normal windows backslashes NOT forward
slashes (just to be different)

-- Note that ipntsvce will zap the space between the input switch and the
following parameter.
So to retain it in the SYSTEM file, pls put in double quotes
eg
test1   local   /perl/bin/perl /fip/local/tester.pl "-1 first" -2 second -3 -4
-5555 -6    sixo
will run \perl\bin\perl
with the following parameters
    1   /fip/local/tester.pl
    2   -1
    3   first
    4   -2second
    5   -3
    6   -4
    7   -5555
    6   -6sixo

Version Control
;03n18  15sep99 -R version for the web plus kall now zaps x/SYSTEM
    ;a small mods ...
    ;b/c 15aug00 added -z and -Z and 'd 30' in the IPNT.SVR.START file
    ;d/e/f 11may01 pass dblqtes when starting programs
    ;g-k 05oct01 display name is now the drive name or letter
    ;l-m 31dec05 added disk space checking
    ;n1 17mar05 allow UNC drives in WAIT ;23 12dec08 added -w
        ;4-5 19mar09 allow perl and local scripts in the SYSTEM file
        ;6-7 06nov09 check ALL ip addreses for licence
        ;8-14 micro-fip and midnight added
        ;15-16 add at timeout of 5 secs, WAIT queues can be parsed and stopped loop
when no fip/x
        ;17 cleanup error messages ;18 finally added filter on tail

(copyright) 2017 and previous years FingerPost Ltd.