Sun Grid Engine Information Center
Administering Sun Grid Engine
Index

Configuring Hosts From the Command Line

Configuring Execution Hosts From the Command Line

To configure execution hosts from the command line, use the following arguments for the qconf command:

• qconf -ae [ exec-host ]
  
  The -ae option (add execution host) displays an editor that contains a configuration template for an execution host. The editor is either the default vi editor or the editor that corresponds to the EDITOR environment variable. If you specify exec-host, which is the name of an already configured execution host, the configuration of this execution host is used as a template. To configure the execution host, change and save the template. See the host_conf(5) man page for a detailed description of the template entries to be changed.

• qconf -de hostname
  
  The -de option (delete execution host) deletes the specified host from the list of execution hosts. All entries in the execution host configuration are lost.

• qconf -me hostname
  
  The -me option (modify execution host) displays an editor that contains the configuration file template for the specified execution host. The editor is either the default vi editor or the editor that corresponds to the EDITOR environment variable. To modify the execution host configuration, change and save the configuration file template. See the host_conf(5) man page for a detailed description of the template entries to be changed.

• qconf -Me filename
  
  The -Me option (modify execution host) uses the content of filename as execution host configuration template. The configuration in the specified file must refer to an existing execution host. The configuration of this execution host is replaced by the file content. This qconf option is useful for changing the configuration of offline execution hosts, for example, in cron jobs, as the -Me option requires no manual interaction.

• qconf -se hostname
  
  The -se option (show execution host) shows the configuration of the specified execution host as defined in host_conf.

• qconf -sel
  
  The -sel option (show execution host list) displays a list of hosts that are configured as execution hosts.

Configuring Administration Hosts From the Command Line

To configure administration hosts from the command line, use the following arguments for the qconf command:

• qconf -ah hostname
  
  The -ah option (add administration host) adds the specified host to the list of administration hosts.

• qconf -dh hostname
  
  The -dh option (delete administration host) deletes the specified host from the list of administration hosts.

• qconf -sh
  
  The -sh option (show administration hosts) displays a list of all currently configured administration hosts.

Configuring Submit Hosts From the Command Line

To configure submit hosts from the command line, use the following arguments for the qconf command:

• qconf -as hostname
  
  The -as option (add submit host) adds the specified host to the list of submit hosts.

• qconf -ds hostname
  
  The -ds option (delete submit host) deletes the specified host from the list of submit hosts.

• qconf -ss
  
  The -ss option (show submit hosts) displays a list of the names of all currently configured submit hosts.

Configuring Host Groups From the Command Line

To configure host groups from the command line, use the following arguments for the qconf command:

• qconf -ahgrp host-group-name
  
  The -ahgrp option (add host group) adds a new host group to the list of host groups. See the hostgroup(5) man page for a detailed description of the configuration format.

• qconf -Ahgrp filename
  
  The -Ahgrp option (add host group from file) displays an editor that contains a host group configuration defined in filename. The editor is either the default vi editor or the editor that corresponds to the EDITOR environment variable. To configure the host group, change and save the configuration file template.

• qconf -dhgrp host-group-name
  
  The -dhgrp option (delete host group) deletes the specified host group from the list of host groups. All entries in the host group configuration are lost.

• qconf -mhgrp host-group-name
  
  The -mhgrp option (modify host group) displays an editor that contains the configuration of the specified host group as template. The editor is either the default vi editor or the editor that corresponds to the EDITOR environment variable. To modify the host group configuration, change and save the configuration file template.

• qconf -Mhgrp filename
  
  The -Mhgrp option (modify host group from file) uses the content of filename as host group configuration template. The configuration in the specified file must refer to an existing host group. The configuration of this host group is replaced by the file content.

• qconf -shgrp host-group-name
  
  The -shgrp option (show host group) shows the configuration of the specified host group.

• qconf -shgrp_tree host-group-name
  
  The -shgrp_tree option (show host group as tree) shows the configuration of the specified host group and its sub-hostgroups as a tree.

• qconf -shgrp_resolved host-group-name
  
  The -shgrp_resolved option (show host group with resolved host list) shows the configuration of the specified host group with a resolved host list.

• qconf -shgrpl
  
  The -shgrpl option (show host group list) displays a list of all host groups.

Monitoring Execution Hosts With qhost

Use the qhost command to retrieve a quick overview of the execution host status:

% qhost

This command produces output that is similar to the following example:

Example – Sample qhost Output

HOSTNAME                ARCH         NCPU  LOAD  MEMTOT  MEMUSE  SWAPTO  SWAPUS
-------------------------------------------------------------------------------
global                  -               -     -       -       -       -       -
arwen                   aix43           1     -       -       -       -       -
baumbart                irix65          2  0.00    1.1G   91.5M  128.0M     0.0
boromir                 hp11            1     -  128.0M       -  256.0M       -
carc                    lx24-amd64      2  0.00    3.8G  989.8M    1.0G     0.0
denethor                aix51           1 4.54G       -       -       -       -
durin                   lx24-x86        1  0.37  123.1M   46.5M  213.6M   26.6M
eomer                   sol-sparc64     1  0.13  256.0M  248.0M  513.0M   93.0M
lolek                   tru64           1  0.02    1.0G  790.0M    1.0G    8.0K
mungo                   lx22-alpha      1  1.00  248.9M   78.8M  129.8M    2.5M
nori                    sol-x86         2  0.38 1023.0M  372.0M  512.0M   37.0M
pippin                  darwin          1  0.00  640.0M  264.0M     0.0     0.0
smeagol                 hp11            1  0.35  512.0M  425.0M    1.0G   95.0M

See the qhost(1) man page for a description of the output format and for more options.

Killing Daemons From the Command Line

To kill Grid Engine system daemons from the command line, use one of the following commands:

% qconf -ke[j] {<hostname>[,...] | all}
% qconf -ks
% qconf -km

You must have manager or operator privileges to use these commands. See Managing Users Access for more information about manager and operator privileges.

• The qconf -ke command shuts down the execution daemons. However, it does not cancel active jobs. Jobs that finish while no sge_execd is running on a system are not reported to sge_qmaster until sge_execd is restarted. The job reports are not lost, however.
  The qconf -kej command kills all currently active jobs and brings down all execution daemons.
  Use a comma-separated list of the execution hosts you want to shut down, or specify all to shut down all execution hosts in the cluster.
• The qconf -ks command shuts down the scheduler sge_schedd.
• The qconf -km command forces the sge_qmaster process to terminate.

If you want to wait for any active jobs to finish before you run the shutdown procedure, use the qmod -dq command for each cluster queue, queue instance, or queue domain before you run the qconf sequence described above. For information about cluster queues, queue instances, and queue domains, see About Configuring Queues.

% qmod -dq {<cluster-queue> | <queue-instance> | <queue-domain>}

The qmod -dq command prevents new jobs from being scheduled to the disabled queue instances. You should then wait until no jobs are running in the queue instances before you kill the daemons.

Restarting Daemons From the Command Line

Log in as root on the machine on which you want to restart Grid Engine system daemons.
Type the following commands to run the startup scripts:

% $SGE_ROOT/$SGE_CELL/common/sgemaster
% $SGE_ROOT/$SGE_CELL/common/sgeexecd

These scripts looks for the daemons that are normally running on this host and then starts them.