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