Set up Esri Vector Basemaps (existing user)

These steps are for updating your Esri Vector Basemaps in WMA.

Note:

To use Esri Vector Basemaps in the GCS format, complete the steps using the information for GCS.

For information about what's included with Esri Vector Basemaps, see Esri Vector Basemaps content and What's new.

You'll use the following workflow to update Esri Vector Basemaps:

1. Upload the package to your ArcGIS Enterprise portal
2. Publish the new hosted tile layer (service)

   Note:

   The title of your new hosted tile layer must be different than the title of your existing hosted tile layer (for example, the name of the new layer is Esri_Vector_Basemap_DA2022_v2).

3. Replace the existing hosted tile layer (service) with the new hosted tile layer
4. Update existing tile layers (map styles)
5. Publish new tile layers (map styles)
6. Share tile layers (map styles)

Upload the package to your ArcGIS Enterprise portal

First, you need to copy the entire USB flash drive contents to your local computer if you have not already done so. Review the system requirements to confirm that you can deploy the Esri Vector Basemaps update.

1. Start ArcGIS Pro, sign in to your ArcGIS Enterprise portal, and select Set As Active Portal.

   

   Note:

   You must sign in and connect to your portal before you proceed. You cannot enter your portal user name and password when using the Share Package tool later in these instructions. The tool obtains your credentials from ArcGIS Pro.

2. Create a project.
3. Select the Analysis tab, and select Tools in the Geoprocessing group.

   

   The Geoprocessing pane appears.

4. In the Geoprocessing pane, search for Share Package, and select the Share Package (Data Management Tools) tool from the search results.

   

5. On the Share Package dialog box, provide the following:
   1. For Input Package, provide the path to the vector tile package, for example, C:\Projects\Esri_Vector_Basemaps_2022\VTPK\Esri_Vector_Basemap_DA2022_Install.vtpk.
   2. For Summary, type Esri Vector Basemap for Data Appliance 2022.
   3. For Tags, type 2022, v2.

   Caution:

   Do not change the Credits parameter value and do not check the boxes to share with Everybody or Within Organization.

   

6. Select Run.

   It will take approximately 30–120 minutes to upload the package to your portal. A Share Package Uploaded Successfully message appears in the Share Package window once the upload is complete.

7. Through your portal, confirm that the .vtpk file uploaded successfully.
   1. Open a web browser and sign in to your portal.

      The Esri_Vector_Basemap_DA2022_Install tile package is located in the root folder.

   2. Under Details, confirm that the Size value of the tile package is 34,497 MB and Shared with indicates that the item is not shared.

   Your item should look like the following:

Note:

If the size is not 34,497 MB, delete the item and upload the Esri_Vector_Basemap_DA2022_Install tile package again. You may want to discuss the problem with your portal administrator.

For the Esri_Vector_Basemap_GCS_DA2022_Install tile package, if the size is not 34,101 MB, delete the item and upload it again.

See the Troubleshooting Esri Vector Basemaps topic for more information.

Publish the new hosted tile layer (service)

Now you'll publish the Esri Vector Basemap hosted tile layer service from your portal.

1. Sign in to your ArcGIS Enterprise portal.

   Note:

   Your account must have publishing credentials.
2. In My Content, go to the item page for the vector tile package (Esri_Vector_Basemap_DA2022_Install.vtpk) you uploaded to your portal.
3. Click Publish, change the title to Esri_Vector_Basemap_DA2022_v2, and click Publish again.

   

   Note:

   For the GCS tile package, use the Esri_Vector_Basemap_GCS_DA2022_Install.vtpk file. Change the title to Esri_Vector_Basemap_GCS_DA2022_v2 for the hosted tile layer that gets published.

   Note:

   It will take 30–120 minutes to create the hosted layer, depending on your system configuration.

   The Esri_Vector_Basemap_DA2022_v2 hosted tile layer is created.

   

Replace the existing hosted tile layer (service) with the new hosted tile layer (service)

Next, you'll replace the 7.2 basemap hosted tile layer (service) with the 2022 hosted tile layer (service).

1. Sign in to your ArcGIS Enterprise portal.

   Note:

   Your account must have publishing credentials.
2. In My Content, go to the item page for the Esri_Vector_Basemap_v2 vector tile service.
3. Click Replace Layer.

   

4. Click Select.

   Note:

   If you're using an ArcGIS Enterprise 10.7.1 portal, click Select layer and select the newly published Esri_Vector_Basemap_DA2022_v2 layer.

   

5. For Archive the current layer as, click the edit button and change the value to Esri_Vector_Basemap_DA72_v2 and click Save. Then, if you're using an ArcGIS Enterprise 10.8 or later portal, scroll to Replace Item information and turn it on.

   

6. Click Next.
7. On the Replace Layer summary, click Replace.
   

   Note:

   The current layer starts as DA7.2. The replacement layer is DA2022. You are archiving the DA7.2 hosted tile layer, and the current layer (Esri_Vector_Basemap_v2) now displays the DA2022 hosted tile layer. Replacing the tile set allows the item ID and URL paths to remain intact so maps and apps continue to work with the current layer and display the new DA2022 basemap content.

   Note:

   If you're using an ArcGIS Enterprise 10.7.1 portal, check the Replace item information check box. Click Replace.

   

   In a few minutes, the Success message appears.

   

   Click Close.

   If you're using an ArcGIS Enterprise 10.8 or later portal, the Success message flashes briefly at the top of the screen.

8. To verify a successful replacement, in My Content, go to the item page for the Esri_Vector_Basemap_v2 vector tile service.

   Your item should look like the following:

   Note:

   The thumbnail is not replaced, but the title is Esri Vector Basemap for Data Appliance 2022 and the Details indicate it was created from the Esri_Vector_Basemap_DA2022_Install Vector Tile Package.

Update existing tile layers (map styles)

Use the Vector Style Updater tool to update your existing layers.

1. Open the DA2022_WMA_StyleUpdater_template.csv file located in the C:\Projects\Esri_Vector_Basemaps_2022\Toolbox folder.
   1. Include the item IDs of all your existing styles in the itemid column in this table. The item ID for each style can be obtained from the portal URL for each style. Only copy and paste the series of letters and numbers after ...id=.

      

   2. Once you fill in the itemid column, save the file and rename it DA2022_WMA_StyleUpdater.csv.

      

2. Run the Vector Style Updater tool.
   1. Start ArcGIS Pro, sign in to your ArcGIS Enterprise portal, and select Set As Active Portal.
   2. Create a project.
   3. Select the View tab, select Catalog View in the Windows group, right-click Toolboxes, and select Add Toolbox.
   4. Browse to the location on your local computer where you copied the contents of the USB flash drive, select VectorStyleUpdater.tbx, and select OK.

      The VectorStyleUpdater toolbox is added to the project.

   5. Double-click Toolboxes, and double-click VectorStyleUpdater.tbx.
   6. Double-click the Vector Style Updater script.

      

   7. On the Vector Style Updater dialog box, select the Parameters tab and provide the following:

      

      1. For CSV formatted file containing the item name and ids (.csv), browse to the location of the DA2022_WMA_StyleUpdater.csv file on your local computer.
      2. For Folder containing vector styles, browse to the location of the WMA Updated Styles folder on your local computer, for example, C:\Projects\Esri_Vector_Basemaps_2022\VectorBasemapStyles\WMA_Styles\WMA_ExistingUser\WMA_UpdatedStyles.
      3. For Vector Tile Service URL, provide the URL of the Esri Vector Basemap tile layer that you replaced above, for example, https://portalname.domain.com/server/rest/services/Hosted/Esri_Vector_Basemap_v2/VectorTileServer.

         Note:

         The vector tile service URL is in the URL section of the Esri_Vector_Basemap_v2 hosted tile layer item page. Click the Copy button and paste the URL in the Vector Tile Service URL parameter text box.

         

      4. For Metadata folder name, keep the default name metadata.

         Note:

         If you are using a portal with PKI authentication, expand PKI Authorization and provide values for the PKI_Certificated_file_(.pfx) and PKI Private Password parameters.

         

         If you are using a portal with Linux LDAP authentication, expand Linux LDAP and provide values for the Sign In Username and Sign In Password parameters.

         

3. Click Run.

   It can take up to a minute to update each existing style in your portal using the Vector Style Updater tool.

   The VectorStyleUpdater toolbox displays a successful update message when complete.

The 34 vector tile layers (map styles) are updated in your assigned ArcGIS Enterprise account.

Publish new tile layers (map styles)

Now that you've published and updated your hosted vector Tile Layer and updated the existing styles, you are ready to publish the new map styles.

VectorStylePublisher.tbx (~54KB) is a geoprocessing toolbox that is run in ArcGIS Pro. This toolbox publishes new private map items in your portal for one new vector tile layer and transfers the vector basemap style resource folders and files and metadata for the map item pages from your local computer to your portal.

1. In the ArcGIS Pro project you created to update the existing styles, select the View tab, select Catalog View in the Windows group, right-click Toolboxes, and select Add Toolbox.

   

2. Browse to the location on your local computer where you copied the contents of the USB flash drive, select VectorStylePublisher.tbx, and select OK.

   

   The VectorStylePublisher toolbox is added to the project.

3. Double-click Toolboxes, and double-click VectorStylePublisher.tbx.

   

4. Double-click the Vector Style Publisher script.

   

5. On the Vector Style Publisher dialog box, select the Parameters tab and provide the following:
   1. For Folder containing vector styles, browse to the location of the WMA New Styles folder on your local computer, for example, C:\Projects\Esri_Vector_Basemaps_2022\VectorBasemapStyles\WMA\WMA_ExistingUser\WMA_NewStyles.
   2. For Vector Tile Service URL, provide the URL of the Esri Vector Basemap tile layer, for example, https://portalname.domain.com/arcgis/rest/services/Hosted/Esri_Vector_Basemap_v2/VectorTileServer.

      Note:

      The vector tile service URL is in the URL section of the Esri_Vector_Basemap_v2 hosted tile layer item page. Click the Copy button and paste the URL in the Vector Tile Service URL parameter text box.

   3. For Metadata folder name, keep the default name metadata.

      Note:

      If you are using a portal with PKI authentication, expand PKI Authorization and provide values for the PKI_Certificated_file_(.pfx) and PKI Private Password parameters.

      

      If you are using a portal with Linux LDAP authentication, expand Linux LDAP and provide values for the Sign In Username and Sign In Password parameters.

      

   4. Click Run.

With the addition of the new map style, you can view all 51 tile layer items in My Content.

Share tile layers (map styles)

The items created are private unless you check the Share vector style web layers publicly check box to make them public.

Alternatively, you can select the map items in your portal and change the sharing settings.

Once you set up the Esri Vector Basemaps update, you can do the following:

• Use Esri Vector Basemaps
• Customize styles
• Localize styles