Troubleshoot OSM Vector Basemaps

Listed below are issues you may encounter when working with OSM Vector Basemaps content for ArcGIS Data Appliance 2025 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 hosted tile layer service did not publish successfully, an issue may have occurred during the upload of the vector tile package (.vtpk) file 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 for your vector tile package and Enterprise version in the following table:

Vector tile package .vtpk fileEnterprise version Size

OSM_Vector_Basemap_DA2025_Install.vtpk (WMA)

10.9.1

63,475 MB

11.1, 11.2, or 11.3

63,474.87 MB

OSM_Vector_Basemap_GCS_DA2025_Install.vtpk (WGS84)

10.9.1

63,616 MB

11.1, 11.2, or 11.3

63,616.091 MB

OSM_Vector_Basemap_DAWB2025_Install.vtpk (WMA)

10.9.1

7,078 MB

11.1, 11.2, or 11.3

7,078.187 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 OSM_Vector_Basemap_DA2025_Install vector tile package details in Enterprise 11.1, 11.2, and 11.3:

Item details showing package size for OSM_Vector_Basemap_DA2025_Install.vtpk in Enterprise 11.1, 11.2, and 11.3

If the size does not match, review 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 from 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 OSM_Vector_Basemap_DA2025_Install.vtpk, OSM_Vector_Basemap_GCS_DA2025_Install.vtpk, or OSM_Vector_Basemap_DAWB2025_Install.vtpk file from your portal. Next, upload the OSM_Vector_Basemap_DA2025_Install.vtpk, OSM_Vector_Basemap_GCS_DA2025_Install.vtpk, or OSM_Vector_Basemap_DAWB2025_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.1, 11.2, or 11.3 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

    OSM_Vector_Basemap_DA2025_Install.vtpk (WMA)

    128 GB

    64 GB

    64 GB

    OSM_Vector_Basemap_GCS_DA2025_Install.vtpk (WGS84)

    128 GB

    64 GB

    64 GB

    OSM_Vector_Basemap_DAWB2025_Install.vptk (WMA)

    16 GB

    8 GB

    8 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. To troubleshoot the Basic vector tile package and service, you need to take the WB naming into consideration.

When running the Share Package tool to share the .vtpk file from OSM 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 systems 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 43,200 seconds.

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

  1. On your server, delete the OSM_Vector_Basemap_v2 or OSM_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.1, 11.2, 11.3)

    OSM_Vector_Basemap_DA2025_Install.vtpk (WMA)

    128 GB

    OSM_Vector_Basemap_GCS_DA2025_Install.vtpk (WGS84)

    128 GB

    OSM_Vector_Basemap_DAWB2025_Install.vtpk (WMA)

    16 GB

  5. In your portal, publish the OSM_Vector_Basemap_v2 or OSM_Vector_Basemap_GCS_v2 tile layer again.

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

Creating Service progress bar

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 whether the thumbnail has changed to the ArcGIS Data Appliance 2025 icon, because the browser connection does not affect the creation of the service.

Edit thumbnail with Data Appliance 2025 icon

If the thumbnail changes to the Data Appliance 2025 icon, confirm that the map displays as expected.