English

How To: Fix BUG-000130541, where corrupted thumbnails that appear pink cause the WebGIS DR tool to fail with the error message, "{"code":500,"messages":["Export operation failed...]}.

Summary

This article describes the solution to BUG-000130541. BUG-000130541 causes a portal item's thumbnail to become corrupted and display as pink after upgrading from ArcGIS Enterprise version 10.6.1 to 10.7 or later.

The upgrade from ArcGIS Enterprise 10.6.1 to version 10.7 or later changes the mechanism by which thumbnail images are loaded and processed. This uncovered a latent bug in how thumbnails are generated by ArcGIS Pro 2.5 and prior. The related ArcGIS Pro bug is BUG-000129503.

The corrupted thumbnails cause administrative commands and tools such as the WebGIS DR tool (webgisdr) to fail, returning the following error message:

 "{"code":500,"messages":["Export operation failed. Unsupported Image Type"],"status":"error"}".

These instructions and the attached script are the resolution to BUG-000130541. The provided script finds and fixes the corrupted thumbnails. Once the thumbnails are corrected, the WebGIS DR tool and other commands that may have failed due to a corrupted thumbnail work as expected.

Procedure

The thumbnails are corrupted because they are incorrectly saved as a JPG files with incompatible alpha channel values. The script provided in the link below fixes the corrupted thumbnails by performing an update of the thumbnails by replacing them with an image in PNG format. It is necessary to download a generic image to use as a thumbnail in PNG format. Before running the script, provide the path to this PNG as an input parameter.

Note:
Note that the script will update the thumbnails of all services, however the thumbnail is only displayed in ArcGIS Server Manager, not in Portal for ArcGIS, so only Administrators and Publishers can see the generic thumbnail.
  1. Download the .zip file from the Related Information section at the bottom of this article, unzip it, and rename the file extension to .py. In a Windows environment, make sure that file extensions are visible in Windows File Explorer before doing so.
  2. Open the script with a text editor and modify the four input parameters below, then save the script. For the base URL use your ArcGIS Server site URL with port 6443, as in the format below. For the username and password make sure to use the site administrator credentials. For thumbnailPath provide the path to this PNG as an input, as shown in the sample script below:
baseURL = "https://<machine>.domain.com:6443/arcgis"
username = "username_admin"
password = "password_admin"
thumbnailPath = r"C:\Users\example\pictures\sample.png"
  1. (Optional) - Back up the services directory (C:\arcgisserver\config-store\services) by simply making a copy of the folder.
  2. Run the script:
    • You may place the script in any directory and run it from there, as long as the script can reach the thumbnail you want to use.
    • To use a command line argument, pass the path to the directory you placed the script in as an argument when calling the Python executable. For example, if the script is placed in a C:\temp directory:
C:\python27\ArcGISx6410.8\python.exe C:\temp\<file_name>.py

The output reports all of the thumbnails that were updated. Once complete, run exportSite, importSite, the WebGIS DR tool, or any other operation and it should succeed.

Related Information

Last Published: 1/14/2022

Article ID: 000024415

Software: ArcGIS Server 10.8.1, 10.8, 10.7.1, 10.7