NIH | National Cancer Institute | NCI Wiki  

WIKI MAINTENANCE NOTICE

Please be advised that NCI Wiki will be undergoing maintenance on Thursday, May 23rd between 1200 ET and 1300 ET.
Wiki will remain available, but users may experience screen refreshes or HTTP 502 errors during the maintenance period. If you encounter these errors, wait 1-2 minutes, then refresh your page.

If you have any questions or concerns, please contact the CBIIT Atlassian Management Team.

Building and Installing using Jenkins

  1. A new release will be tagged in the github project https://github.com/ncievs/nci-protege5.git
  2. Navigate to Jenkins at https://evs-jenkins.nci.nih.gov/jenkins/job/_default/job/_lower/job/_Protege/
  3. Choose protege_build > Build with Parameters and select the appropriate tag in the BRANCH_OR_TAG selection box and click Build
  4. Review the Console Output for any errors
  5. For Dev, choose protege_deploy_dev > Build with Parameters. You should be presented with the same tag. Click Build
  6. Review the Console Output for any errors
  7. Check the protege dev server and see that the /local/content/protege/protege-server and protege-desktop have been updated
  8. Confirm the service has started by checking /local/content/protege/logs/protserv-console.txt for "Admin server has started at port 9091"

Manual Build

Building a new Protege version on Dev using Ant

  1. A new release will be tagged in the github project https://github.com/ncievs/nci-protege5.git
  2. Clone the new release into a new directory in /local/project.  "git clone https://github.com/ncievs/nci-protege5.git nci-protege-V<tag>"
  3. Enter into the scripts subdirectory "cd nci-protege-V<tag>/scripts/"
  4. Run the build script, passing in the version number "./build.sh <tag> ncievs >> build.log".
  5. Review the output for errors or build failures: "cat build.log | grep FAILURE"
  6. Check the structure of the build.  The following folders and files should be present under <build-location>/nci-protege5/scripts/nci-protege5
    • binaryowl
    • explanation-workbench
    • metaproject
    • nci-protege_<date>.tar.gz
    • nci-protege_<date>.zip
    • owlapi
    • protege
    • protege-server
    • run-protege.sh
    • run-server.sh

Installing the server build

  1. Navigate to the running instance of protege, on Dev this is /local/content/protege/scripts/
  2. Shutdown the protege server: "./shutdown.sh" 
  3. Archive the previous version of the services, which are these 2 directories in /local/content/protege:
    • protegeserver
    • protegedesktop
  4. Copy the new protegeserver into the service directory "cp -r <build-location>/nci-protege5/scripts/nci-protege5/protege-server/target/server-distribution/server /local/content/protege/protegeserver"
  5. Copy the new protegedesktop into the empty desktop directory "cp -r 

    <build-location>/nci-protege5/scripts/nci-protege5/protege/protege-desktop/target/protege-5.<version>-SNAPSHOT-platform-independent/Protege-5.<version>-SNAPSHOT /local/content/protege/protegedesktop"

  6. From the /local/content/protege/scripts directory start the protege server: "./run-background.sh".  The server should start almost immediately
  7. Confirm the service has started by checking /local/content/protege/logs/protserv-console.txt for "Admin server has started at port 9091"


Shutdown/Startup of Services

Shutdown

  1. Navigate to /local/content/protege/scripts/
  2. To shutdown the protegeserver: "./shutdown.sh" 

Startup

  1. Navigate to /local/content/protege/scripts/
  2. To startup protege server: "./run-background.sh"
  3. Do "tail ../logs/protserv-console.txt" to check that the protege server is running.
  4. Server is started when you see "Admin server has started at port 9091"


  • No labels