Note : Before you proceed with the following instructions, back up the database. If your organization integrates multiple Blackbaud products, refer to the Additional Requirements section of the backup article. Notes:
  • If Microsoft Office media objects, like Word or Excel documents, will be moved the plug-in MUST be run on a workstation that has Microsoft Office installed
  • If Blackbaud hosts your database, re-attach the missing files to the media tab using embedding method instead of linking files.
  • The plug-in is unable to apply any product-specific shortcut icons but uses a generic shortcut icon for fixed links. For example, instead of seeing the Microsoft Word icon you will see a generic shortcut icon. The plug-in uses the settings from the last time a media object was added to determine whether to display media document as icons. In other words, if this option is marked the last time you add a media object, the media documents will display as icons after running the plug-in. If the option is unmarked the last time you add an object, the document details will display.
  • This utility will link all media files from an old server to a new server. It does not allow you to move a specific folders files to new locations.
 
  1. Log onto the workstation as a local administrator.
  2. Download updatelinkedmedia.exe.
  3. Save UpdateLinkedMedia.exe to the local hard drive of any workstation with The Raiser's Edge installed.
  4. Double-click UpdateLinkedMedia.exe.
  5. When prompted, unzip the files into the "Plugins" folder on the workstation. (For 64-bit operating systems, the default path is C:\Program Files (x86)\Blackbaud\The Raisers Edge 7\Plugins, and for 32-bit operating systems, the default path is C:\Program Files\Blackbaud\The Raisers Edge 7\Plugins). UpdateLinkedMedia.exe is a self-extracting zip file that contains the plug-in files udUpdateMediaLinks.vbd, UpdateMediaLinks.dll.
  6. Register UpdateMediaLinks.dll on the workstation.
  7. Have all other users exit and sign out of The Raiser's Edge.
  8. Log into The Raiser's Edge.
  9. Click Plug-Ins from the navigation bar. The Plug-Ins screen appears.
  10. Click Update Linked Media. 
  11. Set up the options as needed:
    1. In the Previous Server name field, enter the name of the old media server as \\server name. For example, if the previous server name is Server1, enter \\Server1 in that field.
      Note: The previous server does not have to be online if all media to be re-linked now exists on the new server
    2. From the Start Search in drop-down, select the mapped drive for the new media server. 
      Note: We recommend creating an organized file structure on the new server to store the various media types which may be used.
    3. If the plug-in should only search the mirrored file structure on the new server, mark the Use previous Directory Structure checkbox. This lessens the likelihood of false positives, but may result in fewer links being fixed as noted below.
      Note: The plug-in searches the new server to see if the existing file structure is in place and if the media object files are found.
      1. If the media files are found, it updates the links.
      2. If the media files are not found, it searches the mapped drive for media objects with the same names. If files with the same names are found, it updates the links.
    4. Mark the Create a constituent query of updated records checkbox, which groups constituents whose media objects links are repaired.
    5. Mark the Create a constituent exception query checkbox, which groups constituents whose media object links are still broken.
    6. The option 'Prompt for media location when file not found on new server' will prompt once for each file which is not found on the new server. For example, if the old path was C:\Old\Media.pdf and the new server is G:\Old but there is no Media.pdf there, it will prompt you to give you a chance to point it to the correct path on the new server.
    7. The option 'Prompt when previous server name is different on media link' will prompt for every file which it finds on the new server which matches the path of a media link in the database. If the plug-in does not find the file on the new server, then it won’t prompt. It will give the same prompt as the above, giving a chance to point it to the correct path on the new server.
    8. 'Create CSV file for broken media links' will create a single CSV file called BrokenMediaLinks.csv with entries for each media object for which the source directory cannot be determined. 
      Note: This CSV file will only be written if the ‘Create event log of plug-in process' checkbox is checked.
    9. Include… allows us to include only a specific query of records in the plug-in.
    10. Create event log of plug-in process creates just a regular .txt file with details on what was updated and how the paths may have changed. The log provides a lot of detail on each media link that is updated and is very useful should Blackbaud need to review the plug-in results for troubleshooting.  
  12. Click Update to run the plug-in.
Note: If the plug-in is run to move MS Office objects on a workstation that does not have MS Office installed, the objects will become a Microsoft Object Package and cannot be moved in the future.