Skip to main content

How can we help you?

Druva Documentation

Create a device map .csv file

Overview

To perform a mass deployment in a non-AD/LDAP environment, you need to create a  device map file in a .csv format. Each entry in the device map .csv file is called a mapping. A device-map .csv file contains the user and device mapping details, which ensures controlled device and user activation of the client and prevents the addition of rogue or unauthorized devices.

Procedure

You can create a device map .csv file by downloading a sample device-map file from the Endpoints page and adding data to it. To download the sample device map .csv file:

  1. On the Endpoints page, click Device Mappings from the left navigation pane.
  2. Click the Import Device Map CSV button located on the top left of the page. The Import Device Map CSV dialog box appears.​​​​​​

Note: If the CSV file that you import includes users who have enabled data privacy, we will notify those users and server administrators about the new device mapping. Sending email notifications would mitigate a potential threat when a rogue administrator attempts to gain access to user data.  To disable email notifications, contact Support. 

  1. Click the Download Sample CSV File link. A sample .csv file is saved to your local drive. You can update this sample with the data specified in the table below and use it as your device map file.

The following table lists the attributes in the device map .csv file.

  Value Description

1.

email id
 

Email ID of the user. This is validated against the list of user email-ids registered. Multiple authentic devices and user names can map to the same email ID. The .csv file may have multiple entries for the same email-id to show multiple mapped devices and users. However, we recommend having one user per registered email ID.

2.

hostname
 

The hostname of the new device. 

3. 

device Id

Value of the device ID. 

The following commands for Mac and Windows devices will display the device identifiers such as the Serial Number and UUID of the respective device. You can use anyone as a device identifier in the device map .csv file. The device identifier must be unique and must map to a single email ID.

  • Mac OS
    • To display the Serial Number on a Mac device, execute the following command on the terminal:

system_profiler SPHardwareDataType |grep -v tray |awk '/Serial/ {print $4}'

Another option to find the Serial Number:

  1. Click the apple Apple_Logo.png) icon at the top left on the menu bar and select About This Mac.
  2. You can note the Serial Number from the About This Mac dialog box.
  • To display the hardware UUID of a Mac device, run the following command on the terminal:

system_profiler SPHardwareDataType | awk '/UUID/ { print $3; }'

       Another option to find hardware UUID:

  1. Click the apple (Apple_Logo.png) icon at the top left on the menu bar and select About This Mac.
  2. Click System ReportYou can note both the Serial Number (system) and Hardware UUID from the Hardware Overview page.
  • Windows OS
    • To display the serial number of a Windows device execute the following command on the command prompt:

wmic bios get serialnumber

  • To display the UUID of a Windows device, execute the following command on the command prompt:

wmic csproduct get UUID

4.

user-name

User name used to log on to the device.

5. device-id-type The type of the device identifier, for example, Serial Number or UUID.   
6. old-device-name The hostname of the old device.

Use this field if you are replacing the old device.

7. data-restore

 

Type of data to be restored on the new device.

 Use this field if you intend to replace the old device and restore data from the old device.
Specify one of the following values in the data-restore column:

  • All - To restore both the data and the system settings from the existing device to the new device.
  • System - To restore only the system settings from the existing device to the new device.
  • Data - To restore only the data from the existing device to the new device.

You can view the created device mapping details in the Admin Audit Trail (Activity Type->Others).

Additional information

A mapping is displayed on the Device Mappings page and deleted automatically after the device replace activity, and the Client is activated.

  • Attributes such as email-id, device-id, and username identify the user device in Endpoints.

  • If a mapping is not found for a non-AD user, the mapping is searched using the username and device ID.
  • If the device-map .csv file contains old device details that are specified in the old-device-name attribute, the old device is replaced with the new device and the data is restored if the data-restore attribute is set.
  • If a mapping is found that does not have the value defined in the old-device-name attribute, the device is added as a new device.
  • If a mapping is not found when the user is present and the optional setting - Prompt user if device mapping not defined is enabled, the administrator/user can add or replace a device.

Next

After creating the device map .csv file, you need to import the device map .csv file. For more information, see Import Device Mappings.