User Tools

Site Tools


documentation:software:webapi:webapi_installation_guide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
documentation:software:webapi:webapi_installation_guide [2017/02/28 15:12]
anthonysena
documentation:software:webapi:webapi_installation_guide [2019/04/19 16:23] (current)
anthonysena
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
  
-=====WebAPI Installation Guide ===== + 
-----+===== IMPORTANT NOTE ===== 
 + 
 +All WebAPI documentation has moved to [[https://​github.com/​OHDSI/​WebAPI/​wiki|GitHub]]. Please disregard the content below as it is legacy and kept for posterity. 
 + 
 +===== WebAPI Installation Guide (LEGACY) ​=====
  
 ==== Overview ==== ==== Overview ====
Line 84: Line 88:
   </​profiles>​   </​profiles>​
   </​settings>​   </​settings>​
 +
 +Note: this file above is saved as /​WebAPIConfig/​settings.xml and will be referred to in the “Building the .war file section”.
 +
 +**Download the appropriate JDBC driver**
 +
 +For SQL Server, the driver is available from the Maven repository, so no additional steps are required.
  
 === PostgreSQL === === PostgreSQL ===
Line 174: Line 184:
 ==== Building the .war file ==== ==== Building the .war file ====
  
-Open command prompt, go to WebAPI folder, type+Open command prompt, ​**go to the WebAPI folder**, type
  
-  set JAVA_HOME=C:/​Program Files/​Java/​jdk1.7.0_67+  set JAVA_HOME=C:/​Program Files/​Java/​jdk1.8.0_112
  
 //Make sure you point to a JDK, not a JRE. It is probably a good idea to stick to the same Java version that is running Tomcat// //Make sure you point to a JDK, not a JRE. It is probably a good idea to stick to the same Java version that is running Tomcat//
  
-  mvn clean package -s /WebAPIConfig/​settings.xml -P {profile id}+  mvn clean package ​-DskipTests ​-s WebAPIConfig/​settings.xml -P {profile id}
  
 This will create the file WebAPI.war in the target subfolder. This will create the file WebAPI.war in the target subfolder.
Line 187: Line 197:
 === Deploy the war file === === Deploy the war file ===
 ---- ----
-In Tomcat (e.g. using the manager app), deploy the war file. + 
 +In Tomcat, you will need to increase the maximum file size allowed for WAR files. Go to webapps/​manager/​WEB-INF/​web.xml and then increase the max-file-size and max-request-size to at least the size of the WAR file. 
 + 
 +  <​multipart-config>​ 
 +    <​max-file-size></​max-file-size>​ 
 +    <​max-request-size></​max-request-size>​ 
 +   <​file-size-threshold>​0</​file-size-threshold>​ 
 +  </​multipart-config>​ 
 + 
 +In Tomcat (e.g. using the manager app), deploy the war file. 
 + 
 This should automatically create a large number of tables in the webapi schema. This should automatically create a large number of tables in the webapi schema.
  
documentation/software/webapi/webapi_installation_guide.1488294736.txt.gz · Last modified: 2017/02/28 15:12 (external edit)