Auto Light Dark
Auto Light Dark

Add and Configure Hosts

Overview

This guide walks you through configuring and managing target machines using the Cloudamize Agentless Data Collector (ADC) console. It covers how to:

  • Add and discover Windows, Linux, and NetApp targets (individually, by IP range/CIDR, or via bulk CSV upload)

  • Assign, test, and update authentication credentials

  • Monitor connection statuses and review error logs

Prerequisite: Ensure your collector host meets all hardware, software, and firewall requirements detailed in the Agentless Setup Instructions before adding endpoints. If you encounter connection failures, refer to the Agentless Troubleshooting Guide.

Launching the UI

  • Locate the Cloudamize Agentless Data Collector icon in the Windows notification area (system tray) on the collector machine.

  • Right-click the icon and select Open. The main console dashboard will appear.

Add and Configure Hosts 

image-20230522-051053.png

Follow the instructions contained in the above image to open the collector. Once you have clicked Open, you will see the UI.

image-20240605-010546.png

Adding Hosts

Adding a Remote Host

You can add a Windows, Linux, or NetApp host using the 'Add Host' menu as follows-

image-20240605-010647.png

Adding Windows Hosts

  1. Click the Add Host menu and select Add Windows Host.

  2. Enter target IP addresses using any combination of the following formats separated by commas:

    • Single IP: 10.1.1.2

    • IP Range: 10.1.1.2-50

    • Subnet / CIDR: 10.1.4.0/24

  3. Provide the administrative account credentials (e.g., DOMAIN\username or local .\username) and password.

  4. Click Add Host(s).

  5. The collector will launch a validation window testing initial WinRM and WMI/RPC connectivity against each target. The summary dialog displays counts for Succeeded, Failed, and Not Checked (if cancelled). Successfully verified nodes populate the main host table with a status of OK.

image-20230522-145701.png

The screenshot above shows that two Windows hosts have been added successfully.

This will open another window that will check the WMI connection to each host and report Success or Failure. A summary will be printed at the bottom displaying the number of hosts that succeeded, failed, and were not checked. Hosts will not be checked if Cancel is clicked during the checking process.

Instructions for adding a Linux host.

Linux discovery uses SSH (TCP Port 22) and supports either password-based authentication or SSH private keys.

Key Format Note: PuTTY private key format (.ppk) is recommended. While OpenSSH and PEM-style keys are automatically converted by the application, manually convert them to .ppk using PuTTYgen if an authentication error occurs. Ensure the key file resides on local storage accessible to the ADC service on the collector machine.

Step 1: Click Add Host, and then select Add Linux Host, as shown in the screenshot below. The Add Linux Host window opens, where you can enter the required host details.

Screenshot 2026-08-21 at 2.57.40 PM-20260821-092748.png

Step 2: Enter the IP Address of the host and the corresponding Account Name. Under SSH Key, click Browse and select the required SSH key. Once all the required details are entered, click Add Host. The host will be added successfully and displayed in the host list, as shown in the screenshot below.

Note: Ensure that the SSH key is saved on the machine where the ADC (Agentless Data Collector) is installed.

Screenshot 2026-08-21 at 3.00.53 PM-20260821-093059.png
Screenshot 2026-08-21 at 3.07.04 PM-20260821-093806.png
Screenshot 2026-08-21 at 3.09.22 PM-20260821-093938.png


Bulk Onboarding for Linux Hosts (Multi-Server Batch Addition)

You can onboard multiple target Linux servers simultaneously in a single operation, provided they share identical SSH authentication credentials.

  • Multi-Server Batch Addition: Multiple Linux targets utilizing the same SSH key pair (or standard root/sudo credentials) can be uploaded and configured together during a single Agentless Data Collector (ADC) onboarding workflow.

image-20260825-084737.png

IMPORTANT NOTE ON SSH KEYS:

If your target Linux servers utilize different SSH keys, they must be added individually in separate operations. The Cloudamize ADC interface allows you to browse and select only one SSH key file per onboarding operation. Multiple distinct SSH key files cannot be uploaded simultaneously in a single batch.

Instructions for adding a NetApp host.

image-20240605-011008.png

Adding and updating credentials in bulk

When there are a lot of hosts to add, you can add credentials in bulk by uploading a .csv file containing the following information in this order:

  • IP Address

  • OS Type

  • Account Name

  • Password

image-20240605-011441.png

If you are having any issues adding hosts, please send the following log file to helpdesk@cloudamize.com with a description of the errors as reported in the UI:

  • C:\Program Files (x86)\CloudamizeAgentlessDC\log_backup.txt

Example CSV file:

Sample file.csv

View Error Messages

If the WMI connection fails for any reason, the Status column of the UI will display "Error". You can click on the Show error button to the right of Status to learn more. 

image-20220112-191415.png

 Another window will open with more information about the error. Please refer to this page for troubleshooting WMI connection issues. You can review the information in the pop-up window and attempt to fix the error or contact helpdesk@cloudamize.com for assistance.

Change Access Credentials

You can edit the credentials of a host by clicking the checkbox on the left of the row and selecting Change Credentials at the bottom of the UI.

image-20220112-191421.png

The changes made to the credentials will now be displayed in the UI.

If the Change Credentials process is running, you will not be able to close the window until the process is stopped by the user canceling the process or the process completes on its own.

image-20220811-182320.png

You can retry credentials without having to open the Change Credentials window

image-20220811-182008.png

 Deleting a Remote Host

image-20230522-152327.png

To delete one or more remote hosts, select the host(s), click the Delete button, and click the OK button on the confirmation pop-up window.

Parameter Setup

image-20230522-150902.png

You can set up the max. number of remote hosts. The default value is 500, and we suggest 500. If you want to increase it, computer resources need to be increased too (e.g., number of hardware threads).

Error Message

Adding Hosts More Than Limit

The default limit of adding hosts per Agentless Data Collector is 500 to protect the ADC well in terms of resources, and if you try to add more hosts than the limit (e.g., 500 hosts), the following error message will appear.

image-20220728-194859.png

If you have any queries, please get in touch with the helpdesk via our Helpdesk Portal or by email at helpdesk@cloudamize.com.