This guide is meant to get you up and running quickly with SEURAT. To do this it makes several assumptions about how you will install SEURAT. If your situation does not match these assumptions then please refer to our more detailed Installation and Administration Guides on our website at www.synapticscience.com

In this guide we are assuming:

That you will install the SEURAT Client and SEURAT Server both onto the same Windows Vista, XP Professional - SP2, 2000, 2000 server or 2003 server machine.
That you will be using the Synaptic Science native database schema that comes with SEURAT. If you want to configure SEURAT to talk to your existing database please refer to the SEURAT Database Mapping Guide on our website.
You will load the test cMet dataset as the test data for use with SEURAT.
This is the first time you are installing SEURAT. IF you are upgrading from an earlier version then you will need to read the Installation and Administration guides for SEURAT.

2 Installation Requirements

As SEURAT is a pure Java application it can run on any platform supporting a Java 1.5 or greater JVM. Starting with version 5.0 of SEURAT you must use at least a 1.5 JVM.

The SEURAT Server has been successfully deployed under Windows, AIX and Linux. The SEURAT client has been successfully deployed under Windows (Vista, XP, 2000, 2003 Server), AIX, Linux and Mac OSX.

If your particular platform or configuration does not seem to be supported please contact us at sales@syanpticscience.com. As long as your platform supports 1.5 JVM or greater SEURAT will be able to run on your platform.

The installation requirements for Windows are:

You have requested and received from Synaptic Science an evaluation license. You should have received two license files named seurat.lic and license.cxl. If you have not then please contact Synaptic Science support at support@synapticscience.com
Windows Vista, XP Professional - SP2, 2000, 2000 server or 2003 server machine (laptop or desktop) with at least 512 Megabytes of memory.

NOTE: For Windows Vista installations you MUST use right mouse click -> run as administrator when running the downloaded installers otherwise the SEURAT installers for the client and server will fail to run.

You must run the SEURAT Server installer as a windows Administrator.
There is no need to install a version of Java separately as the SEURAT installers come bundled with the correct version of Java in order to run the SEURAT platform.
The SEURAT Server installer will attempt to install PostgreSQL during the installation process. PostgreSQL requires that a windows service account be used to run the PostgreSQL processes for security reasons. The service account must have the following rights:

Log on as a service
Log on locally

You can either create the windows service account before running the SEURAT Server installer and supply that username during installation or you can let the installer attempt to create the service account for your.

In the later case you will need to be sure that you run the installer under an account (most likely an Administrator account) that can grant the required privileges to the service account

3 Installation steps

3.1 SEURAT Server

Download the SEURAT WebStart Client and SEURAT Server installers from the download link on our website at http://www.synapticscience.com/seurat/download/

Run the SERUAT Server installer taking all the defaults.

NOTE: For Windows Vista installations you MUST use right mouse click -> run as administrator when running the downloaded installers otherwise the SEURAT installers for the client and server will fail to run.

You will be asked to supply a PostgreSQL database super user password and a windows service account password in the “Information For PostgreSQL Installation” dialog window as shown below. Make sure you keep a note of the two passwords you enter in this dialog then click the “Next” button.

Select the Start->All Programs->SEURAT Server->SEURAT Server menu option created by the SEURAT Server installer and if everything is configured correctly you should see a screen like the one shown below:

3.1.1 Manually Installing SEURAT Server as Windows Service

The SEURAT Server installer will create a Windows Server configure to start on reboot/restart of your windows machine. If you elected to not install the Windows Service by unchecking the “Install a Windows Service” checkbox during installation you can manually create the Windows Service by executing the following steps:

1. Open a windows command window and cd to the SEURAT Server bin directory (which is C:\Program Files\SynapticScience\SEURATServer\bin by default).

2. Define the environment variable JAVA_HOME to point to the top level directory of an installed version of the j2sdk1.4.2_12 SDK. So for example if you had the SDK installed in C:\j2sdk1.4.2_12 you would need to issue the command “set JAVA_HOME= C:\j2sdk1.4.2_12”

a. NOTE: Pointing JAVA_HOME to the jre that comes bundled with the SEURAT Client and SEURAT Server after installation for this step WILL NOT WORK as the JavaService.exe program we are using to install SEURAT as a service requires the tools.jar jar file that only comes with the JDK. You will need to go to the sun website and download and install the SDK and then make JAVA_HOME point to the install location you choose.

3. Define the environment variable SEURAT_HOME to point to the top level directory of the SEURAT Server. Assuming an installation into the default directory that would be achieved by the command “set SEURAT_HOME=C:\Program Files\SynapticScience\SEURATServer”

a. NOTE: DO NOT put double quotes around the path specified in the setting of the SEURAT_HOME environment variable as the InstallSEURATAsService.bat file will take care of dealing with the spaces in the name.

4. Assuming you installed the SEURAT Server into its default location issue the command “.\InstallSEURATAsService.bat pgsql-8.1 –auto” to install the SEURAT Server as a service. The service will appear in the Services window under the Administrative Tools section of the Control Panel with the name “SEURATServer”

a. Note that although this will create a service to run the SEURAT Server that will start automatically upon system restart you still have to manually start the service after it has been installed (or you could reboot the machine to test that it starts automatically). You can start the SEURATServer service once installed either by issuing the command “net start SEURATServer” or by navigating to the Services window of the Administrative Tools section in the Control panel and using the GUI there to start the service from the list of Windows Services.

b. The first argument pgsql-8.1 passed to the command to install the SEURATServer service is the name of the PostgreSQL database service and denotes the fact that the SEURATServer service depends upon the PostgreSQL service having been started before it will itself be started. This means that the SEURATServer service will not start unless the PostgreSQL database service is running.

c. If you chose to install the SEURAT Server into other than the default directory then make sure you set SEURAT_HOME appropriately.

If you ever want to uninstall the SEURATServer service created in step 5 then issue the command “JavaService -uninstall SEURATServer” from the same directory in which you issued the InstallSEURATAsService.bat command with all the same environment variables defined.

3.2 SEURAT Client using Webstart Installer (Recommended)

The SEURAT WebStart Client allows a team to evaluate the collaborative features (emailing of job links to colleagues, easy web based deployment of documents and upgrades, etc…) of SEURAT in greater depth.

To install and run the WebStart version of the SEURAT Client do the following:

Download the latest WebStart SEURAT Client version from the downloads page of the Synaptic Science website (named SEURATClientWebstart_VX.X.jar where X.X represents the current version).
Unzip or unjar the contents of the file to create a directory named SEURAT-jetty in the directory into which you decide to unjar the jar file contents.
Open a windows command window.
Change directory into the SEURAT-jetty directory created by unjar’ing the contents of the jar file.

Run the following script:

(on Unix, Linux) sh initconfigfiles.sh
(on Windows) initconfigfiles.cmd

Edit the file etc/SEURAT-jetty.properties

Set “jetty.host” to be the hostname accessible to we clients
Set “jetty.port” to the port of your choosing.
Save the file.

Place a copy of your license file for chemaxon products as the file:

webapps/SEURAT/license.cxl

Issue the command “java –jar start.jar” (omitting the double quotes used here for emphasis)
Open a web browser (Firefox, IE or Safari) and enter the URL http://localhost:9080/seurat then click on the “Run SEURAT web start” button in the page that is displayed (see below):

Alternatively you can click the “Example cMet Screening Cascade” link to be taken to a test report that is bundled as part of the SEURAT evaluation. This is a good example of how SEURAT Web Services can be used to make SEURAT Reports and analysis features available through your companies web portal or email.

You will then be presented with a sequence of WebStart dialogs as the SEURAT Client is downloaded form the jetty webserver hosting the WebStart version of the SEURAT Client and will be asked to trust the application.

Please answer yes/allow to all such questions.

You will then be presented with the SEURAT Login window like the one shown below:

In the login window enter a username of demo and a password of demo and click Connect or hit Enter.

Once logged in you will see the List Manager (initial) screen within SEURAT with the Search Portal tab selected as shown below

Click on the Quick Search button and on the Quick Search (as shown below) enter the identifiers 31137, 31437 and hit return (or click get results).

You should see a screen like the following after a few seconds

To learn about how to use the full set of SEURAT features please refer to the SEURAT Users Guide on our website.

If you encounter any problems following these steps please report them to support@synapticscience.com, post a question to the forum link on our website or call our offices at 301 915 0274.

To learn how to configure SEURAT and how to share your results with your colleagues please refer to the SEURAT Administrators Guide, SEURAT Database Mapping Guide and the SEURAT Users guide on our website www.synapticscience.com

Continue on to the next section if you want to learn how to install the jetty web server as a windows service so that it will always automatically be running after a server machine restart.

3.2.1 Installing jetty as windows service

(in your  <jetty-root>/bin)

Jetty-Service.exe --install jetty-service.conf

or

Jetty-Service.exe -i jetty-service.conf

3.2.2 Starting jetty as windows service

(in your  <jetty-root>/bin)

Jetty-Service.exe --start jetty-service.conf

or

Jetty-Service.exe -t jetty-service.conf

3.2.3 Stopping jetty as windows service

(in your  <jetty-root>/bin)

Jetty-Service.exe --stop jetty-service.conf

or

Jetty-Service.exe -p jetty-service.conf

3.2.4 Removing jetty as windows service

(in your  <jetty-root>/bin)

Jetty-Service.exe --remove jetty-service.conf

or

Jetty-Service.exe -r jetty-service.conf

3.2.5 Troubleshooting Installing the Service

3.2.5.1 Jetty-Service.exe must be run by a user with Administrator privileges

The above application (Jetty-Service.exe) must execute with administrator rights otherwise, it fails.

3.2.5.2 Getting an error 'OpenSCManager failed' on Windows Vista

In Vista, even with administrator account the service fails to install. Giving an error 'OpenSCManager failed'.

Below is the solution to this problem. This will now open a command prompt window with administrator rights.

Go to Start | All Programs | Accessories, then right-click on "Command Prompt", and select "Run as administrator".

3.2.5.3 Specifying which Java command to use

To force the service to use a java command that is different from the default, add the following line to the jetty-service.conf file:

wrapper.java.command=<path_to_java>

Example:

wrapper.java.command= C:\Program Files\Java\jre1.6.0_04\bin\java.exe

3.3 SEURAT Client using Windows Installer (Citrix / Remote Desktop)

Run the downloaded SEURAT Client installer for Windows and accept all defaults for the SEURAT Client as well as for the PyMol installation screens that will be kicked off by the installer.

To start the SEURAT client select the Start->All Programs->SEURAT Client->SEURAT Client menu option and after a few moments and the presentation of a splash screen you should be presented with the SEURAT login in screen.

Enter a username of demo and a password of demo and hit Enter or click the “Connect” button.

4 Troubleshooting

This trouble shooting section only documents problems that may be encountered during the installation process.

For troubleshooting tips on administering the SEURAT platform see the Troubleshooting section of the SEURAT Administrators Guide which is available from the “Start->All Programs->SEURAT Server->Administrators Guide” menu item.

For troubleshooting tips on using SEURAT in general see the Troubleshooting section of the SEURAT Users Guide which is available from the “Start->All Programs->SEURAT Client->Users Guide menu item.

4.1 SEURAT Server Installation

4.1.1 PostgreSQL Installation Automatically Uninstalls Itself

4.1.1.1 Description

At the very end of the PostgreSQL installation wizard the PostgreSQL installer issues an error and automatically uninstalls itself.

4.1.1.2 Cause

You are attempting to install the SEURAT Server from a non windows administrator account or an account that cannot grant the “Log on as a service” and “Log on locally” rights to the windows service account the PostgreSQL installer tried to create during installation (or the account you created before installation and specified to the installer did not have these rights).

4.1.1.3 Solution

Please log into the machine as a windows administrator and re-run the installer.