PREREQUISITES FOR INSTALLING TZUNAMI DEPLOYER

This chapter provides information that you should review before installing Tzunami Deployer. It contains the following topics.
• System Requirements
• Network Requirements
• Permission Requirements

System Requirements

The following table lists the system requirements for Tzunami Deployer Licensing Service Version 3.0

Network Requirements

The following table lists the ports that should be open for communication between the Tzunami Licensing Service machine, and the SharePoint front-end web-servers running Tzunami Deployer Remote Service.

Permission Requirements

When you install the Tzunami Licensing Service please make sure that the user running the Tzunami Deployer Remote Service is part of the local Administrators group on the machine upon which the Tzunami Licensing Service is installed. The user installing Tzunami Deployer Remote Service must have following permissions:
• The user must be a member of the Farm Administrators group. For more information, refer to your SharePoint documentation.
• The user must be a member of Local Administrator Group on the machine where Tzunami Deployer Remote Service is installed.
• The user must be a member of Domain Administrator on the Domain.

INSTALLING TZUNAMI DEPLOYER LICENSING SERVICE

This chapter contains information about installing Tzunami Deployer Licensing Service, including the following topics:
• Installing Tzunami Licensing Service
• Configuring Tzunami Deployer and Tzunami Deployer Remote Service

Installing Tzunami Licensing Service

To install Tzunami Licensing Service:
1. On one of the SharePoint front-end Web Servers unzip the zip file, and run DeployerComponentServiceComponents.msi. The Tzunami Deployer 3.0 Service Components Setup Wizard (Welcome window) will be launch. To advance through the install wizard, click Next on the bottom of each screen.

2. In the End User Licensing Agreement panel, click “I accept the terms in the License Agreement” and click Next to continue installation.

**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, click the Deployer Remote Service and choose Entire Feature will be unavailable and again click Deployer Link Resolver Service and choose Enter Feature will be unavailable.

4. Click Deployer Licensing Service and 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.

5. In the Ready to installed Tzunami Deployer 3.0 Service Components panel, click Install.

6. In the Completed Tzunami Deployer 3.0 Service Components Setup Wizard, to exit the wizard, click Finish.

Verify the successful installation of the service by opening the Services window (Click Start > Run and enter Services.msc) and making sure the Tzunami Deployer 3.0 Licensing Service is running.
**If the service is not running, check the Windows Event Log for entries pertaining to the Tzunami Licensing Service.

Configuring Tzunami Deployer and Tzunami Deployer Remote Service

Tzunami Deployer Remote Service is the component of Tzunami Deployer which is installed on the SharePoint Server. While committing a Tzunami Deployer project, Tzunami Deployer or Tzunami Deployer Remote Service checks the current license (includes quotas as per ECM’s, Time Duration and number of operation) with Tzunami Licensing Service. For more information, see Tzunami Installation Guide.
To ensure successful migration, you must install and configure the Tzunami Deployer or Tzunami Deployer Remote Service to communicate with the Tzunami Deployer Licensing Service.

**During commit a message will be prompted, informing you to renew the current license if the current license quota is lower than committed project.

To connect Tzunami Deployer Remote Service and Tzunami Deployer Licensing Service:
1. Click Start > All Programs > Tzunami > Deployer 3.0 Remote Service > RS Configuration Tool.
2. In Licensing Service Address, enter the Name or IP address of the machine where the Tzunami Licensing Service is installed. For more information, see Tzunami Deployer installation Guide.

**This configuration is not needed of the Licensing Service is installed on the same machine as the Tzunami Deployer Remote Service.

3. Click OK to Save.

To connect Tzunami Deployer and Tzunami Deployer Licensing Service:
You need to connect Tzunami Deployer and Tzunami Deployer Licensing Service while committing to Office 365 or SharePoint 2010 (without using Remote Service). For more information see Tzunami Deployer User Guide.

1. Click Start > All Programs > Tzunami > Settings Manager.
2. In Licensing Service Address, enter the Name or IP address of the machine where the Tzunami Licensing Service is installed. For more information, see Tzunami Deployer installation Guide.

3. Click OK to Save.

TZUNAMI DEPLOYER LICENSING SERVICE

This chapter provides information about Tzunami Deployer Licensing Service. It contains the following topics:
• Overview
• Tzunami Deployer Licensing Service Workflow
• Setting LS License
• Setting Tzunami Deployer License
• Setting Tzunami Exporter Licenses
• Upgrading License

Overview

Tzunami Deployer Licensing Service provides project managers with the centralized point of management for the Tzunami Deployer licenses. Tzunami Licensing Service monitors the migration process across the organization.
Together with its management console, Tzunami Licensing Service provides the project manager with an overview of the current license (including remaining quotas per source system, time limitations, etc.), and the ability to update new licenses provided by the Tzunami Support Team.
Lastly, Tzunami Licensing Service allows project managers to generate licenses for individual Tzunami Deployer installations, based on the license restrictions of the migration project license.

For any question regarding usage of Tzunami Licensing Service, or for updated licenses, please contact the Tzunami Support Team at support@tzunami.com.

TZUNAMI DEPLOYER LICENSING SERVICE WORKFLOW

Tzunami Deployer performs migration of contents from source to target in different phases:
Phase I: Extraction of source contents. This might involve the use of specific exporters depending on the source ECM to be extracted.
Phase II: Loading of extracted contents into Tzunami Deployer project
Phase III: Uploading the changes/contents to Target SharePoint

You will need one or more licenses to perform different operations depending on the phase you are working on. Basically there are three types of licenses:
1. Tzunami ECM Exporters License:
Tzunami ECM Exporter’s licenses are required to export ECM contents. Each standalone exporter is installed with a default evaluation license which limits the number of items that can be extracted from each container. You must update Tzunami Exporter License to export ECMs contents in a consignment.

**If you are running Tzunami Exporter for your source from within the Tzunami Deployer, you will not need to load license for the exporter. The license you load for the Tzunami Deployer will be applicable to the exporter as well.

2. Tzunami Deployer License:
Tzunami Deployer license determines which source and target systems will be available to you while creating a migration project. You can generate your own Deployer licenses from the Tzunami Deployer Licensing service console explained below.

3. Tzunami License Service License:
Tzunami License Service License is the license you need to acquire from Tzunami Support. This license is required by the licensing service component and determines the amount of data that can be migrated from the source system to the target SharePoint. When committing contents to the target SharePoint, Tzunami Deployer Remote Service communicates with Tzunami Licensing Service to check the availability of license.

You various steps involved in setting up a Licensing Service are:
1. Setting LS License
2. Setting Deployer License
3. Setting Exporter License

Setting LS License

When committing a project, Tzunami Licensing Service communicates with Tzunami Deployer or Tzunami Deployer Remote Service to check the Tzunami Deployer Licenses. In order to migrate ECM contents, the license must be valid with adequate quota available.
If a license has expired or if the available quota has been used up, you will be prevented from committing Tzunami Deployer project

Requesting Tzunami License
To setup a Licensing Service, you will need Licensing Service License (LSLIC) file from Tzunami support. Contact Tzunami support team atsupport@tzunami.com to request this file. After you receive the license file from Tzunami, you can browse and load the file into the Licensing Service Console. The console will now show you details about your license and the status. You will need to provide a Product Challenge Key from the Tzunami Licensing Service Console which is available on the machine where Licensing Service is installed.

To retrieve the Tzunami Licensing Product Challenge Key:
1. Click Start > All Programs > Tzunami > Deployer 3.0 Licensing Service > Licensing Service Console.
The Tzunami Licensing Service Console window appears.

2. Click Copy. This copies the Challenge Key to the clipboard.
3. Paste the contents of the clipboard into an email and send it to the Tzunami Support Team at support@tzunami.com.

Load Tzunami License
After sending current Product Challenge Key or LS License File to Tzunami Support Team, the next step is to load the new LS License file that is supplied by Tzunami Support Team. You must upload the LS License file before committing Tzunami Deployer Project.
To load a new license in the Tzunami Licensing Service Console:
1. Click Start > All Programs > Tzunami > Deployer 3.0 Licensing Service > Licensing Service Console.
The Tzunami Licensing Service Console window appears (Figure 9).
2. Click Browse and select the new LS License file received from the Tzunami Support Team.
3. The details of the new license will appear in the Tzunami Licensing Service Console window.

**If an error message appears, contact the Tzunami Support Team at support@tzunami.com.

Setting Tzunami Deployer License

Tzunami Deployer License Service determines which sources and targets are available to you while creating a migration project. Once you have your Licensing Service installed and configured, you have the ability to generate your own Deployer licenses for the different instances of Tzunami Deployer’s involved in the migration process.

Generating Tzunami Deployer Licenses
Managers can generate Tzunami Deployer Licenses (LIC file) from License Service Console available on the machine hosting Licensing Service. The Deployer licenses that you can generate are the subsets of the Licensing Service license that you acquired from Tzunami.
The ability to generate licenses for Tzunami Deployer allows managers to reduce the overhead of communicating with the Tzunami Support Team for every new instance of Tzunami Deployer that they wish to use for migration, and allows managers to better control the use of Tzunami Deployer in their organization.

To generate a Tzunami Deployer license:
1. Run the Deployer, go to Tools > Update License and copy the challenge key from th License Update console.

2. Click Start > All Programs > Tzunami > Deployer 3.0 Licensing Service > Licensing Service Console.
The Tzunami Licensing Service Console window appears.
3. Select the Deployer Tab.

4. Paste the Challenge Key retrieved from the Tzunami Deployer instance in step 1.
5. Optionally, fill-in the Issuer and Requester fields. These fields can be used by the project manager to keep track of issued licenses.
6. Check the Allow Rule Engine editor flag to allow users to modify Tzunami Deployer Rule Sets with the Rule Engine editor.
7. Select the sources and target systems to enable in the Tzunami Deployer.
8. Click Generate Key File.
9. Load the generated license key file in Tzunami Deployer License Update window (refer to step 1) to update its license.

**If an error message appears, contact the Tzunami Support Team at support@tzunami.com.
**To evaluate Tzunami Deployer you do not need Tzunami Licensing Service. If you need Tzunami Deployer evaluation license, please contact Tzunami Support.

Setting Tzunami Exporter Licenses

Each standalone Tzunami Exporter is installed with a default evaluation license which is limited to time and number of items that can be extracted from each container. If you are running Tzunami Exporter as a separate standalone component (not from within the Tzunami Deployer), you will need to setup a Tzunami Exporter License to be able to extract source contents.

Generating Tzunami Exporter License
To request a new License file, contact the Tzunami Support Team at support@tzunami.com. For this purpose you need to provide the Product Serial Code, and then enter the License Key you receive back from the Tzunami.
Project manager can Generate License Key file from License Service Console.

To retrieve the Tzunami Deployer Product Serial Code:
1. Run the Tzunami Deployer and go to Tool > Update License. The License Update window appears.

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 support@tzunami.com. For more information, see Generating Tzunami Deployer Licenses.

Loading Tzunami Exporter License
After sending current Product Challenge Key or License File to Tzunami Support Team, the next step is to load the new License file that is supplied by Tzunami Support Team. You must upload the License file before export Source ECM contents.

To load the Tzunami Deployer license:
1. Run Tzunami Deployer 3.0 and go to Tool > Tzunami License Update. The Deployer License window appears (Figure 13).
2. Click Browse and select the new License key file received from the Tzunami Support Team.

**If an error message appears, contact the Tzunami Support Team at support@tzunami.com.
**To evaluate Tzunami Exporters you do not need Tzunami Deployer Licensing Service. If you need Tzunami Exporter evaluation license, please contact Tzunami Support.

Upgrading License

Update LS License File
Tzunami Licensing Service is based on the size of the data to be migrated .During migration if you realize that the remaining quota is not sufficient to cover the entire migration or require other licenses, you may need to request addition quota from Tzunami Support and upgrade your license.

To update/change a license in the Tzunami Licensing Service Console:

*****Do not perform this action unless explicitly instructed by the Tzunami Support Team.*****

1. Click Start > All Programs > Tzunami > Deployer 3.0 Licensing Service > Licensing Service Console.
The Tzunami Licensing Service Console window appears (Figure 10).
2. Select Lock License Tab.

3. Read the message carefully and select ‘I understand the meaning of locking the license and I wish to continue’ option in the Lock License tab. This will enable Save License & Lock button.

4. Click Save and Lock License.
Licensing Service Console window appears asking you ‘Please type the “licensing service” in the textbox below’.

5. Type ‘licensing service’ in the Text box and Click Ok.
6. Save and send the LS Licensing File, along with the challenge key, to Tzunami Support Team at support@tzunami.com.

After receiving an updated LS License file from the Tzunami Support Team, load the license into Tzunami Licensing Service Console. For more information about loading new LS License file, see Load Tzunami License.