Install agents with the interactive installer

This topic explains how to install agents using the interactive installer. You can launch the installer's wizard to guide you through the process, or run the installer from a command prompt.

Considerations and limitations

When preparing to run the interactive agent installer, take into account:

  • The interactive agent installer is available for Windows 64-bit, Linux, AIX, and Solaris SPARC and x86.
  • The interactive agent installer isn't available for Windows 32-bit (in Deployment Automation 6.2.1 and later) and HP-UX operating systems. You can install agents on these platforms only from a command prompt. For details, see Install agents from a command prompt.
  • The interactive installer enables you to install different versions of the agent on the same machine and run them in parallel. When installing another agent on the same machine, make sure to specify a unique port number because the installer does not check if a port is already in use.

Back to top

Run the interactive agent installer's wizard

Before you begin, download and extract the appropriate installation files from the Deployment Automation support page.

Windows: As a local system user, run the following installer:

MicroFocusDA-agent.exe

UNIX/Linux: As a user with full access rights to the installation location, run the following installer:

MicroFocusDA-agent.bin

Note: Because UNIX installers are 32-bit applications, 64-bit Linux 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

To specify installation details, see Agent installation options.

Back to top

Run the interactive agent installer from a command prompt

You can run the interactive installer in a text-based mode using a command-line interface.

To run the installer from a command prompt:

  1. From the Deployment Automation support page, download and extract the appropriate installation files for your system.
  2. From a command prompt, navigate to the directory with the agent installation files.
  3. Run the following command:

    • On Windows, as a local system user:

      MicroFocusDA-agent.exe -console

    • On UNIX/Linux, as a user with full access rights to the installation location:

      MicroFocusDA-agent.bin -console

    • On Solaris, as a user with full access rights to the installation location:

      MicroFocusDA-agent.bin -is:javahome <path to local JRE>

  4. Follow the prompts to accept the License agreement.
  5. Specify the path to a directory where you want to install the agent, or accept the default location.
  6. Enter the unique name for the agent.
  7. Follow the prompts to configure the agent connection, server location, and agent local service details. For more information, see Agent installation options.
  8. Choose if you want to install the JRE supplied with the agent or use existing JRE.
  9. Review the agent’s summary and press 1 for Next.

    To go back to the earlier step and change the details, press 2 for Previous.

  10. When the installation is successfully completed, press 3 to Finish.

Back to top

Add installation options

To add agent installer options, use this format:

MicroFocusDA-agent.bin <Option> <Parameter>

The following table provides a list of installation options:

Option Description
-is:javahome <dir> Specifies the JRE home that points to the directory containing bin/java. Do not include spaces in the path.
-is:tempdir <dir> Specifies a temporary directory used by the installer. Do not include spaces in the path.
-cp:a <classpath> Appends a classpath to the installer.
-cp:p <classpath> Prepends a classpath to the installer.
-is:log <filename> Specifies a filename for log debug messages.
-is:extract Extracts the contents of the archive.
-is:nospacecheck Turns off the installer disk space checker.
-is:version Returns the installer version and exits.
-is:help Prints this help and exits.

Back to top

See also: