17.3. Deploy a Resource Adapter

Resource adapters can be deployed to JBoss Enterprise Application Platform 6 using the Management CLI tool, the Web-based Management Console, or by manually copying the files. The process is the same as other deployable artifacts.

Procedure 17.2. Deploy a resource adapter using the Management CLI

  1. Open a command prompt for your operating system.
  2. Connect to the Management CLI.
    • For Linux, enter the following at the command line:
      $ EAP_HOME/bin/jboss-cli.sh --connect
      $ Connected to standalone controller at localhost:9999
      
    • For Windows, enter the following at a command line:
      C:\>EAP_HOME\bin\jboss-cli.bat --connect
      C:\> Connected to standalone controller at localhost:9999
      
  3. Deploy the resource adapter.
    • To deploy the resource adapter to a standalone server, enter the following at a command line:
      $ deploy path/to/resource-adapter-name.rar
    • To deploy the resource adapter to all server groups in a managed domain, enter the following at a command line:
      $ deploy path/to/resource-adapter-name.rar --all-server-groups
      

Procedure 17.3. Deploy a resource adapter using the Web-based Management Console

  1. Start your JBoss Enterprise Application Platform 6 server.
  2. If you have not yet added a management user, add one now. For more information, refer to the Getting Started chapter of the Installation guide for JBoss Enterprise Application Platform 6.
  3. Open a web browser and navigate to the Management Console. The default location is http://localhost:9990/console/. For more information about the Management Console, see Section 3.2.2, “Log in to the Management Console”.
  4. Click on the Runtime link on the top right to switch to the Runtime view, then choose Manage Deployments in the left navigation panel, and click Add Content at the top right.
    Manage Deployments - Add Content

    Figure 17.5. Manage Deployments - Add Content

  5. Browse to the resource adapter archive and select it. Then click Next.
    Deployment Selection

    Figure 17.6. Deployment Selection

  6. Verify the deployment names, then click Save.
    Verify Deployment Names

    Figure 17.7. Verify Deployment Names

  7. The resource adapter archive should now appear in the list in a disabled state. Click the Enable link to enable it.
    Enable the Deployment

    Figure 17.8. Enable the Deployment

  8. A dialog asks "Are you sure?" you want to enable the listed RAR. Click Confirm. The resource adapter archive should now appear as Enabled.
    Deployments

    Figure 17.9. Deployments

Procedure 17.4. Deploy a resource adapter manually

  • Copy the resource adapter archive to the server deployments directory,
    • For a standalone server, copy the resource adapter archive to the EAP_HOME/standalone/deployments/ directory.
    • For a managed domain, copy the resource adapter archive to the EAP_HOME/domain/deployments/ directory of the domain controller.