How to Create the SERVERS Section of the Configuration File


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Documentation \| Setting Up a BEA Tuxedo Application \| Local Topics \| Previous Topic \| Next Topic \| Contents

The SERVERS section of the configuration file contains information specific to a server process. While this section is not required, an application without this section has no application servers and little functionality. Each entry in this section represents a server process to be booted in the application and includes the following information:

The name, group, and numeric identifier for a server (SRVGRP, SRVID)
Server command-line options defined by servopts (CLOPT)
Parameters to determine the booting order and number of servers to boot (SEQUENCE, MIN, MAX)
A server-specific environment file (ENVFILE)
Server queue-related information (RQADDR, RQPERM, REPLYQ, RPPERM)
Restart information (RESTART, RCMD, MAXGEN, GRACE)
Designation as a conversational server (CONV)
Overriding of system-wide shared memory access (SYSTEM_ACCESS)
Setting security parameters for IIOP Listener (ISL) servers

Note: Command-line options supported by the BEA Tuxedo system are described in servopts(5) in the File Formats, Data Descriptions, MIBs, and System Processes Reference.

For each parameter in the SERVERS section, the following table provides a description and links to reference pages and additional information.

To Specify This Information in the SERVERS Section (Optional)	Set This Parameter (Required/Optional)	For More Information, Click the Following
Whether the server is a conversational server. Connections can be made only to conversational servers, and rpc requests (via tpacall(3c) or tpcall(3c)) can be made only to non-conversational servers.	CONV (optional run-time parameter)	Conversational server
Principal name of the process used for identification, location of the principal user's private key, and the environment variable containing the password	SEC_PRINCIPAL_NAME, SEC_PRINCIPAL_LOCATION, SEC_PRINCIPAL_PASSVAR	Security attributes
When this server should be booted or shut down relative to other servers.	SEQUENCE (Optional boot parameter)	Server boot order
The minimum number of occurrences of the server to be booted by tmboot.	MIN (Optional boot parameter)	Server boot order
The maximum number of occurrences of the server that can be booted.	MAX (Optional boot parameter)	Server boot order
A list of servopts(5) options to be passed to a server process at boot time. If none are specified, the default is -A. string_value may contain up to 256 characters.	CLOPT (Optional boot parameter)	Server command-line options
A request for the addition of the values in this file to the environment of the server during its initialization. If a server is associated with a server group that can be migrated to a second machine, the ENVFILE must be in the same location on both machines.	ENVFILE (Optional run-time parameter)	Server environment file
The name of the group in which the server is to run. string_value must be the logical name associated with a server group in the GROUPS section.	SRVGRP (Required)	Server group
An integer that uniquely identifies a server within a group. Identifiers must be between 1 and 30,000 inclusive.	SRVID (required)	Server ID
The symbolic name of the request queue for the process.	RQADDR (Optional run-time parameter)	Server queue information
The numeric permissions on the request queue.	RQPERM (Optional run-time parameter)	Server queue information
Whether a reply queue should be established for the process.	REPLYQ (Optional run-time parameter)	Server queue information
The numeric permissions on the reply queue.	RPPERM (Optional run-time parameter)	Server queue information
The command that should be executed when the process abnormally terminates, if the process is restartable.	RCMD (Optional run-time parameter)	Server restart information
The maximum number minus one time that the process can be restarted within the period specified by GRACE, if the process is restartable.	MAXGEN (Optional run-time parameter)	Server restart information
A parameter that specifies that the process can have up to MAXGEN lives within the specified number of seconds, if the process is restartable.	GRACE (Optional run-time parameter)	Server restart information
Whether the process is restartable. Default is N. If server migration is specified, RESTART must be set to Y. (A server terminated with a SIGTERM signal must be rebooted.)	RESTART (Optional run-time parameter)	Server restart information
The default mode used by BEA Tuxedo system libraries within application processes to gain access to BEA Tuxedo system internal tables.	SYSTEM_ACCESS (Optional run-time parameter)	System access to servers
The minimum number of server dispatch threads started on initial server boot. The separate dispatched thread that is used when MAXDISPATCHTHREADS>1 is not counted as part of the MAXDISPATCHTHREADS value. It is required that MINDISPATCHTHREADS<= MAXDISPATCHTHREADS. The default for this parameter is 0.	MINDISPATCHTHREADS	Threads
The maximum number of concurrently dispatched threads that each server process may spawn. If MAXDISPATCHTHREADS>1, then a separate dispatcher thread is used and does not count against this limit. It is required that MINDISPATCHTHREADS<= MAXDISPATCHTHREADS. The default for this parameter is 1.	MAXDISPATCHTHREADS	Threads
The stack size in bytes for each server thread after the initial thread. If not specified or specified as 0, the operating system default is used. This option has an affect on the server only when a value greater than 1 is specified for MAXDISPATCHTHREADS.	THREADSTACKSIZE	threads

Sample SERVERS Section

Following is a sample SERVERS section of a configuration file.

*SERVERS
DEFAULT:          RESTART=Y MAXGEN=5 GRACE=3600
                  REPLYQ=N CLOPT="-A"
                  ENVFILE="/usr/home/envfile"
                  SYSTEM_ACCESS=PROTECTED

RINGUP1           SRVGRP=GROUP1 SRVID=1 MIN=3
                  RQADDR="ring1"
RINGUP2           SRVGRP=GROUP1 SRVID=4 MIN =3
                  RQADDR="ring2"

Note: Omitted from this sample are SEQUENCE (the order of booting is 1 to 6), REPLYQ and RPPERM (the server does not receive replies), RCMD (no special commands are desired on restart), and CONV (servers are not conversational). Defaults are applied to all servers unless a different setting is specified for a specific server.

Sample SERVERS Section Parameters

In the preceding sample SERVERS section, the following parameters and values are specified.

Parameter	Meaning
RESTART=Y (default)	Restart the servers.
MAXGEN=5 (default)	The MAXGEN parameter specifies a number greater than 0 and less than 256 that controls the number of times a server can be started within the period specified by the GRACE parameter. The default is 1. If the server is to be restartable, MAXGEN must be >= 2. The number of restarts is at most number - 1 times. RESTART must be Y or MAXGEN is ignored.
GRACE=3600 (default)	If RESTART is Y, the GRACE parameter specifies the time period (in seconds) during which this server can be restarted as MAXGEN - 1 times. The number assigned must be equal to or greater than 0. The maximum is 2,147,483,648 seconds (or a little more than 68 years). If GRACE is not specified, the default is 86,400 seconds (24 hours). As soon as one GRACE period is over, the next grace period begins. Setting the grace period to 0 removes all limitations; the server can be restarted an unlimited number of times.
REPLYQ=N (default)	There is no reply queue.
CLOPT="-A" (default)	Specify -A on the command line of each server.
ENVFILE="/usr/home/envfile" (default)	Read environment settings from the file ENVFILE.
SYSTEM_ACCESS=PROTECTED (default)	Deny access to internal tables outside system code.
RINGUP1	Sample name of the first server to be booted.
SRVGRP=GROUP1 SRVID=1 MIN=3 RQADDR="ring1"	Three instances of the sample server will be booted in group GROUP1 with server IDs of 1, 2, and 3, respectively. The three servers will form an MSSQ set and will read requests from queue ring1. Note: RQADDR assigns a symbolic name to the request queue of this server. MSSQ sets are established by using the same symbolic queue name for more than one server, as well as same executable name for all the servers (and by specifying a value greater than 1 for MIN).
RINGUP2	Name of the second sample server to be booted.