Mascot Server version 2.8

Updating and upgrading procedures

Known Issues

Updating from 2.4 or earlier

The list of modifications used by Mascot is taken from Unimod by downloading the database contents in XML format (unimod.xml). In Mascot 2.4 and earlier, if you wanted to change a modification or add a new one, this could be done using the Mascot Configuration Editor or, if you were very brave, by editing unimod.xml. The unsatisfactory aspect of this was that any changes were lost if you downloaded a fresh copy of unimod.xml.

This was improved in 2.5 by saving all changes to a separate file and merging this with the downloaded file to create the working copy of unimod.xml. The Modifications module of the Configuration Editor has a button (Check Unimod) which looks to see whether a newer unimod.xml file is available. If so, you can choose to download it. The downloaded file is re-named to master.xml and saved to the mascot/config/unimod directory. Any local changes you make using the Configuration Editor are saved to a separate file called usermod.xml in the same directory. When the Mascot Monitor service sees that either file has changed, it merges the two files to create a new unimod.xml in the mascot/config directory. (Note that this means you should never edit or update unimod.xml … your changes could disappear at any time.)

If you are updating to Mascot 2.8 from Mascot 2.4 or earlier, and only have a small number of changes to your local list of modifications, the easiest solution is to re-enter them one final time using the Configuration Editor. If you have a large number of changes, rename your old unimod.xml file to usermod.xml and copy it to mascot/config/unimod, over-writing the existing file. A few seconds later, a new unimod.xml will be created automatically in mascot/config. The only time this won’t work is if you had edited unimod.xml to create a new entry in the elements or mod_bricks sections. If this is the case, please contact support for guidance.

Installation Tips

Windows: It is essential that IIS is correctly configured before installing Mascot. Refer to Chapter 3 of the Mascot Server Installation & Setup Manual for details.

Linux: If you are unsure how to mount the ISO file, try something like this:

sudo mkdir /mnt/mount_point
sudo mount -o loop mascot_2_8_0_linux.iso /mnt/mount_point