This task installs a shared library.
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 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. |
No |
failOnError | Signal task failure to Ant. The default value is "true". | No |
name | Cannot be set along with the file attribute. Shared library name to install shared library from the domain to other targets specified using the target attribute. Target attribute value cannot be set to 'domain'. The valid values for the target attribute are 'server', <cluster-name>, and <instance- name>. | Yes to install shared library from domain |
file | Cannot be set along with name attribute. Path to an archive file that contains the shared library implementation. |
Yes to install shared library with new archive file |
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-install-shared-library host="localhost" port="7890" file="/mydir/myslib/slib.zip" target="server"/> <jbi-install-shared-library file="/mydir/myslib/slib.zip" /> <!-- install shared library from domain to other targets --> <jbi-install-shared-library name="my_shared_lib" target="instnace1" />
Copyright 2007, Sun Microsystems, Inc.