Configuring resources for the Dockerize application processes

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

  1. Click the top-level Resources tab.
  2. Install UrbanCode Deploy agents on the machines that you plan to use for deploying the various components:
    1. Click the Agents tab (Resources > Agents).
    2. Click the Install New Agent button. The Install New Agent pop-up window displays.
    3. Select the SSH radio button. The Authentication Required window displays.
    4. Enter your user name and password. The Install New Agent window displays.
    5. 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.
  3. Create a top-level group. A top-level group is used for grouping resources. To create a top-level group:
    1. Click the Resource Tree tab (Resources > Resource Tree).
    2. Click Create Top-Level Group. The Create Resource window displays.
    3. In the Name field, enter a name for the top-level group.
    4. In the Description field, enter a description for the top-level group.
    5. Click Save.
  4. Assign the agents that you created in step 2 to each top-level group, as follows:
    1. Click the Resource Tree tab (Resources > Resource Tree).
    2. 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.
    3. 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.
  5. Assign the components to each agent, as follows:
    1. Click the Resource Tree tab (Resources > Resource Tree).
    2. 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.
    3. 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