WOLFRAM

Wolfram Language & System Documentation Center

RemoteKernelOpen[spec]

launches a kernel with the given specification.

RemoteKernelOpen[{spec1,spec2,…}]

launches kernels in parallel.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
"LocalLinkMode"  
"Service"  
"Timeout"  
See Also
Tech Notes
Related Guides
LightweightGridClient`
LightweightGridClient`

RemoteKernelOpen

RemoteKernelOpen[spec]

launches a kernel with the given specification.

RemoteKernelOpen[{spec1,spec2,…}]

launches kernels in parallel.

Details and Options

  • RemoteKernelOpen is used by LaunchKernels to start a parallel kernel with the Lightweight Grid protocol.
  • The argument to RemoteKernelOpen can be a hostname, a Lightweight Grid Manager URL, a RemoteServicesAgent expression, or a RemoteService expression.
  • Use RemoteKernelClose or RemoteKernelCloseAll to close the kernel.
  • With the default setting "LocalLinkMode"->"Connect", the remote kernel creates a link and Mathematica connects to it. With "LocalLinkMode"->"Create", Mathematica creates a link and the remote kernel connects to it. Some network configurations do not allow Mathematica to connect to links created on the remote computer, requiring "LocalLinkMode" -> "Create" to establish a connection.
  • The following options can be given:
  • "LocalLinkMode""Connect"how to establish the link
    "Service" ""names the service to launch
    "Timeout"30the timeout for the network connection, in seconds

Examples

open all close all

Basic Examples  (1)

Wolfram Language code: Needs["LightweightGridClient`"]

Open one kernel on a remote computer:

Wolfram Language code: link = RemoteKernelOpen["cluster1.example.com"]

Evaluate an expression on the remote kernel:

Wolfram Language code: LinkWriteHeld[link, Hold[FactorInteger[2 ^ 32 - 1]]]
Wolfram Language code: LinkRead[link]

Close the kernel:

Wolfram Language code: RemoteKernelClose[link]

Scope  (1)

Open kernels on a multi-core machine:

Wolfram Language code: RemoteKernelOpen[Table["octet.example.com", {4}]]

Options  (3)

"LocalLinkMode"  (1)

Let the remote kernel create a MathLink link and connect to it in this Mathematica session:

Wolfram Language code: RemoteKernelOpen["cluster1.example.com", "LocalLinkMode" -> "Connect"]

Create the MathLink link in this Mathematica session running on clusterhead.example.com and have the remote kernel connect to it:

Wolfram Language code: RemoteKernelOpen["cluster1.example.com", "LocalLinkMode" -> "Create"]

"Service"  (1)

Open a kernel using the "ProjectGamma" service on octet.example.com:

Wolfram Language code: RemoteKernelOpen["octet.example.com", "Service" -> "ProjectGamma"]

"Timeout"  (1)

Wait 2.5 seconds for a response from octet.example.com before returning:

Wolfram Language code: RemoteKernelOpen["octet.example.com", "Timeout" -> 2.5]