**Creating a Metadata Service**

ESRI Generic Document

> February 2004
>
> Prepared by:
>
> ESRI
>
> 380 New York Street
>
> Redlands, California 92373-8100
>
> This document contains commercial or financial information or trade
> secrets of ESRI, which are confidential and exempt from disclosure to
> the public under the Freedom of Information Act 5 USC 522(b)(4), and
> unlawful disclosure thereof is a violation of the Trade Secret Act 18
> USC 1905.

Copyright © 2004 ESRI

All rights reserved.

Printed in the United States of America.

The information contained in this document is the exclusive property of
ESRI. This work is protected under United States copyright law and other
international copyright treaties and conventions. No part of this work
may be reproduced or transmitted in any form or by any means, electronic
or mechanical, including photocopying and recording, or by any
information storage or retrieval system, except as expressly permitted
in writing by ESRI. All requests should be sent to Attention: Contracts
Manager, ESRI, 380 New York Street, Redlands, CA 92373-8100, USA.

The information contained in this document is subject to change without
notice.

**U.S. GOVERNMENT RESTRICTED/LIMITED RIGHTS**

Any software, documentation, and/or data delivered hereunder is subject
to the terms of the License Agreement. In no event shall the
U.S. Government acquire greater than RESTRICTED/LIMITED RIGHTS. At a
minimum, use, duplication, or disclosure by the U.S. Government is
subject to restrictions as set forth in FAR §52.227-14 Alternates I, II,
and III (JUN 1987); FAR §52.227-19 (JUN 1987) and/or FAR §12.211/12.212
(Commercial Technical Data/Computer Software); and DFARS §252.227-7015
(NOV 1995) (Technical Data) and/or DFARS §227.7202 (Computer Software),
as applicable. Contractor/Manufacturer is ESRI, 380 New York Street,
Redlands, CA 92373-8100, USA.

\@esri.com, 3D Analyst, ADF, AML, ARC/INFO, ArcAtlas, ArcCAD,
ArcCatalog, ArcCOGO, ArcData, ArcDoc, ArcEdit, ArcEditor, ArcEurope,
ArcExplorer, ArcExpress, ArcFM, ArcGIS, ArcGlobe, ArcGrid, ArcIMS,
ArcInfo Librarian, ArcInfo, ArcInfo---Professional GIS, ArcInfo---The
World\'s GIS, ArcLocation, ArcLogistics, ArcMap, ArcNetwork, *ArcNews,*
ArcObjects, ArcOpen, ArcPad, ArcPlot, ArcPress, ArcQuest, ArcReader,
ArcScan, ArcScene, ArcSchool, ArcSDE, ArcSdl, ArcStorm, ArcSurvey,
ArcTIN, ArcToolbox, ArcTools, ArcUSA, *ArcUser,* ArcView, ArcVoyager,
*ArcWatch,* ArcWeb, ArcWorld, Atlas GIS, AtlasWare, Avenue, BusinessMAP,
Database Integrator, DBI Kit, ESRI, ESRI---Team GIS, ESRI---The GIS
People, FormEdit, Geographic Design System, Geography Matters, Geography
Network, GIS by ESRI, GIS Day, GIS for Everyone, GISData Server,
*Insite*MAP, MapBeans, MapCafé, MapObjects, ModelBuilder, MOLE,
NetEngine, PC ARC/INFO, PC ARCPLOT, PC ARCSHELL, PC DATA CONVERSION, PC
STARTER KIT, PC TABLES, PC ARCEDIT, PC NETWORK, PC OVERLAY, Rent-a-Tech,
RouteMAP, SDE, SML, Spatial Database Engine, StreetEditor, StreetMap,
TABLES, the ARC/INFO logo, the ArcAtlas logo, the ArcCAD logo, the
ArcCAD WorkBench logo, the ArcCOGO logo, the ArcData logo, the ArcData
Online logo, the ArcEdit logo, the ArcEurope logo, the ArcExplorer logo,
the ArcExpress logo, the ArcFM logo, the ArcFM Viewer logo, the ArcGIS
logo, the ArcGrid logo, the ArcIMS logo, the ArcInfo logo, the
ArcLogistics Route logo, the ArcNetwork logo, the ArcPad logo, the
ArcPlot logo, the ArcPress for ArcView logo, the ArcPress logo, the
ArcScan logo, the ArcScene logo, the ArcSDE CAD Client logo, the ArcSDE
logo, the ArcStorm logo, the ArcTIN logo, the ArcTools logo, the ArcUSA
logo, the ArcView 3D Analyst logo, the ArcView Business Analyst logo,
the ArcView Data Publisher logo, the ArcView GIS logo, the ArcView Image
Analysis logo, the ArcView Internet Map Server logo, the ArcView logo,
the ArcView Network Analyst logo, the ArcView Spatial Analyst logo, the
ArcView StreetMap 2000 logo, the ArcView StreetMap logo, the ArcView
Tracking Analyst logo, the ArcWorld logo, the Atlas GIS logo, the Avenue
logo, the BusinessMAP logo, the Data Automation Kit logo, the Digital
Chart of the World logo, the ESRI Data logo, the ESRI globe logo, the
ESRI Press logo, the Geography Network logo, the MapCafé logo, the
MapObjects Internet Map Server logo, the MapObjects logo, the MOLE logo,
the NetEngine logo, the PC ARC/INFO logo, the Production Line Tool Set
logo, the RouteMAP IMS logo, the RouteMAP logo, the SDE logo, The
World\'s Leading Desktop GIS, *Water Writes,*
[www.esri.com](http://www.esri.com/), www.geographynetwork.com,
www.gisday.com, and Your Personal Geographic Information System are
trademarks, registered trademarks, or service marks of ESRI in the
United States, the European Community, or certain other jurisdictions.

Other companies and products mentioned herein are trademarks or
registered trademarks of their respective trademark owners.

[]{.mark}

**Table of Contents**

Section Page

[1.0 Introduction 1](#introduction)

[1.1 Purpose of the Document 1](#purpose-of-the-document)

[1.2 Intended Audience of This Document
1](#intended-audience-of-this-document)

[1.3 Document Overview 2](#document-overview)

[1.4 Referenced Documents 2](#referenced-documents)

[1.5 Acronyms 2](#acronyms)

[2.0 Getting Started 1](#getting-started)

[2.1 Configuration Overview 1](#configuration-overview)

[2.2 Configuration Prerequisites 1](#configuration-prerequisites)

[3.0 Configuration Tasks 1](#configuration-tasks)

[3.1 Turning On Authentication Java Connector (for Metadata Explorer)
1](#turning-on-authentication-java-connector-for-metadata-explorer)

[Step 3 1](#step-3)

[3.2 Turning On Authentication Servlet Connector (for ArcCatalog)
1](#turning-on-authentication-servlet-connector-for-arccatalog)

[3.3 Create Usernames and Passwords to Access the Metadata Service
2](#create-usernames-and-passwords-to-access-the-metadata-service)

[3.4 Configure IIS for Authentication (If using Microsoft Windows 2000
or XP and Internet Information Server (IIS)
3](#configure-iis-for-authentication-if-using-microsoft-windows-2000-or-xp-and-internet-information-server)

[3.5 Create a new database and user in Oracle 8i/9i
4](#create-a-new-database-and-user-in-oracle8i9i)

[3.6 Edit the MetadataServer.axl file
5](#edit-the-metadataserver.axl-file)

[Step 2 6](#__RefHeading___Toc63480468)

[Step 3 6](#__RefHeading___Toc63480469)

[Step 4 6](#__RefHeading___Toc63480470)

[3.7 Starting a Metadata Service 7](#starting-a-metadata-service)

[3.8 Publish Metadata using ArcCatalog
7](#publish-metadata-using-arccatalog)

[3.9 Register your metadata service 8](#register-your-metadata-service)

[3.10 Updating your metadata 8](#updating-your-metadata)

[3.11 Further Steps 9](#further-steps)

[Appendix A---ArcIMS 4.01 System Requirements
1](#appendix-aarcims-4.0.1-system-requirements)

[Appendix B---ArcSDE 8.3 For Oracle System Requirements
1](#appendix-barcsde-8.3-for-oracle-system-requirements)

# 1.0 Introduction

Metadata for geographic data is often referred to as data about data. A
metadata service provides a forum for sharing metadata. If you do not
have data but need some, you might search, or browse, a metadata service
to find what you need. Similarly, if you have data that you want to
share with others, you can share, or publish, it to a Metadata Service
where others can see it.

## 1.1 Purpose of the Document

The purpose of this document is to describe how a user can configure an
ArcIMS 4.0.1 Metadata Service with ArcSDE 8.3 for SQL Server 2000 within
both Windows and UNIX environments. Step-by-step tasks illustrate how to

-   Turn on authentication for the Servlet Connector (for ArcCatalog) or
    Java Connector (for Metadata Explorer)

-   Turn on Authentication Servlet Connector (for ArcCatalog)

-   Create usernames and passwords to access the Metadata Service

-   Configure Internet Information Server (IIS) for authentication if
    using with Microsoft Windows 2000 or XP

-   Create a new database and user in Oracle8*i*/9*i*

-   Edit the MetadataServer.axl file

-   Start a Metadata Service

-   Publish Metadata using ArcCatalog

-   Register your Metadata Service

-   Update Metadata using ArcCatalog

## 1.2 Intended Audience of This Document

The intended audience of this document is the ArcIMS administrator and
ArcSDE database administrator.

## 1.3 Document Overview

This document contains the following sections:

-   **Section 1.0---Introduction:** Outlines the purpose of the
    document, intended audience and reference documents.

-   **Section 2.0---Getting Started:** Review expected configuration
    tasks and setup prerequisites.

-   **Section 3.0---Configuration Tasks:** Details in a step-by-step
    style the configuration tasks required when creating a Metadata
    Service.

## 1.4 Referenced Documents

-   ArcIMS 4.0.1 Installation Guide

-   ArcIMS 4.0.1 Creating and Using Metadata Services

## 1.5 Acronyms

+---------+------------------------------------------------------------+
| ACL     | Access Control List                                        |
|         |                                                            |
| CD      | Compact Disc                                               |
+---------+------------------------------------------------------------+
| COTS    | Commercial Off-the-Shelf                                   |
+---------+------------------------------------------------------------+
| CPU     | Central Processing Unit                                    |
+---------+------------------------------------------------------------+
| DSN     | Data Source Name                                           |
+---------+------------------------------------------------------------+
| ESRI    | Environmental Systems Research Institute, Inc.             |
+---------+------------------------------------------------------------+
| GB      | Gigabyte(s)                                                |
+---------+------------------------------------------------------------+
| GHz     | Gigahertz                                                  |
+---------+------------------------------------------------------------+
| GUI     | Graphic User Interface                                     |
+---------+------------------------------------------------------------+
| HTML    | Hypertext Markup Language                                  |
+---------+------------------------------------------------------------+
| IIS     | Internet Information Service                               |
+---------+------------------------------------------------------------+
| IMS     | Internet Map Service                                       |
+---------+------------------------------------------------------------+
| JRE     | Java Runtime Engine                                        |
+---------+------------------------------------------------------------+
| MB      | Megabyte(s)                                                |
+---------+------------------------------------------------------------+
| MDAC    | Microsoft Data Access Components                           |
+---------+------------------------------------------------------------+
| NTFS    | ##### New Technology File System                           |
+---------+------------------------------------------------------------+
| PDF     | Portable Document Format                                   |
+---------+------------------------------------------------------------+
| RAM     | Random Access Memory                                       |
+---------+------------------------------------------------------------+
| SDE     | Spatial Database Engine                                    |
+---------+------------------------------------------------------------+

# 2.0 Getting Started

## 2.1 Configuration Overview

Having installed ArcIMS 4.0.1, ArcSDE 8.3 and Oracle8*i*/9*i* the main
steps to configure a Metadata Service are:

-   Turn on authentication for the Java Connector (for Metadata
    Explorer).

    **Note:** The instructions illustrate how to modify the Access
    Control List (ACL) file. For additional information please refer to
    the ArcIMS Help (installed with ArcIMS)

-   Turn on Authentication Servlet Connector (for ArcCatalog)

-   Create usernames and passwords to access the Metadata Service

-   Configure Internet Information Server for authentication if using
    with Microsoft Windows 2000 or XP

-   Create a new database and user in Oracle8*i*/9*i*

-   Edit the MetadataServer.axl file

-   Start a Metadata Service

-   Register your Metadata Service

-   Update Metadata using ArcCatalog

## 2.2 Configuration Prerequisites

In order to complete the tasks detailed in the document it is assumed
that the following software has been installed and configured:

-   ArcGIS 8.3

-   ArcIMS 4.0.1---Metadata Explorer (Z39.50 Connector---optional)

-   Application Servlet Connection:

```{=html}
<!-- -->
```
-   ActiveX

-   ColdFusion

-   Java

-   Servlet Connector

```{=html}
<!-- -->
```
-   Web Server

```{=html}
<!-- -->
```
-   Apache 4.0 or higher

-   IIS 5.0 or higher

-   Sun ONE 6.0

-   Other

```{=html}
<!-- -->
```
-   Servlet Engine

```{=html}
<!-- -->
```
-   Tomcat

-   Servlet Exec 4.1.1

-   Other

```{=html}
<!-- -->
```
-   Oracle8*i* or Oracle9*i*

# 3.0 Configuration Tasks

## 3.1 Turning On Authentication Java Connector (for Metadata Explorer)

+-------+--------------------------------------------------------------+
| *     | Locate the Authenticate.properties file.                     |
| *Step |                                                              |
| 1**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | Its default location is:                                     |
|       |                                                              |
|       | -   **Windows:** \<ArcIMS installation                       |
|       |     directory\>ArcIMS\\Connectors\\Java_Connector            |
|       |                                                              |
|       | -   **UNIX:** \<ArcIMS installation directory\>              |
|       |     ArcIMS\\Connectors\\Java_Connector                       |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | This file has to be in the classpath of your JSP/ Java       |
|       | application.                                                 |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | Edit the authenticate.properties file in a text editor.      |
| *Step |                                                              |
| 2**   |                                                              |
+-------+--------------------------------------------------------------+
|       | (**Note:** If you set the properties for both XML file-based |
|       | and JDBC-based ACL, the JDBC settings will be used.)         |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| ### S | Enable authentication within the Java Connector              |
| tep 3 |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | Authenticate=True                                            |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | Set the pathname to the Access Control List. Slashes in the  |
| *Step | pathname must be forward slashes(/).                         |
| 4**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | aclFileName=\<full pathname to the ACL file\>/aimsacl.xml    |
+-------+--------------------------------------------------------------+
|       | (e.g.,                                                       |
|       | aclFileName=c:/arcims/connectors/Java_Connector/aimsacl.xml) |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | Typically you\'ll place the ACL file in the same location as |
|       | the Authenticate.properties file. See Section 3.3 for        |
|       | details on how to create the ACL file.                       |
+-------+--------------------------------------------------------------+

## 3.2 Turning On Authentication Servlet Connector (for ArcCatalog)

  -------- ---------------------------------------------------------------------
  **Step   Locate the Esrimap.prop file installed with your servlet engine and
  1**      with a text editor.

           

           **Note:** ArcIMS installs a backup copy of all the files that
           comprise the Servlet Connector in the ArcIMS installation directory.
           Do not edit the Esrimap_prop file at this location because it will
           have no impact on the operation of the Servlet Connector.

           

  **Step   Enable authentication.
  2**      

           Authenticate=True

           

  **Step   Set the authentication method.
  3**      

           AuthMethod=Digest

           

  **Step   Set the pathname to the Access Control List. Slashes in the pathname
  4**      must be forward slashes(/).

           

           aclFileName=\<full pathname to the ACL file\>/aimsacl.xml

           (e.g., aclFileName=c:/arcims/connectors/Java_Connector/aimsacl.xml)

           

           Typically you\'ll place the ACL file in the same location as the
           Authenticate.properties file. See Section 3.3 for details on how to
           create the ACL file.
  -------- ---------------------------------------------------------------------

## 3.3 Create Usernames and Passwords to Access the Metadata Service

+-------+--------------------------------------------------------------+
| *     | Create an Access Control List with a text editor. Name the   |
| *Step | file aimsacl.xml. Save the file to the same directory as the |
| 1**   | Authenticate.properties file.                                |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | This file identifies which users will have access to which   |
|       | services. Things to keep in mind:                            |
|       |                                                              |
|       | -   Make sure that you name the file and store it on disk as |
|       |     you specified with aclFileName property in the           |
|       |     Authenticate.properties file.                            |
|       |                                                              |
|       | -   Usernames and passwords are case sensitive.              |
|       |                                                              |
|       | -   Service names specified in the ACL file are case         |
|       |     sensitive and should match the case of the names in the  |
|       |     ArcIMS Administrator.                                    |
|       |                                                              |
|       | -   Only those services listed in the ACL file will be       |
|       |     available to a client, even if you have other services   |
|       |     running in ArcIMS Administrator.                         |
+-------+--------------------------------------------------------------+
| *     | Define username and password pairs that provide access to    |
| *Step | your ArcIMS services.                                        |
| 2**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | List the services that can be accessed by the username and   |
| *Step | specify the role.                                            |
| 3**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | The sample ACL file below illustrates a typical Metadata     |
|       | Service configuration. The Metadata Service is called        |
|       | MyMeta. The sample contains one restricted map service and   |
|       | two non-restricted map service:                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | \<?xml version=\"1.0\"?\>                                    |
|       |                                                              |
|       | \<AIMSACL\>                                                  |
|       |                                                              |
|       | \<USER name=\"\*\" services=\"SanFrancisco, World\" /\>      |
|       |                                                              |
|       | \<USER name=\"private\" password=\"pass.word\"               |
|       | services=\"SecretData\" /\>                                  |
|       |                                                              |
|       | USER name=\"mypublic \" password=\"mypublic\"                |
|       | services=\"mymeta\" roles=\"metadata_browser\" active=\"1\"  |
|       | /\>                                                          |
|       |                                                              |
|       | \<USER name=\"mypublish\" password=\"mypublish\"             |
|       | services=\"mymeta\" roles=\"metadata_publisher\"             |
|       | active=\"1\" /\>                                             |
|       |                                                              |
|       | \<USER name=\"myauthor\" password=\"myauthor\"               |
|       | services=\"mymeta\" roles=\"metadata_service_author\"        |
|       | active=\"1\" /\>                                             |
|       |                                                              |
|       | \<USER name=\"myadmin\" password=\"myadmin\"                 |
|       | services=\"mymeta\" roles=\"metadata_administrator\"         |
|       | active=\"1\" /\> \</AIMSACL\>                                |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | Access to a Metadata Service is defined by the roles         |
|       | parameter in the ACL. The following roles are available for  |
|       | Metadata Services:                                           |
+-------+--------------------------------------------------------------+
|       | -   *metadata_browser*---Enables browsing of all public      |
|       |     metadata documents of a Metadata Service (default if not |
|       |     specified)                                               |
|       |                                                              |
|       | -   *metadata_browser_all*---Enables browsing of all public  |
|       |     and any private documents published to the Metadata      |
|       |     Service                                                  |
|       |                                                              |
|       | -   *metadata_publisher*---Enables publishing to the service |
|       |                                                              |
|       | -   *metadata_service_author*---Enables creating metadata    |
|       |     for services. You apply this parameter to those Feature, |
|       |     Image, and Metadata Services that you want to create     |
|       |     metadata for. You may then subsequently publish this     |
|       |     metadata to a Metadata Service.                          |
|       |                                                              |
|       | -   *metadata_administrator*---Enables administration of     |
|       |     database (i.e., ability to reset the metadata tables in  |
|       |     the database).                                           |
+-------+--------------------------------------------------------------+

## 3.4 Configure IIS for Authentication (If Using Microsoft Windows 2000 or XP and Internet Information Server

  -------- --------------------------------------------------------------
  **Step   On the taskbar, click Start \| Settings \| Control Panel \|
  1**      Administrative Tools \| Internet Services Manager.

           

  **Step   In the left panel, double-click the machine name to expand the
  2**      tree.

           

  **Step   Double-click Default Web Site.
  3**      

           

  **Step   If you\'re running ServletExec or JRun as your servlet engine,
  4**      double-click Scripts.

           

           If you\'re running Tomcat, double-click Jakarta.

           

  **Step   In the right panel, right-click ServletExec_ISAPI.dll,
  5**      jrun.dll or isapi_redirect.dll (for ServletExec, JRun, and
           Tomcat respectively). Right-click and select Properties.

           

  **Step   Click the File Security tab.
  6**      

           

  **Step   Click Edit for Anonymous access and authentication control.
  7**      

           

  **Step   Uncheck both Integrated Windows authentication and DIGEST
  8**      authentication. Click OK.

           

           **Note:** XP users may find DIGEST authentication turned on,
           but grayed out and unable to be deactivated. In this case, the
           steps for configuring IIS and XP for authentication are
           available on the ESRI Online Support Center. A direct link to
           the Knowledge Base article was not available at time of
           release.

           

  **Step   Stop and start the servlet engine. If the servlet engine is
  9**      native to the Web server, stop and start the Web server.
           Stopping and restarting the servlet engine (or Web server)
           allows your edits to the Authenticate.properties file to take
           effect---enabling authentication.
  -------- --------------------------------------------------------------

## 3.5 Create a New Database and User in Oracle8*i*/9*i*

In the following example, a new database called mymeta and a new user
called metakeeper will be created using SQL Plus. Alternatively, you
could use Oracle8*i*/9*i* Database Configuration Assistant.

+-------+--------------------------------------------------------------+
| *     | Open SQL Plus. Login as the system dba                       |
| *Step |                                                              |
| 1**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | Create a new tablespace called mymeta                        |
| *Step |                                                              |
| 2**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | CREATE TABLESPACE \"MYMETA\"                                 |
|       |                                                              |
|       | > LOGGING                                                    |
|       | >                                                            |
|       | > DATAFILE \'D:\\ORAHOME1\\ORADATA\\ORA8ICAR\\MYMETA.ora\'   |
|       | > SIZE 1000M                                                 |
|       | >                                                            |
|       | > EXTENT MANAGEMENT LOCAL                                    |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | Create a new user call metakeeper                            |
| *Step |                                                              |
| 3**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | CREATE USER \"METAKEEPER\" PROFILE \"DEFAULT\" IDENTIFIED    |
|       | BY\"                                                         |
|       |                                                              |
|       | > DEFAULT                                                    |
|       | >                                                            |
|       | > TABLESPACE \"USERS\" TEMPORARY                             |
|       | >                                                            |
|       | > TABLESPACE \"TEMP\" ACCOUNT UNLOCK;                        |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+

## 3.6 Edit the MetadataServer.axl File

+-------+--------------------------------------------------------------+
| *     | In a text editor, edit the MetadataServer.axl file in the    |
| *Step | AXL directory created during installation.                   |
| 1**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | For example, on Windows this file is located by default at   |
|       | c:\\ArcIMS\\AXL\\Metadata                                    |
+-------+--------------------------------------------------------------+
| []{#_ | Overwrite the existing contents by copying and pasting the   |
| _RefH | following:                                                   |
| eadin |                                                              |
| g___T |                                                              |
| oc634 |                                                              |
| 80468 |                                                              |
| .anc  |                                                              |
| hor}* |                                                              |
| *Step |                                                              |
| 2**   |                                                              |
+-------+--------------------------------------------------------------+
| \     |                                                              |
| <?xml |                                                              |
| versi |                                                              |
| on=\" |                                                              |
| 1.0\" |                                                              |
| e     |                                                              |
| ncodi |                                                              |
| ng=\" |                                                              |
| UTF-8 |                                                              |
| \"?\> |                                                              |
|       |                                                              |
| \<A   |                                                              |
| RCXML |                                                              |
| ve    |                                                              |
| rsion |                                                              |
| =\"1. |                                                              |
| 1\"\> |                                                              |
|       |                                                              |
| \<CON |                                                              |
| FIG\> |                                                              |
|       |                                                              |
| \<ENV |                                                              |
| IRONM |                                                              |
| ENT\> |                                                              |
|       |                                                              |
| \<L   |                                                              |
| OCALE |                                                              |
| coun  |                                                              |
| try=\ |                                                              |
| "US\" |                                                              |
| langu |                                                              |
| age=\ |                                                              |
| "en\" |                                                              |
| va    |                                                              |
| riant |                                                              |
| =\"\" |                                                              |
| /\>   |                                                              |
|       |                                                              |
| \<U   |                                                              |
| IFONT |                                                              |
| color |                                                              |
| =\"0, |                                                              |
| 0,0\" |                                                              |
| name  |                                                              |
| =\"Ar |                                                              |
| ial\" |                                                              |
| s     |                                                              |
| ize=\ |                                                              |
| "12\" |                                                              |
| st    |                                                              |
| yle=\ |                                                              |
| "regu |                                                              |
| lar\" |                                                              |
| /\>   |                                                              |
|       |                                                              |
| \     |                                                              |
| </ENV |                                                              |
| IRONM |                                                              |
| ENT\> |                                                              |
|       |                                                              |
| \<ME  |                                                              |
| TADAT |                                                              |
| A_CON |                                                              |
| FIG\> |                                                              |
|       |                                                              |
| \     |                                                              |
| <!\-- |                                                              |
| R     |                                                              |
| emove |                                                              |
| the   |                                                              |
| com   |                                                              |
| ments |                                                              |
| a     |                                                              |
| round |                                                              |
| the   |                                                              |
| A     |                                                              |
| DMIN_ |                                                              |
| TABLE |                                                              |
| tag   |                                                              |
| if    |                                                              |
| you   |                                                              |
| have  |                                                              |
| an    |                                                              |
| Admin |                                                              |
| t     |                                                              |
| able. |                                                              |
| H     |                                                              |
| aving |                                                              |
| an    |                                                              |
| Admin |                                                              |
| table |                                                              |
| is    |                                                              |
| opti  |                                                              |
| onal. |                                                              |
| \--\> |                                                              |
|       |                                                              |
| \     |                                                              |
| <!\-- |                                                              |
|       |                                                              |
| \<A   |                                                              |
| DMIN_ |                                                              |
| TABLE |                                                              |
| tabl  |                                                              |
| ename |                                                              |
| =\"ME |                                                              |
| TA_AD |                                                              |
| MIN\" |                                                              |
| idcol |                                                              |
| umn=\ |                                                              |
| "DocU |                                                              |
| UID\" |                                                              |
| filte |                                                              |
| r=\"A |                                                              |
| pprov |                                                              |
| ed=\' |                                                              |
| Y\'\" |                                                              |
| inser |                                                              |
| t=\"I |                                                              |
| NSERT |                                                              |
| INTO  |                                                              |
| Admin |                                                              |
| Table |                                                              |
| (Doc  |                                                              |
| UUID, |                                                              |
| Appr  |                                                              |
| oved) |                                                              |
| V     |                                                              |
| ALUES |                                                              |
| (\'   |                                                              |
| %s\', |                                                              |
| \'N\' |                                                              |
| )\"\> |                                                              |
|       |                                                              |
| \<    |                                                              |
| RESPO |                                                              |
| NSE_C |                                                              |
| OLUMN |                                                              |
| col   |                                                              |
| umnna |                                                              |
| me=\" |                                                              |
| Appro |                                                              |
| ved\" |                                                              |
| /\>   |                                                              |
|       |                                                              |
| \     |                                                              |
| </ADM |                                                              |
| IN_TA |                                                              |
| BLE\> |                                                              |
|       |                                                              |
| \--\> |                                                              |
|       |                                                              |
| \     |                                                              |
| <!\-- |                                                              |
| Edit  |                                                              |
| SD    |                                                              |
| EWORK |                                                              |
| SPACE |                                                              |
| to    |                                                              |
| point |                                                              |
| to    |                                                              |
| the   |                                                              |
| SDE   |                                                              |
| Se    |                                                              |
| rver. |                                                              |
|       |                                                              |
| n     |                                                              |
| ame - |                                                              |
| can   |                                                              |
| be    |                                                              |
| any   |                                                              |
| name  |                                                              |
| that  |                                                              |
| uni   |                                                              |
| quely |                                                              |
| ident |                                                              |
| ifies |                                                              |
| the   |                                                              |
| s     |                                                              |
| erver |                                                              |
| to    |                                                              |
| Ar    |                                                              |
| cIMS. |                                                              |
|       |                                                              |
| ser   |                                                              |
| ver - |                                                              |
| the   |                                                              |
| name  |                                                              |
| of    |                                                              |
| the   |                                                              |
| s     |                                                              |
| erver |                                                              |
| ma    |                                                              |
| chine |                                                              |
| that  |                                                              |
| hosts |                                                              |
| Ar    |                                                              |
| cSDE. |                                                              |
|       |                                                              |
| insta |                                                              |
| nce - |                                                              |
| the   |                                                              |
| port  |                                                              |
| n     |                                                              |
| umber |                                                              |
| for   |                                                              |
| the   |                                                              |
| A     |                                                              |
| rcSDE |                                                              |
| inst  |                                                              |
| ance. |                                                              |
|       |                                                              |
| datab |                                                              |
| ase - |                                                              |
| A     |                                                              |
| rcSDE |                                                              |
| dat   |                                                              |
| abase |                                                              |
| name. |                                                              |
| Sp    |                                                              |
| ecify |                                                              |
| the   |                                                              |
| name  |                                                              |
| or    |                                                              |
| \"\"  |                                                              |
| if    |                                                              |
| not   |                                                              |
| ne    |                                                              |
| eded. |                                                              |
|       |                                                              |
| u     |                                                              |
| ser - |                                                              |
| the   |                                                              |
| dat   |                                                              |
| abase |                                                              |
| user  |                                                              |
| name. |                                                              |
|       |                                                              |
| passw |                                                              |
| ord - |                                                              |
| the   |                                                              |
| pas   |                                                              |
| sword |                                                              |
| for   |                                                              |
| the   |                                                              |
| user  |                                                              |
| name. |                                                              |
| \--\> |                                                              |
|       |                                                              |
| \<WO  |                                                              |
| RKSPA |                                                              |
| CES\> |                                                              |
|       |                                                              |
| \<SD  |                                                              |
| EWORK |                                                              |
| SPACE |                                                              |
| na    |                                                              |
| me=\" |                                                              |
| sde_w |                                                              |
| s-mym |                                                              |
| eta\" |                                                              |
| se    |                                                              |
| rver= |                                                              |
| \"a\" |                                                              |
| in    |                                                              |
| stanc |                                                              |
| e=\"p |                                                              |
| ort:5 |                                                              |
| 152\" |                                                              |
| data  |                                                              |
| base= |                                                              |
| \"mym |                                                              |
| eta\" |                                                              |
| user  |                                                              |
| =\"me |                                                              |
| takee |                                                              |
| per\" |                                                              |
| pas   |                                                              |
| sword |                                                              |
| =\"me |                                                              |
| takee |                                                              |
| per\" |                                                              |
| /\>   |                                                              |
|       |                                                              |
| \</WO |                                                              |
| RKSPA |                                                              |
| CES\> |                                                              |
|       |                                                              |
| \     |                                                              |
| <!\-- |                                                              |
| Edit  |                                                              |
| the   |                                                              |
| foll  |                                                              |
| owing |                                                              |
| M     |                                                              |
| ETADA |                                                              |
| TA_CO |                                                              |
| NTENT |                                                              |
| attri |                                                              |
| butes |                                                              |
| to    |                                                              |
| co    |                                                              |
| ntrol |                                                              |
| how   |                                                              |
| the   |                                                              |
| se    |                                                              |
| rvice |                                                              |
| w     |                                                              |
| orks. |                                                              |
|       |                                                              |
| valid |                                                              |
| ate - |                                                              |
| true  |                                                              |
| or    |                                                              |
| f     |                                                              |
| alse. |                                                              |
| When  |                                                              |
| true, |                                                              |
| the   |                                                              |
| se    |                                                              |
| rvice |                                                              |
| ver   |                                                              |
| ifies |                                                              |
| that  |                                                              |
| co    |                                                              |
| ntent |                                                              |
| req   |                                                              |
| uired |                                                              |
|       |                                                              |
| by    |                                                              |
| Met   |                                                              |
| adata |                                                              |
| Exp   |                                                              |
| lorer |                                                              |
| is    |                                                              |
| pre   |                                                              |
| sent. |                                                              |
|       |                                                              |
| ind   |                                                              |
| ex_wo |                                                              |
| rds - |                                                              |
| auto  |                                                              |
| matic |                                                              |
| or    |                                                              |
| ma    |                                                              |
| nual. |                                                              |
| When  |                                                              |
| autom |                                                              |
| atic, |                                                              |
| all   |                                                              |
| docu  |                                                              |
| ments |                                                              |
| are   |                                                              |
| in    |                                                              |
| dexed |                                                              |
| when  |                                                              |
|       |                                                              |
| publi |                                                              |
| shed. |                                                              |
| Se    |                                                              |
| tting |                                                              |
| to    |                                                              |
| m     |                                                              |
| anual |                                                              |
| means |                                                              |
| you   |                                                              |
| will  |                                                              |
| run   |                                                              |
| the   |                                                              |
| of    |                                                              |
| fline |                                                              |
| ind   |                                                              |
| exer. |                                                              |
|       |                                                              |
| minwo |                                                              |
| rdlen |                                                              |
| gth - |                                                              |
| Sets  |                                                              |
| the   |                                                              |
| mi    |                                                              |
| nimum |                                                              |
| word  |                                                              |
| l     |                                                              |
| ength |                                                              |
| for   |                                                              |
| inde  |                                                              |
| xing. |                                                              |
| V     |                                                              |
| alues |                                                              |
| can   |                                                              |
| be 1  |                                                              |
| or    |                                                              |
|       |                                                              |
| gre   |                                                              |
| ater, |                                                              |
| but   |                                                              |
| will  |                                                              |
| typi  |                                                              |
| cally |                                                              |
| be    |                                                              |
| less  |                                                              |
| than  |                                                              |
| 4.    |                                                              |
| Any   |                                                              |
| word  |                                                              |
| with  |                                                              |
| le    |                                                              |
| ngths |                                                              |
| sm    |                                                              |
| aller |                                                              |
|       |                                                              |
| than  |                                                              |
| this  |                                                              |
| value |                                                              |
| will  |                                                              |
| not   |                                                              |
| be    |                                                              |
| ind   |                                                              |
| exed. |                                                              |
| For   |                                                              |
| exa   |                                                              |
| mple, |                                                              |
| with  |                                                              |
| the   |                                                              |
| de    |                                                              |
| fault |                                                              |
| mi    |                                                              |
| nimum |                                                              |
|       |                                                              |
| word  |                                                              |
| l     |                                                              |
| ength |                                                              |
| of 3, |                                                              |
| words |                                                              |
| of    |                                                              |
| one   |                                                              |
| or    |                                                              |
| two   |                                                              |
| chara |                                                              |
| cters |                                                              |
| will  |                                                              |
| not   |                                                              |
| be    |                                                              |
| ind   |                                                              |
| exed. |                                                              |
|       |                                                              |
| index |                                                              |
| _numb |                                                              |
| ers - |                                                              |
| true  |                                                              |
| or    |                                                              |
| f     |                                                              |
| alse. |                                                              |
| When  |                                                              |
| true, |                                                              |
| all   |                                                              |
| nu    |                                                              |
| mbers |                                                              |
| are   |                                                              |
| in    |                                                              |
| dexed |                                                              |
| and   |                                                              |
| s     |                                                              |
| earch |                                                              |
| able. |                                                              |
| Se    |                                                              |
| tting |                                                              |
|       |                                                              |
| this  |                                                              |
| para  |                                                              |
| meter |                                                              |
| to    |                                                              |
| true  |                                                              |
| can   |                                                              |
| gr    |                                                              |
| eatly |                                                              |
| inc   |                                                              |
| rease |                                                              |
| your  |                                                              |
| dat   |                                                              |
| abase |                                                              |
| size  |                                                              |
| be    |                                                              |
| cause |                                                              |
| every |                                                              |
| u     |                                                              |
| nique |                                                              |
| n     |                                                              |
| umber |                                                              |
|       |                                                              |
| in a  |                                                              |
| doc   |                                                              |
| ument |                                                              |
| is    |                                                              |
| ind   |                                                              |
| exed. |                                                              |
| In    |                                                              |
| gen   |                                                              |
| eral, |                                                              |
| you   |                                                              |
| pro   |                                                              |
| bably |                                                              |
| want  |                                                              |
| to    |                                                              |
| leave |                                                              |
| this  |                                                              |
| as    |                                                              |
| false |                                                              |
| u     |                                                              |
| nless |                                                              |
| there |                                                              |
|       |                                                              |
| is    |                                                              |
| some  |                                                              |
| need  |                                                              |
| you   |                                                              |
| need  |                                                              |
| to be |                                                              |
| able  |                                                              |
| to    |                                                              |
| s     |                                                              |
| earch |                                                              |
| on    |                                                              |
| num   |                                                              |
| bers. |                                                              |
| \--\> |                                                              |
|       |                                                              |
| \<M   |                                                              |
| ETADA |                                                              |
| TA_CO |                                                              |
| NTENT |                                                              |
| val   |                                                              |
| idate |                                                              |
| =\"fa |                                                              |
| lse\" |                                                              |
| index |                                                              |
| _word |                                                              |
| s=\"a |                                                              |
| utoma |                                                              |
| tic\" |                                                              |
| minw  |                                                              |
| ordle |                                                              |
| ngth= |                                                              |
| \"3\" |                                                              |
| ind   |                                                              |
| ex_nu |                                                              |
| mbers |                                                              |
| =\"fa |                                                              |
| lse\" |                                                              |
| /\>   |                                                              |
|       |                                                              |
| \     |                                                              |
| <!\-- |                                                              |
| Ten   |                                                              |
| RDBMS |                                                              |
| t     |                                                              |
| ables |                                                              |
| are   |                                                              |
| cr    |                                                              |
| eated |                                                              |
| to    |                                                              |
| store |                                                              |
| Meta  |                                                              |
| data. |                                                              |
| TABLE |                                                              |
| _NAME |                                                              |
| a     |                                                              |
| llows |                                                              |
| you   |                                                              |
| to    |                                                              |
|       |                                                              |
| sp    |                                                              |
| ecify |                                                              |
| a     |                                                              |
| table |                                                              |
| name  |                                                              |
| p     |                                                              |
| refix |                                                              |
| for   |                                                              |
| these |                                                              |
| ta    |                                                              |
| bles. |                                                              |
| This  |                                                              |
| name  |                                                              |
| s     |                                                              |
| hould |                                                              |
| uni   |                                                              |
| quely |                                                              |
| ide   |                                                              |
| ntify |                                                              |
|       |                                                              |
| the   |                                                              |
| Met   |                                                              |
| adata |                                                              |
| ta    |                                                              |
| bles. |                                                              |
| \--\> |                                                              |
|       |                                                              |
| \<    |                                                              |
| TABLE |                                                              |
| _NAME |                                                              |
| pref  |                                                              |
| ix=\" |                                                              |
| MYMET |                                                              |
| A\_\" |                                                              |
| /\>   |                                                              |
|       |                                                              |
| \</ME |                                                              |
| TADAT |                                                              |
| A_CON |                                                              |
| FIG\> |                                                              |
|       |                                                              |
| \     |                                                              |
| </CON |                                                              |
| FIG\> |                                                              |
|       |                                                              |
| \     |                                                              |
| </ARC |                                                              |
| XML\> |                                                              |
+-------+--------------------------------------------------------------+
| []{#_ | Edit the SDEWORKSPACE element and type in the appropriate    |
| _RefH | information to connect to your ArcSDE database               |
| eadin |                                                              |
| g___T |                                                              |
| oc634 |                                                              |
| 80469 |                                                              |
| .anc  |                                                              |
| hor}* |                                                              |
| *Step |                                                              |
| 3**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| []{#_ | Edit the TABLE_NAME prefix and specify the unique name that  |
| _RefH | you plan to use for your metadata tables. The default value  |
| eadin | is IMSMetadata. This name should not contain spaces or be    |
| g___T | more than 14 characters.                                     |
| oc634 |                                                              |
| 80470 |                                                              |
| .anc  |                                                              |
| hor}* |                                                              |
| *Step |                                                              |
| 4**   |                                                              |
+-------+--------------------------------------------------------------+

## 3.7 Starting a Metadata Service

In this step, you will start the new metadata service using ArcIMS 4.0.1
Administrator:

  -------- --------------------------------------------------------------
  **Step   Start the ArcIMS 4.0.1 Administrator.
  1**      

           

  **Step   Click Services in the left panel to display the currently
  2**      running services.

           

  **Step   Click the New Service button.
  3**      

           

  **Step   Type in the name for your Metadata Service---mymeta.
  4**      

           

           This is the name people will see when they access your
           Metadata Service.

           

  **Step   Locate the configuration file you
  5**      created---MetadataServer.axl.

           

  **Step   Click the Virtual Server dropdown arrow and click
  6**      MetadataServer1.

           

  **Step   Type the directory location where the ArcIMS will store the
  7**      output XML files returned when a user searches or browses your
           Metadata Service.

           

  **Step   Type the HTTP Location of the ArcIMS output specified in
  8**      Step 7.

           

  **Step   Click OK.
  9**      

           

  **Step   Save the configuration and exit from ArcIMS 4.0 1
  10**     Administrator.
  -------- --------------------------------------------------------------

After the service is created, if you review the mymeta tablespace:

SELECT TABLE_NAME FROM USER_TABLES

You will see ten new tables created in mymeta tablespace with table name
prefix MYMETA.

## 3.8 Publish Metadata Using ArcCatalog

Now you are ready to publish your metadata using ArcCatalog! Before
publishing metadata make sure to enter all the minimum \"required\" data
as explained in the ArcIMS 4.01 Creating and Using Metadata Services
document installed with ArcIMS.

+-------+--------------------------------------------------------------+
| *     | Start ArcCatalog.                                            |
| *Step |                                                              |
| 1**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
|       | During the following steps you will add an Internet server   |
|       | to ArcCatalog.                                               |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | Go into the ArcCatalog Internet Servers folder and           |
| *Step | double-click Add Internet Server.                            |
| 2**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | In the dialog that appears, type in the URL of the Internet  |
| *Step | server to which you want to connect.                         |
| 3**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | If you will be accessing secure services on this server,     |
| *Step | check \'Show secure services\' and type the username and     |
| 4**   | password for the services.                                   |
|       |                                                              |
|       | **Note:** you must use the username for the metadata publish |
|       | role specified in the ACL file.                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | If you only want to access particular services on this       |
| *Step | server, click \'Get List\'. A list of all services, which    |
| 5**   | are available on the server, appears. Check the services you |
|       | want to be able to access from this server---mymeta.         |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | Click OK                                                     |
| *Step |                                                              |
| 6**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | Expand the \'mymeta\' folder.                                |
| *Step |                                                              |
| 7**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+
| *     | Drag and drop your metadata (in XML) from its source to      |
| *Step | \'mymeta\'.                                                  |
| 8**   |                                                              |
+-------+--------------------------------------------------------------+
|       |                                                              |
+-------+--------------------------------------------------------------+

## 3.9 Register Your Metadata Service

The last step is to register you metadata service in GOS. Once your site
is registered, GOS will harvest metadata from your metadata service and
your metadata will be searchable in GOS portal. In the registration, you
will need to provide the URL, service name, and user name and password
for metadata browse role.

## 3.10 Updating Your Metadata

Notice that a unique document ID is assigned for each document you
publish in the metadata service. This ID should be carried along with
the document whenever you update the document to avoid duplicating of
the same document in the metadata service.

You can use ArcCatalog to update metadata documents published in ArcIMS
metadata service, or you can download the XML file using ArcCatalog and
edit the XML using text editor.

## 3.11 Further Steps

This document shows you how to set up an ArcIMS metadata service with
basic functionalities. Further steps you may need to enhance these
functionalities:

-   Add the metadata administration function, which will allow you as
    the metadata administrator to approve documents before they are
    published.

-   Use JDBC or integrate with existing user authentication system. This
    document shows you the file-based ACL, which is very basic but may
    be sufficient for your implementation.

Please consult the ArcIMS 4.0.1 help or go to ESRI support Website
([http://support.esri.com](http://support.esri.com/)) for more details.

Appendix A

Appendix A---ArcIMS 4.0.1 System Requirements

# Appendix A---ArcIMS 4.0.1 System Requirements

The following system requirements are required to run ArcIMS 4.01 on
Microsoft Windows computers.

## Hardware Configuration

### Memory Requirements

-   Web server/Manager: 256 MB of RAM recommended

-   ArcIMS Application Server: 256 MB of RAM recommended

-   ArcIMS Spatial Server: 256 MB of RAM recommended per CPU

-   HTML Viewers: 64 MB of RAM recommended

-   Java Viewers and ArcExplorer---Java Edition: 128 MB of RAM
    recommended

-   All components: 256 MB of RAM recommended per CPU

### Disk Space

A Typical ArcIMS installation requires approximately 478 MB of NTFS
(505 MB of FAT) disk space for program files and system files. If
installing to a drive other than your system drive, 123 MB of this total
of NTFS space (127 MB of FAT) will be required on your system drive for
system files.

A Complete installation of ArcIMS requires approximately 827 MB of NTFS
(864 MB of FAT) disk space. If installing to a drive other than your
system drive, 224 MB of this total of NTFS space (231 MB of FAT) will be
required on your system drive for system files.

For the disk space requirements for each ArcIMS component, see the
ArcIMS installation program on the CD.

## System Software

The following system software is required to run ArcIMS.

> ![](media/image1.png){width="4.083333333333333in" height="2.125in"}

### Operating System

Microsoft Windows NT-Intel^®^ 4.0 with Service Pack 6a, Windows 2000, or
Windows XP (hereafter collectively referred to as Windows).

To determine if Service Pack 6a is installed on Windows NT:

> Choose Start \> Run, type \"Winver,\" and press Enter. If your system
> is running it, \'Revised Service Pack 6a\' is listed in the About
> Windows NT screen.

### Web Server

ArcIMS works in conjunction with Web server software. A Web server must
be installed and operational in order to start serving maps.

For information on setting up your Web server and Servlet Engine visit
<http://support.esri.com/search/KbDocument.asp?dbid=23450>.

System administration access to the Web server computer is necessary,
and knowing how to stop and start your Web server is mandatory.

ArcIMS is fully supported on these Web servers on Microsoft Windows
computers:

-   Apache Web Server using Jakarta-Tomcat installed as a service or
    ServletExec as its servlet engine

-   IBM HTTP Server using WebSphere® as its servlet engine

-   Sun ONE 6.0 (iPlanet)™ Web Server, Enterprise Edition, using its
    Native Java servlet engine

-   Microsoft IIS for Windows NT Server, Windows 2000, and Windows XP
    using a servlet engine

**Note:** Microsoft Personal Web Server is not supported.

-   Oracle^®^ Application Server (OAS) using Apache Web Server

-   WebLogic^®^

See [Supported Software
Environments](http://arconline.esri.com/arconline/sysreqs.cfm?PID=6) for
other Web servers and their ESRI support level.

### Servlet Engine

ArcIMS requires a servlet engine if the Web server does not support
servlets natively. For information on setting up your Web server and
Servlet Engine visit
<http://support.esri.com/search/KbDocument.asp?dbid=23450>.

The servlet engine must use Java 2 Platform Standard Edition Runtime
Engine (J2SE JRE) or Java 2 Platform Standard Edition Software
Development Kit (J2SE JDK) 1.3.1 or higher.

-   IBM WebSphere

-   JRun for IIS using J2SE JDK instead of J2SE JRE available from
    [www.macromedia.com/software/jrun](http://www.macromedia.com/software/jrun/).

-   Jakarta-Tomcat for Apache Web Server or IIS installed as a service
    available from [www.apache.org](http://www.apache.org/) (hereafter
    referred to as Tomcat)

-   ServletExec^™^ for IIS available from the ServletExec folder on the
    ArcIMS CD or from [www.newatlanta.com](http://www.newatlanta.com/).

See [Supported Software
Environments](http://arconline.esri.com/arconline/sysreqs.cfm?PID=6) for
other servlet engines and their ESRI support level.

**Note:** Servlet engine evaluation versions are **not** supported.

### Java 2 Platform Standard Edition Java Runtime Environment

ArcIMS Manager and Java Viewers require a registered system of Java 2
Platform Standard Edition Java Runtime Environment version 1.3.1 or
higher. J2SE JRE versions 1.3.1_02 and 1.4.0 are supported for use with
ArcIMS 4.0.1. A J2SE JRE does not have to be installed prior to
installing ArcIMS; the post installation setup will provide you with the
opportunity to install and configure a registered system of J2SE JRE
version 1.4.0.

**Note:** J2SE JRE 1.3.1_03, 1.3.1_04 and J2SE JRE 1.4.0_01 are NOT
recommended for use with ArcIMS 4.0.1.

**Note:** J2SE JRE is not needed if J2SE SDK 1.3.1 or higher is
installed on the computer.

For the latest information on ArcIMS system requirements, see
[support.esri.com](http://arconline.esri.com/arconline/sysreqs.cfm?PID=6>).

## Additional System Requirements

#### ArcIMS Service Administrator Requirements

The following software is required to use the ArcIMS Service
Administrator:

-   Java 2 Platform Standard Edition Software Development Kit 1.3 or
    higher. The J2SE SDK is available from <http://java.sun.com/j2se>.
    Refer to your Web server documentation for supported J2SE SDK
    versions.

**Note:** J2SE SDK versions 1.3.1_02 and 1.4.0 are supported for use
with ArcIMS 4.0.1. J2SE SDK 1.3.1_03, 1.3.1_04 and J2SE SDK 1.4.0_01 are
NOT recommended for use with ArcIMS 4.0.1.

#### ArcIMS Metadata Service Requirements

The following software is required to use the ArcIMS Metadata Service:

-   ArcGIS 8.3 or higher

-   ArcSDE 8.3 or higher

#### ArcMap Server Requirements

Internet Explorer 5.0.1 or higher and Microsoft Data Access Components
(MDAC) 2.5 is required for ArcIMS ArcMap Server. If you do not have
MDAC 2.5 or higher the install will optionally let you install it. You
must obtain and install Internet Explorer 5.0.1 or higher.

The following software is required to use the ArcMap Server:

-   ArcGIS 8.2 or higher is needed to create the map documents that can
    be served in ArcIMS

-   ArcMap Server installs the required ArcObjects runtime files.

**Note:** ArcIMS ArcMap Server cannot be installed on the same machine
as ArcGIS Desktop or ArcInfo Workstation. All other ArcIMS components
can reside on a machine where ArcGIS Desktop or ArcInfo Workstation is
installed; ArcMap Server is the only exception.

#### Metadata Explorer Requirements

The following software is required to use the Metadata Explorer:

-   Java 2 Platform Standard Edition Software Development Kit 1.3 or
    higher. The J2SE SDK is available from <http://java.sun.com/j2se>.
    Refer to your Web server documentation for supported J2SE SDK
    versions.

**Note:** J2SE SDK versions 1.3.1_02 and 1.4.0 are supported for use
with ArcIMS 4.0.1. J2SE SDK 1.3.1_03, 1.3.1_04 and J2SE SDK 1.4.0_01 are
NOT recommended for use with ArcIMS 4.0.1.

### Web Browser for ArcIMS Manager

-   Microsoft Internet Explorer 5.0, 5.5, or 6.0

Remote Manager requires a one-time download for the Java 2 Plug-in and
ArcIMS files. See [Installing ArcIMS Remote
Manager](../../../../../../../../metro/Released/ArcIMS_401_Final/cdcontents/windows/Documentation/Installing_ArcIMS/microsoft_windows/installing_arcims_remote_manager/installing_remote_manager.htm)
for more information.

### Web Browser for ArcIMS Viewers

-   HTML Viewer: Microsoft Internet Explorer 5.0, 5.5, or 6.0 or
    Netscape Communicator 4.75 or 6.0

The Java Viewers require that a one-time download including the Java 2
Plug-in and ArcIMS Viewer be installed:

-   Java Standard Viewer: Microsoft Internet Explorer 5.0, 5.5, or 6.0
    or Netscape Communicator 4.75

-   Java Custom Viewer: Microsoft Internet Explorer 5.0, 5.5, or 6.0
    only

**Note:** See [Supported Software
Environments](http://arconline.esri.com/arconline/sysreqs.cfm?PID=6) for
the latest support information.

### ArcIMS Application Server Connectors

### 

ArcIMS Application Server connectors require the following optional
software if you will be creating custom Viewers using ColdFusion or
ActiveX:

#### ActiveX Connector

-   Web Server: Microsoft IIS 4.0 on Windows NT or IIS 5.0 on
    Windows 2000 and IIS 5.1 on Windows XP

-   Development Environment: Microsoft Visual InterDev 6.0, SP3, or
    Visual Studio 6.0

-   Internet Explorer 5.0.1 or higher is required for the ActiveX
    connector. You must obtain and install Internet Explorer 5.0.1 or
    higher.

-   **Important Notes on the ActiveX connector:** The ActiveX Connector
    feature will install WinHTTP5 on the user\'s machine.

-   Notes concerning Windows 2000:

```{=html}
<!-- -->
```
-   Service Pack 2 is recommended for Windows 2000. Furthermore, there
    are a few hotfixes not included in SP2 for Windows 2000 that may
    need to be applied:

-   Q260649---\"Error Message When You Use WebDav to Copy a Large File\"

-   http://support.microsoft.com/support/kb/articles/Q260/6/49.ASP

-   This fix should be applied if hangs or other serious errors are
    encountered when making HTTPS requests.

-   Q282865---\"Winsock Shutdown Can Increase CPU Usage to 100 Percent\"

-   http://support.microsoft.com/support/kb/articles/Q282/8/65.ASP

-   This fix addresses a hang that may occur while terminating a
    multithreaded program that has sent HTTP requests.

```{=html}
<!-- -->
```
-   Notes concerning Windows NT 4.0:

```{=html}
<!-- -->
```
-   It is strongly recommend that a patch for CRYPT32.DLL be applied on
    Windows NT 4.0 platforms. The patch fixes a hang encountered when
    shutting down a process that has connected to a secure server using
    SSL. Please refer to the following URL for more information:

-   http://support.microsoft.com/support/kb/articles/Q238/9/34.ASP

For ActiveX information, see *Customizing ArcIMS---ActiveX Connector.*

#### ColdFusion Connector 

-   ColdFusion Server Professional or Enterprise 4.5.1 or 5.0 and
    ColdFusion MX.

-   Development Environment: ColdFusion Studio 4.5.1, 4.5.2, or 5.0

For ColdFusion information, see *Customizing ArcIMS---ColdFusion
Connector.*

#### Java Connector

-   Java 2 Platform Standard Edition Software Development Kit 1.3 or
    higher. The J2SE SDK is available from <http://java.sun.com/j2se>.
    Refer to your Web server documentation for supported J2SE JDK
    versions.

**Note:** J2SE SDK versions 1.3.1_02 and 1.4.0 are supported for use
with ArcIMS 4.0.1. J2SE SDK 1.3.1_03, 1.3.1_04 and J2SE SDK 1.4.0_01 are
NOT recommended for use with ArcIMS 4.0.1.

For Java Connector information, see *Customizing ArcIMS---Java
Connector.*

### ArcSDE

The following versions of ArcSDE are supported by ArcIMS:

#### Metadata Users Only

-   ArcSDE 8.3 or higher

#### Other Users

-   ArcSDE 8.0.x, ArcSDE 8.1.x, ArcSDE 8.2, or ArcSDE 8.3 or higher

-   ArcSDE for Coverages 8.0.x, 8.1.x, 8.2, or 8.3 or higher

Appendix B

ArcSDE 8.3 for Oracle System Requirements

# Appendix B---ArcSDE 8.3 for Oracle System Requirements

For the latest in supported system environments see
[http://support.esri.com](http://arconline.esri.com/) and navigate to
ArcSDE \> System Requirements.

Your computer is required to meet these minimum system requirements to
install ArcSDE 8.3 for Oracle8*i*.

**IMPORTANT:** All ArcGIS® clients must be upgraded to ArcGIS 8.3 before
upgrading to ArcSDE 8.3.

## Minimum System Requirements

Operating System

-   Microsoft Windows 2000

-   Microsoft Windows NT---Intel 4.0 Service Pack 6a

(Hereafter collectively known as Microsoft Windows)

Higher releases may, and usually do, work. Lower versions of releases
are not supported.

**Note:** For any given operating system, if the DBMS is not supported
on that version of the operating system, ArcSDE is not supported either.

The ArcSDE Developer Help on Windows requires Internet Explorer 4.0 or
later. Internet Explorer 5.5 is included with the ArcGIS Desktop
installation.

Free Disk Space

Server environment on Windows requires approximately 50 MB.

Recommended Compilers

Microsoft Visual C++® 6.0

This compiler has been tested and is recommended. Other ANSI standard
compilers may work but they have not been tested, and we do not
guarantee their success. Non-ANSI compilers are not supported, and we
strongly advise against their use for ArcSDE applications.

Oracle Requirements

-   Oracle 8.1.6 and 8.1.7 are supported.

-   Oracle\'s Enterprise, Standard and Personal Editions are supported.

**Note:** Oracle\'s Personal Edition is a single user product intended
for software and application developers.

**Note:** Oracle Standard and Personal Editions do not support Oracle
Spatial. Geometry storage with Oracle Standard Edition is limited to
Long Raw (ArcSDE default) or LOB types.

Net8® is optional when both ArcSDE and Oracle run on the same server
machine. Net8 is required when Oracle and the ArcSDE server are running
on different machines, if Oracle needs to be started as a multithreaded
server or if configuring your system to also use direct connect.