Upgrading Document Tracking Service

• All content repositories must be configured before performing this task or Document Tracking Service will not properly function.

• Gimmal Link is formerly known as ERP-Link or DM for SAP Solutions.  Please keep an eye out for these names in older deployments. 

If you are upgrading to Gimmal Link 5.x from Gimmal Link V4.x or older, you need to run the Document Tracking Service Migration Utility after installation and configuration of Gimmal Link.

The Document Tracking Service Migration Utility iterates the Gimmal Link configuration, identifies all primary and secondary document repository locations, and crawls these document repository locations in SharePoint. Therefore, any content repositories that are not configured will not be crawled and references for documents in these repositories are not created in the Document Tracking Service. Additionally, users will not be able to retrieve documents in SAP from these content repositories until they are properly configured.

Configure Settings for the Document Tracking Service Migration Utility

The Document Tracking Service Migration Utility is a command line executable. To configure settings for the Document Tracking Service Migration Utility:

1. Navigate to the Document Tracking Service Migration Utility folder C:\Program Files\Gimmal\ERP-Link\DTS Migration\.

2. Open the configuration file ERPLink.DTSMigrationUtility.exe.Config in a text editor such as Notepad.

3. Edit the DocumentTrackingServiceURL key value to the URL of the Document Tracking Service configured in the Gimmal Link Administration Console.

   <add key="DocumentTrackingServiceURL" value="http://yourserverurl/DocumentTrackingService/" />

4. Edit the ERPLinkConfigPath key value to the UNC path of the Gimmal Link Configuration File.

   <add key="ERPLinkConfigPath" value="C:\Program Files\Gimmal\ERPLink\iNetDM\WebSite\FILES\ERPLinkConfig.xml" />
   
   

5. Save the ERPLink.DTSMigrationUtility.exe.Config to the same location.

Executing the Document Tracking Service Migration Utility

The Document Tracking Service Migration Utility must be executed with an account that has read permissions to all primary and secondary document repositories in the configuration. This account can be the SharePoint farm or web application service accounts, service account for the Document Manager web application, or other domain account that has appropriate permissions.

To execute the Document Tracking Service Migration Utility:

1. Launch a Windows command prompt with an account that appropriate permissions.

2. Navigate to the Document Tracking Service Migration Utility folder C:\Program Files\Gimmal\ERP-Link\DTS Migration\ in the Windows command prompt.

3. Type ‘ERPLink.DTSMigrationUtility.exe’ and press the ENTER key.

4. The executable creates a log file in the Logs folder. The log file is named ERPLink_DTSMigration_mmddyy_hhmm.log, where mmddyy_hhmm is the month, day, year, hour, and minute the log file is created.