English
Continue in the app
Be The First To Get Support Updates
Want to know about the latest technical content and software updates?

How To: Use Drone2Map v2022.1 (and later) with ArcGIS Enterprise 10.9 and earlier

Summary

This technical article is provided for organizations using ArcGIS Enterprise 10.9 or earlier and who are seeking to license and use ArcGIS Drone2Map v2022.1 or later.

The licensing in Drone2Map v2022.1 was changed from the previous version, v2.3.2.  The new licensing is supported in Enterprise version 10.9.1, but cannot be back-ported to older versions.  Organizations that need to license Drone2Map v2022.1 via Enterprise are requested to install a limited, standalone version of Enterprise 10.9.1. See Task 1 below.

Note:
If users do not need to provision licenses through Enterprise, for example your organization does this via ArcGIS Online, Task 1 is not required.

After licensing Drone2Map v2101.1, using Drone2Map with ArcGIS Enterprise may require additional steps.

  • If users do not need to connect Drone2Map directly to your operational Enterprise, no further configuration is required.
  • Note that you may publish data to Enterprise using ArcGIS Pro or the Enterprise home app. 

  • If users need to connect Drone2Map to your operational Enterprise, for example, to load data layers published by your organization, see Tasks 2 and 3 below.

The three major tasks are as follows:

Task 1: Installation and licensing Portal for ArcGIS 10.9.1 and License Manager 2022.1 (or later versions) to support licensing of ArcGIS Drone2Map 2022.1. This must be hosted on a computer separate from the organization’s operational Enterprise at version 10.9 or earlier.

Task 2: Addition of the Drone2Map 2022.1 App ID into older versions of ArcGIS Enterprise to enable users of Drone2Map to authenticate and connect to Enterprise. This is for access to basemaps, display of image and feature services hosted by the organization within Drone2Map, and publishing of results from Drone2Map.

Task 3: Deletion of the ArcGIS Drone2Map items from the Enterprise instance before upgrading Enterprise to 10.9.1

Procedure

Task 1: Install and license Portal for ArcGIS 10.9.1 (or later version) and License Manager 2021.1 (or later) to support ArcGIS Drone2Map 2022.1

  1. Review the Portal for ArcGIS 10.9.1 installation guide and ensure your system meets the minimum requirements. See: Welcome to the Portal for ArcGIS (Windows) installation guide
  2. Install Portal for ArcGIS 10.9.1 following the steps in the installation guide: Installing Portal for ArcGIS
  3. Once the installation is complete, create a new portal site: Create a single machine portal
    • Customers must have a Portal for ArcGIS 10.9.1 license file (.json) that includes at least one user type with full capabilities within the Organization (i.e., Creator user type), and at least one add-on ArcGIS Drone2Map Standard or Advanced license. When generating this file from My Esri, customers must enter the machine name and MAC address for the machine hosting the Enterprise portal’s License Manager.
  4. Optionally, install an ArcGIS Web Adaptor and configure it for use with your Enterprise portal.
    • This step is optional. It is not required to license Drone2Map but your organization’s administrator may have other requirements to use a web adaptor.
  5. Log in to the Enterprise portal site as the Primary Site Administrator (PSA) used to create the site. If the PSA will be the account used to license ArcGIS Drone2Map 2022.1, assign this member the ArcGIS Drone2Map Standard or Advanced license, see: Manage licenses. If another member will be the account used to license ArcGIS Drone2Map 2022.1, then you must add this member to the organization and assign them the appropriate Drone2Map license.
  6. Install ArcGIS License Manager 2022.1, see: License manager installation and startup
  7. Authorize ArcGIS License Manager 2022.1 with the same Portal for ArcGIS license file (.json) imported into your Enterprise portal.
  8. Instructions for Drone2Map users:
    1. In Drone2Map v2022.1, click the Project tab and select Portals > Add Portal.
  1. Add the portal URL for the 10.9.1 standalone version of Enterprise.
  2. Select Licensing and enable the checkbox for Authorize Drone2Map to work offline, and click Configure your licensing options.
  1. In the popup, select your 10.9.1 standalone version of Enterprise

These instructions enable user(s) to connect one time to Enterprise 10.9.1 to license Drone2Map, and then if the license is “offline”, the 10.9.1 Enterprise may be shut down. The offline license will remain valid until the annual expiration date.

Task 2: Support using ArcGIS Drone2Map 2022.1 in older versions of ArcGIS Enterprise

This involves adding and updating two different registered app items in the older version of ArcGIS Enterprise. To make things simpler, we have separated the steps for each below.

Add ArcGIS Drone2Map Portal Item 1:

  1. Add the app item:
    1. Log into the ArcGIS Portal Directory sharing application as an administrator
    2. Navigate to your users account page, user items, then under supported operations choose Add Item.
    3. In Add Item form, enter the following and add the item:
      • Title: ArcGIS Drone2Map
      • Type: Mobile Application
      • Type Keywords: ArcGIS for iPhone, ArcGIS Mobile Map, Mobile Application, Ready To Use, Registered App
      • Tags: drone
    4. Under supported operations, click Share Item and share the item with everyone.
  2. Register the app item:
    1. In the user item page, select and copy the item ID
    2. Under related operations, click registered app
    3. On the registered app page, enter the following:
      • Item ID: the id copied from earlier
      • App type: select multiple
      • Redirect URIs: Enter ["urn:ietf:wg:oauth:2.0:oob","arcgis-d2m://auth/"]
    4. Copy the App ID on the registered app page for use in the next section
  3. Change the App ID:
    1. Open the ArcGIS Portal Directory admin application and login as an administrator.
    2. Navigate to Home > Security > OAuth >  Change App ID.
    3. On the Change App ID page enter and submit the following:
      • Current app ID: app ID from earlier step
      • New app ID: arcgisd2m

Add ArcGIS Drone2Map item 2:

  1. Add the app item:
    1. Log into the ArcGIS Portal Directory sharing application as an administrator.
    2. Navigate to your users account page and under supported operations, and click Add Item.
    3. In the Add Item form, enter the following and add the item:
      • Title: ArcGIS Drone2Map
      • Type: Web Mapping Application
      • Type Keywords: JavaScript, Map, Mapping Site, Online Map, Ready To Use, Web Map, Registered App
      • Tags: drone
    4. Under supported operations, click Share Item and share the item with everyone.
  2. Register the App item:
    1. In the user item page, select and copy the item ID.
    2. Under related operations, click registered app.
    3. On the registered app page, enter the following:
      • Item ID: the id copied from earlier
      • App type: select multiple
      • Redirect URIs: Enter ["https://.arcgis.com","http://.arcgis.com","urn:ietf:wg:oauth:2.0:oob","arcgis-d2m://auth/"]
    4. Copy the App ID on the registered app page for use in the next section
  3. Change the app ID:
    1. Open the ArcGIS Portal Directory admin application and login as an administrator.
    2. Navigate to Home > Security > OAuth > Change App ID.
    3. On the Change App ID page enter and submit the following:
      • Current app ID: app ID from earlier step
      • New app ID: arcgisd2mdesktop

Using ArcGIS Drone2Map:

Once the above steps are complete, you should be able to use Drone2Map, presuming your Portal had been configured for the earlier version of Drone2Map. If not, refer to the help document: An introduction to licensing apps through your portal for licensing premium apps, and then see help document: Configure ArcGIS Drone2Map licenses for connecting to Portal.

Task 3: Delete the ArcGIS Drone2Map items before upgrading to 10.9.1.

Note:
For organizations that follow Task 2, Task 3 includes very important steps that must be followed before upgrading to 10.9.1 (or any later Enterprise version):
  1. Log in to the ArcGIS Portal Directory sharing application as the administrator who owns the ArcGIS Drone2Map items.
  2. Navigate to your users account page and under related resources select User Content.
  3. Select the ArcGIS Drone2Map item from the item list.
  4. On the item’s page under supported operations click Delete Item and delete the item.
  5. Repeat this for the other ArcGIS Drone2Map items.
Note:
If the ArcGIS Drone2Map items are not deleted from the portal content, attempts to upgrade to ArcGIS Enterprise 10.9.1 or later fail.

Last Published: 6/23/2022

Article ID: 000026755

Software: ArcGIS Server 10.9.1, 10.9 ArcGIS Drone2Map 2022.1, 2.3.3, 2.3.2, 2.3.1, 2.3, 2.2.1