0001 TPRECOVER(8)
0002 ============
0003 :doctype: manpage
0004
0005
0006 NAME
0007 ----
0008 tprecover - Transaction Processing System Recovery.
0009
0010
0011 SYNOPSIS
0012 --------
0013 '*tprecover*'
0014
0015
0016 DESCRIPTION
0017 -----------
0018 This is special ATMI system process which is started in standard way by
0019 *ndrxd(8)* process application server boot. This service shall be run in single
0020 instance (min=1 and max=1). The process performs monitoring of the
0021 *ndrxd* executable. Two checks at intervals are performed:
0022
0023 1. Check is PID exists.
0024
0025 2. Check the ping response from *ndrxd*
0026
0027 If number of checks overreaches max pings setting, the *ndrxd* is killed by -9
0028 signal (if it was running), and then process is respawned.*tprecover* will start
0029 a new copy of 'ndrxd', which initially is put in recovery mode.
0030 During recovery mode 'ndrxd' requests all running servers information about their
0031 services. Once learning mode is completed 'ndrxd' will start to do sanity works, pings
0032 and other processes to keep the system in order.
0033
0034 *NOTE:* as pings and performed at intervals and *ndrxd* might be very busy (not
0035 a usual case), the careful calculation of ping timeout should be made, because
0036 *ndrxd* is doing back pings to *tprecover* process. Thus if *tprecover* waits
0037 for ping response for too long time, the ndrxd might kill the *tprecover* by
0038 it self. These settings are controlled in *ndrxconfig.xml(5)*, settings
0039 *<ping_time>* and *<ping_max>*.
0040
0041 OPTIONS
0042 -------
0043 [*-c* 'CHECK_PERIOD']::
0044 This setting denotes how often to perform *ndrxd* availability checks. Number
0045 of seconds. The default value is *5*.
0046
0047 [*-t* 'PING_TOUT']::
0048 Number of seconds to wait for *ndrxd* to respond to ping requests. The default
0049 value is *20*.
0050
0051 [*-m* 'PING_MAX']::
0052 Max number of failed attempts of process existence tests or bad ping responses.
0053 If the number if overreached, the *ndrxd* gets killed and respawned.
0054
0055 EXIT STATUS
0056 -----------
0057 *0*::
0058 Success
0059
0060 *1*::
0061 Failure
0062
0063 BUGS
0064 ----
0065 Report bugs to support@mavimax.com
0066
0067 SEE ALSO
0068 --------
0069 *ndrxconfig.xml(5)* *ndrxd(8)*
0070
0071 COPYING
0072 -------
0073 (C) Mavimax, Ltd
0074
