Building a new Protege version on Dev using Ant
- A new release will be tagged in the github project https://github.com/ncievs/nci-protege.git
- Clone the new release into your local build directory.
- The clone will create a directory "nci-protege5". Enter into the scripts subdirectory "cd nci-protege5/scripts/"
- Run the build script, passing in the version number "./build.sh versionTag ncievs >> build.log".
- Review the output for errors or build failures: "cat build.log | grep FAILURE"
- 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
- Navigate to the running instance of protege, on Dev this is /local/content/protege/scripts/
- Shutdown the protege server: "./shutdown.sh"
- Archive the previous version of the services, which are these 2 directories in /local/content/protege:
- protegeserver
- protegedesktop
- 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"
- 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"
- From the /local/content/protege/scripts directory start the protege server: "./run-background.sh". The server should start almost immediately
- Confirm the service has started by checking /local/content/protege/logs/protserv-console.txt for "Admin server has started at port 9091"
Building and Installing using Jenkins
- A new release will be tagged in the github project https://github.com/ncievs/nci-protege.git
- Navigate to Jenkins at https://evs-jenkins.nci.nih.gov/jenkins/job/_default/job/_lower/job/_Protege/
- Choose protege_build > Build with Parameters and select the appropriate tag in the BRANCH_OR_TAG selection box and click Build
- Review the Console Output for any errors
- For Dev, choose protege_deploy_dev > Build with Parameters. You should be presented with the same tag. Click Build
- Review the Console Output for any errors
- Check the protege dev server and see that the /local/content/protege/protege-server and protege-desktop have been updated
- 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
- Navigate to /local/content/protege/scripts/
- To shutdown the protegeserver: "./shutdown.sh"
Startup
- Navigate to /local/content/protege/scripts/
- To startup protege server: "./run-background.sh"
- Do "tail ../logs/protserv-console.txt" to check that the protege server is running.
- Server is started when you see "Admin server has started at port 9091"