Deploy an app in IBM WebSphere AS
- Connect XL Deploy to your IBM WebSphere Application Server (WAS) Network Deployment (ND) or Base installation
- Discover your WAS middleware containers
- Create an environment where you can deploy applications
- Import a sample application into XL Deploy
- Deploy the sample application to the environment that you created
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:
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.
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:
To add a WebSphere ND cell:
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.
- In the Name box, enter a name for the cell.
- In the WebSphere Installation Path box, enter the path to the deployment manager profile; for example,
- 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
Click Next. A plan appears with the steps that XL Deploy will execute to discover the middleware on the host.
- Click Execute. XL Deploy executes the plan. If it succeeds, the state of the steps will be DONE.
Click Next. XL Deploy shows the items that it discovered.
- 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.
- Click Save to save the items in the repository.
To add an unmanaged server for WebSphere Base:
- Right-click the host that you created and select Discover > was > UnmanagedServer.
- In the Name box, enter a name for the server.
- In the WebSphere Installation Path box, enter the path to the WebSphere profile; for example,
Click Next. A plan displays with the steps that XL Deploy will execute to discover the middleware on the host.
Click Execute. XL Deploy executes the plan. If it succeeds, the state of the steps will be DONE.
- 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.
- Click Save to save the items in the Repository.
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.
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.
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.
To verify the deployment, go to
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.
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:
- IBM WebSphere Application Server plugin
- Getting started with XL Deploy: Understanding packages
- Preparing your application for XL Deploy
You can always ask questions and connect with other users in our forums.