English

ArcIMS 9.3.1 Service Pack 1

Summary

This Service Pack contains maintenance fixes. Please download and install this required Service Pack at your earliest convenience.

Description

Important Note


If you use Microsoft SQL Server, an issue has been found where after applying 9.3.1 SP1 you can no longer view data in Raster catalogs stored in SQL Server. Please see Technical Article 37463 for more information. To fix this issue simply install the ArcSDE 9.3.1 SP1 SQL Server Raster Catalog and Raster Field Patch.

ArcGIS 9.3.1 Service Pack 1 DVD


A DVD of this Service Pack will be made available in the next several weeks for users who experience difficulties downloading the Service Pack from the web site. Simply fill out the Request a Service Pack DVD order form.

Issues Addressed in this Service Pack

Files Installed with this Service Pack

Installing this Service Pack

Windows, Unix and Linux Installation Notes:

  • It is important to keep all versions of ArcGIS products installed on the same machine in sync to avoid any software conflicts.


  • This Service Pack should be installed as the ArcGIS or ArcIMS product owner, i.e. the user owning the installation.


  • ArcSDE and ArcGIS Desktop users: If you use ArcIMS 9.3.1 and ArcSDE 9.3.1 or ArcGIS Desktop 9.3.1 , you should also install ArcSDE 9.3.1 Service Pack 1 or ArcGIS 9.3.1 Service Pack 1. For example, if you use ArcIMS 9.3.1 and ArcSDE 9.3.1, install both ArcIMS 9.3.1 Service Pack 1 and ArcSDE 9.3.1 Service Pack 1. Since ArcIMS 9.3.1, ArcSDE 9.3.1 and the ArcGIS 9.3.1 products share common DLLs, it is important to keep the software release versions in sync to avoid any software conflicts.

Installation Steps for ArcIMS on Windows

ArcIMS 9.3.1 must be installed before you can install this Service Pack. This Service Pack is cumulative and contains all fixes from previous patches. If you already have a previous patch installed, you may apply this Service Pack over it to update the required files.

  1. From your Services control panel, stop the ArcIMS Tasker, ArcIMS Monitor, and ArcIMS Application Server (in that order).
  2. Double-click the ArcIMS931sp1.msp (55 MB) to start the install process. This executable will take some time to examine your current ArcIMS install during the initializing stage. If double clicking the EXE file does not start the Service Pack installation, you can run the Service Pack manually by using the following command:
    msiexec.exe /p [location of Update]\ArcIMS931sp1.msp REINSTALL=ALL REINSTALLMODE=omus
  3. When Setup starts, follow the instructions on your screen.
  4. After the Setup has finished, stop the Web Server and Servlet Engine and then run the ArcIMS Post Installation. The post installation setup can be run from Start > Programs > ArcGIS > ArcIMS > ArcIMS Post Installation.
    If you have customized directories or files, please cut and paste them to a back-up location prior to running the Post Install. Remember to replace any customized files after running the post-install with the backed-up/original files.
    TOMCAT USERS ONLY: Stop the Tomcat processes, then navigate to <Tomcat Installation Directory>\webapps. If any of the following directories and files exist, please move them to a backup location prior to running the Post Install and Web Configuration. These must be removed from the webapps directory. Remember to replace any customized files after running the post-install with the backed-up/original files.

      \aimscsw
      \aimscsw.war
      \esriadmin
      \esriadmin.war
      \wfsconnector
      \wfsconnector.war
  5. In the Post Install, choose the Custom Install option
  6. Check the box for ArcIMS Configuration
  7. Check the box for Web Server – Servlet Engine Configuration
  8. Check the box for ArcIMS JRE Configuration for Author, Designer, and Administration Tools.
    In the ArcIMS JRE Configuration dialog no changes are necessary, simply keep the defaults and click Next.
  9. Uncheck all other options.
  10. Follow the prompts as explained in the ArcIMS Installation Guide and finish the Post Installation.
  11. Note: You will need to follow the uninstallation procedure found in the ArcIMS Install guide to remove deployed ESRI war files from your web-server/servlet engine before re-deployment. If your Web Server is not available as a selection in the Post Installation, please follow the manual instructions found in the ArcIMS Installation Guide to re-configure your web-server/servlet engine and to re-deploy ESRI war files. The war files that have been updated are listed below:

      \aimscsw
      \aimscsw.war
      \esriadmin
      \esriadmin.war
      \wfsconnector
      \wfsconnector.war
  12. The post install will start the ArcIMS Application Server, ArcIMS Monitor and ArcIMS Tasker services. You may need to restart any additional ArcIMS services that may have been stopped for the install.

Installation Steps for ArcIMS Web ADF for the Java Platform on Windows

ArcIMS Web ADF for the Java Platform 9.3.1 must be installed before you can install this Service Pack. This Service Pack is cumulative and contains all fixes from the previous patches. If you already have a previous patch installed, you may apply this Service Pack over it to update the required files.

  1. Copy ArcIMSADFJava931sp1.msp (105 MB) to a location other than the installation directory.
  2. From your Services control panel, stop the ArcIMS Web Manager Service.
  3. Double-click the ArcIMSADFJava931sp1.msp to start the install process. This executable will take some time to examine your current ArcIMS Web ADF for the Java Platform install during the initializing stage. If double clicking the MSP file does not start the Service Pack installation, you can run the Service Pack manually by using the following command:
    msiexec.exe /p [location of Update]\ArcIMSADFJava931sp1.msp REINSTALL=ALL REINSTALLMODE=omus
  4. When Setup starts, follow the instructions on your screen. The setup will start the ArcIMS Web Manager Service.

Installation Steps for ArcIMS Web ADF for the Microsoft .NET Framework on Windows

ArcIMS Web ADF for the Microsoft .NET Framework 9.3.1 must be installed before you can install this Service Pack. This Service Pack is cumulative and contains all fixes from previous patches. If you already have a previous patch installed, you may apply this Service Pack over it to update the required files.

  1. Copy ArcIMSADFDNet931sp1.msp (16 MB) to a location other than the installation directory.
  2. Double-click the ArcIMSADFNet931sp1.msp to start the install process. This executable will take some time to examine your current ArcIMS install during the initializing stage. If double clicking the MSP file does not start the Service Pack installation, you can run the Service Pack manually by using the following command:
    msiexec.exe /p [location of Update]\ArcIMSADFNet931sp1.msp REINSTALL=ALL REINSTALLMODE=omus
  3. When Setup starts, follow the instructions on your screen.

Installation Steps for ArcIMS .NET Web ADF Runtime on Windows

Note: The .NET Web ADF Runtime, ArcGISServerWebADFRuntime931sp1.msp, must be installed on the Web server machine that deploys the developed application before you can install this update. It can also be installed on machines used to test your developed application.
  1. Copy ArcGISServerWebADFRuntime931sp1.msp (12 MB) to a location other than the installation directory.
  2. Double-click the ArcGISServerWebADFRuntime931sp1.msp to start the install process. This executable will take some time to examine your current .NET Web ADF Runtime install during the initializing stage. If double clicking the MSP file does not start the Service Pack installation, you can run the Service Pack manually by using the following command:
    msiexec.exe /p [location of Update]\ArcGISServerWebADFRuntime931sp1.msp REINSTALL=ALL REINSTALLMODE=omus
  3. When Setup starts, follow the instructions on your screen.

Installation Steps for ArcIMS on UNIX/Linux

ArcIMS 9.3.1 must be installed before you can install this Service Pack.

  1. (IBM AIX only) Stop the ArcIMS Tasker, ArcIMS Monitor, and ArcIMS Application Server (in that order) or use the script $AIMSHOME/qs_scripts/stop_arcims.
  2. Note: While the applypatch command will stop and start the ArcIMS services as it runs for all platforms, it cannot run the slibclean command for the IBM-AIX platform. Therefore, it is required that IBM users stop the services in this step.
  3. (IBM AIX only) You must remove any inactive libraries that are loaded into memory before proceeding to the next step. Not doing so will result in an installation error. To remove them, as ROOT user, type:

    # /usr/sbin/slibclean

  4. Back up any customized files within your ArcIMS installation if they are listed in the Files Installed by this Update page for UNIX/Linux. (e.g. the aimsmeta.properties, esriadmin.properties, Esrimap_prop files.)


  5. Extract the tar file ims931-sp1-<platform>.tar by typing:
    % tar -xvf ims931-sp1-<platform>.tar
  6. 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.
  7. Note: The applypatch command will start the ArcIMS Application Server, ArcIMS Monitor, and ArcIMS Tasker (in that order).

  8. To finish the ArcIMS Update install run the <Path to ArcIMS Install>/tools/SetupArcIMS_PostInstall to propogate updated jar files to your JRE/JDK locations.

  9. The Post Installation should include running the <Path to ArcIMS Install>/tools/SetupArcIMS_WebConfig as the root user in order to redeploy the war files that have been updated.
  10. TOMCAT USERS ONLY: Stop the Tomcat processes, then navigate to <Tomcat Installation Directory>\webapps. If any of the following directories and files exist, please move them to a backup location prior to running the Post Install and Web Configuration. These must be removed from the webapps directory. Remember to replace any customized files after running the post-install with the backed-up/original files.

      \aimscsw
      \aimscsw.war
      \esriadmin
      \esriadmin.war
      \wfsconnector
      \wfsconnector.war
    Note: You will need to follow the uninstallation procedure found in the ArcIMS Install guide to remove deployed ESRI war files from your web-server/servlet engine before re-deployment. If your Web Server is not available as a selection in the Post Installation, please follow the manual instructions found in the ArcIMS Installation Guide to re-configure your web-server/servlet engine and to re-deploy ESRI war files. The war files that have been updated are listed below:

      \aimscsw
      \aimscsw.war
      \esriadmin
      \esriadmin.war
      \wfsconnector
      \wfsconnector.war

    Installation Steps for ArcIMS ArcMap Server. (Solaris and Linux only.)

  11. Extract the ims931-sp1-mapsrvr-<platform>.tar:

    %tar xvf ims931-sp1-mapsrvr-<platform>.tar

  12. Before running ArcIMS 9.3.1 Service Pack 1 ArcMap Server applypatch you must:
    • Verify there is no running Xvfb or Xsun process.
    • Remove any locks on Xvfb or Xsun if it exists.

  13. Verify there is no existing Xvfb or Xsun process running.
    % ps -ef | grep Xvfb
  14. If Xvfb is running, kill the process using the Process ID of Xvfb.
    % kill -9 <pid of Xvfb>
  15. Verify there is no existing lock 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.
  16. Remove the lock file if it exists.
  17. Run the ArcIMS 9.3.1 Service Pack 1 ArcMap Server applypatch.
    % ./applypatch
  18. 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.

Installation Steps for ArcIMS Web ADF for the Java platform on UNIX/Linux

ArcIMS Web ADF for the Java Platform 9.3.1 must be installed before you can install Service Pack 1.

  1. Copy the selected tar file to a location other than the installation directory.

    ArcIMS Web ADF for the Java platform gis931sp1-imsadfjava.tar 156 MB

  2. Back up any customized files within your installation if they are listed in the Files Installed by this Update page for UNIX/Linux.

  3. Extract the tar files by typing:
    % tar -xvf gis931sp1-imsadfjava.tar
    % tar -xvf gis931sp1-imsjavahelp.tar
  4. Start the installation by typing:
    % ./applypatch
  5. When Setup starts, follow the instructions on your screen.

How to identify which Service Pack is installed


    Windows

    To find out what ArcGIS products are currently installed on your machine, download the PatchFinder931.exe utility and run it from your local machine. This utility provides a report detailing which ArcGIS products and which service packs have been installed. The report is displayed when the utility is run and a servicepack.txt log file is created in your temp folder. The Service Pack Finder utility searches for the following ArcGIS products.

      ArcGIS ArcReader
      ArcGIS Desktop (ArcView, ArcEditor, ArcInfo) Includes the ArcReader fixes for the ArcReader FEATURE.
      ArcGIS Desktop Developer Kit for the Microsoft .NET Framework, VB6, VBA and Visual C++
      ArcGIS Engine Developer Kit for C++, the Java Platform, the Microsoft .NET Framework, VB6 and Visual C++
      ArcGIS Engine Runtime
      ArcGIS Help System for the Java Platform
      ArcGIS Image Server
      ArcGIS Military Analyst
      ArcGIS Military Overlay Editor
      ArcGIS Server for the Microsoft .NET Framework
      ArcGIS Server for the Java Platform
      ArcGIS Server Web ADF Runtime for the Microsoft .NET Framework
      ArcIMS
      ArcIMS Web ADF for the Microsoft .NET Framework
      ArcIMS Web ADF for the Java Platform
      ArcSDE


    UNIX/Linux

    To find out what ArcGIS products are currently installed on your machine, download and extract the PatchFinder utility and run it 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
      ArcGIS Help System for the Java Platform
      ArcGIS Military Analyst
      ArcGIS Military Overlay Editor
      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



Updates

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

    December 15, 2009: ArcIMS Web ADF for the Java platform (Linux, Unix, and Windows) is now available for download.

Getting Help

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