Install agents

For each PulseUno instance, install at least one agent. Update your agents if the server moves.

For details on how to license agents, see PulseUno licensing.

Agent installation guidelines

Review these guidelines before you install agents:

  • You need to install at least one agent for each PulseUno instance.
  • For security purposes, we recommend that you install agents on a separate machine from the PulseUno server.

  • To distribute the processing load of chains, install multiple agents on different machines in your network.
  • Windows: If you are installing the agent as a service, make sure that the user account to run the service has the Windows Log on as a Service permission. Otherwise, the service doesn't start. For details, see the Microsoft documentation.

  • UNIX: The installation path must not contain spaces. For example, you cannot install agents into the following location:

    /opt/Micro Focus/Pulse Agent/bin

  • Dimensions CM only: If you are using registry passwords in chains that run on agents, create and configure a password registry file on the agent's host machine. Add the path to the registry in the config.properties file, for example:

    registered.password.file=C:\\registry.dat

Back to top

Install PulseUno agent

PulseUno agent installers are available for Windows and Linux platforms.

To install an agent:

  1. Download the PulseUno agent installer from the Micro Focus Software Licensing and Downloads portal (requires login).

  2. Run the installer and follow the instructions.

To remove the agent no longer in use, you need to delete it from the PulseUno user interface. For details, see Delete agents.

Back to top

Update agents if PulseUno server moves

If a PulseUno server moves to another port or machine, update all the associated agents.

To update PulseUno agents:

  1. On each agent, open the config.properties file. Default location: ${pulseAgentDataDir}/config.properties

  2. Modify the pulse.base.url property, for example:

    Copy code
    pulse.base.url=http://newhost.company.com:8080/pulse
  3. If you installed the agent as a service, restart the service. Otherwise, shut down the agent using the agent control script and the shutdown parameter, and then start the agent.

For details on how to upgrade agents to the latest version, see Upgrade agents.

Back to top

See also: