Monitoring Migration Progress and Errors (CLI)

1. Go to a filesystem with shadow migration source and enter shadow, and then enter list.

   hostname:shares default/file_sys1> shadow
   hostname:shares default/file_sys1 shadow> list
   Properties:
                           source = nfs://zfs0000-15/sm/errors
                      transferred = (unset)
                        remaining = 1.37G
                          elapsed = 0h3m
                           errors = 23
                         complete = true
                             time = (unset)
   
   Children:
                              errors => Shadow Migration Errors
   hostname:shares default/file_sys1 shadow>

   ---

   Note -  If there is no shadow migration source defined shadow=none, then the shadow command is invalid for the filesystem:

   hostname:shares default/xyz_1> shadow
   error: invalid command "shadow"

   ---

2. To view shadow migration errors, enter child node errors and enter help to view a list of subcommands.

   hostname:shares default/file_sys1 shadow> errors
   
   hostname:shares default/file_sys1 shadow errors> help
   
   Subcommands that are valid in this context:
   
      help [topic]         => Get context-sensitive help. If [topic] is specified,
                              it must be one of "builtins", "commands", "general",
                              "help" or "script".
   
      show                 => Show information pertinent to the current context
   
      done                 => Finish operating on "errors"
   
      select [entry]       => Select the specified entry to get its properties,
                              set its properties, or run a subcommand
   
      list                 => Lists up to the first 100 errors. The "-a" option may be
                              used to list all the errors if there are more that 100
   						   errors. The "-number" option may be used to list the first
   						   (number) of errors. Format: list -a or list -xx
   

3. Enter show to view individual migration errors in the current context.

   hostname:shares default/file_sys1 shadow errors> show
   Errors:
   
   PATH                             REASON
   ak-2013-dev-on-clone.tar.gz     Permission denied
   test_dir/CREDITS.html           Permission denied
   test_dir/CREDITS_ja.html        Permission denied
   test_dir/CREDITS_pt_BR.html     Permission denied
   test_dir/CREDITS_zh_CN.html     Permission denied
   test_dir/DISTRIBUTION.txt       Permission denied
   test_dir/LEGALNOTICE.txt        Permission denied
   test_dir/LICENSE.txt            Permission denied
   test_dir/README.html            Permission denied
   test_dir/README_ja.html         Permission denied
   test_dir/README_pt_BR.html      Permission denied
   test_dir/README_zh_CN.html      Permission denied
   test_dir/THIRDPARTYLICENSE.txt  Permission denied
   test_dir/bin                    Permission denied
   test_dir/cnd2                   Permission denied
   test_dir/etc                    Permission denied
   test_dir/gsf1                   Permission denied
   test_dir/ide10                  Permission denied
   test_dir/modCluster.properties  Permission denied
   test_dir/nb6.5                  Permission denied
   test_dir/forms.css              Permission denied
   test_dir/platform9              Permission denied
   test_dir/websvccommon1          Permission denied

4. To view an individual error, enter the select command and an individual error name. Then enter show.

   To view individual error properties, use the get command.

   hostname:shares default/file_sys1 shadow errors> select test_dir/nb6.5
   
   hostname:shares default/file_sys1 shadow errors test_dir/nb6.5> show
   Properties:
                             path = test_dir/nb6.5
                           reason = Permission denied
   
   hostname:shares default/file_sys1 shadow errors test_dir/nb6.5> get path
                             path = test_dir/nb6.5
   hostname:shares default/file_sys1 shadow errors test_dir/nb6.5> get reason
                           reason = Permission denied
   hostname:shares default/file_sys1 shadow errors test_dir/nb6.5> done
   hostname:shares default/file_sys1 shadow errors>