My update was cancelled prematurely. How do I restore screen-scraper?

From within the workbench, if when prompted you agreed to download an update, and for some reason the update download stopped prematurely then the next time you try to run screen-scraper it may fail. Instead an error window will appear containing a java.lang.ClassNotFoundException error.

Follow these steps to fix the issue.

  • Open the resource/conf/screen-scraper.properties file in a text editor and note the Version number.
  • Back up your existing database: Zip up all files and folders within resource/db folder into an archive called ss_backup.zip.
  • Move ss_backup.zip to your desktop.
  • Uninstall screen-scraper.
  • Reinstall screen-scraper.
  • Before running your new installation, update it to the version it was at just prior to uninstalling.
    • Modify the following URL to match the version you recorded from the screen-scraper.properties file:
      http://www.screen-scraper.com/screen-scraper/updates/5.5.9a/update.zip
    • Download the update.zip archive and unzip its contents directly into screen-scraper's installation directory (confirm overwrite of existing files).
  • Restore your database by first extracting only the files (not the directories) found in the first part of your ss_backup.zip archive and place them in the resource/db folder of your new installation.
  • Run screen-scraper.
  • If the previous two steps do not work perform the same steps but for the files contained in each of the backup folders of your ss_backup.zip archive.