Patches and updates

ArcSDE 9.3 Service Pack 1 Memory Allocation Patch

Published: March 18, 2009

Summary

This patch is required for all 9.3 Service Pack 1 users. It fixes an issue with curves, a memory overwrite during archiving and a memory leak in ArcSDE for Oracle. It also fixes a separate memory leak and a compression bug in all DBMS implementations.

Description

The ArcSDE 9.3 Service Pack 1 Memory Allocation Patch is to be applied to ArcSDE and ArcSDE clients that already have 9.3 Service Pack 1 installed.

This general ArcSDE patch fixes memory allocation issues that can cause unexpected behavior in versioned geodatabases. One fix addresses inefficient memory use affecting all supported database platforms. Two of the memory allocation issues are specific to the Oracle database. Unexpected behavior can include excessive memory use or a server/application crash after a process (e.g.; a batch reconcile process) runs for several hours. This patch also has some additional fixes in it that having nothing to do with memory allocation. We added fixes for an issue with curves specific to Oracle’s ST_GEOMETRY where an attribute only change incorrectly generalizes the curve. We also fixed a compression bug which affects all DBMS implementations.

Please see the Issues Fixed with this Patch list for details.

Installing the Patch

ArcSDE 9.3 Service Pack 1 must be installed before you can install this Patch. It is strongly recommended that you back up your database including all previous ArcSDE system tables and user layer data before upgrading your ArcSDE installation. Install this Patch using an administrator account.

REQUIRED INSTALL STEP: If you connect to ArcSDE 9.3 via an Application Server and Direct Connect connections using ArcGIS 9.3, ArcIMS 9.3, or 9.3 Workstation make sure you also see ESRI Products connecting to ArcSDE (Application and Direct Connect connections).

Server Install for UNIX

During installation, you can either save the original 9.3 files or overwrite them. If you choose to save them, make sure you have enough disk space. The disk space requirements, for each platform, are displayed during the installation process.

ArcSDE 9.3 Service Pack 1 must be installed on the server and your client applications before you install this Patch.

Download the appropriate tar file to a location other than $SDEHOME:

DB2
HP64	sde93sp1-memorypatch-db2-hp64.tar	7 MB
IBM64	sde93sp1-memorypatch-db2-ibm64.tar	7 MB
Linux	sde93sp1-memorypatch-db2-lx.tar	5 MB
Solaris64	sde93sp1-memorypatch-db2-slrs64.tar	7 MB

Informix
HP	sde93sp1-memorypatch-inf-hp.tar	8 MB
IBM	sde93sp1-memorypatch-inf-ibm.tar	7 MB
Linux	sde93sp1-memorypatch-inf-lx.tar	5 MB
Solaris	sde93sp1-memorypatch-inf-slrs.tar	6 MB

Oracle 9i
HP64	sde93sp1-memorypatch-ora9i-hp64.tar	8 MB
IBM64	sde93sp1-memorypatch-ora9i-ibm64.tar	8 MB
Linux	sde93sp1-memorypatch-ora9i-lx.tar	6 MB
Solaris64	sde93sp1-memorypatch-ora9i-slrs64.tar	8 MB

Oracle 10g
HP64	sde93sp1-memorypatch-ora10g-hp64.tar	8 MB
HPIA	sde93sp1-memorypatch-ora10g-hp64ia.tar	16 MB
IBM64	sde93sp1-memorypatch-ora10g-ibm64.tar	9 MB
Linux	sde93sp1-memorypatch-ora10g-lx.tar	6 MB
Linux 64	sde93sp1-memorypatch-ora10g-lx64.tar	6 MB
Solaris64	sde93sp1-memorypatch-ora10g-slrs64.tar	8 MB

Oracle 11g
IBM64	sde93sp1-memorypatch-ora11g-ibm64.tar	8 MB
Linux	sde93sp1-memorypatch-ora11g-lx.tar	6 MB
Linux 64	sde93sp1-memorypatch-ora11g-lx64.tar	6 MB
Solaris64	sde93sp1-memorypatch-ora11g-slrs64.tar	8 MB

PostgresSQL
PostGres SQL	sde93sp1-memorypatch-pg-lx.tar	4 MB

Stop your current ArcSDE service if one is running.

% sdemon -o shutdown

NOTE (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

(Optional) To list the libraries loaded into memory, as ROOT user, type:

# /usr/sbin/genkld

For further information on the slibclean and genkld commands please refer to your AIX system administrator documentation.
Extract the specified tar file by typing:
% tar -xvf sde93sp1-memorypatch-<Database>-<Platform>.tar
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.
(This step is for Oracle only, all other DBMS skip to the next step)

Before running "sdesetup -o upgrade", you must grant the following additional permissions to the SDE user in Oracle: ALTER ANY TABLE
ANALYZE ANY
CREATE ANY INDEX
CREATE ANY PROCEDURE
CREATE ANY SEQUENCE
CREATE ANY TRIGGER
CREATE ANY VIEW
CREATE INDEXTYPE
CREATE LIBRARY
CREATE OPERATOR
CREATE PROCEDURE
CREATE PUBLIC SYNONYM
CREATE SESSION
CREATE SEQUENCE
CREATE TABLE
CREATE TRIGGER
CREATE TYPE
DROP ANY INDEX
DROP ANY PROCEDURE
DROP ANY SEQUENCE
DROP ANY TABLE
DROP ANY VIEW
DROP PUBLIC SYNONYM
EXECUTE ANY PROCEDURE
SELECT ANY SEQUENCE
SELECT ANY TABLE
UNLIMITED TABLESPACE
To upgrade, run sdesetup. Failure to do so may cause problems in starting the service or with connecting to the geodatabase. Please go to the admin command guide under the %SDEHOME%\documentation folder for more information on using this command:

%sdesetup -o upgrade -d <ORACLE9I|ORACLE10G|ORACLE11G|SQLSERVER|DB2|INFORMIX|POSTGRESQL> –u <DB_Admin_User> –p <DB_Admin_password>
(This step is for Oracle only, all other DBMS skip to the next step)
After the upgrade completes, you may revoke the following permissions from the SDE user account:

ANALYZE ANY
ALTER ANY INDEX
ALTER ANY TABLE
CREATE ANY INDEX
CREATE ANY TRIGGER
CREATE ANY VIEW
DROP ANY INDEX
DROP ANY TABLE
DROP ANY VIEW
DROP ANY PROCEDURE
DROP ANY SEQUENCE
EXECUTE ANY PROCEDURE
SELECT ANY SEQUENCE
CREATE INDEXTYPE
CREATE LIBRARY
CREATE OPERATOR
CREATE TYPE
Restart your service.

% sdemon -o start

(This step only applies to Oracle or PostgreSQL users who have the ArcSDE component and the DBMS installed on separate servers. All other users proceed to the next step.)

For Oracle:

If you have the ArcSDE component and Oracle installed on separate servers, there are three shared libraries used by EXTPROC that must be copied to the Oracle server. Check the list of files altered by this patch. If any of the following files are on this list, new versions of the file must be copied to the Oracle server. Be sure the files copied to the Oracle server are designed to run on the operating system of the Oracle server. See the ArcSDE for Oracle installation guide for instructions.

If the file is not in the list, new versions of it do not need to be copied to the Oracle server.

Library Name	OS-dependent file names
st_shapelib	st_shapelib.dll (Windows), libst_shapelib.so (Solaris, Linux, and HP-UX Itanium), libst_shapelib.sl (HP-UX PA-RISC), libst_shapelib_64.so (IBM)
Projection Engine	pe.dll (Windows), libpe.so (Solaris, Linux, and HP-UX Itanium), libpe.sl (HP-UX PA-RISC), libpe_64.so (IBM)
Geometry	sg.dll (Windows), libsg.so (Solaris, Linux, and HP-UX Itanium), libsg.sl (HP-UX PA-RISC), libsg_64.so (IBM)

For PostreSQL:

If you have the ArcSDE component and PostgreSQL installed on separate servers, there are three libraries that must be copied to the PostgreSQL server. Check the list of files altered by this patch. If any of the following files are on this list, new versions of the file must be copied to the PostgreSQL server. Be sure the files copied to the PostgreSQL server are designed to run on the operating system of the PostgreSQL server. See the ArcSDE for PostgreSQL installation guide for instructions.

If the file is not in the list, new versions of it do not need to be copied to the PostgreSQL server.

Library Name	OS-dependent file names
st_geometry	st_shapelib.dl (Windows), st_geometry.so (Linux)
Projection Engine	pe.dll (Windows), libpe.so (Linux)
Geometry	sg.dll (Windows), libsg.so (Linux)

If you have ArcSDE installed on more than one server, perform steps 1 through 8 for each one.
Note:If you have multiple geodatabases on the same server, you only have to install the patch once on the server, but you must perform steps 5 through 8 to upgrade each of the geodatabases and restart their corresponding services if services exist.

Server Install for Windows

Windows Installation Notes:

ArcSDE 9.3 Service Pack 1 must be installed on the server and your client applications before you install this Patch.

Installation Steps

Install this Patch using an administrator account. Make sure you have write access to the ArcSDE installation folder, that no one is using ArcSDE, and that the ArcSDE service is down.

Download the appropriate files to a location other than the ArcSDE installation folder:

DB2
sde93sp1-memorypatch-db2-win.exe	3 MB
DB2/ZOS
(coming soon)	3 MB
Informix
sde93sp1-memorypatch-inf-win.exe	3 MB
Oracle 9i
sde93sp1-memorypatch-ora9i-win.exe	4 MB
Oracle 10g
sde93sp1-memorypatch-ora10g-win.exe	4 MB
sde93sp1-memorypatch-ora10g-win64.msp	3 MB
Oracle 11g
sde93sp1-memorypatch-ora11g-win.exe	4 MB
sde93sp1-memorypatch-ora11g-win64.msp	3 MB
PostGres SQL
sde93sp1-memorypatch-pg-win.exe	3 MB
SQL Server
sde93sp1-memorypatch-sql-win.exe	3 MB
sde93sp1-memorypatch-sql-win64.msp	3 MB

Double-click the appropriate executable to start the install process.
When Setup starts, follow the instructions on your screen.
(This step is for Oracle only, all other DBMS skip to the next step)
Before running "sdesetup -o upgrade", you must grant the following additional permissions to the SDE user in Oracle:

ALTER ANY INDEX
ALTER ANY TABLE
ANALYZE ANY
CREATE ANY INDEX
CREATE ANY PROCEDURE
CREATE ANY SEQUENCE
CREATE ANY TRIGGER
CREATE ANY VIEW
CREATE INDEXTYPE
CREATE LIBRARY
CREATE OPERATOR
CREATE PROCEDURE
CREATE PUBLIC SYNONYM
CREATE SESSION
CREATE SEQUENCE
CREATE TABLE
CREATE TRIGGER
CREATE TYPE
DROP ANY INDEX
DROP ANY PROCEDURE
DROP ANY SEQUENCE
DROP ANY TABLE
DROP ANY VIEW
DROP PUBLIC SYNONYM
EXECUTE ANY PROCEDURE
SELECT ANY SEQUENCE
SELECT ANY TABLE
UNLIMITED TABLESPACE
As the ArcSDE Administrative user run the sdesetup command. Failure to do so may cause problems in starting the service or with connecting to the geodatabase. Please go to the admin command guide under the %SDEHOME%\documentation folder for more information on using this command:

c:\ sdesetup -o upgrade -d <ORACLE9I|ORACLE10G|ORACLE11G|SQLSERVER|DB2|INFORMIX|POSTGRESQL> –u <DB_Admin_User> –p <DB_Admin_password>
(This step is for Oracle only, all other DBMS skip to the next step)
After the upgrade completes, you may revoke the following permissions from the SDE user account:

ANALYZE ANY
ALTER ANY INDEX
ALTER ANY TABLE
CREATE ANY INDEX
CREATE ANY TRIGGER
CREATE ANY VIEW
DROP ANY INDEX
DROP ANY TABLE
DROP ANY VIEW
DROP ANY PROCEDURE
DROP ANY SEQUENCE
EXECUTE ANY PROCEDURE
SELECT ANY SEQUENCE
CREATE INDEXTYPE
CREATE LIBRARY
CREATE OPERATOR
CREATE TYPE
As the ArcSDE administrative user, run the following command to restart the ArcSDE service:

c:\sdemon -o start

(This step only applies to Oracle or PostgreSQL users who have the ArcSDE component and the DBMS installed on separate servers. All other users proceed to the next step.)

For Oracle:

Library Name	OS-dependent file names
st_shapelib	st_shapelib.dll (Windows), libst_shapelib.so (Solaris, Linux, and HP-UX Itanium), libst_shapelib.sl (HP-UX PA-RISC), libst_shapelib_64.so (IBM)
Projection Engine	pe.dll (Windows), libpe.so (Solaris, Linux, and HP-UX Itanium), libpe.sl (HP-UX PA-RISC), libpe_64.so (IBM)
Geometry	sg.dll (Windows), libsg.so (Solaris, Linux, and HP-UX Itanium), libsg.sl (HP-UX PA-RISC), libsg_64.so (IBM)

For PostreSQL:

Library Name	OS-dependent file names
st_geometry	st_shapelib.dl (Windows), st_geometry.so (Linux)
Projection Engine	pe.dll (Windows), libpe.so (Linux)
Geometry	sg.dll (Windows), libsg.so (Linux)
Geometry	sg.dll, libsg.so (.sl for HP-UX PA-RISC, _64.so for IBM64)

If you have ArcSDE installed on more than one server, perform steps 1 through 8 for each one.
Note:If you have multiple geodatabases on the same server, you only have to install the patch once on the server, but you must perform steps 5 through 8 to upgrade each of the geodatabases and restart their corresponding services if services exist.

ArcSDE SDK Install for UNIX

Download the appropriate tar file to a location other than ArcSDE SDK installation location:
All Databases (32 bit Operating System)

HP	sde93sp1-memorypatch-sdk-hp.tar	11 MB
IBM	sde93sp1-memorypatch-sdk-ibm.tar	11 MB
Linux	sde93sp1-memorypatch-sdk-lx.tar	16 MB
Solaris	sde93sp1-memorypatch-sdk-slrs.tar	10 MB

All Databases (64 bit Operating System)

HP64	sde93sp1-memorypatch-sdk-hp64.tar	18 MB
HPIA64	sde93sp1-memorypatch-sdk-hpia64.tar	29 MB
IBM 64	sde93sp1-memorypatch-sdk-ibm64.tar	20 MB
Solaris64	sde93sp1-memorypatch-sdk-slrs64.tar	21 MB

Extract the specified tar file by typing:
% tar -xvf sde93sp1-memorypatch-sdk-<Platform>.tar
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.

ArcSDE SDK Install for Windows

Make sure you have write access to the ArcSDE SDK installation folder.
Download the appropriate files to a location other than the ArcSDE SDK installation folder:

ArcSDE SDK sde93sp1-memorypatch-sdk-win.exe 10 MB
Double-click the appropriate executable to start the install process
When Setup starts, follow the instructions on your screen.

ESRI Products connecting to ArcSDE (Application Server and Direct Connect connections)

UNIX

If you connect to ArcSDE 9.3 Service Pack 1 using ArcInfo 9.3 Workstation or ArcIMS 9.3 Service Pack 1 on any supported Unix/Linux platform please follow the steps below to install this Patch to your ArcInfo 9.3 or ArcIMS 9.3 SP1 software installation directory. This also applies if connecting to ArcSDE 9.3 SP1 using ArcGIS Server 9.3 SP1, ArcGIS Engine 9.3 SP1, and ArcGIS Reader9.3 SP1 for Sun Solaris and Linux:

Before you start, make sure you have write access to the installation directory then download the appropriate compressed tar file to that location:

HP-UX	sde93sp1-memorypatch-esri-hp.tar.gz	8 MB
IBM	sde93sp1-memorypatch-esri-ibm.tar.gz	7 MB
Linux	sde93sp1-memorypatch-esri-lx.tar.gz	11 MB
Solaris	sde93sp1-memorypatch-esri-slrs.tar.gz	7 MB

ArcIMS only, stop the ArcIMS Tasker, ArcIMS Monitor, ArcIMS Application Server (in that order).
Uncompress and extract the specified tar file for your platform. At the UNIX prompt type:
%cd <installation_directory> (i.e. cd $ARCHOME)
%gunzip sde93sp1-memorypatch-esri-<Platform>.tar.gz
%tar xvf sde93sp1-memorypatch-esri-<Platform>.tar
ArcIMS only, restart ArcIMS Application Server, ArcIMS Monitor and ArcIMS Tasker (in that order).

Windows
- If you connect to ArcSDE 9.3 Service Pack 1 using ArcGIS 9.3 Service Pack 1, ArcIMS 9.3 Service Pack 1, or ArcInfo Workstation 9.3, please follow the steps below to install this Patch to your ArcGIS 9.3 SP1, ArcIMS 9.3 SP1, or ArcInfo Workstation 9.3 installation folder:
- Before you start, make sure you have write access to the installation folder, then download the zip file to that location:
  
  sde93sp1-memorypatch-esri-win.zip 10 MB
- ArcIMS only, stop the ArcIMS Tasker, ArcIMS Monitor, ArcIMS Application Server (in that order).
- Use WinZip to extract the new file from sde93sp1-memorypatch-esri-win.zip to the appropriate installation folder, see list below:
  - ArcGIS Desktop, Workstation, or ArcView 9 - <installation-folder>\bin
  - ArcView GIS - <installation-folder>\arcview3\bin
  - ArcIMS – <installation-folder>\server\bin:
    If it is listed in the files included section, extract sde.dll to <installation-folder>\Metadata\Commands
    If it is listed in the files included section, extract sde.dll to <installation-folder>\IndexBuilder
- ArcIMS only, restart ArcIMS Application Server, ArcIMS Monitor and ArcIMS Tasker (in that order).

How to identify which Patch is installed

UNIX

To find out what ArcGIS products are currently installed on your machine, copy the PatchFinder.tar utility to your machine 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
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

Windows

To find out what products are currently installed on your machine, run the PatchFinder93.exe utility. This utility provides a report detailing which ArcGIS products are currently installed on your machine. This will help determine which product Service Packs you should install on your machine. The report also details 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 Image Server
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

Service Pack Updates

Check Online Support Center periodically for the availability of additional Service Packs. New information about this Service Pack will be posted here.

March 25, 2009: AIX Oracle 9i, Solaris Oracle 9i, Solaris Oracle 11g, Windows Oracle 11g are now available for download.

April 13, 2009: Updated step 9 for both Unix and Windows Server install sections for clarity.

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.