How to Use the HubStor Export Utility (for Admins)
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
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.
- Click the ellipse button and select the Stor and
location of the data to export.
- Depending on your specific configuration you may
have more than one 'Stor' to select from.
- Once you've selected your desired export
location click 'Ok' to proceed.
Define the scope of the export. Your options are:
- All Items - To export all times from the 'Export From' location.
Items - To select individual items for restore.
Items Meeting Metadata Filter
Click 'Add Filter' and select a Policy Filter type.
Your options are:
The date fields allow for age types of 'Older Than
' or 'Younger Than
' and select values in Months or Days.
Allows you to specify the same criteria as MetadataAge while adding a 'Range Start' and or a 'Range End' as a date range.
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:
- TotalBlobSizeKB - Numeric value in kilobytes.
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.
- StorageTier - Value identifying the Tier (Hot, Cool, or Archive).
- RemovedFromSource - Flag identifying where the Connector Service has detected the item has been removed from the source location.
- FolderPath - Export items with a specific folder name and/or path. Can use regex or wildcards.
Your options are:
- Azure Blob Storage
Click the ellipsis button and provide the 'Connection String', 'Container Name' and 'Root Path' of the Blob Storage location.
- File Folder
Click the ellipsis button and provide the 'Destination Path.'
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.'
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.
Select a 'Destination Path' and provide a 'PST File Name.'
Optionally you can choose to 'Suppress Duplicates' in the export.
Click 'Ok' to save.
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.
Single SharePoint Site Collection
the ellipsis button and provide the 'SharePoint Connection'
- Original Item
- Link-Based Stub
Admin Export Mode
- 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.
(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
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'
Are optional, and 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.
- Restore ACLs - If enabled, restores the security ACLs for any file or stub that is
- 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.
- 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.
- Metadata Export - Export a file containing metadata of the exported items.
- 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
- 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
- Prune Empty Folders - If enabled, empty folders are not created during the restore.
- 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
- 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.
- Suppress 'Removed From Source' Content - Items that have been detected as being removed from source are not restored.
This is useful when restoring stubs.
- 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.
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 ...