Install agents with the interactive installer

This topic explains how to install agents using the interactive installer. You can launch the installer wizard 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.
  • HP-UX: Command-prompt installation is the only available method for installing agents. See Install agents from command prompt.
  • The interactive installer enables you to install different agent versions 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 agent installation files from the Software Licensing and Downloads portal (requires login).

Windows

  1. The agent installer is wrapped in the self-extracting executable file MicrofocusDA-agent-bundle.exe. Run the executable to extract the agent installer.

  2. As a local system user, run the agent installer:

    MicroFocusDA-agent-installer.exe

UNIX/Linux

As a user with full access rights to the installation location, run the agent installer:

MicroFocusDA-agent.bin

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).

To specify installation details, see Agent installation options.

Back to top

Run the interactive agent installer in console mode

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

To run the installer in console mode:

  1. Download and extract the agent installation files for your platform from the Software Licensing and Downloads portal (requires login).
  2. Windows: The agent installer is wrapped in the self-extracting executable file MicrofocusDA-agent-bundle.exe. Run the executable to extract the agent installer.
  3. From a command prompt, navigate to the directory with the agent installer.

  4. Run the following command:

    Windows

    As a local system user, run:

    MicroFocusDA-agent-installer.exe -console

    UNIX/Linux

    As a user with full access rights to the installation location, run:

    MicroFocusDA-agent.bin -console

    Solaris

    As a user with full access rights to the installation location, run:

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

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

  10. 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.

  11. 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: