Metadata Services for ArcIMS 10
Setting the Z39.50 Connector's communication protocol

Setting the Z39.50 Connector's communication protocol

The Z39.50 Connector can implement the HTTP, HTTPS, or TCP/IP protocol for communicating with Z39.50 clients. You configure the connector to use a protocol by setting a series of properties in the z3950.properties file. By default, the connector is set to use HTTP; however, you may prefer to use a different protocol. Before changing the protocol, you must consider the consequences�HTTP or HTTPS and TCP/IP have different capabilities for restricting access to your metadata. For details, see �Protocols and restricting access to your metadata� in this chapter.

To use the HTTP or HTTPS protocol with the Z39.50 Connector, set the connectionType property in the z3950.properties file to �http�; this is the default value. Set the url property to the Internet location of the machine that hosts the ArcIMS services; the URL will be either an http or an https address, depending on the protocol you are using.

To use the TCP/IP protocol, set the connectionType property to �tcp� and set the appServerMachine property to the name of the machine that hosts the ArcIMS Application Server. If the ArcIMS Application Server was configured to run on a port other than 5300, you must also modify the appServerPort property in the z3950.properties file.

Setting the protocol to HTTP or HTTPS

  1. Edit the z3950.properties file in a text editor. This file is located in the Z39.50 Connector�s install directory.

  2. Set the connectionType property to �http�. Use the same value for the HTTP and HTTPS protocol.
    As shown in the sample file below, under ### The connection protocol used to connect z39.50�connectionType=http

  3. Set the url property to the Internet address of the server that hosts the ArcIMS Metadata Service. For example, for HTTP:
    url=http://<localhost>.<domain>.com
    Or for HTTPS:
    url=https://<localhost>.<domain>.com

    In this file, it is set to url=http://www.myServer.com.
    Using http with the Z39.50 Connector

  4. Save and close the file.

  5. Stop and restart the ArcIMS Z3950 service in the Services window.

Setting the protocol to TCP/IP

  1. Edit the z3950.properties file in a text editor. This file is located in the Z39.50 Connector�s install directory.

  2. Set the connectionType property to �tcp�.
    In the file shown below, this is shown as connectionType=tcp.

  3. Set the appServerMachine property to the name of the computer where the ArcIMS Application Server is installed.
    appServerMachine=hostname.


    In the example file below, the setting is appServerMachine=myServer.

  4. The default port on which the ArcIMS Application Server runs is 5300. If necessary, modify the appServerPort property.
    The default, appServerPort=5300, is shown in the file below.
    Using tcp/ip with the Z39.50 Connector

  5. Save and close the file.

  6. Stop and restart the ArcIMS Z3950 service in the Services window.

 



Search code: @setting_the_z3950_connectors_communication_protocol