Skip To Content

Troubleshoot Esri Vector Basemaps

Listed below are issues you may encounter when working with Esri Vector Basemaps content for ArcGIS Data Appliance 2024 as well as recommended solutions.

What if the size of the uploaded .vtpk file does not match the size of the source .vtpk file?

If your tile layer (hosted) service did not publish successfully, an issue may have occurred during the upload of the vector tile package (.vtpk) to your portal. The size of the .vtpk file on disk and the size of the uploaded file on your portal must match.

Confirm that the Size value of the tile package matches the size of the vector tile package and Enterprise version in the following table:

Vector tile package .vtpk fileEnterprise version Size

Esri_Vector_Basemap_DA2024_Install.vtpk (WMA)

10.9.1

44,616 MB

11.0

46,784 MB

11.1 and 11.2

44,616.449 MB

Esri_Vector_Basemap_GCS_DA2024_Install.vtpk (WGS84)

10.9.1

44,286 MB

11.0

46,438 MB

11.1 and 11.2

44,286.461 MB

You can check the size of the uploaded vector tile package (supporting the service) on the item details page. The following screenshot shows the Esri_Vector_Basemap_GCS_DA2024_Install vector tile package details in Enterprise 11.2.

Item details showing package size for the Esri_Vector_Basemap_GCS_DA2024_Install vector tile package in Enterprise 11.2

If the size does not match, check the log through the server manager to see whether there are any errors.

In some cases, the ArcGIS Pro Share Package geoprocessing tool may have produced a Success message, but when you check the size of the .vtpk file on the item details page, it does not match. Here are some solutions that you can try to resolve this issue:

  • Upload the .vtpk file again. First, delete the Esri_Vector_Basemap_DA2024_Install.vtpk or Esri_Vector_Basemap_GCS_DA2024_Install.vtpk file from your portal. Next, upload the Esri_Vector_Basemap_DA2024_Install.vtpk or Esri_Vector_Basemap_GCS_DA2024_Install.vtpk file again using the ArcGIS Pro Share Package geoprocessing tool.
  • Verify with your portal administrator that there is the following minimum available space per .vtpk file on your Enterprise 10.9.1, 11.0, 11.1, or 11.2 portal:

    Vector tile package .vtpk file Minimum total available space required Hosting server's job directory available space required Hosting server's cache directory available space required

    Esri_Vector_Basemap_DA2024_Install.vtpk (WMA)

    94 GB

    47 GB

    47 GB

    Esri_Vector_Basemap_GCS_DA2024_Install.vtpk (WGS84)

    94 GB

    47 GB

    47 GB

    Ensure that there is space on <ArcGIS portal install drive>\arcgis\arcgisportal where the content items are stored.
  • Verify that you are using a supported version of ArcGIS Pro. See the system requirements for details.

Contact Esri Support if you still cannot successfully upload the .vtpk file.

Note:

The following answers reflect troubleshooting of the WMA vector tile package and service. To troubleshoot the GCS vector tile package and service, you need to take the GCS naming into consideration.

When running the Share Package tool to share the .vtpk file from Esri Vector Basemaps, I encountered the Cancelled function, aborted by user error message.

When you publish the .vtpk file, it creates a copy of the file at \\arcgisportal\temp in the C: drive, which is the staging path. There is not enough space on the C: drive for the staging process, so the publishing attempt failed. Ensure your local computer has enough storage space to download the files from the flash drive. The additional storage space required for the local staging path is equal to the size of the .vtpk file being shared to your portal.

What if I encounter the There was an error message when I try to publish the service?

Work with your system administrator to check the ArcGIS Server Manager logs.

If there is an error due to a geoprocessing service (PublishingTools) timing out or crashing, you may have skipped a system requirements step. Confirm that you changed the value of The maximum time a client can use a service to 21,600 seconds.

Once you have updated the geoprocessing service maximum time, do the following:

  1. On your server, delete the Esri_Vector_Basemap_v2 or Esri_Vector_Basemap_GCS_v2 hosted tile layer.
  2. On the ArcGIS Server machine, delete the job in the <ArcGIS_Server_Install_Path>\arcgis\arcgisserver\directories\arcgisjobs\system\publishingtools_gpserver\<Job_ID> folder.
    Note:

    You can find the job ID in the log file.

  3. Restart the server.
  4. Verify you have the following minimum available space per .vtpk file on your ArcGIS Server:

    Vector tile package .vtpk file Minimum total available space required (Enterprise 10.9.1, 11.0, 11.1, 11.2)

    Esri_Vector_Basemap_DA2024_Install.vtpk (WMA)

    94 GB

    Esri_Vector_Basemap_GCS_DA2024_Install.vtpk (WGS84)

    94 GB

  5. In your portal, publish the Esri_Vector_Basemap_v2 or Esri_Vector_Basemap_GCS_v2 tile layer again.

What do I do if the progress bars keep loading when I'm trying to publish my service?

Creating Service animated bars

If the Creating Service progress bar continues to load after two hours, the browser connection to the portal may have failed.

Sign out of the portal and sign in again to see if the thumbnail has changed to the Data Appliance 2024 icon, because the browser connection does not affect the creation of the service.

Edit thumbnail with Data Appliance 2024 icon

If the thumbnail changes to the Data Appliance 2024 icon, verify that the map displays as expected.