1. In the Spaces view, highlight the Space where you want to delete the data.

2. Display the Types pane in the lower area of the view.

3. Click the Actions icon and select Clear from the menu.

After you delete the data, you can verify it was removed by looking at the value of the Instances Count column for that data type.

Command:

gs.{sh/bat} pu 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. quiesce <name>

Description:

This command disables a running Processing Unit for maintenance.

Input Example:

<GS_HOME>/bin/gs pu  quiesce  myPu --description="start friday maintenance"

<GS_HOME>/bin/gs.sh pu quiesce  myPu --description="start friday maintenance"

Parameters and Options:

Path

POST /pus/{id}/quiesce

Description:

This option disables a running Processing Unit for maintenance.

Example Request:

curl -X POST --header 'Content-Type: application/json' --header 'Accept: text/plain' 'http://localhost:8090/v2/pus/myPu/quiesce'

Options:

1. In the Processing Units view, highlight the Processing Unit you want to quiesce.

2. Click the Actions icon, and select Quiesce from the menu.

3. (Optional) If you want helpful information to appear in the log, type some descriptive text in the Description box (for example: "offline for maintenance").

4. Click OK.

The Quiesce Progress window displays the result of the Quiesce process (for example, "Quiesce completed successfully"), and a token that the administrator can use to perform actions on the Processing Unit while it is in quiesced state. It is recommended to copy this token from the window before clicking OK.

Refer to the Admin API topics in the Developer Guide.

Command:

gs.{sh/bat} pu unquiesce <pu name>

Description:

This command enables a quiesced Processing Unit.

Input Example:

<GS_HOME>/bin/gs pu  unquiesce  myPu 

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

Parameters and Options:

Path

POST /pus/{id}/unquiesce

Description:

This option unquiesces a Processing Unit.

Example Request:

curl -X POST --header 'Content-Type: application/json' --header 'Accept: text/plain' 'http://localhost:8090/v2/pus/myPu/unquiesce'

Options:

1. In the Processing Units view, highlight the Processing Unit you want to unquiesce.

2. Click the Actions icon, and select Unquiesce from the menu.

3. Click Yes in the confirmation message.

When the Processing Unit is available again, the status in the Processing Unit view changes to Intact.

Refer to the Admin API topics in the Developer Guide.

Command:

gs.{sh/bat} space demote-instance <instance ID>

Description:

This command demotes a Space instance from a primary to a backup, with no downtime required.

Input Example:

<GS_HOME>/bin/gs space demote-instance mySpace~1_1 --max-suspend-time=15s

<GS_HOME>/bin/gs.sh space demote-instance mySpace~1_1 --max-suspend-time=15s

Parameters and Options:

Path

POST /spaces/{id}/instances/{instanceId}/demote

Description:

This command demotes a Space instance from a primary to a backup, with no downtime required.

Example Request:

curl -X POST --header 'Content-Type: application/json' --header 'Accept: text/plain' 'http://localhost:8090/v2/spaces/mySpace/instances/mySpace~1_1/demote?maxSuspendTime=15s'

Options:

1. In any view, highlight the Space instance you want to demote.

2. Click the Actions icon, and select Demote from the menu.

3. (Optional) If you want helpful information to appear in the log, type some descriptive text in the Description box (for example: "rebalance after failover").

4. Click OK.

The Demote Progress window displays the result of the process (for example, "Demote completed successfully").

You can view the status of the Space instances in the Space Browser tab. However, you must use one of the other administration tools to hot swap the instances.

You can use the Administration API to demote a primary Space instance to a backup.

You can call demote for a Space instance, with a parameter of maximum suspend time for that Space instance during the demote process, as follows:

Admin admin = ... // Get or init an Admin instance
Space mySpace = admin.getSpaces().waitFor("mySpace");
SpaceInstance primarySpaceInstance = mySpace.getPartition(0).getPrimary();
// call demote with maximum suspend time of 15 seconds
Future<?> future = primarySpaceInstance.demote(15, TimeUnit.SECONDS);
future.get(); // or future.get(timeout, unit);

In addition, the Administration API allows registering for SuspendTypeChangedEvent:

SpaceSuspendTypeChangedEventListener myListener = new SpaceSuspendTypeChangedEventListener() {
    @Override
    public void spaceSuspendTypeChanged(SpaceSuspendTypeChangedEvent event) {
        System.out.println("Got event for space instance [" + event.getSpaceInstance().getId() + "], " +
                "previous value is " + event.getPreviousSuspendType() + ", " +
                "new value is " + event.getNewSuspendType());
    }
};

mySpace.getSpaceSuspendTypeChanged().add(myListener);
...
mySpace.getSpaceSuspendTypeChanged().remove(myListener);

The SuspendType options are:

• NONE - The Space is not suspended.

• QUIESCED - The Space is quiesced.

• DEMOTING - The Space is being demoted to backup.

• DISCONNECTED - The Space is disconnected from Apache ZooKeeper.

1. In the Processing Units view, highlight the Processing Unit instance you want to restart.

2. Click the Actions icon, and select Restart from the menu.

3. Click Yes in the confirmation message.

The Processing Unit instance is not visible in the Processing Unit view until it has finished restarting. This can take several seconds.

Refer to the Admin API topics in the Developer Guide.

Command:

gs.{sh/bat} pu relocate <instance ID> [<container ID>]

Description:

This command moves a Processing Unit instance to another container. If container ID is not specified, the Processing Unit instance will be moved to any available container.

Input Example:

<GS_HOME>/bin/gs pu relocate  myPu~1 container~1

<GS_HOME>/bin/gs.sh pu relocate  myPu~1 container~1

Parameters and Options:

Path

POST /pus/{id}/instances/{instanceId}/relocate

Description:

This option moves a Processing Unit instance to another container.

Example Request:

curl -X POST --header 'Content-Type: application/json' --header 'Accept: text/plain' 'http://localhost:8090/v2/pus/alertSpace/instances/instance1/relocate?containerId=container2' 

Options:

1. In the Processing Units view, highlight the Processing Unit instance you want to relocate.

2. Click the Actions icon, and select Relocate from the menu.

3. Highlight the host where you want to move the instance, and click Select.

4. Click Yes in the confirmation message.

The Processing Unit state is Scheduled in the Processing Unit view until the instance is relocated and initiated. This can take several seconds.

Refer to the Admin API topics in the Developer Guide.

Command:

xap pu increment <name>

Description:

This command adds one instance to the specified Processing Unit (which must be stateless).

Input Example:

<GS_HOME>/bin/gs pu increment  myPu

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

Parameters and Options:

Path

POST /pus/{id}/instances

Description:

This option adds one instance to the specified Processing Unit (which must be stateless).

Example Request:

curl -X POST --header 'Content-Type: application/json' --header 'Accept: text/plain' 'http://localhost:8090/v2/pus/myPu/instances' 

Options:

Refer to the Admin API topics in the Developer Guide.

Command:

gs.{sh/bat} pu decrement <instance ID>

Description:

This command removes one instance from the specified Processing Unit (which must be stateless).

Input Example:

<GS_HOME>/bin/gs pu decrement myPu~3

<GS_HOME>/bin/gs.sh pu decrement myPu~3

Parameters and Options:

Path

DELETE /pus/{id}/instances/{instanceId}

Description:

This option removes one Processing Unit instance from the specified Processing Unit (must be stateless).

Example Request:

curl -X DELETE --header 'Accept: text/plain' 'http://localhost:8090/v2/pus/myPu/instances/myPu~1'

Options:

Refer to the Admin API topics in the Developer Guide.