=== modified file 'src/docbkx/en/dhis2_implementation_guide_installation.xml'
--- src/docbkx/en/dhis2_implementation_guide_installation.xml 2014-05-06 11:16:52 +0000
+++ src/docbkx/en/dhis2_implementation_guide_installation.xml 2014-06-05 17:29:58 +0000
@@ -445,6 +445,41 @@
}
+ App setup with nginx
+ DHIS 2 supports installation of apps. To avoid having to re-install your apps every time
+ you update and replace DHIS 2, it is beneficial to deploy apps on the server file system
+ outside the DHIS 2 webapp directory. To install apps directly in nginx you can follow the
+ following steps. First create a directory which will be used as the app installation
+ folder.
+ sudo mkdir /usr/share/nginx/apps
+ Make sure that the directory is owned by the user which runs Tomcat, in order to allow
+ the Tomcat process to save apps to this directory when they are uploaded. If the user
+ running Tomcat is dhis you can use the below
+ command.
+ sudo chown dhis:dhis /usr/share/nginx/apps
+ You must add an apps location in the nginx.conf
+ configuration file like below. Note that we omit the apps directory itself in the root
+ directive.
+ server {
+ ...
+ location /apps/ {
+ root /usr/share/nginx;
+ expires max;
+ }
+ ...
+}
+ Finally navigate to the app configuration screen in your DHIS 2 instance by going to App
+ management > Settings and adjust the settings accordingly.
+ The app installation folder should point to the path on the server file system to the
+ base directory:
+ /usr/share/nginx/apps
+ The app base URL should point to the URL where DHIS 2 can find the apps. Replace
+ www.domain.com with your real domain and according to how you have deployed DHIS 2.
+ http://www.domain.com/apps
+ You should now be ready to upload apps from the App management screen. Remember to
+ reload the nginx configuration.
+
+
Basic reverse proxy setup with Apache
The Apache HTTP server is the most common