Installing Desktop Applications

Installation of Cresset’s desktop applications FieldStere, FieldAlign, FieldTemplater and FieldView is usually straightforward, all use a similar set of steps detailed below, FieldStere requires additional steps to install the FieldStere databases.
On first execution, some operating systems will warn that the Cresset applications are requesting access to the internet. For solely local operation, the applications do not require internet access and can be blocked by the firewall. However, to access remote resources or a remote FieldEngine server, internet access will be required.

Licensing

Cresset applications require a valid license file to function correctly. A license file is available from your account manager or from sales@cresset-group.com.

Single User License

If you have been provided with a single-user license file from Cresset, then place it in one of the locations specified here.

Site, Node-locked or Counted License

Cresset uses the Reprise License Manager for licensing. Using RLM involves running a server which is responsible for handing out licenses to software that you wish to run. A full end user manual is available here.
Full instructions on installing and maintaining the license server are available here. If you have any problems with licensing then please contact Cresset support.

Installing the main applications

Windows

1. Browse to the Windows folder of the distribution media or locate the installer in your downloads folder
2. Double click the executable file. Installers are named according to the application and version that you are installing, e.g. FieldAlignInstaller_3.0.1)
3. Follow the on-screen instructions. If you have a previous version of the application installed then this will be removed before installation of this version.

Linux

1. Browse to the Linux directory of the distribution media or navigate to your downloads directory
2. Applications can be installed using a relocatable rpm or from a tgz file.
3. To install from a re-locatable rpm package using the command

   rpm -i cresset-<appname>-<vers_nos>-1.i386.rpm

   where “<appname>” is the name of the application that you are installing and “<vers_nos>” is the version number of the application that you are installing.

4. Alternatively unpack the supplied tgz file to a suitable location (e.g. $HOME or /usr/local or /opt).

Mac OS X

1. Open the supplied disc image
2. Drag the application icon onto the “Applications” icon to install the application in the Applications folder.

Installing FieldStere Databases

FieldStere fragment databases can be installed:-

• using the supplied installer
• using the built-in database downloader and installer
• by copying to the appropriate location

On Windows and Linux the supplied installer should be run as an administrator if the databases are to be installed to a system location. On Mac it is easiest to copy the databases to the desired folder. A full list of database folders is given below.

Cresset supplies 5 databases containing fragments from commercially available compounds. These have been divided based on the frequency with which the fragments were observed to create:-

• 3 "Common" fragments databases requiring a total of 4Gb of disk space
• 2 "Rare" fragments databases requiring 4Gb of disk space each

We recommend installing at least the “VeryCommon”, “Common” and “LessCommon” databases as these cover most fragments that are convenient to synthesize.
Databases can be installed to any location including network disks but please note that FieldStere will run slower if accessing the databases via a network. Also if multiple FieldStere processes are running then there is likely to be a significant load placed on the network infrastructure during the database searching tasks.
To perform a standard installation, browse to the Databases folder of the FieldStere distribution media and execute the appropriate installer for your architecture.

Windows

1. Browse to the Databases folder of the FieldStere distribution media
2. Double click the “FieldStere_Database_Installer_<vers>.exe” executable file
3. Choose which databases to install (detailed above) and follow the instructions
4. Alternatively the database files can be copied to a custom directory and their location set through the “FIELDSTERE_CRESSET_DB” environment variable

If installing the databases on Windows 7 for “All Users” then we strongly recommend that you execute the installer in “Run as Administrator” mode.

Linux

Run the “install_fieldstere_databases.sh” program. You will need to give the install script the path to the FieldStere installation (/opt by default):

./install_fieldstere_databases.sh /path_to_installation/cresset/FieldStere

The installation script will prompt you for which databases you wish to install then copy the appropriate files to the databases folder of the FieldStere installation.
If you wish to install the databases to a custom location then simply copy the database files to the desired folder:

cp *fsd /custom/location

then set the FIELDSTERE_CRESSET_DB environment variable to point to this location. This variable acts as a PATH that FieldStere uses to find appropriate databases files and hence can incorporate multiple locations.
If you have the FieldStere database generator then the location that this creates databases and that is searched for custom databases is set by the environment variable FIELDSTERE_DB.

Mac

Copy the databases from the distribution media to the one of the locations shown in the table below.

Installing databases using the database updater

The database updater uses a small xml file to keep track of databases that are available for installation. By default this file contains information on Cresset supplied databases and updates but can be modified to include custom and proprietary databases, contact Cresset support for more information. If an update to an existing database or a new database is available then the database updater application will download and install the database to your computer. Note that administrator privileges will be required to install this to a system wide location. If the updater does not have the correct permissions to save the database to the default location then it will be saved to the user location (or the location specified by the environment variable FIELDSTERE_DB).

FieldStere Database Locations

C:\Program Files\Cresset-BMD\FieldStere\databases

%APPDATA%\Cresset-BMD\FieldStere\databases

/opt/cresset/FieldStere/databases

/path/to/install/directory/cresset/FieldStere/databases

/Library/Application Support/Cresset/Databases

$HOME/Library/Application Support/Cresset/

The variable $FIELDSTERE_CRESSET_DB