Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Administration Guide

ProcedureTo deploy a connector module

A connector, also known as a resource adapter, is packaged in a type of archive file called a RAR file.

  1. In the tree component, expand the Applications node.

  2. Select the Connector Modules node.

  3. On the Connector Modules page, click Deploy.

  4. On the Deployment page, specify the location of the RAR file to deploy.

    The server machine is the host that is running the application server domain administration server. The client machine is the host on which you are viewing the Admin Console through a browser.

    • If the file resides on or is accessible from the client machine, click the radio button to specify a package file to upload to the Application Server.

      Click Browse to browse to the file, or type the full path to the file.

    • If the file resides on the server machine, or to deploy an unpackaged module from an exploded directory, click the radio button to specify a package file or a directory path that must be accessible from the server.

      Type the full path name to the file or directory. Deploying from an exploded directory is for advanced developers and is not recommended for production environments.

  5. Click Next to display the Deploy Connector Module page.

  6. On the Deploy Connector Module page, specify the settings for the module.

    1. In the Application Name field, either retain the default name, which is the prefix of the file name, or type another name.

      The default name appears if you chose to upload a file. The application name must be unique.

    2. In the Thread Pool Id field, specify the thread pool for the resource adapter you are deploying.

      By default, the Application Server services work requests from all resource adapters from its default thread pool. Use this field to associate a specific user-created thread pool to service work requests from a resource adapter.

    3. To disable the module so that is unavailable after deployment, select the Disabled radio button.

      By default, a module is available as soon as it is deployed.

      When you enable or disable a connector module, you also enable or disable the connector resources and connection pools that point to the module.

    4. If the module has already been deployed, select the Redeploy checkbox to redeploy it; otherwise you see an error.

      You can also choose a different application name and deploy it under a new name.

    5. To verify the structure and contents of the file before deployment, select the Verifier checkbox.

      Verification of large applications is often time-consuming. Verify the file if you suspect it is corrupt or non-portable.

    6. If the resource adapter has additional properties specified, they are displayed.

      Use the table to modify the default values of these properties.

    7. Choose the targets to which to deploy the module.

      From the list of available targets, choose the target or targets and click Add. Targets can be clusters or stand-alone server instances. If you do not select a target, the module is deployed to the default server instance server.

      If you are redeploying, don’t select targets. Anything you select here is ignored. Any target clustered or stand-alone server instance that references the deployed module automatically references the new, redeployed module if dynamic reconfiguration is enabled for the cluster or stand-alone instance. For more information about how to redeploy modules without interruption of service, see “About Rolling Upgrades.”

  7. Click OK to deploy the module.

Equivalent asadmin command