Page info
title title

...

Servers

Related Programs/Services

• Reflection X (using "Direct" or xterm over SSH connection).
• F-Secure SSH Client
• F-Secure SSH Transfer
• Username and password advertised separately

Related Directory Structure in the Various Boxes/VMs

Production

• /usr/local/protegeqa/NCIThesaurusGroup/Protege.Server-x.y.z
• /usr/local/protegeqa/NCIThesaurusGroup/Protege.Client-x.y.z
• /usr/local/protegeqa/NCIThesaurusGroup/Explanation.Server-x.y.z

• Wiki Markup
  /app/protegeqa/data/\[EVS:PROTEGE INSTANCE\]

Dev, QA, Stage

• Wiki Markup
  usr/local/protege/Protege_x.x.x/\[EVS:PROTEGE INSTANCE\]/Protege.Server-x.y.z

• Wiki Markup
  usr/local/protege/Protege_x.x.x/\[EVS:PROTEGE INSTANCE\]/Protege.Client-x.y.z

• Wiki Markup
  usr/local/protege/Protege_x.x.x/\[EVS:PROTEGE INSTANCE\]/Explanation.Server-x.y.z

...

Dev, QA, Stage File Directory for Builds

• /app/protege/repo

Production Login and Basic Server Operations

• If the Protege Protégé server is brought down for maintenance, classification, Prompt analysis, and so on, the RMI can continue running.   While all the services need to be started (e.g. after a reboot), follow this order (see  see the following bullets below for details):
  • star RMI
  • start explanation server
  • start Protege Protégé server

• Remote login
  • Use reflection X (or SSH client if running the Protege Protégé client is not required).

• Start RMI registry (configure script to use port 2822 in production
  • From    From /usr/local/protegeqa/NCIThesaurusGroup/Protege.Server-x.y.z
  • Run     ./run_rmiregistry.sh

• Shutdown rmiregistry
  •  Kill Kill from OS (identify with ps -ef | grep rmiregistry)

• Start explanation server
  • From    From /usr/local/protegeqa/NCIThesaurusGroup/Explanation.Server-x.y.z
  • Run with option to periodically save the reasoner state at a desired time frame:      ./start_explanation_server.sh --port 8092 --protege-standalone /path/to/database/project/   --persistance persistence <numeric time value>
  • Run w/out checking for any changes in ontology:   ./start_explanation_server.sh --port 8092 --protege-standalone /path/to/database/project/   --no-ontology-sync

• Restart explanation server
  • From    From /usr/local/protegeqa/NCIThesaurusGroup/Explanation.Server-x.y.z
  • Run with option to restore to previous saved state of reasoner, as well as to check for any recent changes in the ontology from the previous saved state:     ./restart_explanation_server.sh --restore --persistancepersistaece

• Verifying explanation servers is starting up correctly
  • From    From /usr/local/protegeqa/NCIThesaurusGroup/Explanation.Server-x.y.z
  • Run     Run tail -f nohup.out

• Shutdown explanation sever
  • From    From /usr/local/protegeqa/NCIThesaurusGroup/Explanation.Server-x.y.z
  • Run     Run ./stop_explanation_server.sh
  • Note - after a shutdown, the server can't be "restarted", it must be "started" instead.

• Start Protege Protégé Server
  • From    From /usr/local/protegeqa/NCIThesaurusGroup/Protege.Server-x.y.z
  • Run     Run ./run_protege_server_nci.sh

• Shutdown Protege Protégé Server
  • From    From /usr/local/protegeqa/NCIThesaurusGroup/Protege.Server-x.y.z
  • Run     Run ./shutdown_protege_server.sh localhost:2822

• Verifying Protege Protégé servers is starting up correctly
  • From    From /usr/local/protegeqa/NCIThesaurusGroup/Protege.Server-x.y.z
  • Run      Run tail -f console.txt

• Start Protege Protégé client
  • From    From /usr/local/protegeqa/NCIThesaurusGroup/Protege.Client-x.y.z
  • Run      Run ./run_protege_NCIT.sh

Prompt Accept/Reject Cycle

• Advertise (email/chat) the server is going to be shutdown
• Clean up Pre-Merged, and Pre-Retired concepts.
• Remote login to the host computer using Reflection X
• Shut down Protege Protégé server
• Shut down explanation server
• Start Protege Protégé client
• Connect to database project by following the path: /app/protegeqa/data/Protege_1.2.3/NCIThesaurus/Thesaurus.pprj
• Enable Prompt Tab in menu (in Project --> Configuration dialog)
• Compare against previous baseline file / database project (pprj file).
• Accept/reject changes
• Save concept history (in "save" icon in 'Table View' tab)
• Disable PromptTab (in Configuration dialog)
• Adjust baseline version in Metadata tab
• In the Protege Protégé GUI menu, click 'Change',   'Clean up Changes Ontology'.   Ensure that 'Delete Changes' and 'Archive Changes' remain checked.   Click 'OK'.   After the process has been completed, click 'Change',   'Save Changes Ontology'
• Export file for the next Prompt comparison or publication
  • Click 'File' -, 'Convert Project to Format',   'OWL/RDF Files
    • this creates a new project .pprj file and associated OWL file, give it a name with a date suffix, example: ThesaurusInterim-071120.pprj
• Close project without saving, and exit client
• In Reflection X console, navigate to /app/protegeqa/data/Protege_x.x.x/NCIThesaurus and look for any Thesaurus accept files: (Thesaurus-accept.pprj, pjrn, .rdf, rdfs) and remove them from the directory by typing 'rm Thesaurus-accept.pprj' and so on for the other files.
• Start explanation server (always restart explanation server first before the Protege Protégé server)
• For production tier at the end of the month:
  • Reopen Protege Protégé client
  • Click 'Project',   'Configure',   enable 'OWL Classes Tab'
  • Click 'OWL', 'Classify Taxonomy'
  • Save the Inferred Ontology using the save button on the Inferred Hierarchy section.   Give the naming convention 'Thesaurus-Inferred-YYMMDD.owl
• Start up Protege Protégé server
• Verify Protege Protégé server is up
• Verify explanation tab communicates with the explanation server
• Exit remote program
• Advertise that the server is back up
• For end-of-the-month publications, after performing a prompt, notify Tracy, John, or Rob of the availability of the new baseline
• In the notification include: (a) the filename of the baseline and (b) the length of the time for the Prompt/export to file to complete.
• The raw exports (OWL files only) will be archived in the private FTP site,and the processed exports in the anonymous FTP site.   This will keep the Protege Protégé server clean and organized.

Database Load from File

• Remote login to the host computer using Reflection X
• cd to /usr/local/protegeqa/NCIThesaurusGroup/Protege.Client-x.y.z
• Start Protege Protégé client ('./run_protege_NCIT.sh')
• Load file from /app/protegeqa/data/Protege_x.y.z/NCIThesaurus (new project)
• Convert project to format (OWL/RDF database)
  • initial project - Thesaurus.pprj (as opposed to baselines)

• Configure project (see below, include Save, but don't Exit).
• Exit Protege Protégé without saving  saving (the Save gets done automatically during the conversion)

Configuring a New Project

• (already logged-in in the server box)
• Enable tabs
  • nciedittab
  • advanced query
  • properties
  • metadata
  • changes
  • explanation tab
• Disable extra tabs (OWLClasses, OWLInstances, OWLForms)
• Configure URL for explanation service.
• Enable journaling
• Disable redo/undo
• Set OWL Preferences to read 'Manchester Syntax'
• Set transitivity
• Set display slots to read 'Preferred Name' for the NCI Edit tab as well as Property Tag
• Disable drag and drop in 'OWL Preferences'
• Disable test of deprecated classes/properties
• Set Visibility tab to uncheck all MetaData items
• Generate Lucene indices
  • Move lucene index from /app/protegeqa/data/Protege_x.y.z/NCIThesaurus to the Proege server directory
• Save project
• Exit ProtegeProtégé

Configure

...

Protégé Server for a Project

• Edit run_protege_server_nci.sh   sh
  • to include the proper directory path for the nci_metaproject file - /app/protegeqa/data/NCIThesaurusMetaProject/
  • to use the correct rmi port (use 2822)

Classification (Standalone Mode)

• Advertise the Protege Protégé server is going to be shutdown
• Remote login to the host computer using Reflection X
  • username and password are advertised separately
• Shutdown Protege Protégé server
• Restart explanation server
• Start Protege Protégé client
• Connect to the database project
  • in /app/protegeqa/data/Protege_x.y.z/NCIThesaurus
  • file Thesaurus.pprj
• Enable OWLClassesTab (results are shown there)
• From the OWL menu, select 'Classify Taxonomy', it takes about 20 minutes
• Once classification is complete, an inferred hierarchy panel and a list panel are displayed
• Accept retreeing suggestions in the list panel as per guideline.
• Generate table to pass around to editors and mail it
• Process table from previous classification (accept/reject)
• Close project withtout saving
• Start Protege Protégé server
• Verify Protege Protégé server is running
  • connect to server from the client
  • exit the client
• Exit console
• Exit Reflection X

...

Classification (Client/Server) Mode

• From the client GUI, enable OWLClassesTab (results are shown there)
• From the OWL menu, select 'Classify Taxonomy' it takes about 20 minutes
• Once classification is complete, an inferred hierarchy panel and a list panel are displayed.
• Accept retreeing suggestions in the list panel as per guideline
• Generate table to pass around  around to editors and mail it
• Process table from previous classification (accept/reject)
• Close project without saving
• Exit the client.