Difference between revisions of "Selections"

From Tranzman Documentation
Jump to: navigation, search
 
Line 92: Line 92:
 
       <b>Example:</b> Excluding disk/tape backups with multiple copies. Only the copy on the excluded media will not be migrated; others remain on origin.
 
       <b>Example:</b> Excluding disk/tape backups with multiple copies. Only the copy on the excluded media will not be migrated; others remain on origin.
 
     </p>
 
     </p>
     <table style="width:50%;color:white;background-color:black;font-family:monospace,monospace;border-collapse:seperate;border-radius:5px 5px;border:3px solid #000;box-shadow: 5px 5px 10px grey;">
+
     <table style="width:100%;color:white;background-color:black;font-family:monospace,monospace;border-collapse:seperate;border-radius:5px 5px;border:3px solid #000;box-shadow: 5px 5px 10px grey;">
 
       <tr><td><font style="color:blue"># </font>bpimagelist -backupid qa-nbu812-o-lnx-g-e2e.devs.com_1692236444</td></tr>
 
       <tr><td><font style="color:blue"># </font>bpimagelist -backupid qa-nbu812-o-lnx-g-e2e.devs.com_1692236444</td></tr>
       <tr><td>
+
       <tr><td>IMAGE ...</td></tr>
        IMAGE ...<br>
+
      <tr><td>HISTO ...</td></tr>
        HISTO ...<br>
+
      <tr><td>FRAG 1 ... @aaaab ...</td></tr>
        FRAG 1 ... @aaaab ...<br>
+
      <tr><td><font style="color:red">FRAG 2 ... NBDB06 ...</font></td></tr>
        <font style="color:red">FRAG 2 ... NBDB06 ...</font><br>
 
      </td></tr>
 
 
       <tr><td><font style="color:blue"># </font></td></tr>
 
       <tr><td><font style="color:blue"># </font></td></tr>
 
     </table>
 
     </table>

Latest revision as of 18:37, 11 September 2025



Selections Overview & Migration Rules

Selections allow you to choose components for migration, providing granularity in selecting configurations, images, and other components.

  • Selections are enabled after adding servers to Tranzman and completing Discovery.
  • At least one migration pair (origin and destination) is required to enable selections.
  • Multiple migration pairs can be created for complex scenarios (e.g., 2-to-1 migrations).

🛈 Selections should be modified only before the transition is started. Changes after transition will invalidate the existing license.

Creating Migration Pair

  • Select origin and destination servers from the drop-down list.
  • Navigate to TasksSelections and click Create a migration pair.
  • For 2-to-1 migrations, create two selection pairs (each with an origin and destination).

Defining Rules for Selections

   Selections.jpg
  • Image Rules: Select images for migration (all or by properties like Backup Time, Expire Time, Policy, etc.).
  • Config Object Rules: Granular selection of configuration objects (e.g., Workload, Residency).
  • Rename Rules: Rename, map, or ignore configurations.
  • Pre-Duplication & Duplication Rules: Define rules for duplicating image copies pre/post migration.
  • Merge Configs: Migrate individual config entities and host properties.
  • Verify: Check for inconsistencies and dependencies in selections.

🛈 Resolve all inconsistencies and dependencies for successful configuration migration.

Config Object Rules

  • Click Config Object Rules under Selections tab.
  • Tranzman pre-populates configurations by section.
  • Select, deselect, or rename entities as needed.
  • Click Commit to save selections.
  • Use reset icon to revert to default selections.
   Selections config obj rule.jpg

Download selections using Download filter icon or upload a custom list via Upload filter icon.

   Selections config obj rule download.jpg

Image Rules

  • Granular selection of images for migration.
  • Recommended to perform after Config Object Rules to avoid MISSING_XXX_MAPPING errors.
  • Cannot be modified after transition starts (requires reverting appliance state).
  • Consider already migrated images on destination before making changes.
  • Click + to add image rules.
   Selections image rule.jpg
  • Exclude specific images using Add Exclude Rule icon.
   Selections image rule exclude rule.jpg
  • Download/upload image rules as CSV. First line must define separator (e.g., sep=|).
  • Inclusion: <serial num>|+|<criteria>, Exclusion: replace + with -.
   Selections image rule csv.jpg

Rename Rules

  • Rename objects during migration (must be selected for migration).
  • Map objects of same type (object must NOT be selected, new name must exist or be migrated).
  • Exclude components using NOT_MIGRATED keyword (affects SLPs and DiskMediaIds).
  • Highlight missing config by images not selected, renamed, or mapped (MISSING_XXXX_MAPPING).
   Selections rename rule.jpg

Example: Excluding disk/tape backups with multiple copies. Only the copy on the excluded media will not be migrated; others remain on origin.

# bpimagelist -backupid qa-nbu812-o-lnx-g-e2e.devs.com_1692236444
IMAGE ...
HISTO ...
FRAG 1 ... @aaaab ...
FRAG 2 ... NBDB06 ...
#

Duplication Rules

  • Define rules for duplication on Origin (pre-migration) or Destination (post-migration).
  • Rules are based on images from the Origin.
  • Cannot be modified after transition starts (requires reverting appliance state).
  • If no rules are defined at start, action is paused; if added after, resume manually.
   Selections duplication rule.jpg

Merge Configs

  • Lists all config settings between Origin and Destination.
  • Use arrow to select origin setting and update destination.
  • Use revert to undo changes.
  • Custom values can be typed directly.
  • Click Commit before navigating away or closing dialog.
  • Handled during CreateConfig action; must be done before transition starts.
   Selections merge config.jpg

Verify

  • Verify selected configuration objects, images, and rename rules.
  • Validate server, SLP, and disk pool mappings.
  • Check for valid config names in renames.
  • Identify duplicate configuration objects needing rename or mapping.
   Selections verify.jpg

Other Options in Selections

  • Import empty media: Add empty (scratch) media to destination. Use only for same vendor transitions.
  • Demote Origin Master: Demote origin master as media server on destination (yes/no/partial). For domain split, only one pair can be 'Yes'.
  • Switchover date: Select anticipated switchover date. Tranzman verifies feasibility and ignores images expiring before switchover.
   Selections others.jpg

🛈 Modifying switchover date impacts data transfer and may result in expired images migrated to destination.

   Prev icon.jpg Previous
   Next Next icon.jpg