|GemFire XD Reference / gfxd Launcher Commands|
Removes a JAR file installation, unloaded all classes associated with the JAR.
To remove a JAR file installation and unload the JAR file classes, use the syntax:
gfxd remove-jar -name=<identifier> [-auth-provider=<name>] [-bind-address=<address>] [-client-bind-address=<address>] [-client-port=<port>] [-extra-conn-props=<properties>] [-help] [-locators=<adresses>] [-mcast-address=<address>] [-mcast-port=<port>] [-password[=<password>]] [-user=<username>]
This table describes options for the gfxd remove-jar command. Default values are used if you do not specify an option.
|-name|| The unique identifier of the existing JAR
installation to remove. The identifier that you provide must specify a schema
name delimiter. For example: APP.myjar.
This argument is required.
|-auth-provider||Sets the authentication provider to use for peer-to-peer connections as well as client-server connections. Valid values are BUILTIN and LDAP. All other members of the GemFire XD distributed system must use the same authentication provider and user definitions. If you omit this option, the connection uses no authentication mechanism. See Configuring Authentication and Authorization.|
|-bind-address||The address to which this peer binds for receiving peer-to-peer messages. By default gfxd uses the hostname, or localhost if the hostname points to a local loopback address.|
The hostname or IP address on which a GemFire XD locator listens for client connections. The default is "localhost."
Use this option with -client-port to attach to a GemFire XD cluster as a thin client and perform the command.
The port on which a GemFire XD locator listens for client connections. The default is 1527.
Use this option with -client-bind-address to attach to a GemFire XD cluster as a thin client and perform the command.
A semicolon-separated list of properties to use when connecting to the GemFire XD distributed system.
Display the help message for this gfxd command.
The list of locators as comma-separated host[port] values, used to discover other members of the distributed system.
Using -locators creates a peer client member to execute the gfxd command.
The multicast address used to discover other members of the distributed system. This value is used only when the -locators option is not specified. The default multicast address is 22.214.171.124.
Use this option with -mcast-port to attach to a GemFire XD cluster as a peer client and perform the command.
The multicast port used to communicate with other members of the distributed system. If zero, multicast is not used for member discovery (specify -locators instead). This value is used only if the -locators option is not specified.
Valid values are in the range 0–65535, with a default value of 10334.
Use this option with -mcast-address to attach to a GemFire XD cluster as a peer client and perform the command.
If the servers or locators have been configured to use authentication, this option specifies the password for the user (specified with the -user option) to use for booting the server and joining the distributed system.
The password value is optional. If you omit the password, gfxd prompts you to enter a password from the console.
|-user||If the servers or locators have been configured to use authentication, this option specifies the user name to use for booting the server and joining the distributed system.|
The -name that you provide for the JAR must be an existing JAR file identifier (created with gfxd install-jar). You must include a schema name to qualify the identifier.
GemFire XD removes the JAR file installation (and the unique identifier) and unloads the JAR file classes.
gfxd remove-jar -name=APP.toursjar
gfxd remove-jar -name=APP.toursjar -client-bind-address=myserver -client-port=1234
gfxd remove-jar -name=APP.toursjar -mcast-port=1234 -extra-conn-props=host-data=false