NIH | National Cancer Institute | NCI Wiki  

  • Created by Unknown User (parkj4), last modified by Unknown User (wileyal) on Jan 18, 2012

Protégé Software Updates

Software Updates Only

  • Copy the following folders and scripts from the previous version Protégé server folder to the newly created server folder: 
    run_rmiregistry.sh
run_protege\_ server_nci.sh
shutdown_protege_server.sh
PromptNCIPlugins.properties
protege.properties
codegen.dat

workflow folder
  • Navigate to the Protégé.Client folder and transfer the following script: 
    run_protege <PROTÉGÉ INSTANCE>.sh
protege.properties
PromptNCIPlugins.properties
  • Navigate to the Explanation.Server directory and transfer the following files: 
    start_explanation_server.sh
restart_explanation_server.sh
stop_explanation_server.sh
  • Open the start_explanation_server.sh file, and modify the following line to match the newest Protégé server version number: 
    protege_install=/usr/local/protégé/Protégé_x.x/<PROTÉGÉ INSTANCE>/Protege.Server-x.x.x
  • If there is a previous version of the explanation server running, shutdown is required before starting the new instance. To verify, type 'ps -ef | grep server' to view all running server instances. If an explanation server is running, you should see two different processes, one for the explanation server, as well as the Protégé server.
  • Navigate to the previous explanation server folder version (this folder should be located in the same directory as the newest version), and run the explanation server folder shutdown script (./stop_explanation_server.sh). You can type 'ps -ef | grep server' to verify that the explanation server process has been terminated:
  • Navigate to the new explanation server folder (usr/local/protégé/Protégé_x.x/<PROTÉGÉ INSTANCE>/Explanation.Server-x.x.x) and run './start_explanation_server.sh --protege-standalone --port <port> /app/protege/data/Protege_x.x/<PROTEGE-INSTANCE>/database-project.pprj. To determine the proper port number to use, refer to the tier specific info page. After the server has initiated startup, type 'tail -f nohup.out' to view start up status. Within the nohup.out file, the explanation server indicates it is started when you can see the message "Jena, Classification, and Extracting' all have been initialized, and finally a "Server started, listening on port xxxx .....".
  • After the explanation server is up and running, the same steps must be performed for proper Protégé server startup. If there is a previous version running, it must be shutdown before starting the new version. Type 'ps -ef | grep server' to view all server instances, and if a previous instance is running, navigate to the previous version's server folder (/usr/local/protege/Protege_x.x/<PROTEGE_INSTANCE>/<previous Protege server instance>, and run the server shutdown script (./shutdown_protege_server.sh localhost:<port>). Notice for the Protégé server shutdown script the port is passed as an argument. This will be needed for proper server shutdown.
  • Navigate to your Protégé server directory, and verify if there is a softlink to the workflow directory. This directory contains records of users assigned workflow tasks, and can be viewed from the NCI Workflow tab from the client, if proper workflow permissions have been provided. If the softlink is not present, type 'ln - /app/protégé/data/workflow'. This command will create a soft link to the workflow folder which is centralized in the specified directory.
  • Restart the server by running 'run_protege_server_nci.sh.' Type 'tail -f console.txt' to verify that it's up and running. You will see a message displaying "Protege server ready to accept connections".
  • Connect to the dev server via Protégé client to by navigating to the new client folder and running 'run_protege_<PROTÉGÉ INSTANCE>.sh'. Type in the username / password and select a project from the project list display window. Confirm that the project is viewable from the GUI.