Run the interactive server installer

The Deployment Automation interactive server installer uses a wizard to guide you through the process.

To install Deployment Automation:

  1. Download and unzip the installer zip file.

  2. Launch the Deployment Automation installer.

    Windows: Run the following installer executable as a Windows local system user:


    UNIX/Linux: Run the following installer executable as a user with root privileges:


    Note: The interactive server installer is available only for Linux and AIX. For other UNIX platforms, install the server manually. See Install sever manually on UNIX.

  3. Accept the license agreement.

  4. Specify the path where you want to install Deployment Automation.

  5. In the General Program Settings dialog box, select the location where settings will be saved. Click Change to select a different directory. Configure the following options:

    • Use existing settings

      Install the server using existing settings. This option maintains the current database.

    • Skip database creation

      Install on an additional server for high availability. This option does not overwrite the settings provided during the initial install.

      If selected, decryption keys should be available in the DA profile. The property skipEncKeysCreation (default value: true) is automatically added to the file located in the DA server directory. When the server starts, random encryption keys are not created in the profile directory even if they do not exist. Hard-coded encryption keys are used instead.

      To add decryption keys, copy the enc-keys directory from <existing profile location>/conf/server to <new profile location>/conf/server. Restart the server.

    • JMS connection port

      Enter the JMS port that agents will use to connect to the server.

    • Agent Mutual Authentication

      Configure increased security between agents and the server.

  6. In the Database Selection dialog box, select a database type.

  7. In the Database Details dialog box, edit the Database Connection String for your database.

    Database Database Connection String
    Derby To use the built-in Derby database (for evaluation purposes only), enter a password for the database user and then click Next.
    SQL Server Use this format:

    Oracle If you are using a service name, use the format:


    If you are using an instance name, use the format:


    Where da represents your Oracle SID.

    Note: For Oracle databases, the schema name must be the same as the user name.
    PostgreSQL Use the format:


    Tip: To change the database password after the install, navigate to the profile location conf\server directory and update the hibernate.connection.password property. By default for Windows this is in the following file:


    After the password is updated, restart Common Tomcat where the Deployment Automation server is installed. The hibernate.connection.password property will be encrypted after the server starts if it is not already encrypted.

    Enter the database user name and password.

  8. In the Administrator Details dialog box, enter the user name and password to create a Deployment Automation administrator account. You will use this user name and password to log in to Deployment Automation for the first time.

    Note: Because you cannot change this account later, enter the user name according to your organization's naming standards.

  9. In the Configuration Details dialog box, enter the port number for Common Tomcat. The default port is 8080.

    Note: For Windows installations, Common Tomcat runs under the Windows System Account by default. If you need to run it under a specific user, for example, when you are using network shares that Deployment Automation must have permission to access as part of its core processing, you must change the login information in the Common Tomcat service properties. The default service name is Micro Focus Common Tomcat 8. For details on changing Tomcat service properties, see the Apache Tomcat documentation.

  10. Click Install. The Deployment Automation server installation finishes and the summary dialog box is displayed.

The properties set during the server installation are recorded in the file located in the profile directory. By default for Windows this is:


Deployment Automation is installed and connected to your database. You can now configure Deployment Automation by logging in to the web application using the administrator account you created.

If you want to start configuring your system and defer agent installation until later, continue with Administration.

If you are ready to install agent relays or agents, see Agent relay installation or Agent installation.

Back to top

See also: