Skip to main content

We've Moved!

Product Documentation has moved to docs.hitachivantara.com
Hitachi Vantara Knowledge

Viewing data migration rules

The Data Migration Rules page lists all existing rules and provides for editing or removal of selected rules and creation of new rules.

Data migration rules are used in conjunction with data migration paths to form data migration policies.

Navigate to Home>Storage Management>Data Migration Rules to display the Data Migration Rules page.

GUID-B93A859A-51F4-42CF-BE48-0E58B0E241DF-low.png

The following table describes the fields on this page:

Item/Field Description
Name The name given when the rule is created. It is used to identify the rule when creating or configuring policies.
Type The type of data migration that this rule can be used for.
Description A description of the rule to help identify the criteria to be applied.
In Use by Policies The check box is filled when a rule is being used by one or more policies.
details Click for a selected migration rule to display its complete details.
add Click to create custom rules that will define the criteria by which the files will be migrated.
remove Click to remove one or more existing rules.
Add by Template Click to create simple rules using predefined templates.
Policies and Schedules Goes to the Data Migration Policies and Schedules page. New policies and schedules can be created there.
Data Migration Cloud Accounts Goes to the Cloud Accounts and Destinations page. New cloud accounts and destinations can be created there.
Data Migration Paths Goes to the Data Migration Paths page. New paths can be created there.
CautionOnce created, do not change a data migration rule without verifying that it is not used by existing policies, as such changes might result in unintentional changes to existing policies.

Adding a data migration rule by template

Rules define the properties of files that will be migrated.

  1. To create rules that suit more specific migration needs, navigate to Home Storage Management Data Migration Rules to display the Data Migration Rules page, and then click Add by Template to display the Data Migration Rule Templates page:

  2. Select a Rule Template, then click next.

    The following table describes each of the available rule templates:

    Rule Template Description
    By Last Access Migrates all files that have remained inactive (or have been active) within a certain period of time.
    By Creation Time Migrates all files created before or after a specific point in time.
    By File Name Migrates all files with the same name and extension. An asterisk can be used as a wildcard character. For example:
    • dbfile.db migrates all files with the name dbfile and the extension .db.
    • *.db migrates any file with an extension of .db regardless of the file name.
    • dbfile.* migrates all files with the name dbfile and any extension.
    • *dbfile.db migrates all files ending with the name dbfile and the extension .db.
    • dbfile* migrates all files with a name beginning with dbfile and having any extension.
    By Path Migrates all files under a particular directory.
    By User Migrates all files of the specified users.

    NoteThis rule does not apply to the Data Migrator to Cloud.
    By File Name and Last Access Migrates files of a certain name and/or extension (as described above) that have remained inactive for a certain period of time.
    By Path and Last Access Migrates all files under a certain directory that have remained inactive for a certain period of time.
  3. Enter requested template-specific information:

    • If you select By Last Access, the Data Migration Rule: Last Access Template page contains the fields described in the following table:
      Item/Field Description
      Name Enter a name for the new rule. The rule name can include only alphanumeric characters, hyphens, and underscores.
      Description Enter a description of what the rule does.
      Type The type of data migration that this rule can be used for.
      Include Criteria To specify the maximum period a file can be inactive before being migrated to a secondary file system:
      1. From the menu, select inactive.

        The menu includes an option for selecting the opposite scenario; that is, to choose active within to specify files that have been active within the specified period.

      2. From the menu, select the period (days, hours, or minutes).
      3. Enter the threshold quantity period.
    • If you select By Creation Time, the Data Migration Rule: Creation Time Template page contains the fields described in the following table:
      Item/Field Description
      Name Enter a name for the new rule. The rule name can include only alphanumeric characters, hyphens, and underscores.
      Description Enter a description of what the rule does.
      Type The type of data migration that this rule can be used for.
      Include Criteria To specify the point in time for the migration rule:
      1. From the first menu, select more than or less than.
      2. Enter the threshold number.
      3. From the second menu, select month(s), week(s), day(s), hour(s), or minute(s).
    • If you select By File Name, the Data Migration Rule: File Name Template page contains the fields described in the following table:
      Item/Field Description
      Name Enter a name for the new rule. The rule name can include only alphanumeric characters, hyphens, and underscores.
      Description Enter a description of what the rule does.
      Type The type of data migration that this rule can be used for.
      Case-sensitive pattern checks To specify case-sensitive rule checking, select this check box.
      Include Criteria To specify the type of files (based on their file extension) to be migrated to a secondary file system:
      1. From the menu, select include.

        The menu also has an option for selecting the opposite scenario; that is, selecting to exclude files not of the specified type.

      2. In the all files named field, enter the file name and extension. More than one file name or extension can be named in this field separated by commas; for instance: *.jpg, *.bmp, *.zip.
    • If you select By Path, the Data Migration Rule: Path Template page contains the fields described in the following table:
      Item/Field Description
      Name Enter a name for the new rule. The rule name can include only alphanumeric characters, hyphens, and underscores.
      Description Enter a description of what the rule does.
      Type The type of data migration that this rule can be used for.
      Case-sensitive pattern checks To specify case-sensitive rule checking, select this check box.
      Include Criteria To specify the path to the files under a certain directory:
      1. From the menu, select include.

        The menu also has an option for selecting the opposite scenario; that is, to select exclude to select all files that are not in the path.

      2. In the all files in the path field, enter the directory file path.
    • If you select By User, the Data Migration Rule: User Name Template page contains the fields described in the following table:
      NoteThis option only applies to WFS/HNAS and does not apply to Data Migrator to Cloud.
      Item/Field Description
      Name Enter a name for the new rule. The rule name can include only alphanumeric characters, hyphens, and underscores.
      Description Enter a description of what the rule does.
      Type You can only enable the WFS/HNAS option. This rule does not apply to cloud options.
      Case-sensitive pattern checks To specify case-sensitive rule checking, select this check box.
      Include Criteria To specify the user names for the owners of the files to be migrated to a secondary file system:
      1. From the menu, select include.

        The menu also has an option for selecting the opposite scenario; that is, selecting to exclude files from owners other that the specified owners.

      2. In the all files in the path field, enter the UNIX or Windows user names for the owners of the files you want to migrate. More than one user name can be listed in this field, but names must be separated by commas. For instance, jjames, myco\smithr, myco\wsmith.

        Windows user names are specified in the form domain\user name, and backslashes in user names should not be escaped (double backslashes are not required).

    • If you select By File Name and Last Access, the Data Migration Rule : Last Access Time and File Name Template page contains the fields described in the following table:
      Item/Field Description
      Name Enter a name for the new rule. The rule name can include only alphanumeric characters, hyphens, and underscores.
      Description Enter a description of what the rule does.
      Type The type of data migration that this rule can be used for.
      Case-sensitive pattern checks To specify case-sensitive rule checking, fill this check box.
      Include Criteria To migrate inactive files from a specified directory to a secondary file system:
      1. In the All files named field, enter the file name extension of the files to be migrated. For example note.txt, note*, or mp3.
      2. In the All files not accessed within___ field, enter the threshold quantity.
      3. Select the period from the list. You can choose days, hours, or minutes.
    • If you select By Path and Last Access, the Data Migration Rule: Last Access Time and Path Template page contains the fields described in the following table:
      Item/Field Description
      Name Enter a name for the new rule. The rule name can include only alphanumeric characters, hyphens, and underscores.
      Description Enter a description of what the rule does.
      Type The type of data migration that this rule can be used for.
      Case-sensitive pattern checks To specify case-sensitive rule checking, fill this check box.
      Include Criteria To migrate inactive files from a specified directory to a secondary file system:
      1. In the All files in the Path field, enter the directory file path.
      2. In the All files not accessed within___ field, enter the threshold quantity.
      3. Select the period from the list. You can choose days, hours, or minutes.
  4. Verify your settings, then click OK to save or cancel to decline.

Adding a data migration rule for the Data Migrator to Cloud

This page can be used to name, define, add, and modify Data Migration Rules using rule syntax. Rules can be built with a series of INCLUDE and EXCLUDE statements. Each of these statements can contain a number of expressions specifying the type of files and the conditions under which they will be migrated.

For example:

INCLUDE (<FILENAME *.mp3> AND <FILE_SIZE_OVER 2GB>)

Procedure

  1. Navigate to Home Storage Management Data Migration Rules to display the Data Migration Rules page and then click add.

    GUID-5237529B-B5E0-4B90-9162-8A67C06DEE4B-low.png

    The following table describes the fields on this page:

    Item/Field Description
    Name Enter a name for the new rule. The rule name can include only alphanumeric characters, hyphens, and underscores.
    Description Enter a description of what the rule does.
    Type

    Click the appropriate option, either WFS/HNAS or Cloud.

    Case-sensitive pattern checks To specify case-sensitive rule checking, select this check box.
    Rule Definition Insert the syntax for the data migration rule.
    NoteFor Data Migrator to Cloud only, files that are 4,096 bytes or less will not be migrated.
  2. Verify your settings, then click OK to save the rule, or click cancel to decline.

    For Data Migrator to Cloud only, note that files that are 4,096 bytes or less will not be migrated.

Modifying a data migration rule

You can modify a data migration rule in the NAS Manager.

  1. Navigate to Home Storage Management Data Migration Rules.

  2. Select the check box next to the rule to modify and then click details.

    The following table describes the fields on this page:

    Field/Item Description
    Name Displays the name of the rule.
    Description The description of the rule. Make any changes as appropriate.
    In Use by Policies Displays any associated policies in use for this policy. If none are used, displays 'Not in use.'
    Type Displays the type of rule, either Cloud or WFS/HNAS.

    Case-sensitive pattern checks

    Select the check box if the rule checking must be case sensitive.
    Rule Definition Displays the current definition in use. Modify if necessary.
  3. Make updates as necessary.

  4. Click OK.

 

  • Was this article helpful?