Don’tDuckMetadata

Introducing Setting Up a Clearinghouse Node ---6.1 March 2005

Topic:Topic: Introduction to Setting Up a Introduction to Setting Up a Clearinghouse NodeClearinghouse Node

Objective:Objective: By the end of this session, the By the end of this session, the participants will be able to install, setup participants will be able to install, setup and successfully test a clearinghouse and successfully test a clearinghouse node using provided sample metadata node using provided sample metadata recordsrecords

Audience:Audience: Technical Staff with web service Technical Staff with web service administration experienceadministration experience

Instructor:Instructor: Michelle AnthonyMichelle Anthony

Introducing Setting Up A Clearinghouse Node ---6.2

Don’tDuckMetadata

March 2005

Workshop Background

•Title: Introducing Web Mapping, Clearinghouse & Geospatial Metadata

•Length: 5 Days

Introducing Setting Up A Clearinghouse Node ---6.3

Don’tDuckMetadata

March 2005

Workshop Objectives1. Introduction2. Internet Map Servers (IMS)

• Install and configure IMS software• Create Map Services & Website

3. OGC Web Mapping Specification (WMS)4. Clearinghouse Introduction5. Metadata

• Standards & Development• Linking Metadata and Map Services

6. Establishing a Clearinghouse Node

Don’tDuckMetadata

Introducing Setting Up a Clearinghouse Node ---6.4 March 2005

What is Isite and How Do I setup a Clearinghouse Node

Topic 6.0

Setting Up a Setting Up a Clearinghouse Clearinghouse Node Node

Introducing Setting Up A Clearinghouse Node ---6.5

Don’tDuckMetadata

March 2005

Setting Up a Clearinghouse Node

6.1: Isite Overview

6.2: How to Setup a Clearinghouse Node using the Isite software

Don’tDuckMetadata

Introducing Setting Up a Clearinghouse Node ---6.6 March 2005

What is the Isite software?

Topic 6.1

Isite OverviewIsite Overview

Introducing Setting Up A Clearinghouse Node ---6.7

Don’tDuckMetadata

March 2005

Isite Server Introduction

Integrated suite of Internet-based programs providing text indexing/searching that uses Z39.50 for communication.

Z39.50 is an Internet Protocol for retrieving information from other computer systems

– Bibliographic library work extended to geographic community

Introducing Setting Up A Clearinghouse Node ---6.8

Don’tDuckMetadata

March 2005

Isite Server Introduction Windows version provides nice

graphical interface

– Reduces setup and configuration time!

Introducing Setting Up A Clearinghouse Node ---6.9

Don’tDuckMetadata

March 2005

Isite Server Introduction

UNIX or Linux version requires command line setup and configuration

Introducing Setting Up A Clearinghouse Node ---6.10

Don’tDuckMetadata

March 2005

Data Sets

Iindex and Zserver work together to publish data online.

Clearinghouse Diagram

Iindex & ZserverISITE SERVER

Client

Metadata

Don’tDuckMetadata

March 2005

Iindex

Creates a searchable index out of XML or SGML metadata files

Run every time new metadata records have been added to the database

Syntax: Iindex -d [database] -t [document type] -o [document options] [metadata files]

Iindex

Index(Iindex)

Metadata IsiteDB

Introducing Setting Up A Clearinghouse Node ---6.12

Don’tDuckMetadata

March 2005

Zserver

Runs the Z39.50 communication process

– Performs Searches based upon received queries

– Returns results of search in a session

Setup and options are set through .INI files

– zserver.ini - Server Options, Port, Etc.

– sapi.ini - Database Setup

Zserver

Zserver

Query

Results

Introducing Setting Up A Clearinghouse Node ---6.13

Don’tDuckMetadata

March 2005

Isearch - Local Testing Utility

Performs searches on indexes locally

– Iisearch -d [database] [query]

Isearch

IsiteDB

LocalTest

Query

Results

Local Machine

Introducing Setting Up A Clearinghouse Node ---6.14

Don’tDuckMetadata

March 2005

Zclient - Z39.50 Testing Utility

Performs searches through the internet

– zclient [host] [port] [database] [query]

Zclient

IsiteDB

InternetTest

Query

Results

Remote MachineLocal Machine

Introducing Setting Up A Clearinghouse Node ---6.15

Don’tDuckMetadata

March 2005

Obtaining Isite

Supported Versions

– Version 2.40 required for Geospatial One-Stop (GOS)

• Command line interface only• Linux, SunOS, FreeBSD, Windows (non-GUI) and Source

Code– Version 2.07i only version to contain Graphical

Interface

• Cannot be used for GOS• New graphical version under development for 2.40

FGDC Website

• http://clearinghouse4.fgdc.gov/ftp

Introducing Setting Up A Clearinghouse Node ---6.16

Don’tDuckMetadata

March 2005

Introducing Setting Up A Clearinghouse Node ---6.17

Don’tDuckMetadata

March 2005

Commercial Node Alternatives

Commercial solutions can provide additional functions

– Search engines– Relational Database Support– Large Collections

Commercial Solutions

– Blue Angel MetaStar Suite– Compusult MetaManager Toolkit– ArcIMS Metadata Services– Intergraph GeoConnect

Don’tDuckMetadata

Introducing Setting Up a Clearinghouse Node ---6.18 March 2005

How do I establish a Clearinghouse Node using Isite?

Topic 6.2

Setting up a Setting up a Clearinghouse Node Clearinghouse Node using Isiteusing Isite

Introducing Setting Up A Clearinghouse Node ---6.19

Don’tDuckMetadata

March 2005

Windows Isite Demonstration

Installation

Indexing of metadata

Testing procedures

Registering with the FGDC Clearinghouse

Introducing Setting Up A Clearinghouse Node ---6.20

Don’tDuckMetadata

March 2005

Download Isite Software

Download appropriate platform

Introducing Setting Up A Clearinghouse Node ---6.21

Don’tDuckMetadata

March 2005

Creating Isite directory

Create C:\isite directory

Place Isite executable in directory

Introducing Setting Up A Clearinghouse Node ---6.22

Don’tDuckMetadata

March 2005

Installing Isite Files

Run Executable (Isite207i-NT.exe)

Specify directory as c:\isite

Introducing Setting Up A Clearinghouse Node ---6.23

Don’tDuckMetadata

March 2005

Running Isite

Windows Isite now appears in the Start Menu

Select Isite Admin Console

Introducing Setting Up A Clearinghouse Node ---6.24

Don’tDuckMetadata

March 2005

Main Tab

Location of Isite software

Introducing Setting Up A Clearinghouse Node ---6.25

Don’tDuckMetadata

March 2005

Zserver Values Tab

Port Number

Introducing Setting Up A Clearinghouse Node ---6.26

Don’tDuckMetadata

March 2005

Most Important Components

Node Setup and

Server Control Panel

Introducing Setting Up A Clearinghouse Node ---6.27

Don’tDuckMetadata

March 2005

Database Tab

Introducing Setting Up A Clearinghouse Node ---6.28

Don’tDuckMetadata

March 2005

Zserver Service Tab

Introducing Setting Up A Clearinghouse Node ---6.29

Don’tDuckMetadata

March 2005

Zserver Log Tab

Location of Access Logfile

Isite Access Log

Introducing Setting Up A Clearinghouse Node ---6.30

Don’tDuckMetadata

March 2005

Text Editor Tab

Introducing Setting Up A Clearinghouse Node ---6.31

Don’tDuckMetadata

March 2005

Options Tab

Introducing Setting Up A Clearinghouse Node ---6.32

Don’tDuckMetadata

March 2005

About Tab

Introducing Setting Up A Clearinghouse Node ---6.33

Don’tDuckMetadata

March 2005

Ability to Create Multiple Nodes

Don’tDuckMetadata

March 2005

Creating the Node By Indexing your Metadata

1. Database Tab

6. Run Index5. Unmark if

no MP

4. Save

3. Define your metadata to index and Index to be

created

2. New

7. Check Status

Introducing Setting Up A Clearinghouse Node ---6.35

Don’tDuckMetadata

March 2005

Summary Steps for Creating a Node

1. Select the Database tab

2. Select New button to create a new node

3. Complete the node required fields:- Database: name of the node- Metadata Directory: directory of the metadata- Index Directory: directory of the Isite index

4. Save the settings

5. Unselect the Use Parsed Dir checkbox

6. Run Iindex to index the sample metadata

7. Check Status of index

Introducing Setting Up A Clearinghouse Node ---6.36

Don’tDuckMetadata

March 2005

Running Zserver

Select the Zserver Service tab

Select Start Z39.50 Service

– NOTE: Each time you re-index, make sure to restart zserver.

Start the Server

Introducing Setting Up A Clearinghouse Node ---6.37

Don’tDuckMetadata

March 2005

Testing Your Clearinghouse Node

Open a MS-DOS Window

Change into the c:\Isite directory

Use the zclient program and following commands to test your node

• Full Text Search• Field Search• Spatial Search

Introducing Setting Up A Clearinghouse Node ---6.38

Don’tDuckMetadata

March 2005

Zclient - Full Text Search

zclient [server] [port] [DB Name] [Query Terms]

• [server] - address of your server (localhost : local machine)• [port] - the port defined in your Zserver Values tab• [DB Name] - the name of your database name (node)• [Query Terms] is the data you wish to find• “water[1,1016]” specifies to find the word water anywhere in the metadata records

Introducing Setting Up A Clearinghouse Node ---6.39

Don’tDuckMetadata

March 2005

Zclient - Field Search

zclient [server] [port] [DB Name] [Query Terms]

• [server] - address of your server (localhost : local machine)• [port] - the port defined in your Zserver Values tab• [DB Name] - the name of your database name (node)• [Query Terms] is the data you wish to find• “climate[1,4]” specifies to find the word climate in any title

fields

Introducing Setting Up A Clearinghouse Node ---6.40

Don’tDuckMetadata

March 2005

Zclient - Spatial Search

zclient [server] [port] [DB Name] [Query Terms]

• [server] - address of your server (localhost : local machine)• [port] - the port defined in your Zserver Values tab• [DB Name] - the name of your database name (node)• [Query Terms] is the data you wish to find• “90 -180 -90 180[1,2060]” specifies to find a global search based

upon coordinates. It returns the total number of metadata records.

Introducing Setting Up A Clearinghouse Node ---6.41

Don’tDuckMetadata

March 2005

Registering with the FGDC Gateway

Register with the FGDC from the form:

– http://registry.gsdi.org/registry/

Introducing Setting Up A Clearinghouse Node ---6.42

Don’tDuckMetadata

March 2005

Summary of Test Commands

Full Text Search:

– zclient [server] [port] [node] “water[1,1016]”– substitute ‘water’ for any word that you want to search for

anywhere in the metadata

Field (Title) Search:

– zclient [server] [port] [node] “climate[1,4]”– substitute ‘climate’ for any word that you want to search for

exclusively in the Title field

Spatial Search

– zclient [server] [port] [node] “90 -180 -90 180[1,2060]”– this default search should return all metadata records since this

is a global spatial search.

Introducing Setting Up A Clearinghouse Node ---6.43

Don’tDuckMetadata

March 2005

• Setup a clearinghouse node using the Isite software

• Perform full text, title and spatial searches

• Ensure your search results match your metadata!

EXERCISE 6.2