wiki:ServerAdministration

Version 24 (modified by Fredrik Levander, 12 years ago) (diff)

--

Proteios SE server administration

Some configuration of the Proteios SE server is needed to enable all features. Furthermore, the administrator also needs to create user accounts and activate plug-ins, see the administration part of the user guide.

Tomcat memory settings

Tomcat by defaults run with little memory allocated to the Java Virtual Machine. Some Proteios SE plug-ins will require more memory, as will multiple concurrent users. It is thus recommended that you change the memory allocation to at least 512Mb. Depending on Tomcat version and base system, this can be done in different ways. Basically you'd like to set the environment variable JAVA_OPTS for tomcat to -Xmx512m (or higher).

  • On a SuSE Linux 11.x system with tomcat6 installed from YAST, you can edit JAVA_OPTS in /usr/share/tomcat6/conf/tomcat6.conf (10.x system and tomcat55 /srv/www/tomcat55/base/conf/tomcat55.conf).
  • If running Tomcat as a Windows service you can access the Java memory settings by the Monitor Tomcat tray icon.
  • Also see: Tomcat wiki.

Web server security

If you have Internet access to your Proteios SE server, it is advisable to use SSL encryptation of the connection, since passwords and settings are otherwise sent without encryptation. This is discussed here. Also see ssl-howto for Tomcat.

FTP Server

The integrated Proteios SE ftp server needs to be started separately, see.

Configuration of Proteios SE Access to External Programs

Proteios SE supports use of some external programs for processing data files. The benefit of running the analysis from Proteios SE is that several data files may be selected for an analysis using the same parameters, and the result files will be automatically uploaded to Proteios SE. Some external programs are accessed via a web site, while others are typically installed on a local server. Proteios SE configuration settings for external programs are stored in text files named *.properties, stored in directory WEB-INF/classes/ in your Proteios SE installation. Template files for the configuration files are stored in the same directory with names ending in .properties.in. These files contain information on the available parameters.

Search Engine Configuration - General

There are several search engines that can be accessed directly from Proteios SE. The server administrator needs to edit the configuration files of these to point to the right URLs. Furthermore, for the Proteios SE results combination of multiple search engines, exactly the same databases need to be installed for the different search engines, with a random/reverse part that has a specific prefix for all the random entries. Matrix Science provides a free script to generate such a database. Here you can download a modified script which will name modified IPI:IPI entries IPI:IPRNDx.x or IPI:IPREVx.x for easy parsing of accession numbers. Other entries will have a ###RND### or ###REV### prefix. The script should be run with the --append option so that the decoy database is added at the end of the existing database. If you plan to do PMF searches or 'no enzyme' searches, the --random option is preferable. If you use local reference (.dat) files for Mascot IPI databases, the .dat will also need to be expanded using this script

X!Tandem configuration

Locate the Proteios X!Tandem search properties file xtandem.properties, which can be found under WEB-INF/classes in your installation. If not existing, locate the Proteios X!Tandem search properties file template xtandem.properties.in, and copy it to a file named xtandem.properties in the same directory.

Edit the xtandem.properties file by setting the value of the following parameters (more information and examples can be found in the file):

  1. Set the value of xtandem.gpm.server.url to the URL for the GPM web site to use for the search.
  2. Set the value of xtandem.gpm.result.filename.prefix to the prefix used for result files.
  3. Set the value of xtandem.gpm.server.timediff.hours to the time difference in hours of a GPM server in another time zone.
  4. Set the value of xtandem.gpm.server.timediff.correction.minutes to the difference in system clock settings.

The other settings can normally be used with their default values. For a local GPM install the commented settings in the xtandem.properties file can be used. If you are not sure about the GPM result filename prefix, just "GPM" should work in most cases. Otherwise, run a search through the web interface and check how the result is named.

OMSSA configuration

Install OMSSA according to the instructions at OMSSA download pages. Process your fasta databases using formatdb from the Blast distribution. The output files from formatdb should all be located in the same directory. Locate the Proteios OMSSA search properties file omssa.properties. If not existing, locate the Proteios OMSSA search properties file template omssa.properties.in, and copy it to a file named omssa.properties in the same directory.

Edit the omssa.properties file by setting the value of the following parameters (more information and examples can be found in the file):

  1. Set the value of omssa.local.install.path to the path for the locally installed OMSSA search engine.
  2. Set the value of omssa.local.program.name to the name of the OMSSA search program (normally "omssacl").
  3. Set the value of omssa.local.database.directory.path to the path of the local directory, where the sequence libraries (databases) are installed.
  4. Set the value of omssa.local.input.basename to base name of the created OMSSA input files (a time stamp will be added to make the final name). The default choice is "omssa_input.xml".

The settings above concern a locally installed OMSSA search engine, which is currently supported.

Mascot configuration

Mascot searches can be conducted in batch from Proteios SE similarily to X!tandem searches, and search results from Mascot Daemon searches can be retrieved in batch. For this to work, you need to edit the mascot server settings in the file mascot.properties, which can be found under WEB-INF/classes in your Proteios SE installation. After editing the file you need to restart Tomcat.

msInspect feature detection configuration

Proteios SE supports msInspect feature detection, when installed as a JAR file available from http://proteomics.fhcrc.org/CPL/msinspect/index.html. A release or nightly build of msInspect newer than March 2010 should be used for full mzML functionality. Locate the Proteios SE msInspect search properties file msinspect.properties. If not existing, locate the Proteios SE properties file template msinspect.properties.in, and copy it to a file named msinspect.properties in the same directory.

Edit the msinspect.properties file by setting the value of the following parameters (more information and examples can be found in the file):

  1. Set the value of msinspect.local.install.path to the path for the directory in which the msInspect JAR file is installed.
  2. Set the value of msinspect.local.program.name to the name of the installed msInspect JAR file (normally of type "viewerApp*.jar", where '*' represents an optional time stamp and serial number).
  3. Set the value of msinspect.memory_in_megabytes to the memory in MB to use for the Java Virtual Machine, when running the msInspect program (at least 512 MB is recommended).

PIKE configuration

Proteios SE can access a PIKE web site to fetch information for input protein list files, and upload the result files. The PIKE server settings are stored in file pike.properties, which can be found under WEB-INF/classes in your Proteios SE installation. The default settings can normally be used, but the file may be edited if you want to access another PIKE web site. After editing the file you need to restart Tomcat.

Retrieval of remote files

Remote files can be registered by their URI and used in Proteios as if they were located on the Proteios server. Click here to read about how to configure your server to access files via https using certificates (needed for BILS).

Attachments (2)

Download all attachments as: .zip