English

ArcGIS Server 9.2 Java Web ADF Usability Update Patch

Summary

This patch addresses several defects exposed in Java Web ADF applications found in particular situations that affect usability. These defects may be exposed in Java based web applications.

Description

Introduction

This patch addresses several defects exposed in Java Web ADF applications found in particular situations that affect usability. These defects may be exposed in Java based web applications. This patch is recommended for users with Java based web applications who encounter any of the following situations.

  • Experiencing Internet Explorer crashes when using cached data in Java web applications.
  • Experiencing ArcGIS Server crashes on Linux and Solaris.
  • Using group layers within ArcGIS Server data sources.
  • Have feature classes that are joined to a table in their mxd.

Issues Addressed with this Patch

  • NIM008809 - In an ArcGIS Server map service, if a sub-layer in a group layer is no longer valid, then the entire group layer becomes invalid and does not render in a web mapping application.
  • NIM009081 - ArcGIS Server map services do not return results when a layer is joined to some external table data sources.
  • NIM009364 - The EditingTask in the Java Web ADF for ArcGIS Server is associated with a TaskParamDescriptor class that is used to edit attribute values of a feature. The TaskParamDescriptor.setDisabled method does not work.
  • NIM009941 – When repeatedly panning/zooming on a Java ADF Web Mapping Application that uses a cached map resource and that has user added graphic symbols, Internet Explorer crashes intermittently.
  • NIM009943 - The Java ADF WebQuery.query method does not throw an exception when an invalid SQL statement is used. This method now throws an unchecked exception. For ArcGIS Server data sources it throws an ADFAGSException and for ArcIMS datasources it throws an ADFAIMSException.
  • NIM010322 - (Unix/Linux Only) A particular geometry when symbolized with a hash symbol causes a segmentation violation in ArcReader and Engine.
  • NIM010855 - When an image in the form of a PDF is extracted from a vector based map service, the first image obtained, after the service is started, is not as sharp or clear as subsequent images.
  • NIM011035 - In some situations the previous extent tool in the Java web mapping applications did not return to the appropriate extents.

Files Installed in this Patch

Windows:

<ArcGIS installation location>\bin
    fdacore.dll
    Mapserver.dll
<ArcGIS installation location >\java\web\webcontrols\WEB-INF\lib
    arcgis_webcontrols.jar
    arcgis_webcontrols_ags.jar
    arcgis_webcontrols_arcims.jar
    arcgis_webcontrols_arcweb.jar
    arcgis_webcontrols_ejb.jar
    arcgis_webcontrols_wms.jar
<ArcGIS installation location>\java\web\webcontrols\js
    esri_core.js
    esri_map.js

Sun Solaris, SUSE Linux and Red Hat Linux (Intel):

<ArcGIS Server installation location>/bin
    libmapserver.so
    mapserver.rsb
    libdisplaylib.so
    displaylib.rsb
    libfdacore.so
    fdacore.rsb
<ArcGIS Server installation location>/java/web/webcontrols/WEB-INF/lib
    arcgis_webcontrols.jar
    arcgis_webcontrols_ags.jar
    arcgis_webcontrols_arcims.jar
    arcgis_webcontrols_arcweb.jar
    arcgis_webcontrols_ejb.jar
    arcgis_webcontrols_wms.jar
<ArcGIS Server installation location>/java/web/webcontrols/js
    esri_core.js
    esri_map.js

Installing the Patch

Since this Hot Fix replaces 9.2 files, you must have ArcGIS 9.2 Service Pack 3 installed and running before you can install this Hot Fix. For the same reason, you shouldn't install it while anyone is using ArcGIS.


Installing this patch on Windows

  1. Before you start, make sure you have write access to the ArcGIS installation location folder.
  2. Open the Services Management Console; Control Panel > Administrative Tools > Services. Stop the ArcGIS Server Object Manager and ArcGIS Server Manager services.
  3. Double-click QFE-S-92-CQ00308807.exe to start the install process.
  4. When Setup starts, follow the instructions on your computer screen.
  5. Open the Services Management Console; Control Panel > Administrative Tools > Services. Start the ArcGIS Server Object Manager and ArcGIS Server Manager services.

Installing this patch on Sun Solaris, SUSE Linux and Red Hat Linux (Intel)

Make sure you have write access to the ArcGIS Server installation folder, that no one is using ArcGIS Server.

  1. Stop your server.
    % arcgis/scripts/stopserver
  2. Extract the specified tar file by typing:
    % tar -xvf gis92-s-cq00308807-slrs.tar (Sun Solaris)
    % tar -xvf gis92-s-cq00308807-lx.tar (Linux)
  3. 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.
  4. Before running the ArcGIS 9.2 configuration script you must:
    • Verify there is no existing Xvfb or Xsun process running.
      % ps -ef | grep Xvfb
    • If Xvfb is running, kill the process using the Process ID of Xvfb.
      % kill -9 <pid of Xvfb>
    • Verify there are no existing locks on Xvfb by checking the following locations:
      /tmp/.X7-lock (Linux)
      /tmp/.X11-unix/X7 (optional, exists on some SuSE machines)
      /tmp/.X11-unix/X7= (optional, exists on some Redhat machines)
      /tmp/.username-X11-unix/X7 (Solaris) where username is the owner of the ArcIMS installation.
      /tmp/.username-X11-pipe/X7 (Solaris) where username is the owner of the ArcIMS installation.
    • Remove any locks on Xvfb or Xsun if it exists.
  5. ArcGIS Server, type:

      % arcgis/scripts/SP3config.sh
      % arcgis/scripts/startserver

Patch Updates

Check Online Support Center periodically for the availability of additional patches. New information about this Patch will be posted here.

How to identify which Patch is installed


Windows

To check for the presence of a Patch, for each file examine the File version information (right click, properties, version tab). With only a few exceptions, all files modified as part of a Patch distribution can be uniquely identified in this manner. The File version for this Patch should read:

    9.2.3.1390

Sun Solaris, SUSE Linux and Red Hat Linux (Intel)

To find out what ArcGIS products are currently installed on your machine, download and extract the PatchFinder.tar and run PatchFinder utility from your local machine. This utility provides a report detailing which ArcGIS products and which service packs have been installed. The PatchFinder utility searches for the following ArcGIS products.

    ArcGIS Engine Developer Kit for C++
    ArcGIS Engine Developer Kit for the Java Platform
    ArcGIS Engine Runtime
    ArcGIS Server for the Java Platform
    ArcIMS
    ArcIMS Web ADF for the Java Platform
    ArcInfo Workstation
    ArcReader
    ArcSDE

Extract the tar file by typing:

% tar -xvf PatchFinder.tar

Run the utility by typing:

% ./PatchFinder

Getting Help

Domestic sites, please contact ESRI Technical Support at 1-888-377-4575, if you have any difficulty installing this Patch. International sites, please contact your local ESRI software distributor.