Admin Training 005

Overview

Resources for training.

Topics Covered

• Drip feed mojo and data source

• Wrapper script installation and use

• Manually running drip feed (no script)

• Wiring a cron job

Video

• Admin Training 005 Video

Script

Following is a script for the attached video.

Preparation:

• Login to prod server via command-line interface to show files involved, cd ~/home/code/admin/mojo, ls *delta*

• Login to https://mgr.servers.aceworkspace.net/apps/ihtsdo-archiva/repository/all/org/ihtsdo/intl/release/process/wb-release-process/.  Do not force log in/refresh.

Briefly describe the drip feed:

• Mojos:  Show the TerminologyRF2DeltaLoader

  • Explain this is configured for SNOMEDCT, i.e. dpnTypeId, dpnrefsetId

  • Drip feeds for other terminologies will need custom handling

• Data source:

  • Either obtain automatically through maven

  • Download from aceworkspace repository

    • Explain forcing log in and refresh using non-functional link

Wrapper script: more ~/bin/loadDelta.csh and describe sequence

• As with all wrapper scripts, find them in ~/bin

• cd ~/bin/, more loadDelta.csh
  
  

• Note the config properties to set (MAPPING_CODE, MAPPING_CONFIG, MAPPING_DATA)

• Tomcat server shut down: explain this is necessary to prevent indexing issues

• Delete current delta files

  • Note the version requirements here (e.g. 1.20-SNAPSHOT).  This must be changed every release cycle.

• Get the current delta files and unzip them

  • Note the version requirements here (e.g. 1.20-SNAPSHOT).  This must be changed every release cycle.

• Run the TerminologyRF2DeltaLoader mojo

• Remove and regenerate SNOMEDCT tree positions

  • Note that these steps are very time-consuming, don't be surprised

• Recompute workflow

  • Note the refset ids passed as argument

• Restart the tomcat server.

Manually obtaining data and running drip feed

• Reference obtaining data from start of video

• Use the same process described in the wrapper script, except don't use the delete data/get data steps.  Process is then:

  • Shut down server.

  • Run the TerminologyRF2DeltaLoader with inputDir set to the location of your files

  • Remove and regenerate SNOMEDCT tree positions

  • Recompute workflow

  • Restart tomcat server

Wiring to cron job:

• crontab:  program used to install, remove, or list the current cronjobs

• Demonstrate crontab -l, crontab -e

• Note MAILTO and column headers, direct to online documentation

References/Links

• n/a