You need to set up resources in IBM UrbanCode Deploy before you can deploy the
UrbanCode Deploy application processes.
About this task
Set up
an agent for each virtual machine (VM) server that you want to use. The agents that you set up on
your VM servers (your host) provide the communication that is needed between these host VM servers
and UrbanCode Deploy.
Note: The Dockerize-DB and Dockerize-Runtime components must always be mapped to the same agent.
The component processes for DB2® and the runtime image creation require that both of these
components are deployed on the same VM host server or mapped to the same agent in UrbanCode Deploy. If the Dockerize-DB and
Dockerize-Runtime components are not mapped to the same agent, these component processes fail. All
other components can be mapped to the same agent or different agents, depending on how powerful
these hosts are.
To configure resources in UrbanCode Deploy, perform the following steps:
Procedure
-
Click the top-level Resources tab.
-
Install UrbanCode Deploy agents on
the machines that you plan to use for deploying the various components:
-
Click the Agents tab (Resources > Agents).
-
Click the Install New Agent button. The Install New Agent pop-up window
displays.
-
Select the SSH radio button. The Authentication Required window
displays.
-
Enter your user name and password. The Install New Agent window displays.
-
Enter the following information to install the agent file on the VM machine:
- In the Target Hosts field, enter the IP address of the host
(device).
- In the Username field, enter your user name.
- In the Password field, enter your password.
- In the Agent Name field, enter a name for the agent.
- In the Agent Installation Properties field, select
Agent from the drop-down list and then click Edit. In
the Edit Agent Installation Properties window, verify that the agent installation path and the Java
home path are correct. Click Save.
- Click Save.
-
Create a top-level group. A top-level group is used for grouping resources. To create a
top-level group:
-
Click the Resource Tree tab (Resources > Resource Tree).
-
Click Create Top-Level Group. The Create Resource window displays.
-
In the Name field, enter a name for the top-level group.
-
In the Description field, enter a description for the top-level
group.
-
Click Save.
-
Assign the agents that you created in step 2 to each top-level group, as follows:
-
Click the Resource Tree tab (Resources > Resource Tree).
-
From the Show drop-down list, select Agents. An
Agents pane displays to the right of the screen and shows a list of the agents that you
created.
-
Add the applicable agent or agents to each top-level group by clicking the icon to the left of
an agent in the right pane and dragging and dropping it into a resource in the left pane.
-
Assign the components to each agent, as follows:
-
Click the Resource Tree tab (Resources > Resource Tree).
-
From the Show drop-down list, select Components.
A Components pane displays to the right of the screen and shows a list of the components.
-
Add the applicable components to each agent by clicking the icon to the left of a component in
the right pane and dragging and dropping it into an agent in the left pane.
Notes:
- The Dockerize-Bootstrap component must be added to every agent.
- Typically, the following components need to be added to an agent: Dockerize-Bootstrap,
Dockerize-DB, OMS-AGENT, Dockerize-Elasticsearch, OMS-INTG, Dockerize-MQ, Dockerize-Runtime, and
Dockerize-WAS
- If you are installing the Promising Server with Sterling Order Management, you need to also add the
Dockerize-Promising-DB and Dockerize-Promising-Runtime components to the agent.
Results
For example, the following table shows a sample resource mapping for the dockerize
components:
| Component |
UrbanCode Deploy agent |
| Dockerize-Bootstrap
Dockerize-WAS
|
Machine 1 |
| Dockerize-Bootstrap Dockerize-MQ
|
Machine 2 |
| Dockerize-Bootstrap Dockerize-DB2
Dockerize-Runtime
|
Machine 3 |