This shows you the differences between two versions of the page.
| 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. | ||