Provided by: gridengine-common_6.2u5-4_all bug

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.