Patches and updates
Portal for ArcGIS 11.5 Web Applications Patch
Summary
Esri announces the Portal for ArcGIS 11.5 Web Applications Patch. Esri recommends that all customers using Portal for ArcGIS 11.5 apply this patch. This patch addresses two important issues for ArcGIS Enterprise 11.5. The first issue (BUG-000177808) causes web applications installed with Portal for ArcGIS to intermittently not display correctly and fail to load all application resources. When this specific problem is encountered, the browser developer tools will show a 'ChunkLoadError: Loading chunk # failed.' error. The second issue (BUG-000177260), which affects a less commonly used workflow to update the federated server URL, results in incorrect updates to portal content. The potential impact of this defect is that content is not accessible and federation is broken. This patch deals specifically with the issues listed below under Issues Addressed with this Patch.
Important note: After the Portal for ArcGIS 11.5 Web Applications Patch is installed on the portal machine, the Web browser cache must be cleared on all machines where the problem of loading an application occurred. Typically when a browser experiences an error, once new files are available, the browser will utilize the new files and overcome the failure. BUG-000177808 causes an unusual and difficult condition where the web application received 0-byte files which resulted in a failure in the web application loading process. These erroneous 0-byte files were cached within the browser and while the patch includes logic to force the recognition of new, corrected files, browser caching may still be in effect and thus the application does not utilize the newly corrected files. It is therefore required that the browser cache be cleared explicitly after the patch has been applied. Clearing of browser cache is required on all machines that consume or connect to web applications impacted by this defect.
Esri recommends developing a rollback plan before installing patches. This may be taking a snapshot of machines and related file servers or using the WebGIS DR tool as a software backup. See Back up and restore best practices for more information. For those utilizing a highly available environment, refer to the help topic on how to apply patches in a highly available environment for guidance. This patch can be uninstalled as outlined in the Uninstalling this patch on Windows and Uninstalling this patch on Linux sections below.
Issues addressed with this patch
- BUG-000177808 - Web applications installed with Portal for ArcGIS 11.5 may intermittently fail to fully load all content, and the browser console shows the "ERROR: ChunkLoadError: Loading chunk xxxx failed." error message.
- BUG-000177260 - Updating the federated server URL incorrectly updates portal content URLs, resulting in inaccessible content and negatively affecting federation.
Installing this patch on Windows
On Windows, the release date order of the patches does not matter when installing multiple patches. If an older patch is installed after a newer patch, the newer patch takes precedence and the fixes from the newer patch will remain. The ArcGIS Enterprise Patch Notification tool, when the option to install all available patches is activated, installs multiple patches in order of release date starting with oldest to newest.
The ArcGIS product listed in the table must be installed on your system before you can install a patch. Each patch setup is specific to the ArcGIS product in the list. To determine which products are installed on your system, please see the How to identify which ArcGIS products are installed section. Esri recommends that you install the patch for each product that is on your system.
Step 1: Download the appropriate file to a location other than your ArcGIS installation location.
ArcGIS Enterprise 11.5 | |
Portal for ArcGIS | ArcGIS-115-PFA-WA-Patch.msp |
Checksum (SHA256) |
DC0F521ABE608E8D9342306C3A420A9B16A018485CE10261D04947A3A8FCA43A |
Step 2: Make sure you have write access to your ArcGIS installation location.
Step 3: Double-click ArcGIS-115-PFA-WA-Patch.msp to start the setup process.
NOTE: If double clicking on the msp file does not start the setup installation, you can start the setup installation manually by using the following command:
msiexec.exe /p [location of Patch]\ArcGIS-115-PFA-WA-Patch.msp
Step 4: As a best practice, clear the browser cache and re-launch the browser after installing the patch.
Installing this patch on Linux
On Linux, the release date order of the patches matters when installing multiple patches. If an older patch is installed after a newer patch, the older patch will replace the newer patch and the fixes in the newer patch will be removed. The ArcGIS Enterprise Patch Notification tool, when the option to install all available patches is activated, installs multiple patches in order of release date starting with oldest to newest.
Complete the following install steps as the ArcGIS Install owner. The Install owner is the owner of the arcgis folder.
The ArcGIS product listed in the table must be installed on your system before you can install a patch. Each patch setup is specific to the ArcGIS product in the list. To determine which products are installed on your system, please see the How to identify which ArcGIS products are installed section. Esri recommends that you install the patch for each product that is on your system.
Step 1: Download the appropriate file to a location other than your ArcGIS installation location.
ArcGIS Enterprise 11.5 | |
Portal for ArcGIS | ArcGIS-115-PFA-WA-Patch-linux.tar |
Checksum (SHA256) |
36B652B23FFDE6AADB80ADC1D819FF62374DA4065D3FF74E235FEF83E9E22A5F |
Step 2: Make sure have write access to your ArcGIS installation location, and that no one is using ArcGIS.
Step 3: Extract the specified tar file by typing:
% tar -xvf ArcGIS-115-PFA-WA-Patch-linux.tar
Step 4: Start the installation by typing:
% ./applypatch
This will start the dialog for the menu-driven installation procedure. Default selections are noted in parentheses ( ). To quit the installation procedure, type 'q' at any time.
Step 5: As a best practice, clear the browser cache and re-launch the browser after installing the patch.
Uninstalling this patch on Windows
To uninstall this patch on Windows, open the Windows Control Panel and navigate to installed programs. Make sure that "View installed updates" (upper left side of the Programs and Features dialog) is active. Select the patch name from the programs list and click Uninstall to remove the patch.
Uninstalling this patch on Linux
Navigate to the <Product Installation Directory>/.Setup/qfe directory and run the following script as the ArcGIS Install owner:
./removepatch.sh
The removepatch.sh script allows you to uninstall previously installed patches or hot fixes. Use the -s status flag to get the list of installed patches or hot fixes ordered by date. Use the -q flag to remove patches or hot fixes in reverse chronological order by date they were installed. Type removepatch -h for usage help.
Restart your ArcGIS services.
How to identify which ArcGIS products are installed
To determine which ArcGIS products are installed, choose the appropriate version of the PatchFinder utility for your environment and run it from your local machine. PatchFinder will list all products, hot fixes, and patches installed on your local machine.
Get help from ArcGIS experts
Download the Esri Support App