This task starts the service engine or binding component.
| 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 | Password for user authentication. | Yes. Not required if passwordfile is set. |
| passwordfile | This aplication server-specific attribute processes the password from a properties file with the property "AS_ADMIN_PASSWORD". If you set the password and passwordfile attribute, passwordfile takes precedence. | No |
| failOnError | Signal task failure to Ant. The default value is "true". | No |
| name | Name of the service engine or binding component. | Yes |
| target | Specifies where the JBI administration tasks are performed. The default value is 'server'. | No |
| 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. |
<!-- Load JBI task definitions. Note: If you use the asant command, you do not need to load the JBI task defininitions as they are already defined in the default task definitions in the asant environment. --> <taskdef resource="com/sun/jbi/ui/ant/antlib.xml" /> <jbi-start-component host="localhost" port="7890" name="my.engine.name" target="domain" /> <!-- starts "my.binding.name" components --> <jbi-start-component name="my.binding.name" />
Copyright 2007, Sun Microsystems, Inc.