Node configuration options are specified in an options file, called node.config. The rest of this section provides details about the node.config file.
EnFuzion checks for the node.config file in the following locations: the local working directory, the directory specified in the ENFNODE_PATH environment variable, and the main EnFuzion installation directory on the node. By default, the node.config file is located in the main EnFuzion installation directory on the node.
On Linux/Unix, the default location of the main EnFuzion installation directory is $HOME/enfuzion.
On Windows, the default location of the main EnFuzion installation directory is C:\enfuzion.
The node.config file contains lines with user defined option values. Lines that start with "#" are treated as comments.
The following sections describe configuration options in detail.
The joblimit option specifies the maximum number of concurrent executing jobs on this node. Usually, its value is equal to the number of processors on the host. There is an equivalent option in enfuzion.options. If both are specified, the value in enfuzion.options takes precedence. More information about enfuzion.options can be found in the Section called Specifying Load Monitoring Options.
The option is specified as:
joblimit <integer>Examples:
# the number of concurrent jobs
joblimit 1
The default value is one job.
By default, when the node starts, it opens a port for the root to connect to. This port is assigned dynamically. If the network traffic between the root and the node is controlled by a firewall, then dynamic port assignment might not be compatible with the firewall. In such cases, the node can be configured with a static port.
The nodeport option is specified as:
nodeport <port_number>Examples:
# set node port number, used for root connections
nodeport 10106
There is no default value for the nodeport option.
If the option is not specified, the node port is assigned
dynamically.The connect option determines whether the node initiates the connection to the root. By default, the root connects to the node as specified in the enfuzion.nodes file. This default behavior can be changed using the connect option. If the option value is on, the node will connect to the root, and there is no need to specify the node in the enfuzion.nodes file on the root. However, the port on the root must be enabled in root.options.
The connect option is specified as:
connect on | off
Examples:
# set connect from the node: off - root connect, on - node connect
connect on
The default value for the connect option is off, meaning the root makes the connection to a node.
If the connect option value is on, meaning the node connects to the root, then this option must provide the root host name.
The roothost option is specified as:
roothost "<host_name>"
Examples:
# the root host to connect to
roothost "enfuzion.domain.com"
Note: <host_name> must be included in double quotes.
There is no default value for the roothost option. If the connect option is on, then the roothost value must be specified.
If the connect option is on, and the node connects to the root, then this option must provide the port number for connection to the root host.
The rootport option is specified as:
rootport <port_number>
Examples:
# the root port number
rootport 10103
There is no default value for the rootport option. If the connect option is on, then rootport must be specified.
If the connect option is on, and the node connects to the root, then this option specifies how many times the node tries to connect to the root. This option is useful when the root is not executing at all times, and nodes must wait for the root to become operational.
The connectretry option is specified as:
connectretry <number_of_tries>
If <number_of_tries> is 0, then the node tries to connect infinitely.
Examples:
# the number of tries to connect to the root, default 0, meaning infinite
connectretry 0
The default value for the connectretry option is 0, which means try infinitely.
If the connect option is on, and the node connects to the root, then this option specifies the delay between attempts to connect to the root. This option is useful when the root is not executing at all times, and nodes must wait for the root to become operational.
The connectdelay option is specified as:
connectdelay <seconds>
Examples:
# the delay between different tries, in seconds, default 300s
connectdelay 300
The default value for the connectdelay option is 300s, which means the delay between connections is 5 minutes.
The batch option determines whether the node process terminates after the root connection is terminated or not. By default, the node processes perform a cleanup on the node and terminate after the connection with the root is terminated. This default behavior can be changed with the batch option. If the option is on, the node does not terminate after the root termination, instead it continues to wait for another root connection.
The batch option is specified as:
batch on | off
Examples:
# batch mode: off - exit after the first connection, on - keep executing batch off
The default value for the batch option is off. The node processes perform a cleanup and terminate after the root connection is terminated.
After the node is started, and if the connect option is off, a port is opened for the root to connect to. This option specifies whether the node port is reported to the program that started the node or not. This option is used primarily for internal EnFuzion purposes.
The node port message option is specified as:
report on | off
Examples:
# report the port number (internal use)
report on
The default value for the report option depends on the value of the connect option. If connect is on, then the node port message option is off. Otherwise, the default is on.
After the node is started, the node can exchange an initial sequence with the program that started it. This option specifies whether the initial sequence with the start program is exchanged or not. This option is used primarily for internal EnFuzion purposes.
The hello option is specified as:
hello on | off
Examples:
# exchange an initial sequence (internal use)
hello on
The default value for the hello option depends on the value of the connect option. If connect is on, then the hello option is off. Otherwise, the default is on.
The following is a sample node.config file. All options are disabled with comments.
To change default configuration values, store the text below to file node.config in the EnFuzion directory on the node and modify option values for your environment.
#------------ store the text below to node.config ------------- # # EnFuzion Node Configuration File # this is only a sample # uncomment and modify lines for your configuration # the number of concurrent jobs #joblimit 1 # set node port number, used for root connections #nodeport 10106 # set connect from the node: off - root connect, on - node connect #connect on # the root host to connect to #roothost "enfuzion.domain.com" # the root port number #rootport 10103 # the number of tries to connect to the root, default 0, meaning infinite #connectretry 0 # the delay between different tries, in seconds, default 300s #connectdelay 300 # batch mode: off - exit after the first connection, on - keep executing #batch off # report the port number (internal use) #report on # exchange an initial sequence (internal use) #hello on #--------------------------------------------------------------