Run the interactive server installer

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

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

To install Deployment Automation:

  1. Download the latest server installer for your platform from the Software Licensing and Downloads portal (requires login).

  2. Extract and run the server installer:

    Windows

    1. Unpack the server installer zip bundle.

      The bundle includes the self-extracting executable file MicrofocusDA-Server64-bundle.exe containing the server and the Common Tools installers.

    2. Run the executable to extract the following installers:

      • Server installer MicroFocusDA-Server64-installer.exe

      • Common Tools installer setupOpenTextCommonTools_win64.exe, extracted into the common directory.

    3. As a Windows local system user, run the installer:

      MicroFocusDA-Server64-installer.exe

    AIX/Linux

    As a user with root privileges, extract and run the installer:

    MicroFocusDA-Server.bin

  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 in which to save settings. Click Change to select a different directory. Configure the following options:

    Option Description
    Use existing settings Install the server using existing settings. This option maintains the current database.
    Skip database creation

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

    If selected, decryption keys are available in the DA user profile. The property skipEncKeysCreation (default value: true) is automatically added to the installed.properties file located in the DA profile 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_da_profile_directory>/conf/server to <new_da_profile_directory>/conf/server. Then restart the server.
    JMS connection port Enter the JMS port on which agents 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:

    jdbc:sqlserver://<serverName>:1433;DatabaseName=da
    Oracle If you are using a service name, use the format:

    jdbc:oracle:thin:@//<serverName>:1521/da

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

    jdbc:oracle:thin:@<serverName>:1521:da

    Where da represents your Oracle SID.

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

    jdbc:postgresql://<serverName>:5432/da

    Tip: To change the database password after the installation, update the hibernate.connection.password property in the <da_profile_directory>\conf\server\installed.properties file. Then restart Common Tomcat where the Deployment Automation server is installed. If not yet encrypted, the hibernate.connection.password property is encrypted after the server starts.

    Enter the database username and password.

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

    Because you cannot change this account later, enter the username 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.

    Windows: By default, Common Tomcat runs under the Windows System Account. To run it under a specific user, for example, when you are using network shares that Deployment Automation needs 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 OpenText Common Tomcat. For details on changing Tomcat service properties, see the Apache Tomcat documentation.

  10. Click Install. The installation finishes and the summary is displayed.

The properties set during the server installation are recorded in the installed.properties file stored in the server profile directory.

Default location on Windows:

C:\Users\<username>\.microfocus\da\conf\server

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.

To start configuring your system, continue with Administration.

To install agent relays or agents, see Install agent relay or Install agents.

Back to top

See also: