Skip to main content

We've Moved!

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

Hitachi NAS Universal Migrator Console Commands

This section lists the Hitachi NAS Universal Migrator console commands. See the man pages for more details about a specific command options.

virtualization-license-report CLI command

Lists the amount of data currently virtualized by all virtualization paths.

virtualization-path-control CLI command

Controls the background processing of files for the virtualization path for the specified target vivol/volume.

virtualization-path-create CLI command

This command creates a virtualization path association between a remote NFS export source and a local file system, vivol or directory target.

To ensure data can be managed correctly between the Legacy NAS and the HNAS, it is recommended that the mount on the Legacy NAS is exported with rw, sync, no_subtree_check, no_root_squash. It is also advised that, due to no_root_squash, the mount is available only to the HNAS.

virtualization-path-delete CLI command

This command deletes a virtualization path association between a remote NAS NFS export source and a local file system or vivol target.

virtualization-path-excluded-directory-add CLI command

This command adds an excluded directory to the virtualization path association between a remote NFS export source and a local file system, vivol or directory target.

This command can be applied while the association has created, but the virtualization has not been started.

virtualization-path-excluded-directory-delete CLI command

This command deletes an entry from the list of directories to be excluded from the virtualization path association between a remote NFS export source and a local file system, vivol or directory target.

This command can only be applied once the association has been created but the virtualization has not yet started.

virtualization-path-excluded-directory-list CLI command

This command shows a list of the excluded directories registered to the virtualization path association between a remote NFS export source and a local file system, vivol or directory target.

virtualization-path-files CLI command

This command lists all files and directories that have failed to virtualize correctly. It allows these to be retried as well. Retries, for individual files, can also be achieved by requesting them as normal, through an 'ls' command.

virtualization-path-journal-control CLI command

This command manages journal of files deleted from remote server for a virtualization path association.

virtualization-path-journal-show CLI command

This command displays a journal of files deleted from remote server for a virtualization path association.

virtualization-path-list CLI command

This command lists all NAS virtualization path associations defined for the specified file system or for all file systems if the -a or --all option is used.

virtualization-path-modify CLI command

This command changes the source URI associated with a pre-existing virtualization path that is mapped to a local file system, vivol or directory target.

This command will change the location that data is received from when scanning for entries to virtualize. After virtualization process has started changes by virtualization-path-modify command are no longer allowed. To change the source in such case the virtualization path needs to be deleted and created again.

virtualization-path-stats CLI command

This command displays statistics associated with NAS virtualization paths, detailing the amount and time taken by the migration since the statistics were last reset, or start-up, whichever is the most recent.

Control via SMU GUI

At the time of writing there is no GUI support for the feature.

Formatting file systems

CautionFormatting a file system from the CLI that contains a virtualization path will prompt you to delete the virtualization path. However, if the SMU is used to format a file system that contains a virtualization path, there will be no prompt. Therefore, it is important to remember to delete the virtualization path for a file system before formatting through the SMU.

 

  • Was this article helpful?