Tzunami HCP Exporter enables migrating HCP content into SharePoint 2007, SharePoint 2010, SharePoint 2013, SharePoint 2016, and SharePoint Online using Tzunami Deployer.
To load HCP content into Tzunami Deployer, you must first extract the content, using Tzunami HCP Exporter, into TDX (Tzunami Deployer Export) and STDX (Separate Tzunami Deployer Export) files. You can then load this TDX file into a Deployer project.
Note | When working with Tzunami Deployer on several machines, you can run an export on one machine and load the exported data on another. Tzunami HCP Exporter is distributed as an external tool from Tzunami Deployer. |
Supported Types
The following items are exported from HCP:
- Namespace
- Folder
- Document (including Versions)
Security
In addition to the structure and items, Tzunami HCP Exporter extracts security information. The following permissions are used in the exporter:
- Browse
- Read
- Write
- Delete
- Purge
- Privileged
- Search
- Read ACL
- Write ACL
- Change Owner
- None
Each item is assigned an ACL defining the permissions of the various members according to the roles they were assigned.
Exporting from HCP
The Tzunami HCP Exporter enables you to export HCP content to a TDX file.
When exporting, keep the following in mind: Export in small chunks: When exporting from your source system, perform the export in small chunks of about 40K-50K files each that have a common business logic or some other logic. Ensure consistency: Make sure that the content of the different exports does not overlap and that, while exporting, no changes are made to the source data. |
To export to a TDX file:
1. Run the Tzunami HCP Exporter from installation location or Start menu.
(e.g. C:\Program Files (x86)\Tzunami\Deployer 3.2\Exporters\HCP\TzunamiExporter.exe)
Or
In Tzunami Deployer, Right-Click in the HCP tab source storage area and select Export HCP to TDX.
The Welcome screen of the Export Wizard appears.
Fields | Description | ||
Extract files into file system (otherwise files will be extracted during commit) | Check this option if you wish to download the binary files from HCP server to the file system and store them in the FileStore folder, in the same location as the TDX file. If this option is unchecked, no files are downloaded at the export stage. The files are only downloaded when they are needed, in the commit stage.
|
2. Click Next. The HCP Configurations screen appears with three tabs: Credentials, General, and Advanced.
3. Click the Connection tab and enter the information required for the exporter to connect to HCP.
Fields | Description |
Namespace Url | Enter the URL of a namespace. |
Username | Enter the username to use when connecting to the Namespace. |
Password | Enter the password to use when connecting to the Namespace. |
Remember password | Check this option if you wish to save your password for next login |
4. Click the General tab and enter general export information.
Fields | Description | ||
Export Security | Check this option if you wish to export the security permissions of items | ||
Export Versions | Check this option if you wish to export all versions of documents.
| ||
Export Custom Metadata | Check this option if you wish to export Custom Metadata assigned the document |
5. Click Next. The Folders screen appears.
6. Select the folder(s) to export.
NOTE | You can select all subfolders of a selected folder by checking Automatically select subfolders. |
7. Click Next. The Filter screen appears.
8. Set up filtering as follows:
a. In the Properties field, select a property.
b. In the Condition field, select a condition from the dropdown list and enter or select values in the corresponding field.
c. Click Add Condition. The condition is added to the Filter area, displaying the full filter expression.
NOTE | You can only add one condition per property. You can edit a condition for a property by selecting the property and modifying the condition type or values that are currently assigned to it. You can remove a condition from a property or all the conditions from all the properties by clicking Clear Condition or Clear All, respectively. For example, if ‘Ingested’ property is applied in the filter, the item(s) will be filtered based on the valid condition(s) from ‘Ingested’ property. |
9. Click Next. The Destination Folder screen appears.
10. Click Next.
NOTE | If the export folder already exists, a warning appears, informing you that the destination folder already exists and if you continue all existing information will be deleted. Clicking OK confirms overwrite and clicking Cancel returns you to the Destination Folder screen to change the destination folder. |
NOTE | You can save the export report by clicking Save As… after the export is complete. You can display only export errors and warnings by checking Errors only. You can check Auto-scroll to display the latest progress messages, as they appear. |
11. Click Next. The Export Complete screen appears.
12. Click Done. The Tzunami HCP Export wizard is closed.
If the exporter was run from Tzunami Deployer, after the extraction process completes successfully, you are prompted to load the exported data into the current Tzunami Deployer project. Clicking ‘Yes’ begins the process of loading the content from the previously exported TDX file into the project. For more information about loading sources, refer to the Tzunami Deployer User Guide.
You can find the PDF version of this guide here https://www.tzunami.com/download/HCP-ExporterGuide