Quick start for Linux

This topic provides a summary of the tasks for setting up Deployment Automation and its components on Linux.

Interactive server installation

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

Note: 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 the following are installed:

  • Motif: This is usually available by default
  • 32-bit compatibility libraries: C/C++ runtime

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

MicroFocusDA-Server.bin

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

Back to top

Quick server installation

For a quick default server installation, enter the installer wizard panel information as follows:

  1. Destination Folder: Accept the default and click Next.
  2. General Program Settings: Accept the defaults and click Next.
  3. Database Selection: Accept the default (Derby) and click Next.
  4. Database Details: Specify the details for the built-in Derby database as follows and click Next:

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

    Note: The Derby database will be created by the installer.

  5. Administrator Details: Enter the product administrator user name and password and click Next.
  6. Configuration Details: Accept the default (8080) and click Next.
  7. Ready to Install: Review the settings and click Install.
  8. InstallShield Wizard Completed: Review the installation details and click Finish.

    Your server installation is now complete.

Back to top

Starting and stopping the server

The installer installs Deployment Automation under the application server and starts the service automatically.

To start or stop the server service:

  1. Navigate to the <server_installation>/bin directory.

    For example, /opt/MicroFocus/da/common/tomcat/8.5/bin.

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

Back to top

Logging into Deployment Automation

After you have completed at minimum a server installation, you can login to the user interface to start configuring Deployment Automation.

To open the Deployment Automation user interface:

  1. Open a web browser and 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 is 8080 for Common Tomcat.

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

Back to top

Agent installation

You must install at least one agent for a basic installation.

Multiple agents on multiple machines

If you plan to run deployments on several machines, a separate agent with a unique name should be installed on each machine. If, for example, 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: installation directory name, agent name, and service name, if running the agent as a service.

Back to top

Interactive agent installation

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

Note: 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 the following are installed:

  • Motif: This is usually available by default
  • 32-bit compatibility libraries: C/C++ runtime

Run the following installer executable as a user with full access rights to the installation location:

MicroFocusDA-agent.bin

For details, see Install agents with the interactive installer.

Back to top

Starting and stopping 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 you are using an agent relay, you must start it before starting any agents that will communicate through it.

To start or stop an agent service:

  1. Navigate to the <agent_installation>/bin directory.

    For example, /opt/microfocus/Deployment Automation Agent/core/bin.

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

    Note: For information on configuring your agents to start automatically under a dedicated account, see the Community website.

After the agent has started, in the Deployment Automation user interface, navigate to Management > Resources and select the Relays check box. The agent is now displayed with a status of Connected.

Back to top

Managing plugins

Deployment Automation Help Center includes several standard plugins that are available when you install. Many additional plugins are available for you to download and use for your specific needs. Plugins can be installed, or loaded, at any time, directly from the DA user interface.

Back to top

Loading plugins

After you have downloaded a plugin, you can load it so that it becomes available to use in the process designer.

Note: If you download a bundled zip file that contains multiple plugins, you will need to extract the individual plugin zip files from the bundle. You should not decompress the individual plugin zip files.

To load a plugin:

  1. Navigate to Administration > Automation.
  2. Click the Load Plugin button.
  3. In the Load Plugin dialog box, click Choose File and select the compressed plugin (.zip) file.
  4. Click Load.

After the plugin load process completes successfully, when you are designing processes for components, the plugin is listed on the Automation Plugins pane. Once loaded, plugin functionality is available immediately.

Back to top

See also: