Pre-Installation

Installation Prerequisites:

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. Type: Application is already selected.

  7. Title: Type in Geocortex Mobile.

    You will see this title when you log in to Mobile Designer and Geocortex Go and it requests your permission to use your login information.

  8. Tags: Two tags are required: geocortex-mobile-viewer and app-id-[App-ID] separated by a comma. You can add others like "geocortex", "mobile", or "Go" or tags for your organization.

    These tags should only be applied to this Portal for ArcGIS application, not the web mapping applications that you create in Mobile Designer.

    Once the application is registered, you will replace the "app-id-[AppID]" tag with the actual App ID assigned to this application.
  9. 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.

  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 all the users you want to have access to Geocortex Mobile Designer.

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"?>
    <configuration>
        <system.webServer>
            <rewrite>
                <rules>
                    <rule name="geocortex mobile viewer" patternSyntax="ECMAScript" stopProcessing="true">
                        <match url="^gcx/mobile(/mobileviewer/.*)$" />
                        <action type="Rewrite" url="http://localhost:10952{R:1}" />
                    </rule>
                </rules>
            </rewrite>
        </system.webServer>
    </configuration>
    
  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:

 

© 2019 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 5.2