This topic is provided to help administrators and developers migrate specific features to the 18.3 release.

Extract-Transform-Load (ETL)

The ETL module has been removed from the Community Edition and the functionality has migrated to the dataintegration module, available with all Premium Editions. Premium clients will not experience any change in functionality or interruption in service.

The announcement made on the Developer Forum about this change can be found here.

Developers with premium clients who have enlisted in the version control project and will be using ETLs in 18.3 and beyond will need to take the following steps in order to continue to use the premium 'dataintegration' module from Git. (Learn more about working with Git modules here).

  1. To obtain access, you will need to provide your LabKey Account Manager with the username of your GitHub account if you have not already done so.
  2. Clone the dataintegration module into your optionalModules directory.
  3. Sync your svn enlistment to remove the old svn module.
  4. Add a line like this to your settings.gradle file:
include ":server:optionalModules:dataintegration"
  1. Execute these two commands in this order to ensure that you clear out the old copy and are solely building and running the module from Git:
gradlew cleanBuild
gradlew deployApp

Create Chart View

The deprecated chart creation tool will be removed in 18.3 and existing chart views created by users will be automatically migrated to the updated implementation.

Premium subscribers have access to a variety of LabKey features outside of the community edition as well as professional support. Learn more about LabKey Premium Editions.

Windows Installer Decommission

The LabKey Server Windows-only Graphical Installer will be decommissioned as part of the 18.3 release in November 2018. Moving forward, virtual machine images will be provided with each release as an alternate method for evaluating LabKey Server on-premise. We encourage new users looking to evaluate LabKey Server to take advantage of the cloud-hosted trial version of LabKey Server.

Upgrading Servers Installed with the Graphical Installer

If you used the Windows graphical installer in the past and want to update your LabKey Server, first use the last release of the installer to upgrade it to 18.2. Find it in the archives here:

To migrate this windows-installed server so that it can be upgraded as if it had been manually installed, complete these steps:
  1. Backup your database to be safe and notify any users that the server will be down for a period of time.
  2. Delete the uninstaller, uninst.exe, that was bundled with the windows installer. You can find it in your $<LabKey_Home> directory.
  3. If you are upgrading any component, such as Tomcat, Postgres, or Java, you should also delete the LabKey tomcat service LabKeyTomcat7 using the registry editor (regedit).
  4. Follow the upgrade process documented for any local manual installation:


Was this content helpful?

Log in or register an account to provide feedback

expand all collapse all