Pre-Installation

Installation Prerequisites

Prior to installing Mobile Designer on premises, you must 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 VertiGIS Studio Go. You can use the same app for both Mobile Designer and VertiGIS Studio Go. You also need this application to log in to a Custom Mobile app.

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

  1. Open your browser and sign in to 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. Select the Content tab.

  3. Click New Item.

  4. Select Application.

  5. Select Other application as the Application type.

  6. Click Next.

  7. Configure the application using the following settings:

    • Title: Enter "VertiGIS Studio Mobile". This is the title you see when you log in to Mobile Designer and VertiGIS Studio Go and it requests your permission to use your login information.

    • Tags: Enter "vertigis-mobile-viewer". This is a required tag. You can add other optional tags, such as, "vertigis-studio", "mobile", "Go", or tags for your organization. Type each tag name and press Enter to separate multiple tags.

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

  8. Click Save.

    The VertiGIS Studio Mobile application opens in the Overview tab.

Register the Application

To register the application:

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

  2. Select the VertiGIS Studio Mobile application.

  3. Select the Settings tab and scroll to the Application section.

  4. Click Update.

    If the Update button is not available, click Register.

    The Registered Info window opens.

  5. Ensure that the following host name is in the Redirect URI box:
    urn:ietf:wg:oauth:2.0:oob.

    If the Redirect URI box is blank:

    1. Type the host name for your web server into the Redirect URI box.

    2. Click Add.

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

    If the Update button is not available, click Register.

  7. Copy the App ID in the Application section, as you will need it in the next steps to add the app-id-[App-ID] tag. In the figure below, the App ID is XCRP9kWHzYeHGoPQ.

    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.

  8. Select the Overview tab.

  9. Click Edit in the Tags section, located in the right sidebar.

    The Tags section changes to Edit Tags.

  10. Add the app-id-[APP-ID] tag, replacing [APP-ID] with the App ID copied from the Application section. For example, the tag in the figure below is app-id-XCRP9kWHzYeHGoPQ.

    11. Do not include the square brackets in the App ID tag.

  11. Click Save.

  12. 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 VertiGIS Studio 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:

    Copy 
    <?xml version="1.0" encoding="UTF-8"?>
    <configuration>
        <system.webServer>
            <rewrite>
                <rules>
                    <rule name="vertigis studio 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:

    • 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.