Installing and Upgrading Servers and Agents

A uDeploy installation consists of the uDeploy server (with a supporting database), and at least one agent. Typically, the server, database, and agents are installed on separate machines, although for a simple evaluation they can all be installed on the same machine. In addition, Java must be installed on all agent and server machines.

Note

For evaluation purposes, the supplied Derby database should be adequate and can be installed on the machine where the server is located. If you are installing uDeploy in a production environment, UrbanCode recommends the use one of the supported databases--Oracle Database (all versions), SQL Server, or MySQL.

Installation Steps

  1. Review the system requirements. See the section called “System Requirements”.

  2. Ensure that Java is installed on the server and agent machines (and agent relay machine if used). All machines 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 uDeploy server and agent installation files from the UrbanCode support portal. If you are installing an evaluation version, the license is included with the downloaded files.

  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 should be installed before the server and on a separate machine. See the section called “Database Installation”

  6. Complete database installation by configuring the appropriate JDBC driver (typically supplied by the database vendor).

  7. Create an empty database for uDeploy and at least one dedicated user account.

  8. Install the server. See the section called “Server Installation”.

  9. If you are using an agent relay, install the relay. See the section called “Installing Agent Relays”.

  10. Finally, install at least one agent. See the section called “Agent Installation”.

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 uDeploy web application, see the section called “Running uDeploy”.