2024年4月7日发(作者:)

advertises the application services representing the foreign services based on the CLOPT parameter for

the gateway. If the instantiation has the concept of foreign servers, these servers are booted by the

gateway at this time.

Booting an LMID is equivalent to booting all groups on that LMID.

Application servers are booted in the order specified by the SEQUENCE parameter, or in the order of

server entries in the configuration file (see the description in UBBCONFIG(5)). If two or more servers in

the SERVERS section of the configuration file have the same SEQUENCE parameter, then tmboot may

boot these servers in parallel and will not continue until they all complete initialization. Each entry in the

SERVERS section can have a MIN and MAX parameter. tmboot boots MIN application servers (the default

is 1 if MIN is not specified for the server entry) unless the -i option is specified; using the -i option causes

individual servers to be booted up to MAX occurrences.

If a server cannot be started, a diagnostic is written on the central event log (and to the standard output,

unless -q is specified), and tmboot continues—except that if the failing process is a BBL, servers that

depend on that BBL are silently ignored. If the failing process is a DBBL, tmboot ignores the rest of the

configuration file. If a server is configured with an alternate LMID and fails to start on its primary machine,

tmboot automatically attempts to start the server on the alternate machine and, if successful, sends a

message to the DBBL to update the server group section of TUXCONFIG.

For servers in the SERVERS section, only CLOPT, SEQUENCE, SRVGRP, and SRVID are used by

tmboot. Collectively, these are known as the server's boot parameters. Once the server has been booted,

it reads the configuration file to find its run-time parameters. (See UBBCONFIG(5) for a description of all

parameters.)

All administrative and application servers are booted with APPDIR as their current working directory. The

value of APPDIR is specified in the configuration file in the MACHINES section for the machine on which

the server is being booted.

The search path for the server executables is APPDIR, followed by TUXDIR/bin, followed by /bin and

/usr/bin, followed by any PATH specified in the ENVFILE for the MACHINE. The search path is used only if

an absolute pathname is not specified for the server. Values placed in the server's ENVFILE are not used

for the search path.

When a server is booted, the variables TUXDIR, TUXCONFIG, TUXOFFSET, and APPDIR, with values

specified in the configuration file for that machine, are placed in the environment. The environment

variable LD_LIBRARY_PATH is also placed in the environment of all servers. Its value defaults to

$APPDIR:$TUXDIR/lib:/lib:/usr/lib:lib> where is the value of the first LD_LIBRARY_PATH= line appearing

in the machine ENVFILE. See UBBCONFIG(5) for a description of the syntax and use of the ENVFILE.

Some Unix systems require different environment variables. For HP-UX systems, use the SHLIB_PATH

environment variable. FOR AIX systems, use the LIBPATH environment variable.

The ULOGPFX for the server is also set up at boot time based on the parameter for the machine in the

configuration file. If not specified, it defaults to $APPDIR/ULOG.

All of these operations are performed before the application initialization function, tpsvrinit(), is called.

Many of the command line options of tmboot serve to limit the way in which the system is booted and can

be used to boot a partial system. The following options are supported.

-l lmid

For each group whose associated LMID parameter is lmid, all TMS and gateway servers associated with

the group are booted and all servers in the SERVERS section associated with those groups are executed.

-g grpname

All TMS and gateway servers for the group whose SRVGRP parameter is grpname are started, followed

by all servers in the SERVERS section associated with that group. TMS servers are started based on the

TMSNAME and TMSCOUNT parameters for the group entry.

-i srvid

All servers in the SERVERS section whose SRVID parameter is srvid are executed.

-s aout

All servers in the SERVERS section with name aout are executed. This option can also be used to boot

TMS and gateway servers; normally this option is used in this way in conjunction with the -g option.

-o sequence

All servers in the SERVERS section with SEQUENCE parameter sequence are executed.

-S