NAME
bootstrap - Sun Grid Engine bootstrap file
DESCRIPTION
bootstrap contains parameters that are needed for the startup of Sun
Grid Engine components. It is created during the sge_qmaster
installation. Modifying bootstrap in a running system is not
supported.
FORMAT
The paragraphs that follow provide brief descriptions of the individual
parameters that compose the bootstrap configuration for a Sun Grid
Engine cluster:
admin_user
Administrative user account used by Sun Grid Engine for all internal
file handling (status spooling, message logging, etc.). Can be used in
cases where the root account does not have the corresponding file
access permissions (e.g. on a shared file system without global root
read/write access).
Being a parameter set at installation time changing admin_user in a
running system is not supported. Changing it manually on a shut-down
cluster is possible, but if access to the Sun Grid Engine spooling area
is interrupted, this will result in unpredictable behavior.
The admin_user parameter has no default value, but instead it is
defined during the master installation procedure.
default_domain
Only needed if your Sun Grid Engine cluster covers hosts belonging to
more than a single DNS domain. In this case it can be used if your
hostname resolving yields both qualified and unqualified hostnames for
the hosts in one of the DNS domains. The value of default_domain is
appended to the unqualified hostname to define a fully qualified
hostname. The default_domain parameter will have no effect if
ignore_fqdn is set to "true".
Being a parameter set at installation time changing default_domain in a
running system is not supported. The default for default_domain is
"none", in which case it will not be used.
ignore_fqdn
Ignore fully qualified domain name component of hostnames. Should be
set if all hosts belonging to a Sun Grid Engine cluster are part of a
single DNS domain. It is switched on if set to either "true" or "1".
Switching it on may solve problems with load reports due to different
hostname resolutions across the cluster.
Being a parameter set at installation time changing ignore_fqdn in a
running system is not supported. The default for ignore_fqdn is "true".
spooling_method
Defines how sge_qmaster(8) writes its configuration and the status
information of a running cluster.
The available spooling methods are berkeleydb and classic.
spooling_lib
The name of a shared library containing the spooling_method to be
loaded at sge_qmaster(8) initialization time. The extension
characterizing a shared library (.so, .sl, .dylib etc.) is not
contained in spooling_lib.
If spooling_method was set to berkeleydb during installation,
spooling_lib is set to libspoolb, if classic was chosen as
spooling_method, spooling_lib is set to libspoolc.
Not all operating systems allow the dynamic loading of libraries. On
these platforms a certain spooling method (default: berkeleydb) is
compiled into the binaries and the parameter spooling_lib will be
ignored.
spooling_params
Defines parameters to the chosen spooling method.
Parameters that are needed to initialize the spooling framework, e.g.
to open database files or to connect to a certain database server.
The spooling parameters value for spooling method berkeleydb is
[rpc_server:]database directory, e.g.
/sge_local/default/spool/qmaster/spooldb for spooling to a local
filesystem, or myhost:sge for spooling over a Berkeley DB RPC server.
For spooling method classic the spooling parameters take the form
<common_dir>;<qmaster spool dir>, e.g.
/sge/default/common;/sge/default/spool/qmaster
binary_path
The directory path where the Sun Grid Engine binaries reside. It is
used within Sun Grid Engine components to locate and startup other Sun
Grid Engine programs.
The path name given here is searched for binaries as well as any
directory below with a directory name equal to the current operating
system architecture. Therefore, /usr/SGE/bin will work for all
architectures, if the corresponding binaries are located in
subdirectories named aix43, cray, lx24-x86, hp11, irix65, tru64, sol-
sparc, etc.
The default location for the binary path is <sge_root>/bin
qmaster_spool_dir
The location where the master spool directory resides. Only the
sge_qmaster(8) and sge_shadowd(8) need to have access to this
directory. The master spool directory - in particular the job_scripts
directory and the messages log file - may become quite large depending
on the size of the cluster and the number of jobs. Be sure to allocate
enough disk space and regularly clean off the log files, e.g. via a
cron(8) job.
Being a parameter set at installation time changing qmaster_spool_dir
in a running system is not supported.
The default location for the master spool directory is
<sge_root>/<cell>/spool/qmaster.
security_mode
The security mode defines the set of security features the installed
cluster is using.
Possible security mode settings are none, afs, dce, kerberos, csp. (no
additional security, AFS, DCE, KERBEROS, CSP security model).
listener_threads
The number of listener threads (defaults set by installation).
worker_threads
The number of worker threads (defaults set by installation).
scheduler_threads
The number of scheduler threads (allowed: 0-1, default set by
installation: 1, off: 0). (see qconf(1) -kt/-at option)
jvm_threads
The number of jvm threads (allowed: 0-1, default set by installation,
off: 0).
COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions.