NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This procedural guide is meant in performing a new Protege server build for both the NCI Thesaurus and BiomedGT instances.  Protege server builds can be performed either manually, or via automated run scripts.  Generally, using the automated scripts would be less time-consuming. However, it is recommended that going through the manual process (at least once) be performed to understand the concepts and the workflow of a Protege build.  Doing so will facilitate troubleshooting any future problems during a build.

...

Steps to complete a Manual Protégé Server Build Process for Dev, QA, and Stage Tiers

 **You will need tier-specific info for Dev, QA, Stage before commencing the build. Production-tier information is separated, since the procedures and build information are a bit different than the other tiers.

...

     classification.url=$nci.base.url/classification/trunk
     classification.project=$projects/classification
         

     svn-url-1.34.properties (customized)

     ncitab.url=$nci.base.url/nci-branches/1.34/protegegui
     ncitab.project=$projects/ncitab

     nciconcepthistory.url=$nci.base.url/nci-branches/1.34/NCIConceptHistory
     nciconcepthistory.project=$projects/nciconcepthistory

     ncievshistory.url=$nci.base.url*/nci-branches/1.34*/NCIEVSHistory
     ncievshistory.project=$projects/ncievshistory

     classification.url=$nci.base.url/nci-branches/1.34/classification
     classification.project=$projects/classification

...

  • Navigate to <PATH>/trunk and open the 'local.properties' file and modify the 'PromptNCIPlugins.properties settings' section within the file. This info represents the tier's database connection information, and will need to be set before running the ant build commands. To edit the file using a Unix VI editor within the server console, type 'vi local.properties'. The file should now be displayed in the console.  Type 'Shift + I (eye)'  to enable editing, and utilize the arrow keys to navigate to the PromptNCIPlugins.properties section, and fill in the default database connection values with tier-specific values. Upon completion, type 'esc' to move out of editing mode, and type ':wq' to overwrite, save changes, and exit the file back to the console prompt.
  • Within the same directory, open the 'vesrion.info' file and modify the current version to the latest version (if necessary)  following the same steps as above.  By default, the version number will display as 1.1.10.   Save changes following the instructions above. 

Protege Server Build Ant Commands

You must run Run the following ant commands within the same directory as the build.xml file. The build.xml is usually stored in the same directory as the 'local.properties' and 'version.info' file.  Once the build.xml file is found, the ant build targets are now ready to be run:

...

If the build involves software updates that include any database code or schema changes,  skip to the 'Software Updates & Configuring New Database Project' section.  For builds that will only require software updates   connecting to an existing database project, please follow the 'Protege Software Updates' section.