This topic is under construction.

This topic shows example hardware/software configurations for different LabKey Server installations. These are intended as guidelines only -- your own configuration should be adjusted to suit your particular requirements. Installation instructions and supported technologies can be found at the links below:

General Recommendations

The following recommendations apply to all servers:

  • We recommend running three separate instances of LabKey Server, one for Testing, one for Staging, and one for Production.
  • For each instance (Test, Staging, Production), Tomcat and the main database (either PostgreSQL or MS SQL Server) should be running on the matching machines or virtual machines (M/VM).

Installation Scenarios

Small Laboratory Server

LabKey Web Server:

HARDWARE:

  • 2+ CPU, 4+ cores
  • 4GB RAM (minimum): 16GB is recommended
  • 64GB+ File Storage, 100+GB database storage
The following configuration is appropriate for a server holding MS2 data and running the Panorama module.
  • In the Production environment, the M/VM will have 2 CPUs (cores) and 4GB of memory.
  • As usage increases, increase the amount of memory to 8GB at a minimum (and also increase the memory used by Tomcat and PostgreSQL accordingly).

SOFTWARE:

Database Server:

HARDWARE:

  • Note that PostgreSQL is described here, but MS SQL would work just as well.
  • See Supported Technologies for version information.
  • Recommended Configuration Settings (see postgresql.conf file located in PGDATA directory):
    • Shared Buffers: 1024MB
    • Work mem: 10MB
    • Maintenance work mem: 1024MB
    • Checkpoint segments: 10
    • Checkpoint timeout: 15min
    • Random page count: 1.4
    • Effective cache size: 3072MB
    • join_collapse_limit: 10

SOFTWARE:

  • PostgreSQL or Microsoft SQL Server
    • Both database applications are supported by LabKey Server. Select the one best supported by your organization.
    • See our Supported Technologies page for the specific versions to use.

Large Multi-project Server

LabKey Web Server:

HARDWARE:

  • 4+ CPU
  • 8GB of RAM (minimum): 16GB is recommended
  • Storage (RAID):
    • 64GB+ of storage for OS and application binaries
  • OS: Linux or Windows
    • LabKey Server is supported on both Operating Systems. Select the operating system which is best supported by your organization
  • Network: 1Gb/s

SOFTWARE:

Database Server:

HARDWARE:

  • 4+ CPU
  • 8GB of RAM (at minimum)
  • Storage (RAID):
    • 64GB+ of storage for OS and application binaries
    • 100GB+ for database storage
  • OS: Linux or Windows
    • LabKey Server is supported on both Operating Systems. Select the operating system which is best supported by your organization
  • Network: 1Gb/s

SOFTWARE:

  • PostgreSQL or Microsoft SQL Server
    • Both database applications are supported by LabKey Server. Select the one best supported by your organization.
    • See Supported Technologies for the specific versions to use.

File Storage:

LabKey Server requires storage space for files (i.e. Site-wide FileRoot or Data Pipelines).

  • 256GB storage is generally sufficient.
  • Heavy users of flow assays require 512GB storage. This storage can either be attached to the LabKey Web Server or you can utilize a network attached storage system managed by your institution.

Apache Tomcat

  • See Supported Technologies for version information.
  • Configuration Settings:
    • Start-up Parameters (usually configured via the service startup script):
      • MaxHeapSize: 2GB (When using setting -Xmx2048M)
      • StartHeapSize: 256MB (When using setting -Xms256M)
      • Documentation: Configure Webapp Memory
    • Server configuration
    • Change the Tomcat session timeout
      • This setting controls how long before an idle login session is timed-out (i.e., the user is forced to log in again). By default the timeout is set to 30 minutes.
      • Documentation: Configure the LabKey Web Application
      • For servers which do not contain PHI or confidential information, most users change this value to 1 day (1440 minutes).

discussion

Discussion

Search 

Pages 

previousnext
 
expand all collapse all