Deploying Invocation Grid Projects

When an IG worker project is ready to be deployed, it must be built, zipped, and uploaded to host systems that are running the ScaleOut service.

Invocation Grid Manager

The InvocationGridManager contains static methods for deploying and stopping invocation grids.

Starting an Invocation Grid

  • InvocationGridManager.deployInvocationGridThroughZip(GridConnection connection, String igName, String executableName, File zipFile, String javaEntryPoint)

    • GridConnection connection: The grid connection used by the client application to connect to the ScaleOut cluster.

    • String igName: the invocation grid name.

    • String executableName: the executable name, typically “java” or “java.exe” if the ScaleOut cluster is running on Windows.

    • File zipFile: the packaged invocation grid as a ZIP archive.

    • String javaEntryPoint: the java main – this is the main that instantiates the InvocationWorker.

      • example: com.mycompany.invocationgrid.MyInvocationGrid

  • InvocationGridManager.deployInvocationGridThroughZip(GridConnection connection, String igName, String executableName, File zipFile, String javaEntryPoint, String javaFlags)

    • GridConnection connection: The grid connection used by the client application to connect to the ScaleOut cluster.

    • String igName: the invocation grid name.

    • String executableName: the executable name, typically “java” or “java.exe” if the ScaleOut cluster is running on Windows.

    • File zipFile: the packaged invocation grid as a ZIP archive.

    • String javaEntryPoint: the java main – this is the main that instantiates the InvocationWorker.

      • example: com.mycompany.invocationgrid.MyInvocationGrid

    • optional String javaFlags: additional java flags

  • InvocationGridManager.deployInvocationGridThroughZip(GridConnection connection, String igName, String executableName, File zipFile, String javaEntryPoint, String javaFlags, byte[] startupParam)

    • GridConnection connection: The grid connection used by the client application to connect to the ScaleOut cluster.

    • String igName: the invocation grid name.

    • String executableName: the executable name, typically “java” or “java.exe” if the ScaleOut cluster is running on Windows.

    • File zipFile: the packaged invocation grid as a ZIP archive.

    • String javaEntryPoint: the java main – this is the main that instantiates the InvocationWorker .

      • example: com.mycompany.invocationgrid.MyInvocationGrid

    • optional String javaFlags: additional java flags

    • optional byte[] startupParam: a startup parameter passed to the InvocationGridStartup#configure method.

Stopping an Invocation Grid

  • InvocationGridManager.shutdownInvocationGrid(GridConnection connection, String name)

    • GridConnection connection: The grid connection used by the client application to connect to the ScaleOut cluster.

    • String name: the invocation grid name.

  • InvocationGridManager.shutdownInvocationGrid(GridConnection connection, long igId)

    • GridConnection connection: The grid connection used by the client application to connect to the ScaleOut cluster.

    • long igId: the invocation grid ID