HubStor Inc.

How to Use the HubStor Export Utility (for Admins)

To download the HubStor Export Utility, see DOWNLOAD THE HUBSTOR EXPORT UTILITY.
To install and configure the HubStor Export Utility, see INSTALL AND CONFIGURE THE HUBSTOR EXPORT UTILITY.

Assuming you have the required authorization and have successfully downloaded and installed the HubStor Export Utility, follow these steps to perform an Admin export:

Connect the Export Utility

Provide your work email address (or the email address that was used to share content with you) then click 'Next'. You will be prompted to authenticate with your password.
NOTE: If you are an external user and content has been shared with you, your email address must be configured as a Microsoft account for authentication to work.

Configure the Export


Export Mode

You could have the following 'Export Mode's available depending on your accounts permissions.
  1. Admin - This KB.
  2. End User - for more details see HOW TO USE THE HUBSTOR EXPORT UTILITY (FOR USERS).
  3. Discovery Case - for more details see HOW TO USE THE HUBSTOR EXPORT UTILITY TO EXPORT DISCOVERY CASES.

Export From

  1. Click the ellipse button and select the Stor and location of the data to export.
  2. Depending on your specific configuration you may have more than one 'Stor' to select from.

Note: You can right-click a selected node to apply a filter. This is very useful when you have many connectors or locations available. For more information see HOW TO FILTER LOCATIONS IN THE EXPORT UTILITY.
  1. Once you've selected your desired export location click 'Ok' to proceed.

Export What

Define the scope of the export. Your options are:
  1. All Items - To export all times from the 'Export From' location.
  2. Specified Items - To select individual items for restore.

  3. Items Meeting Metadata Filter
    Click 'Add Filter' and select a Policy Filter type.

    Your options are:
  4. MetadataAge

    The date fields allow for age types of 'Older Than' or 'Younger Than' and select values in Months or Days.
    1. LastModified
    2. Created
    3. LastAccessed
  5. MetadataRange
    Allows you to specify the same criteria as MetadataAge while adding a 'Range Start' and or a 'Range End' as a date range.
  6. MetadataSpecificValue

    Select your 'Metadata Field' from the dropdown and 'Add Value' to specify the value according to the field. You can continue to 'Add Filter' to specify additional metadata. Select whether to AND or OR your Filters Allows you to specify the same criteria as MetadataAge as well as:
  7. TotalBlobSizeKB - Numeric value in kilobytes.
  8. ItemType - Item type can use regex or wildcards. It needs to include the dot before the extension.
    Example: For Example.doc these all are true.
    .doc
    .do*
    regex: ^\..oc$
  9. StorageTier - Value identifying the Tier (Hot, Cool, or Archive).
  10. RemovedFromSource - Flag identifying where the Connector Service has detected the item has been removed from the source location.
  11. FolderPath - Export items with a specific folder name and/or path. Can use regex or wildcards.
    Example:
    *\Data*

Export To



Your options are:
  1. Azure Blob Storage
    Click the ellipsis button and provide the 'Connection String', 'Container Name' and 'Root Path' of the Blob Storage location.
  2. File Folder
    Click the ellipsis button and provide the 'Destination Path.'
  3. Single Mailbox
    Click the ellipsis button and provide the 'Exchange Connection', 'Mailbox SMTP', and 'Mailbox Type'.
    Optionally you can choose a 'Folder Path', 'Suppress Duplicates', 'Only Restore Regular Sent Messages', 'Merge 'Active Mailbox' Folder', and 'Suppress Unsupported Item Classes.'
  4. User Mailboxes
    Click the ellipsis button and select your 'Exchange Connection.'
    Optionally you can choose to 'Suppress Duplicates', 'Only Restore Regular Sent Messages', 'Merge 'Active Mailbox' Folder', and 'Suppress Unsupported Item Classes.'
    Mappings should be automatically created, alternatively: Select 'Add Mapping' or 'Update Mapping' to map locations to mailboxes.
  5. Single PST
    Select a 'Destination Path' and provide a 'PST File Name.'
    Optionally you can choose to 'Suppress Duplicates' in the export.
    Click 'Ok' to save.
  6. User PST
    Select a 'Destination Path' for the individual user PST files to be created.
    Optionally you can choose to 'Suppress Duplicates' in the export.
    Mappings should be automatically created, alternatively:
    Select 'Add Mapping' or 'Update Mapping' to map locations to PST files.
  7. Single SharePoint Site Collection
    Click the ellipsis button and provide the 'SharePoint Connection

Restore Type


Your options are:
  1. Original Item
  2. Link-Based Stub
  3. Seamless Stub
    Note: For more information on stub formats see OVERVIEW OF STUBBING OPTIONS.

Admin Export Mode


  1. All - Exports/recovers the latest version for all items. If 'Restore Stubs' is enabled, any stubs that are output will recall the latest item version.
  2. All (Point-In-Time) - Provide a date and time. Exports/recovers the most recent item versions prior to the selected point-in-time. If 'Restore Stubs' is enabled, any stubs that are output will recall the item version that meets the point-in-time criteria.
    Note: Point-in-time recovery is handy for recovering from ransomware attacks.
  3. Specific Range - Provide either a Range Start or Range End or both. Exports/recovers only those items for which there exists a version between the selected start and end dates. The item version dates are based on when it was archived into HubStor. Only item versions with archive dates between the range start and end are included in the scope (their latest version from within range start and end will be restored (or a stub for that version if 'Restore Stubs' is enabled)).
    Note: This feature can be used for rapid recovery times without incurring heavy cloud data transfer fees and impact on your network. For more information, see HOW TO PERFORM EFFICIENT FILE SERVER RECOVERY WITH HUBSTOR.

Advanced Settings

Are optional, and include:
  1. Include Manifests - If enabled, creates an XML manifest file for each file in the directory. This is true even if the file or stub already exists -- if HubStor has the file in the cloud and a manifest is not present in the directory for the item then one will be created.
  2. Restore ACLs - If enabled, restores the security ACLs for any file or stub that is exported/recovered.
  3. Force Overwrite - If enabled, instead of a merge, any file already in the directory that also has a file/stub in the export/recovery scope will be replaced. This option can lead to data loss since it will remove content in the destination that may not yet be captured into HubStor as a new item version.
  4. Enhanced Metadata Restore - If enabled, exported last modified dates are accurate to the second. This option is resource intensive. With this option disabled, exported last modified dates are accurate to the minute.
  5. Metadata Export - Export a file containing metadata of the exported items.
    1. None
    2. HSMetadataXml - Metadata is exported per item. In each directory where items are restored there is an accompanying file named [filename.ext].hsmetadata.xml that contains any additional metadata for that item.
    3. CSV - Metadata is exported per directory. In each directory where items are restored there is an accompanying file named hsmetadata.csv that contains any additional metadata for all restored items.
  6. Prune Empty Folders - If enabled, empty folders are not created during the restore.
  7. Remove Linked-Based Stubs - If enabled, any file that is restored and which has a Linked-Based stub file in the directory will have the Linked-Based stub removed when the original file is restored. This setting is only needed when Linked-Based stubs exist.
  8. Remove Html Stubs - If enabled, any file that is restored and which has an HTML stub file in the directory will have the HTML stub removed when the original file is restored. This setting is only needed when HTML stubs exist.
  9. Suppress 'Removed From Source' Content - Items that have been detected as being removed from source are not restored. This is useful when restoring stubs.
  10. Remove Offline Attribute from Non-Stubs - This will find any files that are offline but not reparse points and remove the offline attribute. This is useful when certain applications trigger a restore but the offline attribute is not removed.

Run the Export

As the export runs, you will be able to see its progress.

When the export completes, you can run another export by clicking the 'Run Another Export' button.

Access the Export

Navigate to the output location you configured for your export and you should see the original folder structure recreated with the selected items.



    • Related Articles

    • Overview of the HubStor Export Utility

      HubStor makes it easy to perform bulk extraction from the cloud archive. This article provides information and examples around the various export scenarios. NOTE: Export will only work for users with sufficient permissions. For more information on ...
    • How to Export Mailbox Data

      This article will walk through the process of Exporting Mailbox Data.   Step 1 -- Launch the Export Utility   For instructions on where to download the utility, see the following article: Download the HubStor Utility For additional information on ...
    • How to Configure Export Utility Permissions

      Export Utility permissions are configured in the HubStor Admin Portal. This article discusses the specific permissions necessary for different export scenarios. For general instructions on configuring permissions, see HOW TO USE HUBSTOR'S ROLE BASED ...
    • How to Perform Efficient File Server Recovery with HubStor

      Traditionally, backup systems will make a copy of whatever is on the source system, and in a recovery scenario, the backup system will recover the full copy onto the source system. However, source systems (in this case, enterprise file systems) are ...
    • How to Use the HubStor Export Utility (For Admins) to Restore a Mailbox, Folder, or Messages to Exchange

      For more information on the HubStor Export Utility, see HOW TO USE THE HUBSTOR EXPORT UTILITY (FOR ADMINS). Assuming you have the required authorization and have successfully downloaded, installed the HubStor Export Utility, follow these steps to ...