This task modifies the configuration parameters on either the JBI runtime or a specified JBI component.
The configuration parameters are name/value pairs specified either as nested elements or as a path to a configuration file. If you specify configuration parameters with both nested elements and a configuration file, then the values specified in the configuration file are used.
Option | Description | Required |
jbi.host | The machine name where the Domain Administration Server (DAS) is running. The default value is "localhost". | No |
jbi.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. The default value is "false". | No |
jbi.username | The authorized DAS administrator user name. The default value is "admin". | No |
jbi.password | Password for the user authentication. The default value is "adminadmin". | No |
jbi.task.fail.on.error | Signal task failure to Ant. Defaults to "true". | No |
jbi.component.name | sets the configuration paramters for this component. Without this parameter, the configuration parameters are set for JBI runtime. | No. |
jbi.config.params.file | Fully qualified file path to the configuration parameters file that contains the list of name/value pairs for configuration parameters. | Yes |
jbi.target | Specifies where the JBI administration tasks are performed. The default value is 'server'. | No |
jbi.target 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 <cluster-name> is specified, the task is executed against all instances in the specified cluster. |
<instance-name> | When <instance-name> is specified, the task is executed against the specific instance specified. |
# sets the JBI runtime configuration parameters asant -f jbi-install-root/bin/jbi_admin.xml -Djbi.config.params.file="/dir/config-params.properties" -Djbi.target="my-cluster" set-configuration # sets the JBI Component configuration parameters for component "my-engine" on a target "my-cluster-instance1" asant -f jbi-install-root/bin/jbi_admin.xml -Djbi.component.name="my-engine" -Djbi.config.params.file="/dir/comp-config-params.properties" -Djbi.target="my-cluster-instance1" set-configuration
Copyright 2007, Sun Microsystems, Inc.