delete-jacc-provider

enables administrators to delete JACC providers defined for a domain

Synopsis

delete-jacc-provider [--help]
[--target target] jacc-provider-name

Description

The delete-jacc-provider subcommand enables administrators to delete JACC providers defined for a domain. JACC providers are defined as jacc-provider elements in the security-service element in the domain's domain.xml file. JACC providers can be created using the GlassFish Server Admin Console or the create-jacc-provider subcommand.

The default GlassFish Server installation includes two JACC providers, named default and simple. These default providers should not be deleted.

The JACC provider used byGlassFish Server for authorization is identified by the jacc-provider element of security-service in domain.xml. Therefore, if you delete the jacc-provider provider, make sure you change jacc-provider to the name of some other JACC provider that exists under security-service.

If you change the jacc-provider element to point to a different JACC provider, you must restart GlassFish Server.

This subcommand is supported in remote mode only.

Options

If an option has a short option name, then the short option precedes the long option name. Short options have one dash whereas long options have two dashes.

--help

-?

Displays the help text for the subcommand.

--target

Specifies the target from which you are deleting the JACC provider. The following values are valid:

server: Deletes the JACC provider on the default server instance. This is the default value.
configuration_name: Deletes the JACC provider in the specified configuration.
cluster_name: Deletes the JACC provider on all server instances in the specified cluster.
instance_name: Deletes the JACC provider on a specified server instance.

Operands

jacc-provider-name: The name of the JACC provider to be deleted.

Examples

Example 1 Deleting a JACC provider

The following example shows how to delete a JACC provider named testJACC from the default domain.

asadmin> delete-jacc-provider testJACC

Command delete-jacc-provider executed successfully.

Exit Status

0: subcommand executed successfully
1: error in executing the subcommand