Installing IBM UrbanCode Deploy

An IBM™ UrbanCode™ Deploy installation consists of the IBM UrbanCode Deploy server, a database, and at least one agent. The installation can include the blueprint design server and its engine and database.

Typically, the server, database, agents, engine, and blueprint design server are installed on separate systems, although for a simple evaluation they can all be installed on the same system.
Installing IBM UrbanCode Deploy usually involves the following general steps:
  1. Review the system requirements. See System requirements and performance considerations.
  2. Install a Rational® Common Licensing server. See Rational Common Licensing overview.
  3. Add licenses to the server. For more information about the licenses that are available, see License management.
  4. If you are using a database other than Apache Derby, install the database before you install the server. See Installing the server database. Apache Derby is appropriate for evaluation installations only. If you choose Apache Derby, the server installation steps install Derby automatically, so you do not need to install it manually.
  5. Install the server. See Installing the server.
  6. Install agent relays. See Installing agent relays.
  7. Install one or more agents. See Installing agents.
  8. Start the server. See Starting and stopping the server.
  9. Optional: Install plug-ins. See Installing plug-ins.
  10. Optional: Install and configure the blueprint design server. To use the blueprint designer, you must complete the following steps:
    1. Acquire a Heat orchestration engine. To connect to OpenStack and OpenStack-based clouds, extend the existing Heat engine for the cloud; see Extending an existing OpenStack engine. To connect to non-OpenStack clouds, such as Amazon Web Services and MIcrosoft Azure, install an engine with IBM UrbanCode Deploy; see Installing the engine.
    2. Configure a database for the blueprint design server. See Blueprint design server database configuration.
    3. Install the blueprint design server. See Installing the blueprint design server.
    4. Connect the blueprint design server to the server. See Connecting the blueprint design server to the server.
    5. Integrate with the cloud. See Connecting to clouds through the blueprint designer.
    6. Set up access control. See Configuring security for the blueprint design server.
  1. Add licenses to the server. For more information about the licenses that are available, see License management.
  2. If you are using a database other than Apache Derby, install the database before you install the server. See Installing the server database. Apache Derby is appropriate for evaluation installations only. If you choose Apache Derby, the server installation steps install Derby automatically, so you do not need to install it manually.
  3. Install the server. See Installing the server.
  4. Install agent relays. See Installing agent relays.
  5. Install one or more agents. See Installing agents.
  6. Start the server. See Starting and stopping the server.
  7. Optional: Install plug-ins. See Installing plug-ins.
  8. Optional: Install and configure the blueprint design server. To use the blueprint designer, you must complete the following steps:
    1. Acquire a Heat orchestration engine. To connect to OpenStack and OpenStack-based clouds, extend the existing Heat engine for the cloud; see Extending an existing OpenStack engine. To connect to non-OpenStack clouds, such as Amazon Web Services and MIcrosoft Azure, install an engine with IBM UrbanCode Deploy; see Installing the engine.
    2. Configure a database for the blueprint design server. See Blueprint design server database configuration.
    3. Install the blueprint design server. See Installing the blueprint design server.
    4. Connect the blueprint design server to the server. See Connecting the blueprint design server to the server.
    5. Set up access control. See Configuring security for the blueprint design server.
The following diagram illustrates this process:
A diagram that shows the basic steps that are involved in installing IBM UrbanCode DeploySystem requirements and performance considerationsLicense managementInstalling the server databaseInstalling the serverInstalling agent relaysInstalling agentsStarting and stopping the serverInstalling plug-insInstalling the engineBlueprint design server database configurationInstalling the blueprint design serverConnecting the blueprint design server to the serverConnecting to clouds through the blueprint designerConfiguring security for the blueprint design server

For information about accessing the IBM UrbanCode Deploy web application, see Accessing IBM UrbanCode Deploy.