If it’s the first time you’re using ControlUp, click on the “Add Computers” link in the information grid. In order to launch the “Add Computers” window at a later time, right-click the Root Folder or any other folder organization tree and select “Add > Computers”, or click the “Add Computers” button on the Home ribbon.
The Add Computers window prompts you to select your managed computers, using one of the following methods:
By selecting computer accounts from your Active Directory (default)
Choose a domain containing the computers to be added using the “Domain” selector button.
Choose a root OU for the Active Directory search using the “Search Root” selector. This is useful in large environments, in which the size of the directory may slow down the discovery process.
Search for and select computer accounts from Active Directory. Typing text in the Search Filter box performs inline filtering of the result table, which allows for faster location of computer accounts. The text you type in the Search Filter box can be any part of the computer name and does not require the use of wildcard characters.
By default, ControlUp attempts to contact your computers by using the DNS suffix configured in the Active Directory dNSHostName attribute of the computer account. In case the DNS configuration in your network specifies a DNS suffix which is different from the domain name, use the “Alternate suffix” text box to input the name suffix used in your network.
After locating the computers you would like to add to ControlUp, select them and click Add. The right pane will show all computers currently selected for addition.
By entering IP addresses or scanning your internal IP range
You may provide a list of IP addresses in the “IP Addresses” field. Multiple addresses should be separated by a semicolon (;). A contiguous IP address range may be scanned by using the “IP Range” option. Please provide the start and end addresses for the IP range and click “Scan” to discover computers in that range.
By providing a text file that includes a list of computers to be added
ControlUp supports adding managed computers from a text file that includes a list of computers separated by line breaks, commas, semicolons or spaces. Use the “File Path” field to select a file, choose the file encoding if needed and click “Load”.
Note: When adding computers using a text file or by IP address, expand the “Connection Settings” optional pane to select the user account for discovery of the selected computers and to configure connection timeouts:
The credentials you provide here will be used for the Active Directory query only. In order to configure the credentials used for the agent deployment, edit your Active Directory connection on the Settings Window.
When you have selected your target managed computers and clicked Next, all selected computers are contacted and the following tests are performed:
- Ping test (unless disabled).
- .Net Framework installation test (unless disabled).
- Security test – the Windows user account you are using to connect to every managed computer is tested for local administrative rights on that computer.
- Existing ControlUp agent installation – if a ControlUp agent is already present on the machine, this agent will be used unless its version is outdated, in which case you may perform a seamless upgrade of the agent.
- You may rerun the agent installation process for any selected machine if an issue preventing agent installation has been resolved. You can also rerun the process for all failed machines using the “Rerun Failed” button.
At the end of this process, ControlUp agents start reporting performance data, and the ControlUp console will be ready to perform a variety of management tasks on your selected machines.
Deploying ControlUp agents from the hypervisor
After hypervisor connections have been made (see “Connect to the Virtualization Infrastructure”), you will see all of the VMs that are managed by the hypervisors. If they already have the ControlUp agent installed, they will look like all other managed computers. If they do not have the ControlUp agent installed and the status is “Install Agent”, you can easily deploy the agent to them by either clicking on the link in the status “Install Agent” or right-clicking on the computer in the Information Grid. To deploy to multiple VMs at the same time, shift-click or control-click to choose your targets and then right-click on one of those selected computers.
At this point, you will go to the same ‘Add Computers’ window as described above, with a few changes specific to adding computers from a hypervisor.
First, note that there is a box to choose where to place the computers once an agent is installed.
The credentials at the top of the window is for the same purpose as described above. If you change the credentials you choose to use, you can click the “Scan” button to rescan the chosen VMs with the new credentials. If the credentials are valid and have sufficient permissions for installing the agent, the Description column will say “Done” and the VMs put into the target list. If there are any problems, the Description column will give as much detail as it can to help solve the problem.
The Add Computer process then continues as described above.
Please note that deploying the agent from the hypervisor only works in the information grid and not from the organizational tree.
Please be aware that any VM with a status of “Unmanaged” does not have any IP address information offered by the hypervisor, and therefore this method is not available for those VMs. If you want to deploy the agents to VMs in the unmanaged state, you will have to use a different method, as this method relies on knowing the IP address from the hypervisor.
In this version, ControlUp does not filter the ability to install the agent by guest OS, since not all hypervisors always tell what the guest OS is.
Deploying ControlUp agents behind firewalls
By default, ControlUp uses RPC for agent deployment. In some environments, RPC access to the managed computers may be blocked by firewalls or other security measures. In order to deploy ControlUp agents to these computers, use the “Read more about adding computers…” link on the bottom of the Add Computers window. After clicking this link, you will be redirected to the ControlUp website, where you will be able to download a Windows Installer package. You can then use your deployment mechanism of choice in order to install the ControlUp agent on the managed machines. After completing the deployment, you will be able to add these machines to ControlUp using the Add Computers window, provided that the agent communication TCP port (40705 by default) is not blocked by your security hardware and software.
Note: ControlUp agents installed using this method cannot be uninstalled remotely using ControlUp console. You should uninstall these packages manually or using your software deployment system of choice.
Note: The following functionality may be limited when accessing ControlUp agents behind firewalls: Remote Event Viewer, File System Controller (Get file properties, Gather and Send Files Here). These features rely on RPC communications and may not work if firewalls or other security measures on your network prevent this type of connection.
Installing .Net Framework for Managed Computers
.Net Framework 3.5 or 4.5 is a mandatory prerequisite for computers that you would like to manage using ControlUp. After completing the Add Computers action, the computer/s will appear in the organization as “Installation Failed” with an explanation that the required .Net Framework was not found. For computers running Windows Vista or later and Windows Server 2008 or later, .Net Framework feature installation can be performed remotely. To do so, select the computers, and from the Actions menu (from the ribbon bar, right-click, or the right side bar), select Agent Control, and then click “Deploy .Net Framework”. ControlUp agent installation for these computers will resume as soon as the .Net Framework installation is complete.
Please note that .Net Framework needs to be installed manually or deployed using your software deployment mechanism of choice for computers running Windows XP or Windows Server 2003.
Troubleshooting connections to managed computers
Please refer to the Troubleshooting section of this document in order to review the possible causes for errors in connections to managed computers.