= OpenSpecimen HowTo Install

Tags: [[OpenSpecimen]] [[HowTo]]

See [[https://openspecimen.atlassian.net/wiki/display/CAT/Deployment+steps]]

- Have to make install.sh and catalina.sh executable.

== Notes from watching Nitesh upgrade our dev version

1. Our customisations are in the file {{{/local/os_v20/app/plugin-dir/os-le-1.0.0.jar}}}.  This file can be copied between installations.
2. He copied the build zip file (linked in the page above) into the directory {{{/local/os_v20/installable}}} and unzipped it.
3. He then ran the {{{install.sh}}} script from within the unzipped directory.
4. He ran the script using {{{nohup}}} so that the output for the installation is stored in the file {{{nohup.out}}}.
5. The full command was:

{{{
nohup ./install.sh -dhost localhost -dport 3306 -dname os_v21 -duser {db user name} -dpass {db password name} -dtype mysql -ahome /local/os_v20/app -ahost localhost -aport 8280 -adtype upgrade -adatadir /local/os_v20/app/os-data -aplugindir /local/os_v20/app/plugin-dir &
}}}

6. He then ran {{{chmod 777 *}}} in the app OpenSpecimen directory and the {{{app/lib}}} directory.
7. He then :

{{{
unset JAVA_TOOL_OPTIONS
export JAVA_HOME=/opt/java
export JRE_HOME=/opt/java/jre
}}}

8. He then ran {{{/local/os_v20/app/bin/catalina.sh start}}}

These later steps are documented in the script {{{/local/os_v20/run_osv20.sh}}}

[[BackLinks]]