Page History

...

• As long as no changes have been made to the behavior of the startup scripts, the following files and scripts should be copied over from the old Protégé.Server version to the new folder:
  

     ru{}n_rmiregistry.sh
run_protege_ server_nci.sh
shutdown_protege_server.sh
codegen.properties
codegen.dat (the seed number will also need to be changed to 101000.  This can be accomplished by typing 'vi                    vi codegen.dat.'  Once in the vi editor, type 'shift + insert' and modify the seed number.  Press 'esc', then ':wq' to save and exit the vi editor).
     codegen.properties
     run_rmiregistry.sh
     run_protege_ server_nci.sh
     shutdown_protege_server.sh

• If you do need to use new scripts, make sure to adjust the memory upwards from the default in the run_protege_server_nci.sh script.  The following table dsisplays how much memory to allocate for each script, per tier.  You will also need to adjust the rmi.registry and rmi.server ports, the hostname and the metaproject location in this same file.  Please view Appendix A for port information for each tier.

• As long as no changes have been made to the behavior of the startup scripts, navigate to the Protégé.Client folder and transfer the following script:

     run_protege_BGT.sh (BiomedGT)  or  run_protege_NCIT.sh (NCIThesaurus)

• If you do need to use a new script, make sure the Xmx memory is adjusted upwards from the default (Appendix G).

• As long as no changes have been made to the behavior of the startup scripts,  navigate to the Explanation.Server directory and transfer the following files:

     start_explanation_server.sh
     restart restart_explanation_server.sh
     stop_explanation_server.sh

• If you do need to use a new script, there should be no edits that need to be made.

...

• Set transitivity by clicking the properties tag, and perform a search for the 'Anatomic_Structure_Has_Location' property. Select, and check the box marked transitive. Repeat the same step for the 'Anatomic_Structure_Is_Physical_Part_Of' property.

    Image Removed

• Set the display slots by clicking the NCIEdit tab, and clicking the "F" tab on the very far top right section of the page.  You will now be within the Form Editor section. Set the 'Display Slot' drop down to 'Preferred_Name'.

      Image Removed
 

• Next, click the Properties tab, and click the "F" tab on the very right.  Click 'OK'  for the forms dialogue box.  On the left hand menu, click on 'owl:DatatypeProperty, and set it's display slot drop down to 'Preferred_Name'.  Next, click on the owl:ObjectProperty on the left hand menu, and set its display slot drop down field to 'Preferred_Name' as well.
  Image Removed
  
  
• Click 'OWL' on the menu tab, and select 'preferences'.  On the General tab, Disable the drag and drop feature, and set the explanation server URL to 'http://<Protege Server Address>:<port>/explain
  Image Removed
  
  
• In the Tests tab, disable test of deprecated classes/properties.  This should be the fifth entry down. 
  Image Removed
  
  
• Click on the visibility tab from the window, and disable all the boxes in the MetaClasses section.  Close the window.
  Image Removed
  
• Click 'Project' on the menu bar, and select 'configure'. On the Tab Widgetss tab, enable only the following boxes from the Widgets tab and put in the following order:

     NCIEditTab
     LuceneQueryPlugin
     OWLPropertiesTab
     OWLMetadataTag
     ChangesTab
     ExplanationTab
     WorkflowTab
Image Removed
 

• Click on the 'options' tab and enable journaling and disable redo/undo. Image Removed 

• From the menu bar, select 'LuceneQueryPlugin" and select 'Index Ontologies. A window will pop up.  Check 'Use Phonetic Indexer' and select 'OK'.  After indexing has completed, a new lucene folder will be stored in the same directory as your database project file. Overwrite the old lucene folder with the new lucene folder in /app/protégé/data/.
  Image Removed
  
  
• Click File, Save Project As.  Name it with the current date and "DB".  Example: Thesaurus-yymmdd-DB.pprj.  This act of saving will create an Annotations project in the same directory as the main project. 

• Select File, Convert Project to File.  Store in app/protégé/data/Protégé_x.x/<PROTÉGÉ INSTANCE> labeled with the current date and "file". Example: Thesaurus-yymmdd-file.pprj.  Set the Language drop-down field to 'XML/RDF ABREV'.  You will notice a small dialogue box displaying the conversion progress.  This step may take approximately 30 minutes depending on the size of the database project. Once completed, the dialogue box should disappear, and the client should display the new file project. Image Removed 

• Close the project WITHOUT saving the file project, however, leave the Protégé client open.

• Open the nci_metaproject.pprj located at /app/protégé/data/<PROTÉGÉ INSTACE>/Meta/.  Click on the project tab underneath the SYSTEM-CLASS tab on the left-hand side menu.  Select the 'Instances' tab at the top of the page. You will notice an 'Instance Browser' section, and an 'Instance Editor' section. The instance browser specifies the display name of your project, and the Instance Editor specifies the path of your database project.  Click on the dispay project name and set the correct path to your project files. 
  
  
• Within the metaproject, the changes ontology projects (annotation files) should also not be made visible to users when trying to access a project on the server.  To configure the project display list, please view the DisplayInList setup instructions.

• Within the shell console, navigate to usr/local/protégé/Protégé_1.3/<PROTÉGÉ INSTANCE>/Explanation.Server-x.x.x and run ./start_explanation_server.sh -p <port> --url jdbc:mysql://<database server address>:<port>/<database name> -t <table_name> -U <db_username> -P <db_password>.   

• After the server has initiated startup, type 'tail -f nohup.out' to view start up status.  Within the nohup.out file, the explanation server has started when you see "Jena, Classification, and Extracting' all have been initialized, and finally a "Server started, listening on port xxxx" message. Image Removed

• Verify that the port numbers in the run_protege_server_nci.sh script correspond to the port numbers in run_rmiregistry.sh. Please refer to Appendix A for tier specific port numbers. 

...

• Connect to the server via Protégé client to confirm that the project is viewable from the GUI:  run_protege_<PROTÉGÉ INSTANCE>.sh.  Enter proper login information.
   
  Image Removed
   
• Select the desired proeject from the project display window. Image Removed 

• The client should now display the database project file, accesed via the Protege server.
  Image Removed
  

• Once tested, the client can now be posted up on the GForge website to be downloaded by users.