Overview
Deployment instructions used for the PROD environment.
This information is recorded in the file /home/ihtsdo/refset/README.txt.
This information is also in the repository in config/prod/src/main/resources/README.txt.
Unless otherwise stated, instructions were performed as "ihtsdo" user.
NOTE: occasionally database changes are needed with code deployments. Typically, this just involves running the "Updatedb" admin tool (e.g. mvn install -PUpdatedb -Drefset.config=/home/ihtsdo/refset/config/config.properties). In some instances, it may also require running statements from an .sql file. We can standardize all of this if desired.
README.txt
PROD REFSET SERVER SETUP
1. Use provided starting point (mysql, Tomcat, java, mvn installed)
2. Install software (as root)
emacs: apt-get install emacs
git: apt-get install emacs
3. Edit /etc/default/tomcat7 - set memory and -Drefset.config in JAVA_OPTS
JAVA_OPTS="-Djava.awt.headless=true -Xmx3000m -XX:+UseConcMarkSweepGC -Drefset.config=/var/lib/tomcat7/conf/config.properties"
4. Follow "DIRECTORY AND PROJECT SETUP" shown below
5. Copy config file to a location that is accessible by tomcat and link back (as root)
sudo su - root
mv /home/ihtsdo/refset/config/config.properties /var/lib/tomcat7/conf/config.properties
chmod a+rw /var/lib/tomcat7/conf/config.properties
cd /home/ihtsdo/refset/config/
ln -s /var/lib/tomcat7/conf/config.properties
6. Create the database - N/A - "refset" db already created
7. Configure MYSQL - ./etc/mysql/my.cnf (restart mysql when finished)
max_allowed_packet = 100M
innodb_file_per_table
8. Download initial prod data and indexes, load prod data
cd ~/refset/data
wget https://s3.amazonaws.com/wci1/IHTSDO/refset-indexes.zip
wget https://s3.amazonaws.com/wci1/IHTSDO/refset-sql.zip
unzip refset-sql.zip
mysql -urefset -p refset < refset.sql
8. Prepare indexes (as root)
sudo su - root
cd /var/lib/tomcat7
mkdir indexes
cd indexes
unzip /home/ihtsdo/refset/data/refset-indexes.zip -d .
mv indexes refset
chown -R tomcat7:tomcat7 /var/lib/tomcat7/indexes/refset
chmod -R 777 /var/lib/tomcat7/indexes/refset
9. Make sure the /tmp/tomcat7-tomcat7-tmp is owned by tomcat7 user (for file uploads)
sudo su - root
chmod a+rw /tmp/tomcat7-tomcat7-tmp
10. nginx configuration
see /etc/nginx/sites-enabled/refset.ihtsdotools.org
11. See the REDEPLOY instructions below
DIRECTORY AND PROJECT SETUP
1. Create space and pull code
mkdir ~/refset
cd ~/refset
mkdir config data
git clone https://git.ihtsdotools.org/ihtsdo/ihtsdo-refset-management-service.git code
2. Build code with proper config
cd ~/refset/code
git pull
mvn -Dconfig.artifactId=refset-config-prod clean install
3. Unpack and edit config
cd ~/refset
unzip ~/refset/code/config/prod/target/refset*.zip -d config
# edit ~/refset/config/config.properties
# * javax.persistence.jdbc.url=jdbc:mysql://127.0.0.1:3306/refset?useUnicode=true&characterEncoding=UTF-8&rewriteBatchedStatements=true&useLocalSessionState=true
# * javax.persistence.jdbc.username=*******
# * javax.persistence.jdbc.password=*******
# * hibernate.search.default.indexBase=/var/lib/tomcat7/indexes/refset
# * identifier.assignment.handler.DEFAULT.userName=refset-prod
# * identifier.assignment.handler.DEFAULT.password=********
REDEPLOY INSTRUCTIONS
# run as ihtsdo:
cd ~/refset/code
git pull
mvn -Dconfig.artifactId=refset-config-prod clean install
# run as root:
sudo su - root
service tomcat7 stop
/bin/rm -rf /var/lib/tomcat7/work/Catalina/localhost/refset-rest
/bin/rm -rf /var/lib/tomcat7/webapps/refset-rest
/bin/rm -rf /var/lib/tomcat7/webapps/refset-rest.war
/bin/cp -f /home/ihtsdo/refset/code/rest/target/refset-rest*war /var/lib/tomcat7/webapps/refset-rest.war
service tomcat7 start
chmod -R 777 /tmp/tomcat7-tomcat7-tmp
chown -R tomcat7:tomcat7 /var/lib/tomcat7/indexes/refset
chmod -R 777 /var/lib/tomcat7/indexes/refset