This topic shows an example hardware/software configuration to support a LabKey installation. Your own configuration should be adjusted to suit your needs.  Installation instructions and supported technologies can be found at the links below:

• https://www.labkey.org/home/Documentation/wiki-page.view?name=manualInstall
• https://www.labkey.org/home/Documentation/wiki-page.view?name=supported

Assumptions

The configuration shown here is based on the following assumptions:

• For each environment (i.e., Production, test, development), Tomcat and PostgreSQL will be running on the same machine, or a virtual machine (M/VM)
• For Production environment the M/VM will have 2 CPU(core) and 4GB of memory
• • As your Production environment sees more usage, we recommend increasing the amount of memory to 8GB at a minimum (and then increasing the memory used by Tomcat and PostgreSQL accordingly).
• Test Environment will use M/VM with same configuration as Production.
• PostgreSQL instead of MsSQL (Both work just fine.)

Oracle JAVA

• Java Version: 8u111 or 8u112
• Use the ServerJRE distribution which is available at http://www.oracle.com/technetwork/java/javase/downloads/server-jre8-downloads-2133154.html

Apache Tomcat

• Tomcat Version: 8.5.9
• Use Binary distribution which is available at https://tomcat.apache.org/download-70.cgi
• Configuration Settings:
• • Start-up Parameters (usually configured via the service startup script):
  • • MaxHeapSize: 2GB
    • • When using setting -Xmx2048M
    • StartHeapSize: 256MB
    • • When using setting -Xmx256M
    • Documentation: https://www.labkey.org/wiki/home/Documentation/page.view?name=configWebappMemory
  • Server configuration
  • • We recommend using our sample configuration file. This configuration file contains our recommended settings described in our documentation.
    • Download of sample configuration file from
    • • If using HTTP-only: https://github.com/LabKey/samples/blob/master/ops/config-examples/server.xml
      • • Simply download this file and copy it to TOMCAT_INSTALL_DIR/conf/ directory, replacing the file shipped with the distribution.
      • If using HTTP and SSL: https://github.com/LabKey/samples/blob/master/ops/config-examples/server-SSL.xml
      • • Configuration of this file is a little more involved as you have to change the HTTPS connector configuration to use your SSL certificate.
  • 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.
    • Instructions: https://www.labkey.org/home/Documentation/wiki-page.view?name=configTomcat#8
    • For servers which do not contain PHI or confidential information, most users change this value to 1 day (1440 minutes).

PostgreSQL Configuration

• Version: 9.6.1
• Configuration Settings:
• • Server configuration(postgresql.conf file located in PGDATA directory). Recommended settings:
  • • 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