Note: This task has been deprecated. Use the jbi-upgrade-component task instead.
This task updates the specified component in the JBI runtime.
The contents of jbi.xml in the new archive must be identical (at the DOM level) to the existing jbi.xml. If the content of jbi.xml in the new archive differs from the existing jbi.xml, the update of the jbi component fails.
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 |
name | Specifies the component to update. The component with this name must exist in the JBI runtime. | Yes |
file | Path to an archive file (.zip or .jar file) that contains the updated component implementation. | Yes |
<!-- 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" /> <!-- update the existing service engine with name "my-engine" with new code in my-updated-engine.zip file. --> <jbi-update-component name="my-service-engine" file="/mydir/my-updated-engine.zip" />
Copyright 2007, Sun Microsystems, Inc.