Install sever manually on UNIX

This topic explains how to install the server manually. Use this method on UNIX systems for which the interactive or silent installers are not available.

Note: The interactive or silent installers are available for Linux and AIX systems. For other UNIX systems, install the server manually.

For instructions on how to run the interactive installer or install the server in silent mode, see Server installation.

To install the server manually on UNIX:

  1. Prepare your database. For a typical installation, use Oracle. See Prepare your database.

    Note: Use Derby only if your installation is for evaluation or test purposes. Derby is included in the da.war file, and you set it up it as part of the Deployment Automation configuration.

  2. Install Tomcat if it is not already installed. Use the Common Tomcat installer. If you can't run the installer, you must install Tomcat according to the Apache instructions. See

    • Install the version of Tomcat supported by your version of Deployment Automation. For supported versions, see the Support Matrix.
    • Do not use the root user or super user to own and run Tomcat. Any new files created will be owned by the user running Tomcat, so this should be a user who you want to be authorized to remove or overwrite any files under Tomcat.
    • Set 755 permissions for the Tomcat installation location.
    • Before continuing, start Common Tomcat and verify that it is installed properly by entering its URL in a web browser, for example, http://localhost:8080.

      As only the owning user has write permission in the Tomcat location, this is the user who should start and stop Tomcat.

  3. Download and install the JDBC driver specific to the database edition you are using and save it in the Tomcat lib directory. For the Oracle JDBC driver, see

  4. Install JRE 8.0 if it is not already installed. See

    Set the necessary environment variables for the owning user's session to point to this location, such as adding the JRE paths to the PATH environment variable and setting JAVA_HOME.
  5. From the Deployment Automation support page, download the Deployment Automation Server WAR Installer (microfocus_da-other<version>.zip) and extract the da.war file.

  6. Stop Common Tomcat.

  7. Copy and paste the da.war file into your Common Tomcat webapps directory.

  8. Start Common Tomcat.

    When running, the server automatically unpacks the da.war file.

  9. In your web browser, navigate to http://<serverName>:8080/da.

    The configuration setup is displayed.

  10. Modify configuration parameters as needed:

    • Install location

    • External Web URL

    • Agent port and choice of mutual authentication

    • Database (port, schema, user, password)

  11. Click Install.
  12. Set 755 permissions for the profile directory and its subdirectories for the user that the installation will run under. The default directory is:


    Note: CodeStation, the Deployment Automation repository, is by default under the profile directory structure. If you move it, make sure to set the same level of permissions for the new location. See Relocate the repository.

When the server installation is complete, the Deployment Automation login page opens.

After installing the server, continue with the next steps in the Installation checklist.

Back to top

See also: