Task: jbi-list-configuration

Description

This task prints the information about JBI runtime configuration and JBI component configuration.

Example Output - Runtime Configuration

============================================================
Runtime Configuration for Target "server"
============================================================
autoDeployEnabled=false
autoInstallEnabled=true
com.sun.jbi=INFO
com.sun.jbi.framework=INFO
defaultLogLevel=INFO
heartBeatInterval=5500
startOnDeploy=true
....
------------------------------------------------------------

Example Output - Component Configuration

============================================================
Component Configuration for "sun-http-binding" on Target "cluster1"
============================================================
Instance name: cluster1-instance1
  HttpDefaultPort=9381
  OutboundThreads=10
  ProxyPassword=****
  ProxyUserName=admin
  ....
------------------------------------------------------------
Instance name: cluster1-instance2
  HttpDefaultPort=8081
  OutboundThreads=22
  ProxyPassword=****
  ProxyUserName=admin
  ....
------------------------------------------------------------

Parameters

Attribute Description Required
host The machine name where the Domain Administration Server (DAS) is running. The default value is localhost. No
port The HTTP/S port for DAS administration. The default value is 4848. No
secure If set to true, uses SSL/TLS to communicate with the DAS. No
username The authorized DAS administrator user name. Yes
password Specifies a password for user authentication.

If you set a password with both the password attribute and the passwordfile attribute, the password specified in the passwordfile attribute is used for authentication.

If you do not set a password with both the password attribute and the passwordfile attribute, then no password is required.
Yes. Not required if passwordfile is set.
passwordfile Specifies a path to a password property file that is used for user authentication.

The password for user authentication is specified by the "AS_ADMIN_PASSWORD" property in the property file.

If you set a password with both the password attribute and the passwordfile attribute, the password specified in the passwordfile attribute is used for authentication.
No
failOnError Signal task failure to Ant. The default value is "true". No
componentName Lists the configuration information for this component.
Without this parameter, the JBI runtime configuration will be listed.
No
target Specifies where the JBI administration tasks are performed. The default value is 'server'. No

Nested Elements

param

This nested element is an optional child element. This element takes a name for listing the runtime/component configuration parameters. If none of param elements are specified, this task lists all of the runtime/component configuration parameters.

Attribute Description Required
name Name of the configuration parameter. Yes

Target Attribute Values

Target Attribute Value Behavior
'server' When the target option is not specified, or the literal string 'server' is specified, the task is executed against the embedded DAS server instance.
'domain' When the target option is the literal string 'domain', the task is executed against the domain itself, but not to any instances or clusters running on the domain.
<cluster-name> When a <cluster-name> is specified, the task is executed against all instances in the specified cluster.
<instance-name> When a <instance-name> is specified, the task is executed against the specific instance specified.

Examples

<!--
Load JBI task definitions.
Note:  This task is not included in the default task definitions in the asant environment.
you need to load the JBI task definitions in the Ant script in the asant environment.
-->
<taskdef resource="com/sun/jbi/ui/ant/antlib.xml" />
<!-- list the JBI runtime configuration for the target "MyInstance" -->
<jbi-list-configuration host="localhost" port="7890" target="MyInstance" /> 
<!-- list a service engine configuration with name="my_engine_name" -->
<jbi-list-configuration componentName="my_engine_name" />
<!-- list a particular configuration for service engine configuration with name="my_engine_name" -->
<jbi-list-configuration componentName="my_engine_name" >
    <param name=ABCD />
</jbi-list-configuration >

Copyright 2007, Sun Microsystems, Inc.