SYNOPSIS
SGE_Helper_Service.exe [ -help | -install | -uninstall ]
DESCRIPTION
SGE_Helper_Service.exe helps the sge_execd(8) to run Windows jobs that
request to be allowed to display their GUI on the visible Desktop. It
is a Win32 service that is started at boot time under the SYSTEM
account, giving it the permissions to give any process the permissions
to access the visible Desktop.
This service runs independently of the sge_execd(8) (i.e. it is not
started and stopped together with the execution daemon) and there can
be only one SGE_Helper_Service.exe per host.
Jobs can request to be allowed to display their GUI on the visible
desktop by requesting the resource "display_win_gui" (qsub -l dis-
play_win_gui=1). See submit(1) , option "-v", for information on how to
set a job environment variable.
When running GUI jobs, the environment variable SGE_BACKGND_MODE can be
used to direct where the output of the GUI will be displayed. If the
environment variable SGE_BACKGND_MODE is set to "TRUE" or "1" and "-l
display_win_gui=true" is requested, the job is started by the helper
service, but the GUI is not opened on the execution host's screen.
Instead it is opened on a virtual screen.
The Windows administrator can operate this service using the usual Win-
dows Service Control Manager or the "net" command. The "start" method
starts the service if possible, the "stop" method stops it regardless
of any jobs that might be still running. For a graceful shutdown, first
run the "pause" method. This will start the shutdown procedure of the
service and prevent it from accepting any further jobs. After this, the
"resume" (aka "continue") method will fail as long as there are jobs
running in the SGE_Helper_Service.exe. If no job is left in the ser-
vice, the "resume" method will succeed and the service will stop.
OPTIONS
-help
Prints a listing of all options.
-install
Installs the service. Only the local Administrator has the permissions
to install the service.
-uninstall
Uninstalls the service. Only the local Administrator has the permis-
sions to uninstall the service. Only a stopped service can be unin-
stalled. See the Windows command net.exe for information on how to stop
a service.
SEE ALSO
sge_intro(1), sge_execd(8).
Man(1) output converted with
man2html