sge_hostnameutils(1) [debian man page]
HOSTNAMEUTILS(1) Sun Grid Engine User Commands HOSTNAMEUTILS(1) NAME
sge_hostnameutils.1 - SGE Host name utilities gethostname - get local hostname. gethostbyname - get local host information for specified hostname. gethostbyaddr - get hostname via IP address. getservbyname - get configured port number of service SYNTAX
gethostname [-help|-name|-aname|-all] gethostbyname [-help|-name|-aname|-all] <name> gethostbyaddr [-help|-name|-aname|-all] <ip> getservbyname [-help|-number] <service> DESCRIPTION
gethostname and gethostbyname are used to get the local resolved host name. gethostbyaddr is used to get the hostname of a specified IP address (dotted decimal notation). getservbyname can be used to get the configured port number of a service (e.g. from /etc/services). The hostname utils are primarily used by the Sun Grid Engine installation scripts. gethostname , gethostbyname and gethostbyaddr called without any option will print out the hostname, all specified aliases, and the IP address of the locally resolved hostname. Calling get- servbyname without any option will print out the full service entry. OPTIONS
-help Prints a list of all options. -name This option only reports the primary name of the host. -aname If this option is set, the Sun Grid Engine host alias file is used for host name resolving. It is necessary to set the environment variable SGE_ROOT and, if more than one cell is defined, also SGE_CELL. This option will print out the Sun Grid Engine host name. -all By using the -all option all available host information will be printed. This information includes the host name, the Sun Grid Engine host name, all host aliases, and the IP address of the host. -number This option will print out the port number of the specified service name. <name> The host name for which the information is requested. <ip> The IP address (dotted decimal notation) for which the information is requested. <service> The service name for which the information is requested (e.g. ftp, sge_qmaster or sge_execd). EXAMPLES
The following example shows how to get the port number of the FTP service: >getservbyname -number ftp 21 The next example shows the output of gethostname -all when the host alias file contains this line: gridmaster extern_name extern_name.mydomain The local host resolving must also provide the alias name "gridmaster". Each Sun Grid Engine host that wants to use the cluster must be able to resolve the host name "gridmaster". To setup an alias name, edit your /etc/hosts file or modify your NIS setup to provide the alias for the NIS clients. The host alias file must be readable from each host (use e.g. NFS shared file location). >gethostname -all Hostname: extern_name.mydomain SGE name: gridmaster Aliases: loghost gridmaster Host Address(es): 192.168.143.99 ENVIRONMENTAL VARIABLES
SGE_ROOT Specifies the location of the Sun Grid Engine standard configuration files. SGE_CELL If set, specifies the default Sun Grid Engine cell. SEE ALSO
sge_intro(1), host_aliases(5), COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions. SGE 6.2u5 $Date$ HOSTNAMEUTILS(1)
Check Out this Related Man Page
SGE_EXECD(8) Sun Grid Engine Administrative Commands SGE_EXECD(8) NAME
sge_execd - Sun Grid Engine job execution agent SYNOPSIS
sge_execd [ -help ] DESCRIPTION
sge_execd controls the Sun Grid Engine queues local to the machine on which sge_execd is running and executes/controls the jobs sent from sge_qmaster(8) to be run on these queues. OPTIONS
-help Prints a listing of all options. LOAD SENSORS
If a load sensor is configured for sge_execd via either the global host configuration or the execution-host-specific cluster configuration (See sge_conf(5).), the executable path of the load sensor is invoked by sge_execd on a regular basis and delivers one or multiple load figures for the execution host (e.g. users currently logged in) or the complete cluster (e.g. free disk space on a network wide scratch file system). The load sensor may be a script or a binary executable. In either case its handling of the STDIN and STDOUT streams and its control flow must comply to the following rules: The load sensor must be written as an infinite loop waiting at a certain point for input from STDIN. If the string "quit" is read from STDIN, the load sensor should exit. When an end-of-line is read from STDIN, a load data retrieval cycle should start. The load sensor then performs whatever operation is necessary to compute the desired load figures. At the end of the cycle the load sensor writes the result to stdout. The format is as follows: o A load value report starts with a line containing only either the word "start" or the word "begin". o Individual load values are separated by newlines. o Each load value report consists of three parts separated by colons (":") and containing no blanks. o The first part of a load value information is either the name of the host for which load is reported or the special name "global". o The second part is the symbolic name of the load value as defined in the host or global complex list (see complex(5) for details). If a load value is reported for which no entry in the host or global complex list exists, the reported load value is not used. o The third part is the measured load value. o A load value report ends with a line with only the word "end". ENVIRONMENTAL VARIABLES
SGE_ROOT Specifies the location of the Sun Grid Engine standard configuration files. SGE_CELL If set, specifies the default Sun Grid Engine cell. To address a Sun Grid Engine cell sge_execd uses (in the order of prece- dence): The name of the cell specified in the environment variable SGE_CELL, if it is set. The name of the default cell, i.e. default. SGE_DEBUG_LEVEL If set, specifies that debug information should be written to stderr. In addition the level of detail in which debug infor- mation is generated is defined. SGE_QMASTER_PORT If set, specifies the tcp port on which sge_qmaster(8) is expected to listen for communication requests. Most installations will use a services map entry for the service "sge_qmaster" instead to define that port. SGE_EXECD_PORT If set, specifies the tcp port on which sge_execd(8) is expected to listen for communication requests. Most installations will use a services map entry for the service "sge_execd" instead to define that port. RESTRICTIONS
sge_execd usually is started from root on each machine in the Sun Grid Engine pool. If started by a normal user, a spool directory must be used to which the user has read/write access. In this case only jobs being submitted by that same user are handled correctly by the system. FILES
sgepasswd contains a list of user names and their corresponding encrypted passwords. If available, the password file will be used by sge_execd. To change the contents of this file please use the sgepasswd command. It is not advised to change that file manu- ally. <sge_root>/<cell>/common/configuration Sun Grid Engine global configuration <sge_root>/<cell>/common/local_conf/<host> Sun Grid Engine host specific configuration <sge_root>/<cell>/spool/<host> Default execution host spool directory <sge_root>/<cell>/common/act_qmaster Sun Grid Engine master host file SEE ALSO
sge_intro(1), sge_conf(5), complex(5), sge_qmaster(8). COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions. SGE 6.2u5 $Date$ SGE_EXECD(8)