Knowledge Center Contents Previous Next |
ls_limcontrol()
Shuts down or reboots a host's LIM.
DESCRIPTION
To remove a host from a cluster, use ls_limcontrol() to shut down the host's LIM. Next, to return a removed host to a cluster, use ls_limcontrol() to reboot its LIM. When you reboot the LIM, the configuration files are read again and the previous LIM status of the host is lost.
The use of ls_limcontrol() is restricted to root and the LSF administrator as defined in the file LSF_CONFDIR/lsf.cluster.cluster_name.
Any program using this API must be setuid to root if LSF_AUTH is not defined in the lsf.conf file.
SYNOPSIS
#include <lsf/lsf.h> int ls_limcontrol(char *hostname, int opCode)PARAMETERS
hostname
Specifies the host
opCode
Specifies the shutdown or reboot LIM command.
LIM_CMD_SHUTDOWN
Command to shutdown the LIM.
LIM_CMD_REBOOT
Command to reboot the LIM.
RETURN VALUES
integer:0
The function was successful.
integer:-1
The function failed.
ERRORS
If the function fails, lserrno is set to indicate the error.
SEE ALSO
Related APIs:
ls_lockhost() - locks a local host
ls_unlockhost() - unlocks a local host
Equivalent line command
lsadmin limstartup
lsadmin limshutdown
lsadmin limrestart
Files:
${LSF_ENVDIR-/etc}/lsf.conf
$LSF_CONFDIR/lsf.shared
$LSF_CONFDIR/lsf.cluster.cluster_name
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |