BOOTSTRAP(5)               Grid Engine File Formats               BOOTSTRAP(5)



[1mNAME[0m
       bootstrap - Grid Engine bootstrap file

[1mDESCRIPTION[0m
       [4mbootstrap[24m  contains  parameters that are needed for the startup of Grid
       Engine components.  It is created during the  ge_qmaster  installation.
       Modifying [4mbootstrap[24m in a running system is not supported.


[1mFORMAT[0m
       The paragraphs that follow provide brief descriptions of the individual
       parameters that compose the bootstrap configuration for a  Grid  Engine
       cluster:

   [1madmin_user[0m
       Administrative  user  account used by 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 per-
       missions (e.g. on a shared file system without global  root  read/write
       access).

       Being  a  parameter  set  at installation time changing [1madmin_user [22min a
       running system is not supported. Changing it manually  on  a  shut-down
       cluster  is possible, but if access to the Grid Engine spooling area is
       interrupted, this will result in unpredictable behavior.

       The [1madmin_user [22mparameter has  no  default  value,  but  instead  it  is
       defined during the master installation procedure.

   [1mdefault_domain[0m
       Only  needed if your 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 [1mdefault_domain [22mis appended  to
       the  unqualified  hostname  to  define a fully qualified hostname.  The
       [1mdefault_domain [22mparameter will have no effect if [1mignore_fqdn [22mis  set  to
       "true".

       Being a parameter set at installation time changing [1mdefault_domain [22min a
       running system is not supported.  The  default  for  [1mdefault_domain  [22mis
       "none", in which case it will not be used.

   [1mignore_fqdn[0m
       Ignore  fully  qualified  domain name component of hostnames. Should be
       set if all hosts belonging to a Grid Engine cluster are part of a  sin-
       gle  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 [1mignore_fqdn [22min a
       running system is not supported. The default for [1mignore_fqdn [22mis "true".

   [1mspooling_method[0m
       Defines  how  [4mge_qmaster[24m(8)  writes  its  configuration  and the status
       information of a running cluster.

       The available spooling methods are [4mberkeleydb[24m and [4mclassic[24m.

   [1mspooling_lib[0m
       The name of a shared  library  containing  the  [1mspooling_method  [22mto  be
       loaded  at [4mge_qmaster[24m(8) initialization time.  The extension character-
       izing a shared library (.so, .sl, .dylib  etc.)  is  not  contained  in
       [1mspooling_lib[22m.

       If  [1mspooling_method  [22mwas  set to [4mberkeleydb[24m during installation, [1mspool-[0m
       [1ming_lib [22mis set to [4mlibspoolb[24m, if [4mclassic[24m was chosen as  [1mspooling_method[22m,
       [1mspooling_lib [22mis set to [4mlibspoolc[24m.

       Not  all  operating  systems allow the dynamic loading of libraries. On
       these platforms a certain spooling method (default: berkeleydb) is com-
       piled into the binaries and the parameter [1mspooling_lib [22mwill be ignored.


   [1mspooling_params[0m
       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  [4mberkeleydb[24m  is
       [rpc_server:]database  directory,  e.g.  /sge_local/default/spool/qmas-
       ter/spooldb  for  spooling  to  a  local  filesystem, or myhost:sge for
       spooling over a Berkeley DB RPC server.

       For spooling method [4mclassic[24m the spooling parameters take the form <com-
       mon_dir>;<qmaster      spool      dir>,     e.g.      /sge/default/com-
       mon;/sge/default/spool/qmaster

   [1mbinary_path[0m
       The directory path where the Grid Engine binaries reside.  It  is  used
       within  Grid  Engine components to locate and startup other Grid Engine
       programs.

       The path name given here is searched for binaries as well as any direc-
       tory  below with a directory name equal to the current operating system
       architecture. Therefore, /usr/GE/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 <ge_root>/bin


   [1mqmaster_spool_dir[0m
       The location  where  the  master  spool  directory  resides.  Only  the
       [4mge_qmaster[24m(8)  and [4mge_shadowd[24m(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 [4mcron[24m(8)
       job.

       Being a parameter set at installation time  changing  [1mqmaster_spool_dir[0m
       in a running system is not supported.

       The    default   location   for   the   master   spool   directory   is
       <ge_root>/<cell>/spool/qmaster.


   [1msecurity_mode[0m
       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).

   [1mlistener_threads[0m
       The number of listener threads (defaults set by installation).

   [1mworker_threads[0m
       The number of worker threads (defaults set by installation).

   [1mscheduler_threads[0m
       The number of scheduler threads (allowed: 0-1, default set by installa-
       tion: 1, off: 0).  (see [4mqconf[24m(1) -kt/-at option)

   [1mjvm_threads[0m
       The  number  of jvm threads (allowed: 0-1, default set by installation,
       off: 0).

[1mCOPYRIGHT[0m
       See [4mge_intro[24m(1) for a full statement of rights and permissions.



GE 6.2u2                 $Date: 2008/05/21 09:47:35 $             BOOTSTRAP(5)
