Mascot Server version 2.7

Updating and upgrading procedures

Known Issues

Incompatibility with certain AMD Opteron CPUs on Linux

The Mascot Server 2.7 executables on Linux require the SSSE3 instruction set on the host processor. This instruction set is available on all Intel CPUs since the Intel Core 2 architecture (2006). The instruction set is available on all AMD CPUs since the Bulldozer microarchitecture (2011). However, most AMD CPUs manufactured before 2011 are incompatible with Mascot 2.7. Incompatible models include all AMD Opteron CPUs manufactured before 2011.

If you are updating from Mascot 2.6 or earlier on Linux, and your CPU or CPUs were manufactured before 2011, please check that the CPU implements the SSSE3 instructions. The easiest way is to inspect /proc/cpuinfo and look for ssse3 on the flags line. If the instruction set is missing, please contact us to discuss your options.

Only the Linux version is affected. The Windows version of Mascot 2.7 uses the SSSE3 instruction set if it is present in the host processor, but does not require it.

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.7 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_7_0_linux.iso /mnt/mount_point