How to Run BackupMyOrg in IIS Mode
Introduction
Running IIS mode is a configuration option that allows BackupMyOrg to be accessed via a standard web URL, rather than the default 8500
port, which provides a more streamlined and secure deployment. This setup is ideal for organizations looking to host BackupMyOrg behind a reverse proxy with support for enterprise authentication methods like ArcGIS logins or managed roles. Further context on reverse proxies can be located here. This configuration option allows for your BackupMyOrg setup to run on domain.com/backupmyorg instead of domain.com:8500.
In this guide, you’ll learn how to correctly setup your BackupMyOrg files, install the required IIS modules, configure the application in Internet Information Services Manager (IIS), and enable reverse proxy routing.
Step-by-Step Guide
Unzip BackupMyOrg
You can unzip to C:\BackupMyOrg or any other desired directory location. Since the files (served on the client-side) will reside in the BackupMyOrg\html directory, it is advised to keep the folder out of the default inetpub\wwwroot directory and set the webpage up as an application item.Install MongoDB-windows-*.exe if needed. The .exe file is located in the following directory:
Your BackupMyOrg root directory/installs
Install Required IIS Modules
In the C:\BackupMyOrg/installs/IISstandalone folder, there are two files: rewrite_amd64_en-US.msi and requestRouter_amd64.msi. These IIS modules must be installed, in the listed order, for the BackupMyOrg application to work properly. They are used by the application to create a reverse proxy to begin forwarding requests through IIS to the server application.Install & start Windows Service as noted in the BackupMyOrg standard installation.
In IIS: Under your machine name -> Sites -> Default Web Site, right click Add Application (Connections or left-panel in IIS)
Specify the name backupmyorg as the Alias
Make the Physical Path C:\BackupMyOrg\html or wherever you have unzipped BackupMyOrg. Make sure the html directory is added.
This will access BackupMyOrg from yourdomain.com/backupmyorg or localhost/backupmyorg
IIS: Enable Application Request Router (ARR) proxy
Under Connections (left-panel in IIS), click on the server entry under the start page.
In the center panel under the IIS section, double click on the Application Request Routing icon, so that your domain, <domain>/backupmyorg/api, properly reroutes to the http://127.0.0.1:8500.
Application Request Routing in IISClick the enable proxy checkbox in the center panel, then on the right panel click the apply button.
Enabling Proxy in Application Request Routing
In C:\BackupMyOrg\html\config\config.json, set
"iisMode": true,
You can now open a browser to (https://yourdomain.com/backupmyorg) and use the application.
Since this URL will be available over the web and not on a specific port, we recommend you set up
useArcGISAuth.enabled = true
or use Managed Roles to access BackupMyOrg as noted here: How to Enable ArcGIS Login and Create Managed Roles in Backup My Org
If you have any questions or are experiencing any issues while following the step-through, please reach out to our GEO Jobe Support Team at support@geo-jobe.com.