SpatialWare

for Microsoft SQL Server Version 4.9.2

INSTALLATION GUIDE

Information in this document is subject to change without notice and does not represent a commitment on the part of the vendor or its representatives. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, without the written permission of MapInfo Corporation, One Global View, Troy, New York 12180-8399. 2007 MapInfo Corporation. All rights reserved. Portions 2004 Stopwatch Maps, Inc. All rights reserved. MapInfo, the MapInfo logo, MapInfo Professional, and SpatialWare are trademarks of MapInfo Corporation and/or its affiliates. MapInfo Corporate Headquarters: Voice: (518) 285-6000 Fax: (518) 285-6070 Sales Info Hotline: (800) 327-8627 Government Sales Hotline: (800) 619-2333 Technical Support Hotline: (518) 285-7283 Technical Support Fax: (518) 285-6080 Contact information for all MapInfo offices is located at: http://www.mapinfo.com/contactus. Adobe Acrobat is a registered trademark of Adobe Systems Incorporated in the United States. Products named herein may be trademarks of their respective manufacturers and are hereby recognized. Trademarked names are used editorially, to the benefit of the trademark owner, with no intent to infringe on the trademark. January 2007

Table of Contents
Chapter 1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Key Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Product Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Sample Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Sample Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Installation Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Questions About Upgrading? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Chapter 2: Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Selecting a SQL Server Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Local or Remote Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Additional Steps for Installing on Windows Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Testing Your Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Post Installation Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Upgrading to or Reinstalling SpatialWare 4.9.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Upgrading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Reinstalling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Uninstall SpatialWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Removing a Remote SpatialWare Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Chapter 3: Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Install Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Installation Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Maximum Stored Procedure Nesting Level Exceeded. . . . . . . . . . . . . . . . . . . . . . . . . .16 Incorrect Reference to Older DLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Error Message: "This string is too long." . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Error Message: Incompatible Version of MDAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

Appendix A: Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Table of Contents

Installation Guide 2007 MapInfo Corporation. All rights reserved.

Introduction

Welcome to SpatialWare for Microsoft SQL Server. This guide explains how to install and set up SpatialWare for Microsoft SQL Server. It contains tips and information for this version of the software only. Subsequent shipments of the software may or may not contain a similar guide. MapInfo SpatialWare for Microsoft SQL Server will be referred to as SpatialWare in this guide. This chapter introduces you to SpatialWares components and features, and orients you to get the most out of the product.

In this chapter:
Key Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Product Inventory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Installation Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Questions About Upgrading? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Key Features

Key Features
SpatialWare has the following benefits and features: A complete integration of spatial and attribute data. Data security. Scalability. The spatial data type enhancements are implemented entirely on the server side to exploit the scalability offered by Microsoft SQL Server. A rich set of spatial functions that follow the OGC naming and parameter specifications for spatial functions in SQL. Standards compliance. Ease of use. Programmatic interfaces. SpatialWare requires no middle tier to access the database, so you can access SpatialWare functionality through standard programmatic interfaces such as JDBC and ODBC.

Product Inventory
Your copy of SpatialWare includes software, sample data, sample queries, and documentation.

Software
SpatialWare software is provided to integrate with Microsoft SQL Server.

Sample Data
SpatialWare includes sample data for experimenting with data retrieval and analysis. The following sample data are installed with SpatialWare: Georgetown database A sample database that many of the examples in the User Guide reference.

Sample data are automatically installed into the SQL Server instance specified during SpatialWare installation.

Sample Queries
Sample queries on the Georgetown database are provided to show the advantages and implementations of using SQL Server and SpatialWare for spatial data management. Sample queries are installed into SpatialWares demo/Query directory.

Documentation
SpatialWare documentation consists of the following: Installation Guide This guide provided in PDF form.

6
2007 MapInfo Corporation. All rights reserved.

SpatialWare for SQL Server 4.9.2

Chapter 1: Introduction User Guide Installed with your software and accessible by pointing your Internet browser to the index.htm page in SpatialWares doc directory. Also provided as a PDF file on the software media.

You can view online (HTML) documentation on a Windows, Macintosh, or UNIX computer running version 4 or later of Internet Explorer or Netscape, or running a current version of Mozilla or Safari. The online documentation uses JavaScript. If you encounter difficulty viewing the documentation, ensure that JavaScript is enabled in your browser.

Requirements
SpatialWare has been verified with Microsoft SQL Server 2000 (with Service Pack 4) and SQL Server 2005 on the following platforms: Windows XP Professional (Service Pack 2) Windows 2000 Professional and 2000 Server (both Service Pack 4) Windows 2003 Server Enterprise Edition

To view the online User Guide you need version 4 or later of Internet Explorer or Netscape, or a current version of Mozilla or Safari. About 70 MB of disk space is necessary to install the SpatialWare software.

Installation Structure
SpatialWare components are installed in two locations: the \Binn subdirectory of SQL Server, and the SpatialWare subdirectory under the Program Files directory of Windows (for example, C:\Program Files\SpatialWare 4.9). The latter contains the following subdirectories: bin Scripts used by SpatialWare. s9_info Message files used by SpatialWare. demo Demonstrations and samples. dB Sample Georgetown data. Query Sample queries for Georgetown data. doc Documentation. Point your Internet browser to the index.htm file in order to view the online User Guide. log SpatialWares log file.

Questions About Upgrading?

For those of you who are upgrading from a previous release of SpatialWare, this section addresses some of the questions that you may have. Do I need to re-spatialize my existing database? No. The installation wizard upgrades all attached spatial databases.
Installation Guide 2007 MapInfo Corporation. All rights reserved.

Questions About Upgrading? Do I need to spatialize any new databases that I create on my SpatialWare server? Yes. You will have to spatialize any new databases using the sp_spatialize_db procedure. Refer to the User Guide for instructions.

8
2007 MapInfo Corporation. All rights reserved.

SpatialWare for SQL Server 4.9.2

Installation

This chapter provides important installation and pre-installation instructions, and describes how to test the installation.

In this chapter:
Selecting a SQL Server Instance . . . . . . . . . . . . . . . . . . . . . . . . . .10 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Upgrading to or Reinstalling SpatialWare 4.9.2. . . . . . . . . . . . . . .12 Uninstall SpatialWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Selecting a SQL Server Instance

Selecting a SQL Server Instance

Local or Remote Installation
SpatialWare can be installed locally, if SQL Server is installed locally. It can also be installed remotely on the same network machine where SQL Server is running. For a local install you will need Local Administrator privileges. For a remote installation, you will need Operating System Administrator privileges. If you are on a workgroup network you will need Administrator rights on the domain. To configure databases and install data, you will need Database Administration privileges. A new installation of SQL Server, by default, will give you database privileges. If you are working with an existing SQL Server installation, then it is possible that the security options have been reconfigured. In this case, you may need to consult with your Database Administrator to ensure that you have database administration privileges set up for your user ID before installing the server component. The server install wizard checks for these privileges and notifies you if they are not in place. If you plan to perform a remote installation, installing across a network to the SQL Server database machine, you must first map a drive to that machine. You can do this by choosing Tools > Map Network Drive from your Windows Explorer dialog. If it is necessary for the DBA to install the server component, they should perform a local installation on the machine running SQL Server. SpatialWare can be installed on the default or any named instance of SQL Server. Note that if you install SpatialWare on more than one instance on the same server, you have to select correct installation directories for each instance of SpatialWare. In the case of SQL Server 2005 the default instance is installed by default under C:\Program Files\Microsoft SQL Server\MSSQL.1. Named instances would use a higher number (depending on the set of SQL Server components you have installed), for example, C:\Program Files\Microsoft SQL Server\MSSQL.2.

Installation
SpatialWare can be installed locally or remotely to SQL Server. If choosing a remote installation: The client machine must have SQL Server 2000 or SQL Server 2005 client installed. If the remote machine is running Windows XP or above, you must log in with system administrative privileges.

SpatialWare 4.9.2 has separate installers for SQL Server 2000 and SQL Server 2005. Use the correct installer for your version of SQL Server. To install SpatialWare, run the program setup.exe on the SpatialWare CD-ROM to install SpatialWare files. Follow the instructions provided in the dialogs. During the installation you are prompted to:

10
2007 MapInfo Corporation. All rights reserved.

SpatialWare for SQL Server 4.9.2

Chapter 2: Installation 1. Specify if this is a local or a remote installation to SQL Server. You also have the option of installing documentation only. 2. Choose the SQL Server instance. For a remote installation, if you choose "(another)" from the list of instances, you are asked to provide the instance name. 3. If a previous installation of SpatialWare is detected, then you are asked if you want to upgrade it to the current version. 4. Reboot the installation machine. It is suggested that you reboot your installation machine to have all registry settings take effect. Note: If an error occurred during installation and you did not obtain a hostname and hostid, refer to Troubleshooting on page 15. For a remote installation, you will have to run the lmhostid.exe utility to obtain the hostname and hostid. This utility can be run from the bin subdirectory where SpatialWare is installed. You should now test your installation.

Additional Steps for Installing on Windows Cluster

To install SpatialWare 4.9.2 on SQL Server 2005 deployed on Windows Cluster, you have to install SpatialWare on each node. In addition, you need to store your databases on the shared disk. Therefore, if you would like to use the Georgetown database on Windows Cluster, you have to follow these additional steps: 1. After deploying SpatialWare on each node, login to the active node and copy the Georgetown database files (georgetown_Data.MDF and georgetown_Log.LDF) to the shared disk (for example, to Q:\Microsoft SQL Server\MSSQL.1\MSSQL\Data). 2. Using SQL Server Management Studio, detach the Georgetown database that was installed by SpatialWare and attach the version of the same database you copied to the shared disk.

Testing Your Installation

Sample queries are provided to test the installation with the Georgetown database. This database installs by default with SpatialWare into the Data subdirectory where SQL Server is installed. It is made available so that you have a spatial data set to explore and experiment with. It is also referred to by the examples in the SpatialWare User Guide. To test the installation, choose georgetown from the Query Analyzers database list, and run the georgetown_demo.sql script located under SpatialWares demo/Query subdirectory. This script contains sample queries. If an error occurs, please do the following: 1. Reboot your installation machine if you have not already done so after installing. 2. Choose the georgetown database from the DB list before running the georgetown_demo.sql script. 3. Send your query and error messages to swsupport@mapinfo.com for assistance. Refer to Install Log on page 16 for the location of SpatialWare error messages.

Installation Guide 2007 MapInfo Corporation. All rights reserved.

11

Upgrading to or Reinstalling SpatialWare 4.9.2 After a successful installation, you are ready to use SpatialWare.

Post Installation Setup

Refer to the SpatialWare User Guide for information on how to get started with your SpatialWare software and for setting up your data.

Upgrading to or Reinstalling SpatialWare 4.9.2

Upgrading
To upgrade SpatialWare for SQL Server from version 4.8.7 or 4.9, to version 4.9.2, use the following steps: 1. Stop the SQL Server instance on which you are upgrading SpatialWare. 2. In the \Binn subdirectory under the SQL Server installation directory, replace the libspatialware.dll file with the newer version supplied with SpatialWare 4.9.2. 3. Restart the SQL Server instance. 4. In the \bin subdirectory under the SpatialWare installation directory, replace the file sw_spatialize_db_script with the newer version supplied with SpatialWare 4.9.2. Ensure that the newer replacement file is the correct one for your version of SQL Server (2000 or 2005). 5. Execute sp_spatialize_db on each spatial database.

Reinstalling
If the version 4.9.2 georgetown sample database is present because you are reinstalling SpatialWare, the 4.9.2 install wizard will not overwrite it. If you want the install wizard to attach the new 4.9.2 georgetown sample database, you should delete the original 4.9.2 georgetown database using Enterprise Manager (SQL Server 2000) or Management Studio (SQL Server 2005) before reinstalling 4.9.2.

Uninstall SpatialWare
To remove SpatialWare from your system, stop SQL Server, and then choose Start > Settings > Control Panel > Add/Remove Programs. Select the SpatialWare instance you want to remove. If you want to clean your database first, remove spatial data from your tables using SQL Server tools, remove indices, despatialize the table columns, and then uninstall SpatialWare.

Removing a Remote SpatialWare Installation

If you installed SpatialWare 4.9.2 on a remote machine, to remove it do the following manually:

12
2007 MapInfo Corporation. All rights reserved.

SpatialWare for SQL Server 4.9.2

Chapter 2: Installation 1. Stop SQL Server. 2. Remove the SpatialWare DLLs in the \Binn subdirectory of the SQL Server install. 3. Delete the MapInfo\SpatialWare 4.9 registry key with all its subkeys. Detach and delete the SpatialWare databases, or move them to another location.

Installation Guide 2007 MapInfo Corporation. All rights reserved.

13

Uninstall SpatialWare

14
2007 MapInfo Corporation. All rights reserved.

SpatialWare for SQL Server 4.9.2

Troubleshooting

This chapter contains troubleshooting notes.

In this chapter:
Install Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Installation Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

Install Log

Install Log
A log of the install procedure is named spwmssql.is and is located in the user's temporary directory (for example, C:\Documents and Settings\UserName\Local Settings\Temp). You can review this log if you require detailed information about the installation.

Installation Error Messages

Maximum Stored Procedure Nesting Level Exceeded
Every spatial database must have its "Recursive triggers" setting turned OFF. This can be managed through Enterprise Manager, by selecting a database and following Properties > Options > Settings. If this setting is on, you can expect some insert and update operations to fail with the message: "A cursor with the name ... already exists." Or "Maximum stored procedure nesting level exceeded..."

Incorrect Reference to Older DLL

In case of an upgrade, if SpatialWare keeps reporting an older version number when executing exec sp_spatial_query 'select hg_version() from hg_onerow', make sure that no directory listed in the PATH environment variable contains an older version of libspatialware.dll. If this happens to be the case, either rename or remove the older version of the DLL and then restart the system.

Error Message: "This string is too long."

The message, "This string is too long", may appear during installation instead of a failure message if your PATH environment variable is longer than 255 characters. To remedy the problem, you will have to reduce the length of your PATH.

Error Message: Incompatible Version of MDAC

When you are installing SpatialWare on some versions of Windows XP you may receive the following error message: "MDAC 2.8 RTM is incompatible with this version of Windows." If this occurs, click Cancel, and the installation will continue without problem.

16
2007 MapInfo Corporation. All rights reserved.

SpatialWare for SQL Server 4.9.2

Glossary

Client Machine The machine where client application programs reside. Client applications access a SpatialWare database on a server machine to read or modify data. Typically, client machines are for individual users and their applications. Client machines may access common server machines. The more powerful server machines handle intensive processing and large volume data storage. Coordinates Coordinates are a set of numbers used to define the location of any place on the surface of the earth. SpatialWare supports many different coordinate systems. MapInfo Map Catalog MapInfo clients store coordinate system information and symbology on a per-table basis in the MAPINFO_MAPCATALOG table. To determine the coordinate system that a SpatialWare table is stored in, a MapInfo client accesses the MAPINFO_MAPCATALOG table. RDBMS Relational Database Management System Server Machine The machine where server application programs reside. The SpatialWare database resides on a server machine, which can be accessed by applications from a client machine. Spatial Object Synonym for a geometry defined by the ST_Spatial string. A spatial object could be empty, or comprised of a single geometry, or a geometry collection. Spatial Table A table is considered spatializable if it has a column of type ST_Spatial, and spatial if it has been spatially enabled using the sp_sw_spatialize_ column procedure. Spatialize To spatially enable a table using the Spatialize Column procedure. This is necessary to save spatial data to a table. Note that the table must first contain a column of type ST_Spatial.

Spatially Enable A database must be spatially enabled in order for SpatialWare to use it. This involves running scripts on the database to install SpatialWare components, and create the spatial type necessary to work with SpatialWare. Spatial Database A database that is set up to hold spatial data. Spatial Data Data with information on location, position, size, and shape. SQL Structured Query Language

18
2007 MapInfo Corporation. All rights reserved.

SpatialWare for SQL Server 4.9.2

Index
C
Client machine, defined 17 Coordinate systems, defined 17 Options, installation 10 Overview 5

P
Prerequisites, installation 7 Product specifications 67

D
Database, upgrading 12 DB list 11 Definitions 1718 Documentation 67

Q
Query Analyzer 11

E
Error messages installation 16 log file 16

R
RDBMS definition 17 Remote removal 12

S
Scripts, georgetown_demo 11 Server machine 17 setup.exe 10 Spatial data, definition 18 Spatial database definition 18 Spatializing tables, definition 17 Spatially enabling databases, definition 18 SQL definition 18 Standard installation procedure 1011

G
georgetown_demo 11 Glossary 1718

H
HTML docs 67

I
Installation 9 error messages 16 prerequisites 7 remote 10 testing 11 Installation, options 10

T
Testing, installation 11 Troubleshooting 15

U
Uninstall procedure 1213 remote installation 12 Upgrading, procedure 12

K
Key Features 6

M
MAPINFO_MAPCATALOG, defined 17

O
Online docs 67