Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. IT Analytics Help
  3. Section IV. End user
  4. Manage hosts, backup servers, and host groups
  5. Import Hosts

Import Hosts

If your hosts are not part of a data collection process, you can still manually add them using the Import function. Import adds the data to the Portal database and displays the information in the Inventory. If a host already exists in your system, Import will update the host's details.

Before importing, create a comma-separated values (CSV) file of host data using the format specifications. The CSV file must be of UTF-8 type.

Note:

This utility is designed to create and update hosts. It does not load or maintain relationships between hosts or host groups. See Load relationships between hosts and host groups section in the IT Analytics Administrators Guide for details on loading host relationships.

CSV Format Specifications (Host Import)

Create a comma-separated file that contains the following fields for a host, in the order listed in the following table. Note that each field in the CSV must have an entry, even if it is a null entry within the commas. Field values cannot contain embedded commas.

Name

Type

Value

/path_to_host_group

String

The path to the host group must be the full path from the root host group. The host group corresponds to your domain. Null values are not allowed.

Note:

If you are using the product in a multi-tenancy environment, you may not know the full path to the root host group. For security purposes, if there are multiple domains and host groups, you will only know the path within your host group. Only an administrator with a Super User role can provide the full path.

internal_name

String

The host name, typically how it is known in your data center, is a required field with a maximum of 128 characters. Null values are not allowed.

external_name

String

The host name, as you want it displayed in the Inventory, is a required field with a maximum of 128 characters. Null values are not allowed.

description

String

The host description, as it will be displayed in the Inventory, has a maximum of 256 characters.

location

String

Location of the host, a maximum of 64 characters.

ip_address

String

Host IP address, a maximum of 40 characters.

make

String

Make of the host, a maximum of 64 characters. Example: Dell PowerEdge

model

String

Model of the host, a maximum of 64 characters. Example: 4300

os_version

String

Operating system version of the host, a maximum of 128 characters. Example: RHEL 2.1

os_platform

String

Operating system platform of the host, a maximum of 128 characters. Example: Linux

EXAMPLE: hostImport.csv
/HDS/Finance Assets,Finance NBU Primary,Finance Backup,Main 
backup server for the finance group,HQ New York,10.10.10.10,Dell,
64-bit, 10.0.10240,Microsoft Windows
Import Notes
  • If the host already exists in the specified host group, the details are updated.

To import hosts from a CSV file

  1. Prepare the CSV according to format specifications. The CSV file must be of UTF-8 type.

    See CSV Format Specifications (Host Import).

  2. Select Inventory.
  3. Navigate to Hosts and select a host group. This can be anywhere in the hierarchy structure that displays hosts.
  4. Click Import.

    Note:

    The Import function is controlled by privilege settings in the user profile.

    See Assigning user privileges.

  5. Click Choose File to navigate to the CSV to import.
  6. Click OK. You must refresh to see the new hosts in the grid.

Feedback

Was this page helpful?
Previous

Adding and Editing Hosts and Backup Servers

Next

Decommission/Recommission Hosts and Backup Servers

Feedback

Was this page helpful?