Installing servers and agents

A IBM® UrbanCode Deploy installation consists of the IBM UrbanCode Deploy server (with a supporting database), and at least one agent.

About this task

Typically, the server, database, and agents are installed on separate systems, although for a simple evaluation they can all be installed on the same system. In addition, Java™ must be installed on all agent and server systems.
Note: For evaluation purposes, the supplied Derby database is adequate and can be installed on the system where the server is located. If you are installing IBM UrbanCode Deploy in a production environment, use one of the supported databases: Oracle database (all versions), SQL Server, or MySQL.

Procedure

  1. Review the system requirements. See System requirements and performance considerations.
  2. Ensure that Java is installed on the server and agent systems (and agent relay system if used). All systems require Java JRE 5 or greater. Set the JAVA_HOME environment variable to point to the directory you intend to use. A JDK can be used.
  3. Download the server, agent, agent relay, and CLI client (command-line interface) installation packages. If you are installing an evaluation version, the license is included with the downloaded files. For evaluations, the agent relay (used to communicate with remote networks) and the CLI client can be skipped. At a minimum, an installation must have the server, a database, and at least one agent.
  4. If you are installing an agent relay, download the agent relay installation files as well.
  5. If you are not installing an evaluation version, install one of the supported databases. The database must be installed before the server and on a separate system. See Installing the database
  6. Complete database installation by configuring the appropriate JDBC driver (typically supplied by the database vendor).
  7. Create an empty database for IBM UrbanCode Deploy and at least one dedicated user account.
  8. Install the server. You must supply values for the IP address, ports for HTTP communication (secured and unsecured), port for agent communication, and URL. The installation program provides default values for many parameters. The properties that are set during installation are recorded in the installed.properties file in the server_install/conf/server/ directory. If you intend to turn on SSL, see SSL configuration See Installing the server.
  9. If you are using an agent relay, install the relay. See Installing agent relays.
  10. Finally, install at least one agent. Agents are installed on target systems and communicate with the server. When you install an agent, you supply several values that are defined during server installation. See Installing agents from the command line for instructions about installing agents. An agent requires various access privileges for the system where it is installed, which are described in that section. To determine whether the agent is in communication with the server, display the web application Resource pane. A value of Online in the agent Status field means that the agent is successfully connected.

What to do next

For information about using the CLI (command-line interface, see Command-line client (CLI) reference.

For information about running the installed items and accessing the IBM UrbanCode Deploy web application, see Running IBM UrbanCode Deploy.


Feedback