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