Skip To Content

Troubleshooting Esri Vector Basemaps

Listed below are issues you may encounter when working with Esri Vector Basemaps content 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_DA2023_Install.vtpk (WMA)

10.8.1, 10.9, 10.9.1

38,447 MB

11.0

40,315 MB

Esri_Vector_Basemap_GCS_DA2023_Install.vtpk (WGS84)

10.8.1, 10.9, 10.9.1

37,998 MB

11.0

39,844 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_DA2023_Install vector tile package details in Enterprise 10.8.1, 10.9, or 10.9.1.

Item details showing package size for the Esri_Vector_Basemap_DA2023_Install vector tile package in Enterprise 10.8.1, 10.9, or 10.9.1

If the size does not match, check the log via the server manager to see if 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 things that you can try to resolve this issue:

  • Upload the .vtpk file again. First, delete the Esri_Vector_Basemap_DA2023_Install.vtpk or Esri_Vector_Basemap_GCS_DA2023_Install.vtpk file from your portal. Next, upload the Esri_Vector_Basemap_DA2023_Install.vtpk or Esri_Vector_Basemap_GCS_DA2023_Install.vtpk file again using the ArcGIS Pro Share Package geoprocessing tool.
  • Verify with your portal administrator that there is at least 82 GB of disk space per .vtpk file available on your Enterprise 11.0 portal. Enterprise 10.8.1, 10.9, or 10.9.1 requires at least 78 GB of disk space per .vtpk file. Make sure 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 Technical 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 must take the GCS naming into consideration.

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. For Enterprise version 11.0, verify that you have at least 82 GB of available space per .vtpk file on ArcGIS Server. For Enterprise version 10.8.1, 10.9, or 10.9.1, verify that you have at least 78 GB of available space per .vtpk file on ArcGIS Server.
  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 animated bars continue 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 2023 icon, because the browser connection does not affect the creation of the service.

Edit Thumbnail with Data Appliance 2023 icon

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