Target: set-configuration

Description

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 Values

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.

Example

# 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.