iiab/roles/nginx/README.md

### Transition to NGINX

1. Initial testing strategy (December 2019 - January 2020) is to move NGINX to [port 80](https://github.com/iiab/iiab/wiki/IIAB-Networking#list-of-ports--services), and proxy everything to Apache on [port 8090](https://github.com/iiab/iiab/wiki/IIAB-Networking#list-of-ports--services) &mdash; creating "Shims" for each IIAB App/Service in *Section iii.* below.

   Until "Native" NGINX is later implemented for that IIAB App/Service &mdash; allowing it to move up to *Section ii.* below.

   And potentially later moving it up to *Section i.* if its Apache support is dropped!

2. Without PHP available via FastCGI, any function at all for PHP-based applications validates NGINX.

3. Current state of IIAB App/Service migrations as of 2020-01-23...

   1. These support "Native" NGINX but ***NOT*** Apache
      * Admin Console
      * captiveportal
      * osm-vector-maps
      * RACHEL-like modules
      * usb-lib

   2. These support "Native" NGINX ***AND*** Apache, a.k.a. "dual support" for legacy testing (if suitable "Shims" from *Section iii.* below are preserved!)  Both "Native" NGINX and "Shim" proxying from NGINX to Apache port 8090 *cannot be enabled simultaneously* for these IIAB Apps/Service.  But if you want to attempt their "Shim" proxying legacy testing mode, change your *primary web server* over to Apache by setting `nginx_enabled: False` in [/etc/iiab/local_vars.yml](http://wiki.laptop.org/go/IIAB/FAQ#What_is_local_vars.yml_and_how_do_I_customize_it.3F) (which will [auto-enable Apache](../0-init/tasks/main.yml#L40-L44) for your testing).
      * awstats
      * calibre-web
      * gitea
      * kiwix
      * kolibri
      * mediawiki
      * munin
      * sugarizer
      * wordpress

   3. These support Apache but ***NOT*** "Native" NGINX.  They use a "Shim" to [proxy_pass](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/) from NGINX to Apache on port 8090.  See [roles/0-init/tasks/main.yml#L40-L44](../0-init/tasks/main.yml#L40-L44) for a list of these IIAB Apps/Services, that auto-enable Apache.
      * dokuwiki ([#2056](https://github.com/iiab/iiab/issues/2056))
      * elgg
      * lokole
      * moodle
      * nextcloud ([PR #2119](https://github.com/iiab/iiab/pull/2119))
      * nodered

   4. Not Yet Dealt With!
      * internetarchive (menu goes directly to port 4244, [PR #2120](https://github.com/iiab/iiab/pull/2120))
      * kalite (menu goes directly to ports 8006-8008)
oversignts and corrections -- most now seem to work on rpi 2019-10-15 23:47:49 +00:00			`### Transition to NGINX`
Update roles/nginx/README.md 2020-01-11 17:48:09 +00:00
Update nginx/README.md 2020-01-24 16:31:50 +00:00			`1. Initial testing strategy (December 2019 - January 2020) is to move NGINX to [port 80](https://github.com/iiab/iiab/wiki/IIAB-Networking#list-of-ports--services), and proxy everything to Apache on [port 8090](https://github.com/iiab/iiab/wiki/IIAB-Networking#list-of-ports--services) — creating "Shims" for each IIAB App/Service in Section iii. below.`
Update nginx/README.md 2020-01-23 23:10:53 +00:00
Update nginx/README.md 2020-01-23 23:48:37 +00:00			`Until "Native" NGINX is later implemented for that IIAB App/Service — allowing it to move up to Section ii. below.`
Update nginx/README.md 2020-01-23 23:10:53 +00:00
			`And potentially later moving it up to Section i. if its Apache support is dropped!`
Doc tweaks @ roles/nginx/README.md 2020-01-12 06:57:00 +00:00
Update roles/nginx/README.md 2020-01-11 17:48:09 +00:00			`2. Without PHP available via FastCGI, any function at all for PHP-based applications validates NGINX.`
Doc tweaks @ roles/nginx/README.md 2020-01-12 06:57:00 +00:00
Update nginx/README.md 2020-01-24 16:31:50 +00:00			`3. Current state of IIAB App/Service migrations as of 2020-01-23...`
Doc tweaks @ roles/nginx/README.md 2020-01-12 06:57:00 +00:00
Update nginx/README.md 2020-01-23 23:48:37 +00:00			`1. These support "Native" NGINX but *NOT* Apache`
Update roles/nginx/README.md 2020-01-11 17:59:05 +00:00			`* Admin Console`
Update nginx/README.md 2020-01-23 23:10:53 +00:00			`* captiveportal`
Update roles/nginx/README.md 2020-01-11 17:48:09 +00:00			`* osm-vector-maps`
Update nginx/README.md 2020-01-23 23:10:53 +00:00			`* RACHEL-like modules`
Update roles/nginx/README.md 2020-01-11 17:48:09 +00:00			`* usb-lib`
Doc tweaks @ roles/nginx/README.md 2020-01-12 06:57:00 +00:00
Update nginx/README.md 2020-01-24 16:31:50 +00:00			2. These support "Native" NGINX *AND* Apache, a.k.a. "dual support" for legacy testing (if suitable "Shims" from Section iii. below are preserved!) Both "Native" NGINX and "Shim" proxying from NGINX to Apache port 8090 cannot be enabled simultaneously for these IIAB Apps/Service. But if you want to attempt their "Shim" proxying legacy testing mode, change your primary web server over to Apache by setting `nginx_enabled: False` in [/etc/iiab/local_vars.yml](http://wiki.laptop.org/go/IIAB/FAQ#What_is_local_vars.yml_and_how_do_I_customize_it.3F) (which will [auto-enable Apache](../0-init/tasks/main.yml#L40-L44) for your testing).
Update nginx/README.md 2020-01-23 23:10:53 +00:00			`* awstats`
Update roles/nginx/README.md 2020-01-11 17:48:09 +00:00			`* calibre-web`
			`* gitea`
Update nginx/README.md 2020-01-23 23:10:53 +00:00			`* kiwix`
Update roles/nginx/README.md 2020-01-11 17:48:09 +00:00			`* kolibri`
Update nginx/README.md 2020-01-23 23:10:53 +00:00			`* mediawiki`
			`* munin`
Update roles/nginx/README.md 2020-01-11 17:48:09 +00:00			`* sugarizer`
Update nginx/README.md 2020-01-23 23:10:53 +00:00			`* wordpress`
Doc tweaks @ roles/nginx/README.md 2020-01-12 06:57:00 +00:00
Update nginx/README.md 2020-01-24 16:31:50 +00:00			`3. These support Apache but *NOT* "Native" NGINX. They use a "Shim" to [proxy_pass](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/) from NGINX to Apache on port 8090. See [roles/0-init/tasks/main.yml#L40-L44](../0-init/tasks/main.yml#L40-L44) for a list of these IIAB Apps/Services, that auto-enable Apache.`
Update roles/nginx/README.md 2020-01-11 17:59:05 +00:00			`* dokuwiki ([#2056](https://github.com/iiab/iiab/issues/2056))`
Update roles/nginx/README.md 2020-01-11 17:48:09 +00:00			`* elgg`
			`* lokole`
			`* moodle`
Update roles/nginx/README.md 2020-01-11 17:59:05 +00:00			`* nextcloud ([PR #2119](https://github.com/iiab/iiab/pull/2119))`
Update nginx/README.md 2020-01-23 23:10:53 +00:00			`* nodered`
Doc tweaks @ roles/nginx/README.md 2020-01-12 06:57:00 +00:00
Update nginx/README.md 2020-01-23 23:10:53 +00:00			`4. Not Yet Dealt With!`
			`* internetarchive (menu goes directly to port 4244, [PR #2120](https://github.com/iiab/iiab/pull/2120))`
			`* kalite (menu goes directly to ports 8006-8008)`