IBM UrbanCode Deploy for Application Deployment Automation (JBoss Application Server)

Here is the complete guide to Application Deployment Automation using IBM UrbanCode Deploy:

This tutorial will educate you about Application Deployment Automation without any manual intervention using IBM UrbanCode Deploy (JBoss Application Server).

All 12 steps involved in the process along with the tools are explained here in detail with clear screenshots for your easy and better understanding.

NOTE: This tutorial has many images so allow it to load properly. 

Application Deployment Automation Using IBM UrbanCode Deploy

IBM UrbanCode Deploy

What is IBM UrbanCode Deploy?

IBM UrbanCode Deploy is a tool for automating application deployment through various deployment environments like Dev, QA, Staging, and PROD.

It is a very important tool used for continuous delivery in agile development.

UrbanCode Deploy provides:

  • Automated deployments and rollbacks of applications
  • Orchestration of application changes across servers
  • Inventory Management
  • Clear visibility which defines what and where the artifact is deployed
  • Integration with various J2EE and .NET application servers and ITSM tools
  • Integrate with build and test tools to automatically deploy, test, and promote new builds

IBM Rational Team Concert and IBM Urban Code Deploy help automate the CI / CD steps:

CI-CD steps

Tools Used in this Tutorial

  • IBM UrbanCode Deploy v6.2.2. To install UCD 6.2.2 server, please check here
  • WildFly10.0 Application Server (Formerly known as JBoss Application Server)
  • JDK 8. This version of JDK is mandatory with Urbancode Deploy 6.2.2
  • Download and install the Urbancode Deploy plugin for JBoss from here

Step #1: JBoss Configuration

This tutorial uses WildFly 10.0 (Formerly known as JBoss Application Server) as an application server to deploy a WAR file using UrbanCode Deploy.

Start the JBoss application server by running the file standalone.bat. This file can be found in the JBoss installation directory \bin folder.

(Note: Click on any image for an enlarged view)

Bin Folder

JBoss Installation

Sample WAR file Deploy through JBoss

Start the CLI command by running the file Jboss-cli.bat and typing connect

JBoss Sample RAR

JBoss Sample RAR

Deployed Maven

Step #2: UrbanCode Deploy Login

a) Login to UrbanCode using this URL https://<ServerName>:8443

Login to UrbanCode

b) Install the UCD Agent.

Agents must run on all target machines and environments (QA, Staging, etc) where deployment is being carried out. Agents do their job of deploying artifacts to the target environment.

c) Go to the Help menu and select the Tools option.

Select Tools Option

d) Click the link to download the zip containing the Deploy agent

Download Deploy Agent

e) Extract the agent ZIP file and RUN the file install-agent.bat to install it.

Run Install Agent.bat

f) Sample installation of Agent. At the end of the installation do not select to Run the Agent as Windows service.

Sample Installation of Agent

g) Run the agent from the Installed directory. Select the file cmd

Select the file start_agent

h) Agent starts in a command window. Do not close this BLANK. Just minimize it

Blank Window

Step 3: Verify Agent Status

After you log in to the IBM UrbanCode Deploy server, verify if the agent is online. To check, go to Resources and select the Agents TAB as shown below. The agent should have a status of Online in GREEN, as shown in the following figure. Only agents with online status can perform the task of deployment.

Agent is Online

Step 4: Add Files

Add files that represent deployable artifacts to the file system on the computer where you installed the agent.

  1. Create a folder on the machine where the agent is installed.
  2. In this folder, create a subfolder named 1.0.
  3. In the this1.0sub folder, copy the project WAR file. In this example, it is called HelloWorld-Maven.war

Project WAR file called Hello Maven Folder

Step 5: Creating Components

Components are typically the “What” of deployment. It defines a deployable piece of application like WAR/JAR file, database SQL file, etc. In Urbancode Deploy, you can import deployable artifacts from any build system, SCM system, or file system.

In my previous tutorial, I showed you how to BUILD is done, using the Rational Team Concert SCM repository and how a J2EE WAR file is generated. In this tutorial, I will first show how we import the WAR file from a file system and then the second part will be about how a deployment can be automated to an environment directly from RTC Build

To start the first step in IBM UrbanCode Deploy includes creating/configuring components & component processes and adding the components to applications. Then, you use the processes to deploy the components to different environments.

The artifacts for this example component come from the file system where the IBM UrbanCode Deploy agent is installed.

How to create JBoss component:

  1. On the Components tab, click Create New Components.
  2. In the Name field, type JBoss_Component.
  3. Select File System (Versioned) in the Source Config Type drop-down box
  4. In the Base Path field, specify the d:\tempfolder created in step 4. In this folder, there is a subdirectory called 1.0 which is actually a version for the artifact. So we need to be sure to use the temp directory and not the d:\temp\1.0directory.
  5. Select the second radio button to import the component version using the agent installed
  6. Accept the default values for the other fields on the page.
  7. Click Save.

Create ComponentCreate a Component

Step 7: Import the component version

  1. Click on the Versions tab.
  2. Click Import New Versions. The server imports  1.0 as a new version. If other folders were in the Temp directory, they too would be imported and versions would be created for them as well.
  3. Version 1.0 is now listed and the WAR file is within

Import New component Version

Import Version 1.0

Click on 1.0 version

Click on version 1.0

Step 8: Create Component Process

Component process describes various steps on how to automate the deployment without any manual intervention.

In this step, we will create a deployment process for the JBOSS_Component. Later, we will create an application process that uses the component process to deploy the component. These two steps are required to deploy the WAR file effectively.

How to create the component process:

#1) On the “Component: JBOSS_Component” page, click the Processes tab and then click Create New Process.

#2) In the Create a New Process window, type _JBoss_Component_Process in the Name field.

Create New Process

#3) Click on the HelloWorld_JBoss_Component_Process. The process editor is open. The process editor lists plug-ins and steps to deploy the application. Step 2 – Start and Finish represent the beginning and end of the process and are automatically placed on the editor. You need to add steps for deploying the application to the process by dragging them onto the editor between the Start and Finish steps.

Click Hello Maven Start and Finish Steps

a) Firstly expand Repositories => Artifact => IBM UrbanCode Deploy on the plugin palette on the left and drag the Download Artifacts step to the process editor.

This step downloads the specified version, which will be mentioned during the deployment later on, about the component artifacts to the agent’s recent working directory, which is typically the <drive:>\<AgentDir>\var\work\<Name of Comp>.

So in most cases, this is usually the first step as the application (WAR file) is downloaded from the UCD server to the target machine or the environment for deployment

Click on the MIDDLE icon to edit the step

Click on Middle Icon

Click OK and do not add or modify any fields in this step.

Click OK

b) We will now take the following steps to automate the deployment.

(i) Stop or Disable the application

(ii) Undeploy the current version deployed in JBoss AS

(iii) Deploy a new version of the application

c) Expand the Application Server => Java =>JBoss and drag the remaining steps to the process editor. Enter the values as shown below

Expand Application

Expand Application Server

Values for each step

Disable Application

Undeploy Application

Deploy Application

Step 9: Create an Application

Applications manage components and contain environments.

How to create an application:

1) Click on the Applications tab and then click Create New Application.
2) Name the new application. For instance, HelloWorld-Maven_JBoss_Application
3) Accept the default values for the other fields and then click Save

Create Application

4) Add the JBOSS_Component to the application.
5) Click on the Components tab and then click Add Component.
6) In the Add, a Component window, select the JBOSS_Component and then click Save. An application can only be deployed if components are added to it.

Add Component

Add JBoss Component

JBoss Application Added

Step 10: Create Application Process

An application process, like a component process, consists of steps that are configured within the process editor. In this step, you create an application process that installs the JBOSS_Component component by calling the component process that we created earlier.

How to create an application process:

1) Click on the Applications tab and then click the HelloWorldMaven_JBoss_Application.
2) Click Processes and then click Create New Process.
3) In the Create an Application Process window, name the new application process something like HotelWeb_JBoss_Application_Process.
4) Accept the default values for the other fields and click Save.
5) To open the new process in the process editor, click on the new process.

Create an Application Process

Hello Maven Application Process created

6) Click on HelloWorld-Maven_JBoss_Application_Process to open the Process editor.
7) Add a step that deploys the JBoss_Component. From the list of steps on the left, add an Install Component step to the editor.
8) In the Component list, select the JBoss_Component. All components that are associated with an application are available.
9) In the Component Process list, select the HelloWorld-Maven_JBoss_Component_Process
10) Accept the default values for the other fields and then click Save.
11) Connect the Start step to the Install JBoss_Component step.
12) Connect the Install_JBoss_Component step to the Finish step.
13) Save the process by clicking the Save icon

Edit Properties

Install JBoss Component

Save the process

Step 11: Deploy the component

Before we start the deploying process, we need to create a Resource that defines what should be deployed and where it should be deployed. We need to link the agent and then the component to the resource.

a) Click on the Resources tab at the TOP

b) Click on the Create Top-Level Group button, give a new resource a name such as JBoss and click Save.

c) Click Actions > Add Agent to the resource which was just created, as shown in the following figure:

Create Resource

Create Top Resource Group

Link the Agent to the Resource

Add Agent

Create Resources

Link the Component to the Agent

Add component

Click on Save.

Agent is Online

d) Before you can run any deployment, you must define at least one environment that associates components with an agent on the target host. Let’s create a SIT_Env.

e) Open the Create New Environment window by clicking Applications > HelloWorld-Maven_JBoss_Application> Environments > Create New Environment and then enter the following information and later click Save.

Create Environment

Environment Loading Compliancy

f) Click on the Environment you just created and select Add Base Resources. Select the JBoss folder and Click OK

Add Base Resource

Add Resources to Environment

Agent is Online

g) To deploy the component, run the application process on the SIT_Env environment.

  • Open the application page by clicking Applications and then clicking on the application name.
  • In this environment, click the Request Process icon

Request Process Icon

  • In the Run Process window, un-check the default value for the Only Changed Versions parameter.
  • In the Process list, select the HelloWorld-Maven_JBoss_Application_Process

Run Process

  • Click Choose Versions. The Component Version window opens.
  • In the Component Versions window, click Add and select the 1.0 version. Click OK to return to the Run Process window.

Component Version

  • Click Submit. The progress is shown. From there, you can watch the process run on the application server. The following figure shows the running process.

Process Runs

Step 12: Rational Team Concert6.0.2 Post-Deploy Build Settings

In my previous tutorial, we learned about the BUILD process which generated the application WAR file. The Build definition created can now be extended to address the above UCD Application process.

So the benefit here is that, once the BUILD is done, the application is auto-deployed to a particular environment, thereby not waiting for a resource to be made available to manually deploy the application.

First we need to open the Build Definition which we created in the previous tutorial and enable the Post-Build Deploy option.

RTC Deploy Build Settings

Edit Configuration

Post Build Deploy

Click OK after selecting the Post-build Deploy option. Also, remember to SAVE the Build Definition

Enable Post Build Deploy

Post Build Deploy Build Settings

Base Directory is the folder where the WAR file resides after the Build is completed.

End Process

Now when you request a build and after it is completed the deployment will automatically begin and no manual intervention is needed.


In this tutorial, we learned how an application deployment can be automated without manual intervention using IBM Urbancode Deploy which is a very useful tool for DevOps.

Today it is very crucial from an automation point of view too. We also came to know how the IBM Rational Team Concert BUILD process can be extended to automate the deployment once the build is completed.

This tutorial focused on JBoss as the application server. You can also use other J2EE application servers like Websphere Application Server, Weblogic, Tomcat, etc. as well for deployment automation.

Let us know your thoughts/suggestions in the comments section below.

Recommended Reading

5 thoughts on “IBM UrbanCode Deploy for Application Deployment Automation (JBoss Application Server)”

  1. Nice Tutorial. Keep up the good work.

  2. What code languages are applicable for UrbanCode Deploy?

    • Urbancode Deploy does not need coding. it uses plug-ins (250+ different technologies supported) which provide plug-in “steps” for tasks you want to achieve (see the install JBOSS step).
      A plug-in can be also developed using the SDK, which is in Groovy.

  3. HI, Good one!!!. Is it possible to kick off a Selenium test after the deployment like smoke test to verify the build? Can you please give some insight on that?

  4. UCD 6.2.2 is really old. Could you update the content?


Leave a Comment