Installation quick start

This topic provides a summary of the tasks for setting up Deployment Automation on Windows and Linux. Select your platform to view the details.

Interactive server installation

The Deployment Automation interactive server installer uses a wizard that guides you through the installation process.

As a Windows local system user, run the following installer on a Windows 64-bit system:

MicroFocusDA-Server64-installer.exe

The properties set during the server installation are recorded in the installed.properties file located in the <da_profile_directory>\conf\server directory.

For details, see Run the interactive server installer.

Back to top

Quick server installation

For a quick default server installation, run the installer and complete the wizard.

To quickly install Deployment Automation:

  1. Complete the steps in the installation wizard:

    Setting Description
    Destination Folder Accept the default.
    General Program Settings Accept the defaults.
    Database Selection Accept the default (Derby).
    Database Details

    Specify the details for the built-in Derby database:

    • Port: 11377
    • User: <any user ID>
    • Password: <anypassword>
    • Confirm Password: <anypassword>

    Note: The installer creates the Derby database.

    Administrator Details Enter the product administrator username and password.
    Configuration Details Accept the default, 8080.
  2. On the Ready to Install page, review the settings and click Install.
  3. When the wizard is completed, review the installation details and click Finish.

Your server installation is now complete.

Back to top

Start and stop the server

The installer installs Deployment Automation under Common Tomcat and starts the service automatically.

To start or stop Common Tomcat, use Administrative Tools > Services.

Back to top

Log in to Deployment Automation

After you have installed the server, you can log in to the user interface to start configuring Deployment Automation.

To open the Deployment Automation user interface:

  1. In a web browser, enter the following URL:

    http://<serverName>:port/da/

    Use the host name and port for the application server where you installed Deployment Automation. The default port for Common Tomcat is 8080.

  2. Log in to the server using the credentials (Username and Password) you set up during the server installation.

Back to top

Install agents

Install at least one agent for a basic installation.

Follow these recommendations when preparing to install agents:

Multiple agents on multiple machines

If you plan to run deployments on several machines, install a separate agent with a unique name on each machine.

For example, if your testing environment consists of three machines, install an agent on each one. Follow the same procedure for each environment the application uses.

Multiple agents on one machine If you plan to install multiple agents on a single machine, make sure that all names are unique, such as installation directory name, agent name, and service name, if running the agent as a service.

For details about installing agents, see Install agents.

Interactive agent installation

The interactive agent installer uses a wizard to guide you through the installation process.

As a Windows local system user, run the following installer: MicroFocusDA-agent-installer.exe

For details, see Install agents with the interactive installer.

Back to top

Start and stop an agent

The agent installer installs the agent service, but does not start the service. It is set to manual start by default.

Note: If using an agent relay, you need to start it before starting any agents that communicate through it.

To start or stop an agent service:

Use Administrative Tools > Services to start or stop the agent, DA-Agent.

After the agent has started, open Deployment Automation, navigate to Management > Resources, and select the Relays option. The agent is now displayed with a status of Connected.

Before you can use an agent, make sure it is licensed. For details, see Manage licenses.

Back to top

Load plugins

Deployment Automation includes a set of standard plugins in the server installation.

Many additional plugins are available for you to download and use for your specific needs. You can install, or load, plugins directly in the Deployment Automation user interface. For details, see Load and upgrade plugins.

Back to top

Interactive server installation

The Deployment Automation interactive server installer uses a wizard that guides you through the installation process.

UNIX: UNIX installers are 32-bit applications, and 64-bit systems may not support them by default. Before running the installer on a 64-bit Linux system, ensure that you have Motif installed (usually available by default).

As a user with root privileges, run the following installer:

MicroFocusDA-Server.bin

The properties set during the server installation are recorded in the installed.properties file located in the <da_profile_directory>/conf/server directory.

For details, see Run the interactive server installer.

Back to top

Quick server installation

For a quick default server installation, run the installer and complete the wizard.

To quickly install Deployment Automation:

  1. Complete the steps in the installation wizard:

    Setting Description
    Destination Folder Accept the default.
    General Program Settings Accept the defaults.
    Database Selection Accept the default (Derby).
    Database Details

    Specify the details for the built-in Derby database:

    • Port: 11377
    • User: <any user ID>
    • Password: <anypassword>
    • Confirm Password: <anypassword>

    Note: The installer creates the Derby database.

    Administrator Details Enter the product administrator username and password.
    Configuration Details Accept the default, 8080.
  2. On the Ready to Install page, review the settings and click Install.
  3. When the wizard is completed, review the installation details and click Finish.

Your server installation is now complete.

Back to top

Start and stop the server

The installer installs Deployment Automation under Common Tomcat and starts the service automatically.

To start or stop the server service:

  1. Navigate to the Common Tomcat bin directory:

    <tomcat_install_directory>/bin

  2. Run startup.sh to start the server or shutdown.sh to stop it.

Back to top

Log in to Deployment Automation

After you have installed the server, you can log in to the user interface to start configuring Deployment Automation.

To open the Deployment Automation user interface:

  1. In a web browser, enter the following URL:

    http://<serverName>:port/da/

    Use the host name and port for the application server where you installed Deployment Automation. The default port for Common Tomcat is 8080.

  2. Log in to the server using the credentials (Username and Password) you set up during the server installation.

Back to top

Install agents

Install at least one agent for a basic installation.

Follow these recommendations when preparing to install agents:

Multiple agents on multiple machines

If you plan to run deployments on several machines, install a separate agent with a unique name on each machine.

For example, if your testing environment consists of three machines, install an agent on each one. Follow the same procedure for each environment the application uses.

Multiple agents on one machine If you plan to install multiple agents on a single machine, make sure that all names are unique, such as installation directory name, agent name, and service name, if running the agent as a service.

For details about installing agents, see Install agents.

Interactive agent installation

The interactive agent installer uses a wizard to guide you through the installation process.

UNIX: UNIX installers are 32-bit applications, and 64-bit systems may not support them by default. Before running the installer on a 64-bit Linux system, ensure that you have Motif installed (usually available by default).

As a user with full access rights to the installation location, run the following installer: MicroFocusDA-agent.bin

For details, see Install agents with the interactive installer.

Back to top

Start and stop an agent

The agent installer installs the agent service but does not start it. By default, the service is set to manual start.

Note: If using an agent relay, you need to start it before starting any agents that communicate through it.

To start or stop an agent service:

  1. Navigate to the agent's bin directory:

    <agent_install_directory>/core/bin

  2. Run agent {start|stop} to start or stop the agent.

    For details on how to configure agents to start automatically under a dedicated account, see the Community website.

After the agent has started, open Deployment Automation, navigate to Management > Resources, and select the Relays option. The agent is now displayed with a status of Connected.

Before you can use an agent, make sure it is licensed. For details, see Manage licenses.

Back to top

Load plugins

Deployment Automation includes a set of standard plugins in the server installation.

Many additional plugins are available for you to download and use for your specific needs. You can install, or load, plugins directly in the Deployment Automation user interface. For details, see Load and upgrade plugins.

Back to top

See also: