Starfish Updater

Starfish Updater

Update Wizard

Starfish ETL has a built-in updater. To start, click the Starfish button and select “Check for Updates” or launch StarfishUpdater.exe directly from within the Starfish Admin installation path.

NOTE: It is often times necessary to start StarfishUpdater.exe with "Run-As Administrator".


The first time the Updater is run, you'll have to supply the paths to the Starfish ETL™ components. If your Starfish Engine is installed on another server, UNC paths are supported. If you don’t have a certain component installed (such as the Scheduler), you may leave the path empty.


Now you may click the “Look for Updates” button. If the updater finds out of date or missing files, the “Update Now” button will become available. (Files are compared by MD5 hash) Before proceeding, it is recommended that you close out Starfish Admin and shut down the Starfish Scheduler service if running. Now you may press the “Update Now” button. This will download and replace the necessary files from Starfish ETL™ servers.


Manually running the Update Wizard as Administrator

System.IO.FileNotFoundException: File not found.

If you run into errors, you may need to run StarfishUpdater.exe as administrator. To do this, surf to where you installed the Starfish Admin program. Generally: C:\Program Files (x86)\Starfish ETL\Starfish Admin\. Find StarfishUpdater.exe, right click on it and select Run as Administrator.

Note that you may need to be logged into the computer as a local Admin.

Upgrading StarfishETL versions 3.x and 4.x

Earlier versions of StarfishETL require you to uninstall and reinstall the On-Prem version to upgrade. 

1.  Backup the following Starfish items (typically located under C:\inetpub\wwwroot\StarfishEngine)
  • The Xref folder
  • engine.db file
  • Web.config file
2.  Go to Control Panel | Programs and Features and uninstall:
      Starfish Admin
      Starfish Engine
      Starfish Scheduler

3.  Download the latest StarfishETL from:

4.  Run the installer per the instructions found in these videos:

5.  After installation is complete copy this file and folder from your backup into the new installation:

  • The Xref folder
  • engine.db file

6. Take note of any changes you made to your web.config file and manually update those settings within the new web.config file. Do not simply overwrite this file from your backup.

    • Related Articles

    • Starfish Ray

      Overview The Starfish Ray is a light-weight footprint service installed on a client machine which enables the movement of data from a system behind the firewall to other cloud-based systems. Our cloud hosted Starfish software facilitates this ...
    • Starfish Admin

      You will install the Admin tool on the workstation where you plan to do your job development. The installation requires the .NET Framework 4.0, and will need the ability to access the web service set up in the previous step. An easy way to test this ...
    • Starfish Scheduler

      Installation The Scheduler is a run as Windows Service. It may installed on any server which has access to the web service, but for the sake of simplicity it is recommended to be installed the same server as the Starfish Engine. The Scheduler reads ...
    • Starfish Monitor

      Installation Beginning with Starfish ETL 3.8, the Starfish Monitor service is included and created when you install the Starfish Scheduler. The Monitor service's Startup Type is set to 'Manual' by default. If you wish to use this service, you should ...
    • Working with Starfish Variables

       Starfish variables can be used to store configurable information used by jobs and scripts. In the example below, several Variables have been defined. Use the following steps to walk through Viewing variables Selecting and changing a variable ...