This task upgrades the specified component in the JBI runtime.
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" /> <!-- upgrade the existing service engine with name "my-engine" with new code in my-updated-engine.zip file. --> <jbi-upgrade-component name="my-service-engine" file="/mydir/my-updated-engine.zip" />
Copyright 2007, Sun Microsystems, Inc.