System Requirements

Mascot Daemon requires:

  • Windows XP SP3 or 2003 Server SP2 or later
  • .NET framework 4.0 (client profile is sufficient)
  • If Mascot Distiller is used as data import filter, it must be version 2.5 or later

64-bit versions of Windows are fully supported. Mascot Daemon communicates with the Mascot Server using HTTP over TCP/IP, even when installed on the same PC as Mascot Server.

Note: If you have multiple Mascot Server systems with different versions, Mascot Daemon 2.5 can be used to submit searches to Mascot Server 2.1 and later. In exceptional circumstances, it can also be used with Mascot Server 2.0, but this requires the Mascot Server to be updated by downloading file updates from the Mascot support page.

Getting Help

Once Mascot Daemon is installed, refer to its on-line help for detailed information on configuration and use. The on-line help is context sensitive, so you can jump to a relevant page at any time by pressing F1.

Installing Mascot Daemon

If upgrading from an earlier version of Mascot Daemon, switch to the Upgrading topic.

1. Using a web browser, verify that it is possible to connect to your Mascot server from the PC on which Mascot Daemon is to be installed. If there are any problems submitting a search from a web browser and retrieving the result report, these must be resolved before installing Mascot Daemon. 

2. Mascot Daemon requires .NET framework 4 or later. This is standard on Windows 8 and Server 2012, and it may already have been installed on earlier versions of Windows by some other application. If you are not sure whether it is present, just run Mascot Daemon setup. If it reports that .NET is missing, download and install it from the following locations:

3. Run Mascot Daemon setup. The same installer handles both 32-bit and 64-bit platforms.

4. After installation, when you first run Mascot Daemon, the Preferences dialog will be displayed. You must configure a connection to your in-house Mascot Server before you can proceed. On the Intranet tab, enter your in-house Mascot server URL, up to and including the cgi directory, e.g. http://your_server/mascot/cgi/. If the web server or a proxy server requires authentication by user name and password, enter your credentials on the Authentication tab.

If you have Mascot security enabled, you need to ensure Daemon can log into your Mascot Server as a user with the rights to submit searches from Daemon. Usually, this means being a member of the power users or daemons groups. If necessary, ask your Mascot system administrator for a user name and password, and enter these into the appropriate fields on the authentication tab of Daemon preferences.

5. By default, the task database uses an embedded engine called VistaDB, which is pre-configured and requires no additional components to be installed. If you want to share a single task database between multiple instances of Daemon running on different PCs, you should choose one of the server-based, high-performance database engines, (Microsoft SQL Server, MySQL, Oracle, PostgreSQL). For detailed guidance on the installation of database engines and ODBC drivers, press F1 and refer to the Daemon on-line help: Getting started; Database engines.

6. Choose Save and the Mascot Daemon desktop interface will be displayed. The Mascot Daemon engine will run in the system tray. This is the preferred arrangement in all cases except when you want to run multiple instances of Daemon in separate remote desktop sessions on the same PC, which requires the engine to be configured as a Windows service. For details, press F1 and refer to the Daemon on-line help.

7. The quickest way to familiarise yourself with Mascot Daemon is to follow through the short tutorial in the on-line help.

Upgrading Mascot Daemon

If this is a clean installation of Mascot Daemon, switch to the Installing topic.

1. Mascot Daemon 2.5 requires .NET framework 4 or later. This is standard on Windows 8 and Server 2012, and it may already have been installed on earlier versions of Windows by some other application. If you are not sure whether it is present, just run Mascot Daemon setup. If it reports that .NET is missing, download and install it from the following locations:

2. Run Mascot Daemon setup. The same installer handles both 32-bit and 64-bit platforms. If an earlier version of Mascot Daemon is installed, setup will automatically stop the old Mascot Daemon Windows service, delete it, then ask you to uninstall the earlier Mascot Daemon using the Windows control panel. In which case:

  • From the Windows Start menu, select Settings.
  • Select Control Panel
  • Double-click Add/Remove Programs or Programs and features
  • From the applications list, select Mascot Daemon and choose Change/Remove or Uninstall
  • Run Mascot Daemon 2.5 setup once again

Note: If you want to keep your old task database, and it is the default Microsoft Access file (TaskDB.mdb in the application directory) make a copy of it in a safe place before uninstalling the earlier version of Mascot Daemon.

3. After installation, when you first run Mascot Daemon, the Preferences dialog will be displayed. You must configure a connection to your in-house Mascot Server before you can proceed. On the Intranet tab, enter your in-house Mascot server URL, up to and including the cgi directory, e.g. http://your_server/mascot/cgi/. If the web server or a proxy server requires authentication by user name and password, enter your credentials on the Authentication tab.

If you have Mascot security enabled, you need to ensure Daemon can log into your Mascot Server as a user with the rights to submit searches from Daemon. Usually, this means being a member of the power users or daemons groups. If necessary, ask your Mascot system administrator for a user name and password, and enter these into the appropriate fields on the authentication tab of Daemon preferences.

4. By default, the task database uses an embedded engine called VistaDB, which is pre-configured and requires no additional components to be installed.

Option 1: To stay with Microsoft Access, choose Microsoft Access. The default path to the database file is %allusersprofile%\Matrix Science\Mascot Daemon\TaskDB.mdb. Either copy your old database file to this location, over-writing the empty database file, or change the path to point to your preferred location.

Option 2: To share a single task database between multiple instances of Daemon running on different PCs, choose whichever high-performance database engine you prefer: Microsoft SQL Server, MySQL, Oracle, PostgreSQL. These database engines may be running on a different computer, accessed over the LAN. Note that someone with database administrator rights must create an empty database before it can be used by Mascot Daemon. For detailed guidance on the installation of database engines and ODBC drivers, press F1 and refer to the Daemon on-line help: Getting started; Database engines.

Option 3: If the task database will not be shared, the default VistaDB engine is recommended.

Note: To migrate the contents of your existing Access database to a new database engine, refer to the Daemon on-line help: Getting started; Database engines; Access; Migrating to other database engines..

Note: %allusersprofile% is a Windows environment variable that expands to the full path to the All Users profile directory. This profile contains resources and settings that are used by all system accounts. In recent versions of Windows, the All Users profile directory is C:\ProgramData, which is hidden by default. You can enter %allusersprofile% as part of a path in Windows Explorer or in a command window. wherever you enter a Windows path. For Windows XP, Daemon non-program files are in %allusersprofile%\Application Data\Matrix Science\Mascot Daemon

5. If you have to install or update an ODBC driver for your chosen database engine, refer to the help topics for the individual database engines. Details can be found in the on-line help topics for the individual database engines.

Note: Windows 32-bit and 64-bit ODBC components are totally independent. That is, a 64-bit application cannot use a 32-bit ODBC driver and vice versa. On a clean 64-bit Windows installation, the only driver will be for SQL Server, and this may be a very old one.

6. If you connect to a task database from an earlier version of Mascot Daemon, you will be warned that it will be updated. You might wish to make a backup of the file or tables in case of problems. Once the database has been updated, the Mascot Daemon desktop interface will be displayed, and the Mascot Daemon engine will run in the system tray. This is the preferred arrangement in all cases except when you want to run multiple instances of Daemon in separate remote desktop sessions on the same PC, which requires the engine to be configured as a Windows service. For details, press F1 and refer to the Daemon on-line help

Troubleshooting

For troubleshooting, press F1 and refer to the Daemon on-line help.