NFR File Formats: nfr.conf
Home ] Up ] NFR File Formats: fac_res.src ] NFR File Formats: gui.cf ] NFR File Formats: nfr_res.src ] [ NFR File Formats: nfr.conf ] NFR File Formats: queue.cf ] NFR File Formats: spaceman.cf ] NFR File Formats: usr_res.src ] NFR File Formats: Resource Files ]


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.

Required 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.

Default Variables

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".

Additional Variables

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

Back ] Home ] Up ] Next ]