Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Open the DrTool using an administrative command prompt to change the location a stub is to be restored.
    By default the location for the drtools.exe is C:\Program Files\Caringo FileFly\AdminTools\DrTool\

  2. Opening the drtool.bat with the -help flag displays all options:

  3. Specify the -csu flag to change the source location. Use this format: win:\\FQDN\path in FileFly syntax

    • Same Server — Moving a stub from a dead disk or to a new, preferred partition on the same server:

      Code Block
      drtool.bat -csu win://fileflyagent.testdomain.com/E/share1/example%20directory%20with%20spaces/ win://fileflyagent.testdomain.com/E/restoredhere/ "C:\drtools\drtool.txt"
      Image Modified
    • New Server — Change the FQDN to change the server the stubs are restored to.

      Code Block
      drtool.bat -csu win://fileflyagent.testdomain.com/E/share1/example%20directory%20with%20spaces/ win://fileshare.testdomain.com/E/restoredhere/ "C:\drtools\drtool.txt"
      Image Modified
      Info
      titleRequired

      The server that you are restoring must be a migration agent with connection to Swarm

  4. Press return if the path substitutions are correct and the DrTool UI opens.

  5. The URI substitutions appear highlighted in blue. Hover over an entry to check the details, and check Show Full URIs to view the paths where the stubs restore to:

  6. Right-click and select Create Stub... to restore the links to the files in the new location if the path looks correct.

  7. Choose the Create Stub Option:

    Image Modified
    • Update source URLs in secondary storage files — This default option updates the object in Swarm so the new path is reflected.

    • Force destination to use Write Once Read Many — This excludes the recreated file from scrub policies.

  8. Select OK. The stub files are created in the new location and linked to the storage files.

  9. Shift-click individual files in the DrTool if a small subset of stubs needs to be re-created; otherwise, run the DrTool.bat command with the -recreateStubs option before the DrTool file.
    Create the stubs automatically without performing steps 6-8:

    Code Block
    languagebash
    drtool.bat -csu win://fileflyagent.testdomain.com/E/share1/example%20directory%20with%20spaces/ win://fileshare.testdomain.com/E/restoredhere/ -recreateStubs "C:\drtools\drtool.txt"

    Best practice

    1. Verify the process/path with steps 6-8 for a single file.

    2. Run the DrTool.bat command again with the flag to re-create all stubs once verified.

  10. IMPORTANT: Update the Sources tab to reflect this new location if the source location (where your content lives on the migration agent server) changes. The Source is broken (assuming the root folder is deleted when performing step 11) if this is not performed.
    Change the Source from "win://fileflyagent.testdomain.com/E/share1/example%20directory%20with%20spaces/" to "win://fileflyagent.testdomain.com/E/restoredhere/" In the example above.

  11. Delete stubs from the original source location if present.

Info

Important

If your stub files have not been deleted, they will remain active in the original location also, which can be problematic, as a deletion of one stub may mean that the other becomes inactive unexpectedly due to a scrub policy being run.

...