monitor - Texis monitoring program

SYNOPSIS

monitor [-C index] [-D] [-H] [-I] [-L] [-M] [-V] [-c command]
        [-d database] [-f] [-o filename] [-v] [-z] [database]
        [-k] [-t] [-R] [-r configfile] [-E]
        [--texis-conf{=| }configfile] [--install-dir{=| }dir]

DESCRIPTION
monitor is a monitoring program for Texis, which performs many tasks. Many of the other Texis commands are available using the -c option. Any arguments after -c are treated by that program. The currently supported set of commands is texis, vhttpd, tsql, creatdb, addtable, wordlist, dumplock, dumpshared and copydbf. See the documentation on these commands for full details.

Depending on the commands given to it monitor will either execute once, or repeat a set of tasks at various intervals. If monitor is run with no arguments it will run in the background, and do its primary jobs in monitoring the license.

The monitor program is required to be running at all times to monitor various aspects of Texis operation, such as Vortex scheduling, the license, and statistics. To ensure this, the various Texis programs may fork a monitor process if they detect one isn't running. Thus, the Texis Monitor process may not always have the name "monitor" in a process listing (Unix ps); it may look like another Texis process. To verify that a process is the primary Texis Monitor process, compare its process ID with the "Monitor process pid" given by texis -license. (See the command-line discussion in the Texis Web Script manual.)

The -I option makes monitor behave as chkind. If no other arguments are specified then it is identical to chkind, although you do have the option of adding other options. -C allows you to force a check of a particular index. This will disable the normal repetitive checking of -I.

-D causes monitor to act like dumplock. -H displays a help message. ltest behaviour is achieved with -L, and monlock behavior with -M.

The -V option disables the visual display in ltest and chkind modes. -v increases the verbosity and will display more messages.

The -z option is used internally by Texis to launch a monitoring process on a particular database.

The -k option will stop (kill) all running monitor processes (both primary Texis Monitor and database monitors). This can be used during a manual installation process to ensure no Texis processes are running prior to installation of a new version. In version 6.01 and later, if the current configuration has the Texis Monitor disabled ([Monitor] Run Level bit 0 off), only the "vanilla" (non-Texis/DB) monitor process indicated by [Monitor] Pid File will be terminated. For example, this may be used to stop a standalone (non-Texi-Monitor) process running as the Texis Web Server.

In Texis version 8 and later under Linux, a systemd service (texis-monitor) may be installed to control the Texis Monitor. In this environment, stopping the monitor with monitor -k may cause systemd to simply restart it immediately. The proper way to control a version 8 monitor when this service is installed is thus via the systemctl command, e.g. (as root): systemctl stop texis-monitor. A similar service may exist for vhttpd.

The -t option will cause the monitor process to run in the foreground. The default is to run in the background. Under Windows, the Texis Monitor service will also not be run. Under Unix, for chkind/ltest, the program will exit after loading the ncurses library (this is used for install checks).

The -R option is for Windows, and will cause monitor to register itself as a service, and set the install dir in the registry to the current path of the executable running. Added in version 4.02.1037378163 Nov 15 2002.

The -E option is used to encrypt passwords for the [Httpd] EncPass setting in conf/texis.ini (here). It will prompt for a password and then print the EncPass setting for it.

The -r option (deprecated) gives the path to the Texis Configuration file to use. Added in version 4.02.1037306718 Nov 14 2002.

The --texis-conf{=| }file option gives the path to the Texis Configuration File to use (default is conf/texis.ini in the install dir). See here for details on syntax. The non-assignment, separate-argument syntax was added in version 8.

The --install-dir{=| }dir option gives the Texis install dir to use, instead of the install-time (or Windows registry) dir. The non-assignment, separate-argument syntax was added in version 8.

The --tracepipe (in version 8.01.1711048408 20240321 and later) or -tracepipe option takes an integer argument to set bit flags for pipe tracing; this is the same value as the Vortex <vxcp tracepipe> value.

The --tracelib option (in version 8.01.1711048408 20240321 and later) takes an integer argument to set bit flags for shared library loading tracing; this is the same value as the Vortex <vxcp tracelib> value.