Deploy an app in IBM WebSphere AS

After you have installed XL Deploy and the IBM WebSphere plugin, log in to XL Deploy and follow these instructions to:

  1. Connect XL Deploy to your IBM WebSphere Application Server (WAS) Network Deployment (ND) or Base installation
  2. Discover your WAS middleware containers
  3. Create an environment where you can deploy applications
  4. Import a sample application into XL Deploy
  5. Deploy the sample application to the environment that you created

Connect to your infrastructure

First, you need to connect XL Deploy to the host on which wsadmin is running. Typically this is:

  • The host where the WebSphere Deployment Manager is running, if you use WebSphere ND
  • The WebSphere server, if you use WebSphere Base

Follow the instructions for the host’s operating system and the connection protocol that you want XL Deploy to use:

Accept WebSphere trusted certificate

If wsadmin has not been used on your WebSphere Deployment Manager or unmanaged server before, you must set up a trusted certificate to allow XL Deploy to deploy to WebSphere. Refer to Troubleshoot a WAS connection for more information.

Add your middleware

Once XL Deploy can communicate with your host, it can scan for middleware containers and automatically add them to the repository for you. You can:

Add a WebSphere ND cell

To add a WebSphere ND cell:

  1. Right-click the host that you created and select Discover > was > DeploymentManager.

    Tip: If you do not see the was option in the menu, verify that the WebSphere plugin is installed.

  2. In the Name box, enter a name for the cell.

  3. In the WebSphere Installation Path box, enter the path to the deployment manager profile; for example, /opt/ws/6.1/appserver/profiles/AppSrv01.

  4. In the Administrative port, Administrative username, and Administrative password boxes, optionally enter the TCP port, user name, and password to use when connecting to WebSphere using wsadmin.

  5. Click Next. A plan appears with the steps that XL Deploy will execute to discover the middleware on the host.

    Sample discovery steps

  6. Click Execute. XL Deploy executes the plan. If it succeeds, the state of the steps will be DONE.

  7. Click Next. XL Deploy shows the items that it discovered.

    Sample discovered infrastructure items

  8. You can click each item to view its properties. If an item is missing a required property value, a red triangle displays next to it. Provide the missing value and click Apply to save your changes.

  9. Click Save to save the items in the repository.

Add an unmanaged server for WebSphere Base

To add an unmanaged server for WebSphere Base:

  1. Right-click the host that you created and select Discover > was > UnmanagedServer.

  2. In the Name box, enter a name for the server.

  3. In the WebSphere Installation Path box, enter the path to the WebSphere profile; for example, /opt/IBM/WebSphere/AppServer/profiles/AppSrv01

  4. Click Next. A plan displays with the steps that XL Deploy will execute to discover the middleware on the host.

    Sample discovery steps

  5. Click Execute. XL Deploy executes the plan. If it succeeds, the state of the steps will be DONE.

    Sample discovered infrastructure items

  6. Click each item to view its properties. If an item is missing a required property value, a red triangle displays next to it. Provide the missing value and click Apply to save your changes.

  7. Click Save to save the items in the Repository.

Create an environment

An environment is a grouping of infrastructure and middleware items such as hosts, servers, clusters, and so on. An environment is used as the target of a deployment, allowing you to map deployables to members of the environment.

Follow these instructions to create an environment where you can deploy a sample application.

To deploy to WebSphere ND, you must add a was.Cluster and a was.NodeAgent to the environment. To deploy to WebSphere Base, you must add a was.UnmanagedServer to the environment.

Import the sample application

You can now deploy the sample application to the environment that you created.

Follow these instructions to deploy the application.

Note: If the deployment appears to hang on a step, XL Deploy may have encountered an issue with the SSL certificate. See Accept WebSphere trusted certificate for more information. If this is the case, click Abort to abort the operation and stop the deployment.

If the deployment succeeds, the state of the deployment plan is EXECUTED.

Sample failed deployment

If the deployment fails, click the failed step to see information about the failure. In some cases, you can correct the error and try again.

Sample failed deployment

Verify the deployment

To verify the deployment, go to http://IP:PORT/petclinic, where IP and PORT are the IP address and port of the server where the application was deployed; for example, the node in a WebSphere ND environment or the server in a WebSphere Base environment.

Sample deployed PetClinic-ear application

What’s next

After you’ve connected XL Deploy to your middleware and deployed a sample application, you can start thinking about how to package and deploy your own applications with XL Deploy. To learn more, see:

Get help

You can always ask questions and connect with other users in our forums.