Auto Light Dark
Auto Light Dark

Create CSV-based Move Groups

Overview

This guide will walk you through creating CSV-based move groups in the Migration Planner. You will learn how to format the CSV file, upload the file, select which columns to map groupings to, and then view the results.

Instructions

First, you will need to create a file in CSV format, which will be used to re-group your machines. The layout of this file can vary significantly based on your specific use case; however, you will always need a column with the machine names and at least two other columns to map to the Group name and Asset name. These columns could be anything relevant to the environment - Production/Non-production, Migration Type, Application, Scope, etc.

Attached is a sample CSV file:

SampleForCreatingGroups.csv

 

Navigate to the Migration Planner and click Upload File from the top toolbar through the following steps

Step 1: Click on the Plan section on the landing home page of the console portal

Screenshot 2026-07-22 at 1.08.22 PM-20260722-073857.png

Step 2: The Plan section takes you to the page below, and click on the “Application Canvas” tab as shown in the screenshot below.

Screenshot 2026-07-22 at 1.12.39 PM-20260722-074244.png

Step 3: Then, click on the highlighted option below to open the CSV upload option and to upload the file.

image-20251008-065108.png

Click Choose File, navigate to the CSV file you created, and select it. Then click Submit to continue.

image-20230504-144651.png

 Select which column from your CSV file will be mapped to Group Name, Asset Name, and Machine Name. Then click Save to continue.

image-20220112-181228.png

Review the mapping before applying the changes. Here you will see the Group Name, Asset Name, Machine Name, and a Message indicating whether the machine was found or not found. Click Save to apply the changes and return to Migration Planner.

image-20220112-181237.png

 

You may now view the changes applied in the Migration Planner.

image-20220112-181242.png

You have finished the process to create meaningful move groups based on custom columns defined in a CSV file.

Adding Tags via CSV Upload

Cloudamize allows users to bulk-apply tags to infrastructure assets using CSV file ingestion within the Canvas module. This bulk onboarding feature enables project teams to rapidly import custom key-value pairs such as ownership details, environment classifications, target migration strategies, or custom tag parameters across large machine inventories.

Download the Tag Sample CSV Template

  1. Log in to your account portal at console.cloudamize.com.

  2. Select Plan from the top right navigation bar and click Application Canvas

    image-20260902-072144.png
  3. Ensure you are under Migration Planner > Machine View.

  4. On the top-right corner of the interactive canvas grid, click the Wrench icon (Tools Menu) to expand the Canvas Action Tools palette.

  5. Click the CSV Upload icon (the document icon with the downward arrow labeled CSV).

    image-20260902-072252.png


Step 2: Open Modal & Download Template

  1. When the "Please upload a file to create groups or apply tags" modal opens, select the Upload for Adding Tags radio button.

  2. Click Tag Sample CSV to download the official sample template (SampleForAddingTags.csv).

  3. Save the file to your local workspace.

    image-20260902-072434.png

Step 3: Populate the CSV File

Open SampleForAddingTags.csv in your spreadsheet editor (such as Microsoft Excel or Google Sheets) and enter your machine and tag attributes.

CSV Formatting Guidelines & Structure

Column Header

Description & Technical Requirement

Required / Optional

Example Entry

MachineName

The exact hostname or server name discovered in Cloudamize.

Required (Column A)

TestMachine1

Owner

User or team responsible for the target host.

Optional

UserName1

Environment

Operating environment classification (e.g., DEV, Test, Prod).

Optional

DEV

Purpose

Function or application role of the server.

Optional

Log

[Custom Tag Columns]

Additional key-value pairs (e.g., Tag1, Wave, Strategy).

Optional

value1

Step 4: Upload and Ingest Tags

  1. Save your populated file strictly in .CSV format (Comma Separated Values).

  2. Return to the open modal in Cloudamize:

    • Click Choose File and select your file (SampleForAddingTags.csv).

    • Confirm that Upload for Adding Tags remains selected.

  3. Click Submit to ingest and process the tags across your targeted infrastructure.

⚠️ IMPORTANT FILE CONSTRAINTS:

  • File Format: The file must be saved in native .CSV format. Excel spreadsheet formats (.xlsx, .xls) will fail validation.

  • Host Identification: The server name under MachineName must match the discovered hostname in Cloudamize exactly.

  • Visibility: Uploaded tags will be reflected across the Project Management Tab and Canvas views for filtering, grouping, and migration wave planning.


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