=== 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