Skip to content

Create a Development Instance

Jump to bottom
bbimber edited this page Oct 5, 2023 · 2 revisions

  1. Follow these instructions to install the LabKey dependencies, including Apache Tomcat and a database: https://www.labkey.org/Documentation/wiki-page.view?name=devMachine

  2. Next, you need to check out the source code from various repos. Below is a scriptable way to accomplish this, based on the code used in our CI:

#!/bin/bash

# Update this to match the target release:
export GITHUB_REF=discvr-XX.X
export GITHUB_BASE_REF=$GITHUB_REF
export GITHUB_EVENT_NAME=
export NO_SHALLOW=1

# Update this to the local folder where you want to create the enlistment:
export HOME=/c/Projects/
cd $HOME

if [ ! -e discvr-lk ];then
	mkdir discvr-lk
fi

cd discvr-lk
wget https://raw.githubusercontent.com/bimberlabinternal/DevOps/master/githubActions/discvr-build/doBuild.sh
bash doBuild.sh
rm doBuild.sh

  1. Ensure the build works, and that you can start the server. I highly recommend Intellij for working with Labkey (https://www.jetbrains.com/idea/). You can get a free student license.

  2. The selenium automated tests are a useful tool to create a local development environment. See here for instructions here, specifically for Functional Tests: https://www.labkey.org/Documentation/wiki-page.view?name=runningTests.

Clone this wiki locally