Integration prerequisites

Eclipse must be installed on the target platform (a local Windows or a remote UNIX machine).

Visual Studio

Visual Studio must be installed on the target platform.

Export and import customizations

Installing the Visual Studio integration deletes existing Visual Studio customizations. You can export your current customizations before installing the integration:

1. Tools | Import and Export Settings

2. Follow the instructions of the Microsoft Import and Export Wizard to export your customizations.

Visual Studio automatically exports customizations, but we recommend exporting your customizations. After you have installed the integration use the Microsoft Import and Export Wizard to import your customizations.

You also need to migrate your Visual Studio solutions controlled by Dimensions SCC into solutions compatible to the new Visual Studio integration by using the migration tool.

Dimensions CM Connect for SBM

To continue using the Dimensions CM Connect for Solutions Business Manager (SBM) synchronization integration, certain Windows registry keys are set to the last synchronization every time a synchronization occurs. These keys should be maintained for as described below. If not, the updated integration restarts from the "epoch" (1970-01-01).

1. (Recommended) Backup your registry.

2. Open regedit.

3. Navigate to the following registry hive:

   HKEY_LOCAL_MACHINE\SOFTWARE\Serena\Dimensions Connect
     for Business Mashups\<link_no>
   

4. Log the values of the keys below or export the parent hive to a file using the registry export command so that you can import them after installation the integration:

   • DM Last Timestamp

   • TT Last Timestamp

Chang the location of temporary files

Running the SBM-to-Dimensions connector produces numerous temporary files. These include temporary attachment files created during the transfer from SBM to Dimensions of:

• detailed descriptions (DM_ATTR_DD)
• file attachments (TS_ATTACHATTRIB_FILE and
• TS_ATTACHATTRIB_SHOWIMAGE)
• notes (TS_ATTACHATTRIB_NOTE)
• URLs (TS_ATTACHATTRIB_URL)

The default location for temporary attachment files is the Attach.Tmp folder in the installation folder. You can use the Windows registry to change the location for these files.

The HKLM\SOFTWARE\Serena\Dimensions Connect for Business Mashups\TmpAttachmentsDir registry key explicitly defines a folder for temporary attachment files. If the specified folder does not exist, it is created and registered in the current log file (the parent folder must exist). You can create a subkey in the registry that looks like this:

HKEY_LOCAL_MACHINE\SOFTWARE\Serena\Dimensions Connect for
   Business Mashups\TmpAttachmentsDir="C:\TTDM.Temp"

Note that the TTDmSyncService.exe program normally deletes temporary files for new and updated SBM issues when current SBM issue transfer is complete.

The TTDmSyncService.exe program writes the names of successfully created temporary files to a separate log file. The default location is TmpFile.log in the installation folder. You can change this location using the HKLM\SOFTWARE\Serena\Dimensions Connect for Business Mashups\TmpFileLog registry key by creating a subkey that looks like this:

HKEY_LOCAL_MACHINE\SOFTWARE\Serena\Dimensions Connect for
  Business Mashups\TmpFileLog="C:\Program
  Files\OpenText\Dimensions  
  <version>\CM\Integrations\Business
  Mashups\SBMAttachments.log"

To disable the temporary file log set the HKLM\SOFTWARE\Serena\Dimensions Connect for Business Mashups\TmpFileLog registry key to the empty string.

To simplify diagnosis of temporary file issues, the current log file contains file system error descriptions together with file names and attachment types.