undeploy

This topic describes the undeploy command in gfsh, the VMware Tanzu GemFire command-line interface.

Use this command to undeploy the JAR files that were deployed on members or groups using deploy command.

If --jars is not specified, the command will undeploy all deployed JARs. If --groups is not specified, the command applies to the entire cluster. Note that this command cannot unload the classes that were loaded during deployment. You must restart the members to unload the classes that were loaded during deployment.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

undeploy [--jars=value(,value)*] [--groups=value(,value)*]

Name	Description	Default Value
‑‑groups	Groups from which the specified JARs will be undeployed.	Undeploy will occur on all members
‑‑jars	JAR or JARs to be undeployed.	All JARs will be undeployed

Table 1. Undeploy Parameters

Example Commands:

undeploy --jars=domain-objects.jar
undeploy --groups=Group1

Sample Output:

gfsh>undeploy --jars=domain-objects.jar

  Member   |  Un-Deployed JAR   |         Un-Deployed From JAR Location        
---------- | ------------------ | ---------------------------------------------
datanode10 | domain-objects.jar | /usr/local/gemfire/deploy/GF#domain-objects#1
datanode11 | domain-objects.jar | /usr/local/gemfire/deploy/GF#domain-objects#1 


gfsh> undeploy --groups=Group1

 Member   |     Un-Deployed JAR     |             Un-Deployed From JAR Location        
--------- | ----------------------- | ------------------------------------------------------
datanode1 | group1_functions.jar    | /usr/local/gemfire/deploy/GF#group1_functions.jar#1
datanode1 | group1_dependencies.jar | /usr/local/gemfire/deploy/GF#group1_dependencies.jar#1 
datanode2 | group1_functions.jar    | /usr/local/gemfire/deploy/GF#group1_functions.jar#1
datanode2 | group1_dependencies.jar | /usr/local/gemfire/deploy/GF#group1_dependencies.jar#1

Error Messages:

No JAR Files Found