Maintenance Tools

Overview

This page documents the use of various other maintenance tools.

Prerequisites

• MySQL database must already exist (e.g. "mappingservicedb") and be loaded with production data.
• MySQL database connection parameters must be defined in the properties file specified by "run.config".
• IMPORTANT: The Tomcat server must not be running while this is run, otherwise indexes can get corrupted.

Details

A review of the "mojo" project reveals a lot of additional tools that can be used alongside the standard lifecycle management tools.  In fact, mojos are often a very convenient way of developing one-time or ad hoc tooling to make batch changes to the underlying data model.  These tools can properly bootstrap the environment allowing direct interaction with the internal service APIs supporting a very wide range of maintenance use cases.

Here are a few examples of tools that have been developed to enable certain maintenance tasks

Mojo:

• MapAdviceRemoverMojo.java (in admin/mojo/src/main/resources/java/org/ihtsdo/otf/mapping/mojo)

Project: admin/remover

Configuration Parameters

• A profile of "MapAdvice" must be used
• run.config - the standard configuration file specified as a -D parameter

• map.advice.name - the advice to remove

  • This mojo entirely removes an advice value from a project, from all records, and from the map advices table itself.

Mojo: TreeposComputerMojo.java (in admin/mojo/src/main/resources/java/org/ihtsdo/otf/mapping/mojo)

Project: admin/loader

Configuration Parameters

• run.config - the standard configuration file specified as a -D parameter

• terminology - the terminology to compute tree positions for specified as a -D parameter

  • Any existing tree positions should be removed before running this.

Mojo: TreeposRemoverMojo.java (in admin/mojo/src/main/resources/java/org/ihtsdo/otf/mapping/mojo)

Project: admin/remover

Configuration Parameters

• run.config - the standard configuration file specified as a -D parameter

• terminology -  the terminology to remove tree positions for specified as a -D parameter

Mojo: WorkflowFinishSpecialistEditingMojo.java (in admin/mojo/src/main/resources/java/org/ihtsdo/otf/mapping/mojo)

Project: admin/qa

Configuration Parameters

• run.config - the standard configuration file specified as a -D parameter

• refset.id - The refset id of the map project to process specified as a -D parameter.\

  • This tool performs a complicated workflow cleanup operation for a map project and is a good example of the kind of ad-hoc (but still reusable) processing that can be developed in this way.  See the class itself for details about what it does.