Installation Prerequisites

If you are installing Geocortex Mobile on premises with the build service on a machine that also has Geocortex Essentials installed, you must install all the IIS components Essentials requires as detailed in IIS Configuration. Otherwise, you must not use /geocortex/ as the URL prefix when installing Geocortex Mobile.

You need to ensure that you have the following:

Create an App in ArcGIS Online or Portal for ArcGIS

You need to create an app in ArcGIS Online or Portal for ArcGIS to enable the use of an ArcGIS Login for Mobile Designer and Geocortex Go. You can use the same app for both Mobile Designer and Geocortex Go. You also need this application to log in to a Custom GXM app.

To add an app in ArcGIS Online or Portal for ArcGIS:

  1. In your Browser, open ArcGIS Online or your Portal for ArcGIS.

    You can also add an ArcGIS application just after you install Mobile Designer, during the post-installation process. To create an application from the Post Installer, click Launch to open your Portal in the browser, then continue from step 2 below.
  2. Sign in to your portal, and navigate to the Content page.

  3. Click Add Item and select An application.

  4. When the Add an Application pop-up opens, select the Application radio button.

    The options in the pop-up change to show only a title and tags.

  5. Configure the application using the following settings:

  6. Click Add Item.

    The new Application opens in the Overview tab.

Register the Application

To register the application:

  1. In your ArcGIS portal, select the Content tab.

  2. Click the link to the Application you just created.

  3. Select the Settings tab, and scroll down to the Application section at the bottom of the page.

  4. In the App Registration area, click Update.

    If the Update button is not present, click Register instead.

  5. When the Registered Info window opens, ensure that following redirect is in the Redirect URI box:
    urn:ietf:wg:oauth:2.0:oob, or type the host name for your webserver into the Redirect URI box.

  6. Click Add and the Redirect URI appears in the box below.

  7. Click Add again, and type the host name for your web server into the Redirect URI box.

  8. Click Update to complete the registration of the application.

    If the Update button is not present, click Register instead.

  9. When you return to the Application area, copy the App ID to the clipboard so that you can use it to update the app-id-[App-ID] tag with this App ID. In the screen shot below, the App ID is XCRP9kWHzYeHGoPQ.

    You can leave the application open in the browser so that you can copy and paste the App ID and Redirect URL when you need them during installation.
  10. Select the Overview tab.

  11. In the right side bar, click Edit beside Tags.

    The Edit Tags box opens.

  12. Replace the app-id -[APP-ID] tag with a tag that contains the actual App ID, for example, app-id-XCRP9kWHzYeHGoPQf.
  13. Click Save.

  14. In your portal, share this application with everyone.

    You must share this application with everyone so that users can sign into Mobile Designer with Esri identities. If you use other Geocortex 5-Series products, we recommend using the same portal and app ID for all of them so that users can freely switch between the products without needing to sign in again.

Use a Custom IIS Website

Add a Custom Folder

To add a custom folder:

  1. In Windows Explorer, add a new custom folder in any location you want it to be.

Create and Edit a Web.Config File in the Custom Folder

You need to create a web.config file, add it to the custom folder and insert your preferred URL prefix into the web.config file.

To create a Web.Config file in the custom folder:

  1. Open a text editor like (like Notepad++).
  2. Create a new file called web.config and save it to the custom folder.
  3. Copy the following code into the web.config file:

    <?xml version="1.0" encoding="UTF-8"?>
                    <rule name="geocortex mobile viewer" patternSyntax="ECMAScript" stopProcessing="true">
                        <match url="^gcx/mobile(/mobileviewer/.*)$" />
                        <action type="Rewrite" url="http://localhost:10952{R:1}" />
  4. Verify that your web.config file looks the same as the one below:

  5. Save the web.config file.

To edit the Prefix in the Web.Config file:

  1. In the web.config file, locate the match url prefix: gcx/mobile.

  2. Replace the URL prefix with the one you want to use.
  3. Save the web.config file.

Grant IIS Permission to the Custom Folder

To allow IIS to access the custom folder, you need to grant IIS permission to the folder.

To grant IIS permission to the custom folder:

  1. In Windows, right-click the Custom-Folder you just created and select Properties from the menu.

  2. Select the Security tab, and then click Edit.

  3. In the Permissions dialog, in the Group or user names box, click Users and then Add.

  4. In the Select Users, Computers, Service Accounts or Groups dialog, click Locations.

    If you are asked to enter the credentials of the user, click Cancel.
  5. In the Locations dialog, select the machine name, and then click OK.

    When you return to the Select Users, Computers, Service Accounts or Groups dialog, the name of the machine is in the From this location box.

  6. In the Enter the object names to select box, type in IIS_IUSRS, and then click Check Names.

  7. In the Permission for.... dialog, click Apply and then OK.

  8. In the Properties dialog, click OK again.

Add a Custom IIS Website

To add a custom IIS website:

  1. Open Internet Information Services (IIS) and expand the tree under the User's Computer name on the left.

  2. Right-click the Sites folder and select Add Website.

  3. In the Add Website dialog, add the following settings and then click OK:

    • Site name: Type in mobile-site.

    • Physical path: Enter the path to the custom folder you created.

    • Type: Select https. New fields appear in the dialog after you select this option.

    • Port: Type in 443.

    • SSL Certificate: Select the SSL certificate installed on the server.

      To find the SSL certificate, click on the root folder in IIS, and then select Server Certificates.

      The custom website appears in the Site folder in IIS.