Registers a JNDI resource.
Synopsis
asadmin [asadmin-options] create-jndi-resource [--help]
[--target target]
--restype restype --factoryclass factoryclass
--jndilookupname jndilookupname [--enabled={true|false}]
[--description description]
[--property (name=value)[:name=value]*]
jndi-nameDescription
The create-jndi-resource subcommand registers a JNDI resource.
This subcommand is supported in remote mode only.
Options
- asadmin-options
-
Options for the
asadminutility. For information about these options, see theasadminhelp page. --help-?-
Displays the help text for the subcommand.
--target-
This option specifies the target for which you are registering a JNDI resource. Valid values for target are described below.
The resource is always created for the domain as a whole, but the resource-ref for the resource is only created for the specified --target. This means that although the resource is defined at the domain level, it is only available at the specified target level. Use the create-resource-ref subcommand to refer to the resource in multiple targets if needed.
|
server-
Creates the resource for the default server instance. This value is the default.
domain-
Creates the resource for the domain
- cluster-name
-
Creates the resource for every server instance in the cluster
- instance-name
-
Creates the resource for a particular server instance
--restype-
The JNDI resource type. Valid values are
topicorqueue. --factoryclass-
The class that creates the JNDI resource.
--jndilookupname-
The lookup name that the external container uses.
--enabled-
Determines whether the resource is enabled at runtime. Default is true.
--description-
The text that provides details about the JNDI resource.
--property-
Optional properties for configuring the resource. Each property is specified as a name-value pair. The available properties are specific to the implementation that is specified by the
--factoryclassoption and are used by that implementation. Payara Server itself does not define any properties for configuring a JNDI resource.
Examples
Example 1 Creating a JNDI Resource
This example creates the JNDI resource my-jndi-resource for the default server instance.
asadmin> create-jndi-resource
--restype com.example.jndi.MyResourceType
--factoryclass com.example.jndi.MyInitialContextFactoryClass
--jndilookupname remote-jndi-name
--description "sample JNDI resource" my-jndi-resource
JNDI resource my-jndi-resource created.
Command create-jndi-resource executed successfully.