Undeploying a Processing Unit

Removing a Processing UnitClosed This is the unit of packaging and deployment in the GigaSpaces Data Grid, and is essentially the main GigaSpaces service. The Processing Unit (PU) itself is typically deployed onto the Service Grid. When a Processing Unit is deployed, a Processing Unit instance is the actual runtime entity. from the Service GridClosed A built-in orchestration tool which contains a set of Grid Service Containers (GSCs) managed by a Grid Service Manager. The containers host various deployments of Processing Units and data grids. Each container can be run on a separate physical machine. This orchestration is available for Smart Cache only. For Smart DIH, we recommend using our Kubernetes orchestration.

Command:

gs.{sh/bat} puClosed This is the unit of packaging and deployment in the GigaSpaces Data Grid, and is essentially the main GigaSpaces service. The Processing Unit (PU) itself is typically deployed onto the Service Grid. When a Processing Unit is deployed, a Processing Unit instance is the actual runtime entity. undeploy <name>

Input Example: 

<GS_HOME>/bin/gs pu undeploy myPu

<GS_HOME>/bin/gs.sh pu undeploy myPu

Parameters and Options:

Item Name Description Value
Parameter name The name of the Pu to undeploy String
Option keep-file Keep the undeployed file for future use.

Boolean —

false (default) — the data will not be saved

true — the data for the PU will be saved. It can be used later to restore the PU.
Option drain-mode Specify the desired drain behavior on shutdown.

none (default) — no drain before undeploy

attempt— undeploy even if drain didn't complete in timeout (drain-timeout

required— undeploy only if drain succeeded in timeout ( drain-timeout)
Option drain-timeout Specify the desired timeout interval for the drain phase

Time value (for drain-mode=attempt or drain-mode=required only) —

1m (default) — wait for drain for one minute.

50s — wait for drain for 50 seconds.

Path

DELETE DELETE /pus/{id}

Example Request: 

curl -X DELETE --header 'Accept: text/plain' 'http://localhost:8090/v2/pus/myPU'

This example undeploys a Processing Unit named myPU.

Options:

Option Description Required
id Provide the name of the PU you are undeploying. Yes
keepFile Boolean: false (default) — do not keep the file. true — keep the undeployed file for future redeployment. No
drainMode

Specify the desired drain behavior on shutdown.
none (default) — no drain before undeploy

attempt— undeploy even if drain didn't complete in timeout (drain-timeout

required— undeploy only if drain succeeded in timeout ( drain-timeout)

 No
drainTimeout

Timeout to wait for the drain to complete.

Examples: 5m (default, one minute). 50s (50 seconds)

No

  1. In the Processing Units view, highlight the Processing Unit to undeploy.

  2. Click the Actions icon and select Undeploy from the menu.

  3. Confirm that you want to undeploy the Processing Unit.

When the Processing Unit is undeployed successfully, it no longer appears in the Processing Units view.

You can confirm that the Processing Unit was undeployed by viewing the list of events from the toolbar. If you redeploy the same Processing Unit, all of the deploy and undeploy events appear in the event list for the Processing Unit that is displayed in the Events tab on the side of the view.

Refer to the GigaSpaces Management Center topics in the Administration section.

Refer to the Admin API topics in the Developers Guide.