nfr.conf
Defines the configuration that the nfrwatch program reads to start and monitor NFR
processes.
This file contains two sections: one to configure environmrent variables and one to
configure the processes that nfrwatch monitors.
File Location
$NFRHOME/install/nfr.conf
Environment Variable
When nfrwatch executes programs listed in command entry section of this file, it
creates a completely new environment for the applications to run in. The environment
variable section of the nfr.conf file configures various settings for the environment in
which NFR runs. This section of the file includes of variables
that you must set, variables that you cannot change,
and a place for you to add your own variables.
NFR uses several environment variables that you must set for your environment.
These variables are set by the install process.
- NFRHOME
- Root directory for NFR.
- NFRUSER
- The user as whom NFR runs.
- HTTPD
- The location of the Web server.
These variables will be in the environment of programs that nfrwatch starts. You cannot
set
these variables by editing this configuration file.
- NFRUID
- The user ID of the user under which NFR runs. This is set to the UID of NFRUSER.
- NFRGID
- The group ID of the default group for the user under which NFR runs. This is set
to the GID of NFRUSER.
- HOME
- The home directory for the NFRUSER. This is set to the same value as NFRHOME.
- LOGNAME
- The name of the user as whom NFR runs. This is set to the same values as NFRUSER.
- USER
- The name of the user as whom NFR runs. This is set to the same values as NFRUSER.
- SHELL
- The shell for commands run by NFR. This is set to /bin/sh.
- IFS
- The interfield separator used by the SHELL. This is set to " \t\n".
You can set your own variables for the NFR environment. This section lists
several commonly used variables:
- PATH
- The path where NFR searches for programs and commands. This is set to /usr/bin.
Command Entry
The command entry section of the nfr.conf file specifies programs that the NFR watcher
starts and monitors.
Command Entry Syntax
+Program : StartCommand : Privilege : [Nice]
: [Respawn] : PIDfile : TerminationCommand
Fields
- +
- A special character, which must be the first character on the line, indicating that this
line is a command entry.
- Program
- The meta name of the subsystem.
- StartCommand
- The command line to execute to start the program. Use absolute paths or paths relative
to the NFR home directory.
- Priv
- Indicates whether or not to execute with root privileges. Valid values are:
Y: Indicates that the process is started with root provileges.
N: indicates that the process is started as the user specified for
NFRUSER in the environment variables section of the file.
- Nice
- Specifies the scheduling priority (nice value) for the process. If you do not
specify a nice value, the command executes with the default scheduling priority for the
nfrwatch program.Valid values are:
0 (highest), equivalent to a nice value of -19 or -20
through 39 (lowest), equivalent to a nice value of 19 or 20.
- Respawn
- Indicates whether or not to restart (respawn) this process if it terminates or is
terminated. Valid values are:
R: Indicates that the process is restarted if it terminates.
If you do not specify whether or not to respawn, the process is not restarted.
- PIDfile
- Specifies the location of the process ID file. Use absolute paths or paths
relative to the NFR home directory.
- TerminationCommand
- Specifies the command to execute to end the process. Valid values are:
Command Line to terminate the process. Use absolute paths or paths
relative to the NFR home directory.
Termination Signal. Valid values are:
- SIGHUP: Hangup
- SIGINT: Interrupt
- SIGKILL: Kill Program
- SIGTERM: Termination
- SIGUSR1: User Signal 1
- SIGUSR2: User Signal 2
|