Install a ControlUp Monitor
    • Dark
    • PDF

    Install a ControlUp Monitor

    • Dark
    • PDF

    Article Summary

    The ControlUp Monitor is a Windows service that allows for continuous monitoring of your external resources. For more information, see here.

    Prerequisites for ControlUp Monitor

    From version 9.0, you can install the ControlUp Monitor on workgroup machines. To install monitors with PowerShell cmdlets, see here.

    Verify that the machine that you deploy the monitor on meets the following prerequisites:

    • Windows Server 2016 or higher. Windows client OS are not supported.
    • .NET Framework 4.8 or higher
    • Enable RPC access
    • All monitor machines must be able to communicate with each other over TCP port 40706. See ControlUp for Multi-Tenancy Environments if this requirement can't be met.
    • Enable administrative shares on the monitor machine.
    • Windows PowerShell 5 or higher

    Configure the Monitor (On-prem + Hybrid Cloud pre 9.0)

    From version 9.0, you can configure monitors with PowerShell cmdlets, see here. Before you install a monitor on a machine, you first need to configure the monitor settings in the Real-Time Console.

    To configure the monitor:

    1. From the Real-Time Console, login to your ControlUp organization, go to Home > Add Monitor.
    2. On the popup message, click OK. As you need to provide a service account credential for the Primary Domain Credential, make sure that you already you prepared this account prior to the installation of the monitor.
    3. In the Monitors tab, click Monitors Settings. The Sites and Monitors - Configuration Wizard opens.

    Add Monitor Credentials (On-prem + Hybrid Cloud pre 9.0)

    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.
    For ControlUp On-premises environments, or Hybrid Cloud environments lower than version 9.0, you need to assign domain credentials to the monitor service to enable the ControlUp Monitor to connect to managed machines, as described below.

    In the Domain Identity tab, add credentials so your monitors can connect to your environment and resources, such as hypervisors, EUC environments, cloud environments, NetScaler applicances.

    To add monitor service account credentials:

    1. Click Add Domain. The Add New Domain Identity popup appears.
    2. Enter or select the Domain FQDN from the Domain Selection list, enter valid domain credentials, and click OK. We recommend that the domain account be a member of the local administrator group to deploy agents remotely.
    3. Optionally, to save new credentials, select Save a new credentials set, enter the new credentials into each field as required, and click OK.
    4. Select Shared credentials for each credential set. To learn more about this option, see Configuring Shared Credentials.
    Shared Credentials

    Note that all monitors and consoles in your environment must use the same credentials when connecting to your resources. You can share your credentials in your Monitor Settings so that all ControlUp users can easily connect to your resources without having to know the service account username and password. For more information, see Configuring Shared Credentials.

    1. Optionally, to add additional credentials for hypervisor connections or EUC environment connections:
    • Click Add Credentials Set and the Add New Credentials popup appears.
    • Enter the new credentials into each field as required, click OK, and the credentials are added.
    • Repeat the process as needed to add credentials for all of the resources that you connect to ControlUp.
    1. Optionally, click the Proxy Settings tab to configure any proxy settings for the default site, if required.
    Proxy Settings

    You can configure the proxy settings option separately for each site.

    1. Optionally, click the Export Schedule tab to configure an Export Schedule.
      If you already configured export rules in the console, and not on a monitor, you can select Import Settings to import those rules so that the export occurs even when no console is running. Set the Reports Directory path on the monitor machines where the reports are saved. Enter Credentials that have permission to write to the directory you entered.
    2. Optionally, click the SMTP Settings tab to configure Trigger Alerts. Follow the instructions to configure a priorty list of SMTP servers and their connection details and click OK.
    3. Optionally, click the Advanced Settings tab to change the default monitor service resource settings. For more information about changing the default settings, see Performance Optimization for Real-Time Console & Monitor.
    Global Settings

    The Export Schedule , SMTP Settings, and Advanced Settings are global and aren't set per site.

    Install Monitors (On-prem + Hybrid Cloud pre 9.0)

    From version 9.0, you can install monitors with PowerShell cmdlets, see here. After you configure your monitor, you can install the monitor on domain-joined machines with the following prerequisites:

    • Windows Server 2016 or higher
    • .NET Framework 4.8 or higher
    • Windows PowerShell 5 or higher

    For network communication requirements, see Hybrid Cloud or On-Premises.

    To install the monitor on a machine:

    1. From the Real-Time Console, go to Home > Add Monitor > Monitors > Add Monitors to Site.
      The ControlUp Monitor Installation Wizard opens.
    2. Select one or more machines as required to install the monitor on. Note that these machines should be dedicated to running the monitor.
    3. Optionally, change the port that the monitor uses for communication to the console. Verify that the port is open for communication in your firewall. By default, the port that the monitor listens on is 40706 (console <> monitor).
    4. Click Install. The installation process might take a few seconds.
      The monitor installation wizard tests various components of the target machine before deploying the service to ensure that it will be able to run.
    5. After the installation completes, click Finish > OK.
      The monitor(s) you installed appear in the Monitors tab next to a green icon.

    Confirm Monitor Connection

    To learn how to manage your monitor resources connections, watch our video.

    After you install a monitor, you can go to Settings > Monitors to view the connection status of each monitor, and all of the data sources that the monitor(s) is connected to.

    Was this article helpful?