Visual Studio Team Services Extension for IBM WebSphere Application Server
This extension contains a deployment task which allows you to automate the installation and update of applications to IBM WebSphere Application Servers. This extension installs the following components:
A service endpoint for connecting to IBM WebSphere Application Server on Visual Studio Team Services and Team Foundation Server 2017.
A build task to install / update enterprise application on WebSphere Application Servers.
Prerequisites
In order to automate the installation and update of enterprise applications to WebSphere Application Servers, the build agent must have access to the 'wsadmin' commands. Please follow the IBM WebSphere document to setup the command environment.
To check if the environment is setup correctly:
You can run wsadmin.sh(Linux) / wsadmin.bat(Windows) command from the terminal or command line respectively. Make sure IBM WebSphere bin/ directory is in the PATH.
Execute wsadmin.sh -conntype SOAP -host <your_websphere_hostname> -port <your_websphere_SOAP_port> -username <your_username> -password <your_password> -c AdminControl.getNode\(\) on the build agent. It should return the node name of the IBM WebSphere Application Server.
You may need to create a profile in your build agent to make the command line work.
Quick Start
Once you have set up the WebSphere environemnt, perform the following steps to automate the deployment of enterprise applications to WebSphere Application Servers:
Go to your Visual Studio Team Services or TFS project, click on the Build tab, and create a new build definition (the "+" icon) that is hooked up to your project's appropriate source repository.
Click Add build step... and select the necessary tasks to generate your release assets (e.g. Maven, Gradle).
Click Add build step... and select IBM WebSphere Deployment task from the Deploy category.
Configure the IBM Websphere Deploment task with the desired authentication method, and the install / update options.
Click the Queue Build button or push a change to your configured repository in order to run the newly defined build.
Your Webpshere application changes will now be automatically installed / updated to the WebSphere Application Servers!
IBM WebSphere Application Deployment Task
Open your build definition and add the "IBM WebSphere Deployment" task. The task can be found in the 'Deploy' section.
Details of the install / update deployment task. Note that this task includes both install and update cases. If the target application does not exist, it will install it; Otherwise it will update the target application.
Follow the Setup Connection Options section below to setup connection to IBM WebSphere.
Enter the application name.
Enter the update content path. This should be the path points to the application file. Wildcards can be used, but the pattern must resolve to exactly one file.
By default "Install Application If Not Exist" is checked. If the application does not exist, it will be first installed.
Enter the target cell, node, and application server name if this application is expected to be installed for the first time.
Enter the optional context root information. If left blank, the default context root will be "/your_application_name".
Enter the optional Web Module, Virtual Host, and URI information. If left blank, the task will attempt to extract this information automatically from the application file.
By default "Start Application" is checked. It will start the application after the installation.
If you are certain that the target application already exists in the IBM WebSphere Application Server, you can uncheck the "Install Application If Not Exist". The task will then hide fields that are only relevant to installation:
Setup Connection Options
The tasks provide two options to connect to IBM WebSphere Application Server:
Connecting with an "IBM WebSphere" endpoint.
This option is supported on Visual Studio Team Services and Team Foundation Server 2017. On Team Foundation Server 2015, please use other options to connect.
Connection name: name used to identify this connection.
Hostname / IP Address: IP address or the hostname of the computer on which the IBM WebSphere is running. The hostname must be resolvable by the build agent. Do not prefix with protocol names.
Port: SOAP port of the target WebSphere.
Username and Password: Administrative user name and password of the target WebSphere. Make you can use this pair to login the WebSphere console.
Manually enter credentials.
The same fields from "IBM WebSphere" endpoint section are repeated within the task.
