LaunchSlave

To start a remote kernel and add it to the list of available slave processors, use the command LaunchSlave.

LaunchSlave["remotehost", "oscommands"]

use the operating system (shell) command oscommands to start a kernel on a remote machine named remotehost and have it connect to a link created on the local machine

LaunchSlave["remotehost", "oscommands", ConnectionType->LinkLaunch]

use the operating system (shell) command oscommands to start a kernel on a remote machine named remotehost using LinkLaunch (no separate MathLink connections)

LaunchSlave["localhost", "oscommands"]

use the operating system (shell) command oscommands to start a kernel on the local machine (using LinkLaunch)

LaunchSlave["localhost"]

use the operating system (shell) command stored in $mathkernel to start a kernel on the local machine

LaunchSlave["remotehost"]

use the operating system (shell) command stored in $RemoteCommand to start a kernel

$ProcessorID

a unique integer assigned to each remote kernel (Numbers are assigned starting with 1.)

Starting remote kernels.

The argument oscommands can be a template containing the character sequences `1` for connection type LinkLaunch and `1` through `4` for connection type LinkConnect.

placeholder	meaning
`1`	host name	the remote host name, the first argument of LinkLaunch.
`2`	link name	the name of the link object created
`3`	remote user	the user name on the remote machine, the value of $RemoteUserName, which defaults to $UserName.
`4`	protocol	a suitable -linkprotocol proto setting for the MathLink argument list

Placeholders in operating system command templates.

If there is no LinkProtocol->"proto" setting in LaunchSlave, the placeholder `4` expands to the empty string for local connections (to use the native default protocol) and to -linkprotocol TCPIP for remote connections. If an explicit LinkProtocol->"proto" setting exists, `4` expands to -linkprotocol proto.

The following options can be given in LaunchSlave.

option name	default value
InitCode	$InitCode	a sequence of commands (wrapped inside Hold) to send to each remote kernel upon startup
ConnectionType	Automatic	the MathLink connection type, which can be either LinkLaunch or LinkCreate; by default, LinkLaunch is used for local kernels, and LinkCreate is used for remote kernels
LinkProtocol	Automatic	this option is passed on to LinkLaunch or LinkCreate. by default, "TCPIP" is used for remote kernels, and no setting is used for local kernels
LinkHost	""	this option is passed on to LinkCreate. It can be used to specify the interface on which the link is listening.
ProcessorSpeed	1	an estimate of the relative speed of the remote kernel

Options of LaunchSlave.

THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.