Tzunami Deployer LiveLink Exporter Guide
Supports migration of LiveLink contents into Microsoft SharePoint using Tzunami Deployer
Version 3.3
Page | II
Table of Contents
PREFACE ................................................................................................................................................................IV
INTENDED AUDIENCE............................................................................................................................................ IV
CONVENTIONS .................................................................................................................................................... IV
TECHNICAL SUPPORT ............................................................................................................................................. V
COMMENTS AND SUGGESTIONS............................................................................................................................... V
1 INSTALLING TZUNAMI LIVELINK EXPORTER ................................................................................................ 1-1
1.1 SYSTEM REQUIREMENTS ........................................................................................................................... 1-2
1.2 INSTALLING TZUNAMI LIVELINK EXPORTER ................................................................................................... 1-3
1.3 UNINSTALL TZUNAMI LIVELINK EXPORTER .................................................................................................... 1-5
1.3.1 Uninstallation using Installer................................................................................................. 1-5
1.3.2 Uninstallation using Control Panel ........................................................................................ 1-6
2 TZUNAMI LIVELINK EXPORTER .................................................................................................................... 2-7
2.1 OVERVIEW ............................................................................................................................................. 2-8
2.1.1 Supported Types ................................................................................................................... 2-8
2.1.2 Supported Types of Community of Practice (COP) module .................................................. 2-8
2.1.3 Security ................................................................................................................................. 2-9
2.1.4 Nested Groups .................................................................................................................... 2-10
2.1.5 Credentials .......................................................................................................................... 2-11
2.2 EXPORTING FROM LIVELINK ..................................................................................................................... 2-11
2.3 COMMAND-LINE EXPORT ........................................................................................................................ 2-23
2.4 BEST PRACTICE ..................................................................................................................................... 2-24
3 LICENSING INFORMATION ......................................................................................................................... 3-26
4 ANNEX ........................................................................................................................................................ 4-27
4.1 EXPORT ADDITIONAL DOCUMENT METADATA DIRECTLY THROUGH DATABASE................................................... 4-27
5 COPYRIGHT AND TRADEMARK .................................................................................................................. 5-29
Page | III
List of Tables
Table 1-1: Hardware Requirements ................................................................................................ 1-2
Table 2-1: Web Server Requirements for HTTP Tunneling ............................................................. 2-11
Table 2-2: LiveLink Server and Port Definitions ............................................................................. 2-12
Table 2-3: LiveLink Exporter, Welcome screen - Description of fields ............................................ 2-13
Table 2-4: LiveLink Configurations, Web Settings Tab – Description of Fields ................................ 2-14
Table 2-5: LiveLink Configurations, Items Tab - Description of fields ............................................. 2-15
Table 2-6: LiveLink Configurations, Advanced Tab - Description of fields ....................................... 2-16
Table 2-7: LiveLink Configurations, Roots Tab - Description of fields ............................................. 2-17
Table 2-8: LiveLink Configurations, DB Settings Tab - Description of fields .................................... 2-18
Table 2-9 Analyzer Information Description .................................................................................. 2-19
Table 2-10: Target Structure Guidelines ........................................................................................ 2-24
List of Figures
Figure 1-1: Welcome Window ........................................................................................................ 1-3
Figure 1-2: End-User Licensing Agreement...................................................................................... 1-3
Figure 1-3: Custom Setup Window.................................................................................................. 1-4
Figure 1-4: Installing Tzunami LiveLink Exporter Window ................................................................ 1-4
Figure 1-5: Installation Complete Window ...................................................................................... 1-5
Figure 2-1 Nested Groups Export (Enabled) .................................................................................. 2-10
Figure 2-2 Nested Groups Export (Disabled) ................................................................................. 2-10
Figure 2-3: LiveLink Exporter Wizard – Welcome screen ............................................................... 2-13
Figure 2-4: LiveLink Configurations Screen – Web Settings Tab ..................................................... 2-14
Figure 2-5: LiveLink Configurations Screen – Items Tab ................................................................. 2-15
Figure 2-6: LiveLink Configurations Screen – Advanced Tab .......................................................... 2-16
Figure 2-7: LiveLink Configurations Screen – Roots Tab ................................................................. 2-17
Figure 2-8: LiveLink Configurations Screen – DB Settings Tab ........................................................ 2-18
Figure 2-9 Analyze Option ............................................................................................................ 2-19
Figure 2-10 Analyzer Information ................................................................................................. 2-19
Figure 2-11 Folders Selection Screen ............................................................................................ 2-20
Figure 2-12: Filter Screen .............................................................................................................. 2-20
Figure 2-13: Destination Folder Screen ......................................................................................... 2-21
Figure 2-14: Export Progress Screen ............................................................................................. 2-22
Figure 3-1: License Update window .............................................................................................. 3-26
Figure 4-1 Property Query Settings in Configuration file: Locate ................................................... 4-27
Figure 4-2 Property Query Settings in Configuration file: Set Key-Value ........................................ 4-28
Figure 4-3 Property Query Settings in Configuration file: Update Query ........................................ 4-28
Page | IV
PREFACE
This guide provides installation procedures for Tzunami LiveLink Exporter and detail steps to
extract contents from LiveLink contents using Tzunami LiveLink Exporter. The guide also
describes how to extract contents non-interactive way using command-line instructions and
best practice.
This preface contains the following topics.
• Intended Audience
• Conventions
• Technical Support
• Comments and Suggestions
INTENDED AUDIENCE Tzunami LiveLink Exporter Guide is intended for:
• System Administrators who are responsible for exporting LiveLink contents and
setting migration environment using Tzunami Deployer.
• Project Managers and IT Managers who create and regulate usage of Tzunami
Deployer and Tzunami LiveLink Exporter.
CONVENTIONS The following text conventions are used in this document:
• Commands and keywords are given in boldface
• Terminal sessions, console screens, or system file names are displayed in fixed width
fonts
Caution indicates that the described action might result in program malfunction or data loss.
Notes contain helpful suggestions about or references to materials not contained in this
manual.
Tips provide information that might help you solve a problem.
Page | V
TECHNICAL SUPPORT Before contacting Tzunami Support team, ensure that you are referencing the latest copy of
this user guide (Ctrl+Click to follow link) Tzunami Deployer LiveLink Exporter Guide.
For more information, please contact Tzunami Support Team at [email protected]
COMMENTS AND SUGGESTIONS Your feedback is important to us and will help us to provide the most accurate and high
quality information possible in our documentation. Send us comments or suggestions by email
to [email protected]. Be sure to include as much of the following as possible:
• The document title.
• The location that the document was accessed from (either downloaded from
Tzunami web site or the Tzunami Deployer User Guide available in Tzunami
Deployer).
• The section or chapter number and the original text found in the document.
When you send information to Tzunami Deployer, you grant Tzunami a non-exclusive right to
use or distribute the information in any way it believes appropriate without incurring any
obligation to you.
Page | 1-1
1 INSTALLING TZUNAMI LIVELINK EXPORTER
This chapter contains information about installing Tzunami LiveLink Exporter. It contains the
following topics:
• System Requirements
• Installing Tzunami LiveLink Exporter
• Uninstall Tzunami LiveLink Exporter
Page | 1-2
1.1 SYSTEM REQUIREMENTS The following requirements must be met in order to use Tzunami LiveLink Exporter:
Table 1-1: Hardware Requirements
Components Minimum Requirements
Computer and processor 2GHz Pentium processor or equivalent
Memory 2 GB (Minimum); 4GB (Recommended)
Hard disk 50Mb (additional space will be required for the Tzunami Deployer projects, which may vary from 10 Mb to 4 GB).
Supported Operating System Windows Server 2000/2003/2008/2012, Windows XP, Windows Vista, Windows 7, Windows 8 & Windows 10.
Supported Architectures x86 and x64
Network Intranet/Internet access depending on connectivity requirements
Display 800 x 600, 256 colors (minimum); 1024 x 768 high color, 32-bit (recommended)
Microsoft .NET Framework Microsoft .Net Framework 2.0
Additional Requirements LiveLink server configured and running
Page | 1-3
1.2 INSTALLING TZUNAMI LIVELINK EXPORTER Tzunami LiveLink Exporter requires that the latest version of Microsoft Visual J#
Redistributable Package is installed and configured on the machine that is used to run the
exporter. The latest version can be downloaded from Microsoft at
http://msdn.microsoft.com/en-us/vjsharp/bb188598.aspx.
To install Tzunami LiveLink Exporter:
1. Unzip the zip file, and run Tzunami LiveLink Exporter Tool Setup.msi. The Tzunami LiveLink Exporter setup wizard (Welcome window) will launch. To advance through the install wizard, click Next on the bottom of the window.
Figure 1-1: Welcome Window
2. In the End-User Licensing Agreement panel, click “I accept the terms in the License
Agreement” and click Next to continue installation.
Figure 1-2: End-User Licensing Agreement
Page | 1-4
You are advised to read the terms of the license carefully before proceeding with the installation. If you decline the license terms, the installation cannot proceed.
3. In the Custom Setup panel, do one of the following:
• To accept the default Destination Folder, click Next.
• Click Browse, locate and select a destination folder, click OK, and then click Next.
Figure 1-3: Custom Setup Window
4. In the Ready to install Tzunami LiveLink Exporter panel, click Install.
Figure 1-4: Installing Tzunami LiveLink Exporter Window
Page | 1-5
5. In the Completed Tzunami LiveLink Exporter Setup Wizard, to exit the wizard, click Finish.
Figure 1-5: Installation Complete Window
When Tzunami LiveLink Exporter is installed, it comes with a default license that can be used for evaluation purpose only. This license is limited in time and number of operations.
1.3 UNINSTALL TZUNAMI LIVELINK EXPORTER This section of the guide illustrates different ways to remove or uninstall Tzunami LiveLink
Exporter from your LiveLink Server. Here are the two different ways to uninstall Tzunami
LiveLink Exporters:
• Uninstallation using Installer
• Uninstallation using Control Panel
To uninstall Tzunami LiveLink Exporter, user needs to be a Local Administrator in the LiveLink
Exporter installed machine. Uninstalling Tzunami LiveLink Exporter is simple and easy. You
can remove or uninstall it in no time. You don’t need to reboot your computer once the
uninstalling process is complete.
Log files, licensing information files etc. will remain after uninstalling Tzunami LiveLink
Exporter. You can manually delete those files from your computer if needed. By default logs
are located at the “C:\Program Files\Tzunami\Deployer 3.3\Exporter\Logs”, or where
Tzunami LiveLink Exporter is installed. Tzunami LiveLink Exporter Options information will be
available in “C:\Documents and Settings\All users\Application Data\Local\Tzunami” location.
1.3.1 Uninstallation using Installer
To uninstall Tzunami LiveLink Exporter using Installer
Page | 1-6
1. Close Tzunami LiveLink Exporter.
2. Unzip the zip file, and run Tzunami LiveLink Exporter Setup.msi. The Tzunami
LiveLink setup wizard (Welcome window) will launch. To advance through
the remove installation wizard, click “Next” at the bottom of the screen.
3. In the Change, repair or remove installation panel, click “Remove” button to
proceed to remove Tzunami LiveLink Exporter from your computer.
4. In the Ready to remove Tzunami LiveLink Exporter panel, click “Remove” to
remove Tzunami LiveLink Exporter from your computer.
5. Click Finish to exit the setup wizard.
You can right-click Tzunami LiveLink Exporter setup (Tzunami LiveLink Exporter Setup.msi) file
and select Uninstall to remove or uninstall Tzunami LiveLink Exporter from your computer.
1.3.2 Uninstallation using Control Panel
To uninstall Tzunami LiveLink Exporter using Control Panel
1. Close Tzunami LiveLink Exporter.
2. Click Start > Control Panel > Add or Remove Programs.
3. In Add or Remove Programs window, right-click the Tzunami LiveLink
Exporter application you want to remove, and then click Uninstall.
Page | 2-7
2 TZUNAMI LIVELINK EXPORTER
This chapter contains information about Tzunami LiveLink Exporter. It contains the following
topics:
• Overview
• Exporting from LiveLink
• Command-line Export
• Best Practice
Page | 2-8
2.1 OVERVIEW Tzunami LiveLink Exporter enables migrating LiveLink content into SharePoint 2007,
SharePoint 2010, SharePoint 2013, SharePoint 2016, SharePoint 2019 or SharePoint Online
using Tzunami Deployer.
To load LiveLink content into Tzunami Deployer, you must first extract the content, using
LiveLink Exporter, into TDX (Tzunami Deployer Export) and STDX (Separate Tzunami Deployer
Export) files. You can then load this TDX file into a Deployer project.
When working with Deployer on several machines, you can run an export on one machine and load the exported data on another.
Tzunami LiveLink Exporter is an extension module of Tzunami Deployer. You can work with this module independently of Tzunami Deployer.
2.1.1 Supported Types
The following items are exported from LiveLink:
• Enterprise Workspaces
• Discussions (Topics and Replies)
• Tasks (Tasks Lists, Tasks Groups, and Tasks) and Milestones
• Channels and News
• Projects
• Folders
• Documents, Text Documents, and Compound Documents
• Links
• Aliases
• Email Volume’s
• Binders
• Generations
• Record Management
2.1.2 Supported Types of Community of Practice (COP) module
The following items are exported from LiveLink COP module:
• Community
• Library
• Mail Archive
Page | 2-9
• Blog
• Blog Entry
• Blog Comment
• FAQ
• FAQ Entry
• Forum
• Forum Topic
• Email Folder
If any of these items have attachments, the exporter scans them, looking for Documents and
Text Documents, and exports them as well. When the item is deployed to SharePoint, it is
deployed together with its attachments.
Compound Documents and Tasks Groups are converted to Folders.
2.1.3 Security
In addition to the structure and items, Tzunami LiveLink Exporter extracts security
information. The following permissions are used in the exporter:
• See
• See Content
• Modify
• Edit Attributes
• Delete Versions
• Add Items
• Delete
• Reserve
• Edit Permissions
• None
Each item is assigned an ACL defining the permissions of the various members according to
the roles they were assigned.
The exporter automatically creates four default roles that are used during the deployment process. The roles include Reader (See and See Content permissions), Contributor (See, See Content, Modify, and Edit Attributes, and Add Items permissions), Web Designer (See, See Content, Modify, Edit Attributes, Delete Versions, Add Items, Delete, and Reserve permissions), and Administrator (user has full permissions).
Page | 2-10
2.1.4 Nested Groups
LiveLink Exporter exports the nested groups as part of ACL item when nested groups are
created and applied in LiveLink items. By default, the key LiveLinkExportNestedGroups is set
to true in TzunamiExporter.exe.config file that enables the Tzunami LiveLink Exporter to
export the nested group as well.
Figure 2-1 Nested Groups Export (Enabled)
The configuration file is located in the exporter installation directory (e.g. C:\Program Files (x86)\Tzunami\Deployer 3.3\Exporters\LiveLink)
Since, target SharePoint does not support the nested groups (SharePoint supports groups in
flat structure only), Tzunami Deployer migrates LiveLink groups in flat structure according to
SharePoint’s behavior.
Tzunami Deployer shows the LiveLink Groups (nested as well) under Source Groups panel
during deployment process. User can map LiveLink groups to existing SharePoint groups in
Group mapping wizard or can map to <Create New Group> option that will create groups in
SharePoint automatically (similar to LiveLink groups) post migration.
Tzunami Deployer automatically handles the circular dependency of nested groups when detected.
If user does not want to migrate the nested groups as part of ACL item, then the key
LiveLinkExportNestedGroups need to set false in TzunamiExporter.exe.config file as shown
in the below figure before running the Tzunami LiveLink Exporter.
Figure 2-2 Nested Groups Export (Disabled)
Page | 2-11
2.1.5 Credentials
LiveLink credentials are used for the LiveLink API. These are the same credentials that users
use to log-in in order to access the LiveLink portal.
The account provided to the LiveLink Exporter should have the following LiveLink
permissions:
• Log-in enabled
• System administration rights
HTTP tunneling credentials is used only when the HTTP tunneling option is selected. These
credentials are for the HTTP Web server that performs the tunneling, that is, one of the
front-end web servers of the LiveLink farm.
2.2 EXPORTING FROM LIVELINK The Tzunami LiveLink Exporter enables you to export LiveLink contents 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.
In order to use HTTP tunneling, your Web server must meet the following requirements:
Table 2-1: Web Server Requirements for HTTP Tunneling
Operating System Web Server Communication Web Server Authentication
Windows • ISAPI
• CGI
• Basic
• Anonymous
• NTLM
Solaris CGI • Basic
• Anonymous
HP-UX CGI • Basic
• Anonymous
Using Secure HTTP tunneling is not supported
When the Web server is configured to accept only secure connections (https://), HTTP
tunneling cannot be used. In order to use HTTP tunneling, the Web server should be
configured to accept requests also from non-secure connections (http://).
A proxy server with authentication is not supported.
Page | 2-12
Depending on your connection method, the port and server values may differ according to
the following information:
Table 2-2: LiveLink Server and Port Definitions
HTTP Tunneling
Proxy Server
LiveLink/Front-End/Proxy Server Port
Disabled Disabled The host name or IP address of the LiveLink server. Note that this entry should not contain URL protocol headers, such as http:// or https://.
In a single server installation environment, this should be the same as the host name of the Web server. That is, the host name used to access the LiveLink portal through the Web interface.
The port number on which the LiveLink server listens. The default is 2099.
Enabled Disabled The host name or IP address of the machine on which the Web server is running. Note that this entry should not contain URL protocol headers, such as http:// or https://.
In a single server installation environment, this should be the same as the LiveLink server.
The port number of the Web server (usually 80). If the port number is different, it appears in the URL used to access the LiveLink Portal. For example, http://llserver:888/livelink/livelink.exe.
Enabled Enabled The host name or IP address of the machine on which the Web proxy server is running. Note that in this case the host name and the port number of the Web server used for tunneling is obtained from the LiveLink CGI URL entry.
The port number of the Web proxy server.
To export to a TDX file:
1. In Tzunami Deployer, right-click in the LiveLink tab source store area and select
Export LiveLink to TDX.
Or
Click Start > All Programs > Tzunami > Tzunami LiveLink Exporter.
The Welcome screen of the Tzunami LiveLink Export Wizard appears.
Page | 2-13
Figure 2-3: LiveLink Exporter Wizard – Welcome screen
Table 2-3: LiveLink Exporter, Welcome screen - Description of fields
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 LiveLink 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.
To download files from LiveLink server during commit stage, you must install Tzunami LiveLink Exporter on the Tzunami Deployer installed machine.
2. Click Next. The LiveLink Configurations screen appears. Use this screen to enter the
settings required for the exporter to connect to LiveLink. The screen includes tabs:
Web settings, Items, Advanced and Roots.
a. Web settings
The Web settings tab allows you to enter the information required for
connecting to the LiveLink service.
Page | 2-14
Figure 2-4: LiveLink Configurations Screen – Web Settings Tab
Table 2-4: LiveLink Configurations, Web Settings Tab – Description of Fields
Field Description
LiveLink CGI URL Enter the URL to the LiveLink CGI integration process. For example, http://llserver/livelink/livelink.exe or http://llserver/livelink/llisapi.dll.
This field is used to generate URLs of Aliases for reporting. When running the exporter on multiple LiveLink front-end Web or remote cache servers with the same back-end database, Tzunami recommends that you use the same values in all the exports.
Use HTTP Tunneling Check this option if you wish to use HTTP tunneling.
If you check this option, you must provide HTTP credentials in the HTTP Username and HTTP Password fields.
Use proxy server Check this option if you wish to use a proxy server. This option is only available when you check Use HTTP Tunneling option.
LiveLink/Front-End Web Server/Proxy Server
Enter the hostname of the required server.
The field name changes depending on your entries in the Use HTTP Tunneling and Use Proxy Server options.
Port Enter the port number of the required server, based on your selection of HTTP tunneling and proxy server.
If Use HTTP tunneling and Use proxy server remain unchecked, enter the port number on which the LiveLink server listens.
LiveLink Username Enter the username for the LiveLink user account that has access to the LiveLink server. When using HTTP tunneling, the LiveLink username is case sensitive.
LiveLink Password Enter the password for the account specified in LiveLink Username.
Remember password(s)
Check this option if you wish to save LiveLink password and HTTP password for next login
HTTP Username This field only appears if you select Use HTTP Tunneling. Specify the HTTP username for an account known to the Web server.
Page | 2-15
Field Description
HTTP Password This field only appears if you select Use HTTP Tunneling. Enter the HTTP password for the account specified in HTTP Username.
b. Items tab
The Items tab allows you to specify how the exporter should treat item versions.
Figure 2-5: LiveLink Configurations Screen – Items Tab
Table 2-5: LiveLink Configurations, Items Tab - Description of fields
Field Description
Export items
versions
Check this option if you wish to export item versions.
If you do not select this option, only the latest version of each item is exported.
Export
Personal
Workspaces
Check this option if you wish to export Personal Workspaces
Export Email
Volume
Check this option to export emails from LiveLink server.
To enable “Export Email Volume” option, the option "LiveLinkUseDB” in the Exporter Configuration file (TzunamiExporter.exe.config) must be true and which is by default set to true.
By default, “TzunamiExporter.exe.config” is located at the “C:\Program Files
(x86)\Tzunami\Deployer 3.3\Exporters\LiveLink”, or where Tzunami LiveLink Exporter is installed.
You must provide Database credentials in Tab to extract emails from LiveLink.
Page | 2-16
Types Check the types of item versions to export. Documents, Text Documents, URLs, and
Aliases, Binders etc. are always exported.
c. Advanced tab
The Advanced tab allows you to specify the export options such as attachments,
security, Additional Node Attributes, Categories & Attributes, Personal
Workspace, URLs and Aliases.
Figure 2-6: LiveLink Configurations Screen – Advanced Tab
Table 2-6: LiveLink Configurations, Advanced Tab - Description of fields
Field Description
Export attachments Check this option if you wish to export item attachments.
Export security settings Check this option if you wish to export the permissions (ACLs) of the exported items.
Export Audit Trail Check this option to extract Audit Trail of items.
Export Multi-Value properties as text
Check this option if you wish to export Multi-Value Properties as text.
Export Additional Node Attributes
Check this option to assign additional metadata to items. This LiveLink function is mainly used in versions earlier than 9.0 and may considerably slow the export process. Tzunami recommends that you leave this option unchecked if it is not used in your LiveLink.
Categories and Attributes
Export Categories & Attributes
Check this option to export categories and attributes of items.
Merge values for attribute Sets
Check this option to merge and export the values of attribute sets. If you don’t check this option, the attributes set values will not be merged. For e.g. In the Attribute Set “Category Types” has values “A, B and C” in three different rows, and if the option is not selected, the exporter will export values in three different properties such as Category Type as ‘A’, Category Type 1 as ‘B’ and Category Type 2 as ‘C’.
Page | 2-17
Field Description
Export Record Management Attributes
Check this option if you wish to export record management attributes of items.
Export URLs and Aliases as file of type
Check this option if you wish to export URLs and Aliases as file of type HTML or ASPX
Export Generation as files of type
Check this option if you wish to export Document or Compound Document Generations as file of type HTML or ASPX.
d. Roots tab
The Roots tab allows you to enter URL or ID to be used as root folder.
Figure 2-7: LiveLink Configurations Screen – Roots Tab
Table 2-7: LiveLink Configurations, Roots Tab - Description of fields
Field Description
Additional items to be used as roots (one URL or Id per line)
Enter the URL or ID of Additional Items in the text box to be used as root folder.
e. DB Settings tab
The DB Settings tab allows you to enter Database Credential to connect with the
LiveLink Database Server. To enable DB Settings tab in the LiveLink
Configuration wizard, you must set " LiveLinkUseDB” to True in the Exporter
Configuration file (TzunamiExporter.exe.config).
By default, “TzunamiExporter.exe.config” is located at the “C:\Program Files
(x86)\Tzunami\Deployer 3.3\Exporters\LiveLink”, or where Tzunami LiveLink
Exporter is installed.
Page | 2-18
Figure 2-8: LiveLink Configurations Screen – DB Settings Tab
Table 2-8: LiveLink Configurations, DB Settings Tab - Description of fields
Field Description
Server Instance Enter the Server Instance for LiveLink Server.
Database Name Enter the Database Name for LiveLink Server.
Username Enter the username that has access to the Database on LiveLink Server.
Password Enter the password for the account specified in the Username.
Database schema Enter the Database schema for LiveLink Server.
DB Provider Select the DB Provider from the drop down list.
Authentication type Select the LiveLink Database Authentication type from the drop down list.
Download Document Check the option to download the document(s) using DB Settings.
3. Click Next. The Folders screen appears.
Tzunami Exporter provides quick analysis option before exporting to know the size,
count of contents inside selected folder.
If you want to analyze the content: Check on the Folder(s) in tree view, then Analyze
button is enabled. Click Analyze.
Page | 2-19
Figure 2-9 Analyze Option
Please, provide the database connection settings prior to perform the content analysis. Refer
DB Settings tab section.
Analyzer screen appears. Analyzer screen provides the detail information that helps
to plan for the export (chunk size) based on File size and number of items.
Figure 2-10 Analyzer Information
Table 2-9 Analyzer Information Description
Field Description
File Size [all versions] Provides the total size of files for all versions of documents.
File Size [current version only]
Provides the total size of files for current version of documents.
Folder Count Provides the number of folders.
File Count [all versions] Provides the total number of files for all versions of documents.
File Count [current version only]
Provides the total number of files for current versions of documents.
Page | 2-20
Field Description
Data Item Count Provides the total number of data item.
4. Select folders to export.
Figure 2-11 Folders Selection Screen
You can select all subfolders of a selected folder by checking Automatically select subfolders.
5. Click Next. The Filter screen appears.
Figure 2-12: Filter Screen
6. Set up filtering as follows:
a. In the Properties field, select a property.
Page | 2-21
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.
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.
This option works only for Data Items.
If multiple conditions are applied, only items that match all conditions are exported.
While adding filter condition for a file size using the Size property, you have to enter file size
value in bytes.
7. Click Next. The Destination Folder screen appears.
Figure 2-13: Destination Folder Screen
8. Specify where to export the files and generated TDX information. Make sure you are
saving to a folder with a descriptive name and under a well-organized file system
hierarchy. It is recommended to export to a folder that is as close to the root as
possible.
Click Save for saving export specification details as an XML file which can be used to
run the exporter in command-line mode. See the section ‘Command-line Export’
below for more details.
Page | 2-22
9. Click Next.
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.
An Exporting screen appears with a progress bar and execution report, and the
export process begins.
Figure 2-14: Export Progress Screen
You can save the export report by clicking Save as… after export is complete.
You can check Auto-scroll to display the latest progress messages, as they appear
You can display only export errors by checking Errors only.
You can display only export warnings by checking Warnings only.
10. Click Next. The Export Complete screen appears.
11. Click Done. The Tzunami LiveLink Exporter wizard is closed.
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.
Page | 2-23
2.3 COMMAND-LINE EXPORT Tzunami Exporter for LiveLink provides ability to run export sessions non-interactively using
command line instructions. This allows administrators to plan and schedule long running
migration jobs through scripts, batch files and schedulers according to needs and
organizational timetables. To run the exporter in batch mode you will need exporter
specification file explained in the ‘Choose Destination Folder’ step of the export wizard. The
file contains all the export option details including:
• Source ECM connectivity information (Server Address, User Name, Password etc.)
• Items to export
• Destination and Log Folder
• Filter
• Exporter specific options
This file can be edited to suit your needs however the XML schema of the file should not be
altered. It is recommended that you generate a sample specifications file in the Destination
Folder Screen selection step of the export wizard and use it as a template to create your own
specification file.
Once the specification file is ready, you can run the exporter from command line using
command:
TzunamiExporter.exe [-r <ResultFile>] -s <ExportSpecificationsFile>
Usage
Field Description
-r Outputs export results into an XML file [Optional]
-s XML file containing export specifications
For example:
C:\User\Administrator> “C:\Program Files (x86)\Tzunami\Deployer
3.3\Exporters\LiveLink\TzunamiExporter.exe” -s “D:\Spec Files\specs1.xml”
C:\Program Files (x86)\Tzunami\Deployer 3.3\Exporters\LiveLink> TzunamiExporter.exe -s
“D:\Spec Files\specs1.xml”
Based on your needs you can create number of specification files and use them to run
multiple export sessions as batch commands.
You will need to provide absolute path for TzunamiExporter.exe and ExportSpecificationsFile in the command if you are not running from the exporter installation directory.
In Microsoft Windows 10, Windows 8, Windows 7, Windows Vista, Windows Server
2003/2008/2012 and environment, if USG (Universal Security Group) is enabled, Users with
Page | 2-24
low privileges sometimes cannot export ECM contents. To export contents using command
line, User must run with elevated or administrative privileges.
To export contents with elevated or administrative privileges, you can run the exporter from
command line using command:
RUNAS /trustlevel:“Unrestricted” “<ExporterInstallationDirectory>\TzunamiExporter.exe”
–s “<Spec file path>\Specfilename.xml ”
For example:
RUNAS /trustlevel:“Unrestricted” “C:\Program Files (x86)\Tzunami\Deployer
3.3\Exporters\LiveLink\TzunamiExporter.exe” -s “D:\Spec Files\specs1.xml”
2.4 BEST PRACTICE Due to the technological differences between LiveLink and SharePoint, the following best
practices should be taken into consideration
• Migrate folders to their relative list types, based on the items in those folders.
Table 2-10: Target Structure Guidelines
LiveLink Item Type Relevant SharePoint Types
Workspace • Site Collection
• Site
Channel Announcements List
Discussion Discussion Board
Project • Site Collection
• Site
Task List Tasks List
Task Group Folder inside a Tasks List
Compound Document/Binders
Folder
URL • Link inside a Links List
• Document inside a Document Library (with the Link to a Document Content Type)
Alias • Link inside a Links List
• Document inside a Document Library (with the Link to a Document Content Type)
Document Document inside a Document Library
Text Document Document inside a Document Library
Generation • Link inside a Links List.
• Document inside a Document Library (with the Link to a Document Content Type)
Folders Depending on the content of the folder, valid options may include migrating as Lists, Folders, or even Sites
Page | 2-25
LiveLink Item Type Relevant SharePoint Types
Community Team Site
Library • Document Library
• Folder
Mail Archive • Document Library
• Folder
Mail • Documents
• Item
Blog Blog Site
Blog Entry Posts
Blog Comment Comments
FAQ • List
• Discussion Board
FAQ Entry • Item
• Topic
Forum Discussion Board
Forum Topic Discussion Board
Email Folder • Document Library
• Folder
• URLs and Aliases can be migrated in two ways:
• Migration as data-items in a Links List.
• Migration as documents in a Document Library. Office 365 or
SPS2013/SPF2013 or SPS2010/SPF2010 or MOSS/WSS3.0 provides a Content
Type named Link to a Document, which functions in a similar way to a
shortcut. For more information about migrating using this Content Type,
please contact the Tzunami Support Team, at [email protected].
Attributes (derived from Categories or from Additional Node Attributes) can
be added to the items as part of the deployment. Note that in LiveLink, each
item can be assigned several categories while in Office 356 or
SPS2013/SPF2013 or SPS2010/SPF2010 or MOSS/WSS3.0 each item can only
have one Content Type. For more information about adding attributes, refer
to the Tzunami Deployer User Guide.
Top-level folders should be deployed as Sites and Sub-sites, in order to
better organize the content in a SharePoint-oriented structure.
Page | 3-26
3 LICENSING INFORMATION
Tzunami LiveLink Exporter uses a default license that can be used for evaluation purposes. This
license is limited in the number of items that are exported. If the license does not match your
evaluating needs, contact [email protected] for an extended license. For this purpose you
will need to provide the Product Serial Code, and then enter the License Key you receive back
from the Tzunami.
To retrieve the Tzunami Product Serial Code:
1. Select Start > Programs > Tzunami > Tzunami License Update for LiveLink. Tzunami License Update window opens (Figure 3-1).
Figure 3-1: License Update window
2. Click Copy. This copies the Product Serial Code to the clipboard.
3. Paste the contents of the clipboard into an email and send it to the Tzunami Support Team at [email protected].
To extend the Tzunami license:
1. Select Start > Programs > Tzunami > Tzunami License Update for LiveLink. Tzunami License Update window opens (Figure 3-1).
2. Click Browse and select the new License Key file received from the Tzunami Support Team.
If an error message appears, contact Tzunami Support Team at [email protected].
Page | 4-27
4 ANNEX
4.1 EXPORT ADDITIONAL DOCUMENT METADATA DIRECTLY THROUGH
DATABASE. Tzunami Livelink Exporter uses the Livelink APIs to extract and export the Item metadata. Generally,
the metadata extracted through APIs includes all necessary metadata and associated value that can
be observed through livelink interface.
However, Livelink database may store additional information in the database which cannot be
extracted through APIs or in some cases cannot observe in Livelink interface as well. For example:
Last Accessed date can be fetched from LiveLink using a SQL query on a LiveLink table, it doesn’t
exist as a separate document metadata field.
Tzunami Livelink Exporter provides added feature to extract such metadata. Further, the Livelink
database should be accessible from the network where Tzunami Livelink Exporter is installed and
database information and credential having privileges at least to execute query and fetch data are
required. This information should be provided in Tzunami Livelink Exporter. For more details, please
refer to DB Settings Tab section on page 2-17.
To specify the Metadata and SQL Query
You need to carry out the following steps to add the Additional Document Metadata.
1. Open PropertyQueryList.xml file in edit mode from the Livelink Exporter installation location.
(e.g. C:\Program Files (x86)\Tzunami\Deployer 3.3\Exporters\LiveLink)
Figure 4-1 Property Query Settings in Configuration file: Locate
The PropertyQueryList.xml file provides Document node, under which additional metadata
should be specified as Property node(s). Each Property node has DispalyName, Type and
AddOnFilter atrributes whose value should be configured.
2. The Property node should include values for DisplayName for a metadata, Type for data type of
the metadata.
The property node includes AddOnFilter attribute with default empty value. This property
provides additional capability to use the newly added metadata in Exporter Filter when its value
is set to “true”.
Page | 4-28
Figure 4-2 Property Query Settings in Configuration file: Set Key-Value
3. Add the SQL Query for the property. SQL Query should include “{}” placeholder for ‘dataId’ in
WHERE clause. The value for ‘dataId’ for data item will be included in query at runtime.
Figure 4-3 Property Query Settings in Configuration file: Update Query
4. Save and close the file.
Page | 5-29
5 COPYRIGHT AND TRADEMARK
© Copyright 2019. Tzunami Inc. All rights reserved.
All intellectual property rights in this publication are owned by Tzunami, Inc. and protected by
United States copyright laws, other applicable copyright laws and international treaty
provisions. Tzunami, Inc. retains all rights not expressly granted. No part of this publication may
be reproduced in any form whatsoever or used to make any derivative work without prior
written approval by Tzunami, Inc.
No representation of warranties for fitness for any purpose other than what is specifically
stated in this guide is made either by Tzunami, Inc. or by its agents.
Tzunami, Inc. reserves the right to revise this publication, and/or make improvements or
changes in the product(s) and/or the program(s) described in this documentation at any time
without prior notice.
Any software on removable media described in this publication is furnished under a license
agreement included with the product as a separate document. If you are unable to locate a
copy, please contact Tzunami, Inc. and a copy will be forwarded to you.
Tzunami is either a registered trademark or a trademark of Tzunami, Inc. in the United States
and/or other countries.
All other brand or product names are trademarks or registered trademarks of their respective
companies.
For further information, you can contact Tzunami Inc. at:
Tzunami Inc.
601 108th Avenue, NE
Suite 1900
Bellevue, WA 98004, USA
Email: [email protected], [email protected]
Web: http://www.tzunami.com
Top Related