Back to Home | Admin Console Help | Log Out
 Admin Console Help
 
Admin Console Help

Home

Content Sources
 Web Crawl
  Connector Managers
  Connectors
  Feeds
  Groups
  OneBox Modules
  Diagnostics

Index

Search

Reports

GSA Unification

GSAn

Administration

More Information

Content Sources > Connector Managers

Use this page to register a connector manager on a Google Search Appliance or to edit log levels for a connector manager.

Connector managers monitor connectors, initiate traversal schedules, and terminate traversal at scheduled intervals. External connector managers are deployed on an application server running on a computer on your network. Connectors run on these connector managers.

The Content Sources > Connector Managers help page includes the following topics:

Before Starting these Tasks

Before you register an external connector manager on the search appliance, you must deploy the connector manager and a connector on a host. For information on deploying connector managers and installing connectors, see the documentation for your content repository type and connector version, which is linked to the connector documentation landing page. The search appliance help system does not discuss connector manager installation and deployment.

Viewing Connector Manager Status Information

To view the status of connector managers registered on a search appliance, click Content Sources > Connector Managers. A status table is displayed on the Content Sources > Connector Managers page that includes the following information about registered external connector managers:

  • Status - The status of connection between a Google Search Appliance and the connector manager deployed on an application server. The Status column has the following status indicators:
    • connected connectors A plain green circle. If the green circle is lit, the Google Search Appliance can communicate with the application server where the connector manager is running.
    • disconnected connector A minus sign enclosed within a red circle. If the red circle is lit, the Google Search Appliance cannot communicate with the application server, either because the application server is down or there are problems on the network. To view the status of individual connectors, click the connector manager name.
  • Name - The name of the connector manager.
  • Actions - This column lists the following actions:
  • Details - This column lists the following information:
    • Description - A description of the connector manager.
    • Service URL - The URL of the application server where the connector manager is installed.
    • Version - Software versions for the connector manager and components.

Registering an External Connector Manager

To register a new external connector manager:

  1. Click Content Sources > Connector Managers.
  2. In the Manager Name field, type a unique name for the connector manager. The name must be no longer than 20 alphanumeric characters. Connector manager names may include underscores (_) and hyphens (-), but they cannot begin with a hyphen.
  3. In the Description field, type a description.
  4. In the Service URL field, type the URL to which the servlet container publishes the connector manager.

    This is the root access URL for the connector manager. Ensure that the location you enter is a fully-qualified domain name. Use http://myappserver.com:8080/connector-manager, not http://myappserver:8080/connector-manager.

    For example, if the connector manager is located in the $CATALINA_HOME/webapps/connector-manager/ directory of a Tomcat server running on the myappserver host machine, its location is:

    http://myappserver.com:8080/connector-manager

    The following values are used in this example:

    • http://myappserver.com

      The host name of the computer on which Tomcat runs. This must be a fully-qualified domain name.

    • 8080

      The default http port on which Tomcat serves web applications. The value is configurable. See the Apache Tomcat documentation for further information on changing the value

    • /connector-manager

      The name or context of the web application (connector manager WAR file). Do not include the .WAR extension in the file name.

  5. If access from the Google Search Appliance to Apache Tomcat is through a proxy server, the URL in the Service URL field must include the proxy redirect. For example:

    http://proxy.foo.com:81/tomcat/connector-manager

  6. Optionally, in the IP Address field, type one or more IP addresses associated with the connector manager. Use commas to separate multiple IP addresses.
    Providing an IP address enables the search appliance to trust the IP for accepting connector feeds. If you leave this field blank, the search appliance attempts to fill it in automatically. If the search appliance cannot fill in the field, you must enter a valid IP address.
  7. Click Save.

Editing an External Connector Manager

Use these instructions to change the settings for an external connector manager.

To edit connector manager settings:

  1. Click Content Sources > Connector Managers.
  2. Click Edit on the line corresponding to the correct connector manager.
  3. Edit the Manager name, Description, Service URL, or IP Address fields.
  4. Click Save.

Unregistering an External Connector Manager

To unregister a connector manager, click the Unregister link corresponding to the connector manager you want to unregister.

This action unregisters the connector manager on the Google Search Appliance, but does not affect the machine on which the application server runs. You must uninstall the connector manager from that host. See the connector administration document for your content management system on the connector documentation landing page.

Changing the Connector Log Level

The connector logs are generated by connectors as well as connector manager to store important information about about internal processing that connector/connector manager is executing. You can review this information to check whether the connector is working as expected. Also in the events when connectors are not working correctly, these logs can help in troubleshooting.

By default, the connector log level is "Info." At this level, the connector might not log every detail of its processing. However, each subsequent level of logging, from "Severe" to "All," contains progressively more detailed logging.

If you are troubleshooting a traversal issue you can change the connector log level to one of the other more detailed options.

To change the connector log level:

  1. Click Content Sources > Connector Managers.
  2. Select a connector log level from the pull-down menu.
  3. Click the Save link next to the pull-down menu.

Changing the Feed Log Level

The connector manager can produce a feed log, which contains information about each document that the connector manager sends as part of the feed file to the Google Search Appliance. Information in the feed log includes what metadata was sent to the search appliance for each document and which documents are missing from the feed. By default, the setting for the feed log is "Off."

If you are troubleshooting a feed issue, you can change the feed log level to "All."

To change the feed log level:

  1. Click Content Sources > Connector Managers.
  2. Select a feed log level from the pull-down menu.
  3. Click the Save link next to the pull-down menu.

Subsequent Tasks

After you register a connector manager, register connector types and connectors on the search appliance.

If you unregister a connector manager from the search appliance, uninstall the connector from the computer on which it is installed.

For More Information

For more information about connectors and connector managers, see the connector documentation set.
 
© Google Inc.