Agent Settings
    • Dark
    • PDF

    Agent Settings

    • Dark
    • PDF

    Article summary

    In the Settings ribbon of the Real-Time Console, click the Agent icon image.png to open the Agent Deployment Settings dialog box.

    This personal setting isn't global. If you clear the AppData folder it won't be applied anymore.

    You can configure your organization's ControlUp Agent installation preferences from the following options:

    • Deploy agents automatically. If you select this option, the ControlUp Agent automatically deploys when machines are added to the console. If a machine is defined in the console tree but the agent doesn't exist on the endpoint, the monitor also reaches out to try to deploy the agents. If you don't want resources used to automatically check for and install updates on the monitored machines, deselect this option to install agents manually.

      • From version 9.0, this option doesn't apply to monitors. If you select this option, the console still automatically deploys the agents.
        Removed AD Dependency
        From version 9.0, you can deploy ControlUp Monitors on machines that are not joined to a local Active Directory (AD) domain. For details, see Removed AD Dependency for Monitors.
      • From versions lower than 9.0, the AD account used by the monitor requires admin rights on the machines to deploy the agent.
    • Check ping. By default, to ensure connectivity, the console machine pings all selected machines before the agent is installed to ensure connectivity.

    • Prerequisites check. Before deploying the agent, all selected machines are tested for .NET Framework presence. To skip this check, deselect this option.

    • Agent TCP port. The default port for inbound traffic is 40705. You can select a custom TCP port number for client communications. Ensure that the port number you select is not used for any other applications on your network.

    • Auto-Connect Interval. Determines the time span (minutes) between attempts to reconnect to agents.

    • Agents will be uninstalled automatically when not used. When enabled, agents are automatically uninstalled when consoles or monitors aren't connected for a specific time limit (by default, 5 minutes). Note that this local console setting doesn't apply to other consoles.


      If the machine is a ControlUp Monitor, the agent won't uninstall.

    • Linux monitoring

      • You can select to install missing packages on Linux machines for agentless data collection.
      • You can allow users to add machines that are running unsupported Linux flavors.

      We highly recommend not to add machines for unsupported Linux flavors as this could disrupt data collection. Perform this action at your own risk.

    • Customized icon for chat window. You can add a customized icon if you are using the chat functionality. Select this option and browse the local machine to locate and upload the icon image file.

    • Use only encrypted communication. For details, see Agent Security Options in Agent Settings.

    • New in 9.0 Enable Agent Manager. By default, the Real-Time Agent Manager is installed when you install a 9.0 ControlUp Agent with the console. To disable Agent Manager installation with the console, deselect this option.

    • New in 9.0 Enable Agent Outbound Communication. By default, agent outbound communication is enabled from agents to monitors. To revert to agent inbound communication globally, deselect this option.

    • Download Agent MSI. Download the desktop MSI package for installing the agent, if you can't deploy the agents from the console.

    • Agents Authentication Key. For details, see Agent Security Options in Agent Settings.

    • New in 9.0 Agents Registration Key. Required for agent outbound communication. For details, see Manual Installation.

    Was this article helpful?

    What's Next