Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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