Home

Crawl and Index

Serving

Status and Reports

Connector Administration
  Connector Managers
  Connectors

Social Connect

Cloud Connect

GSA Unification

GSAⁿ

Administration

More Information

Connector Administration > Connector Managers

Use this page to register a connector manager on a Google Search Appliance or to retrieve logs for the internal 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 search appliance has an internal connector manager installed. The internal connector manager does not need to be registered. It is always called ConnectorManager0 on the Admin Console. The search appliance also has three connectors installed internally:

• SharePoint connector
• File System connector
• LDAP connector

You cannot install other connectors internally and you cannot edit the internal connector manager.

The Connector Managers help page includes the following topics:

• Before Starting these Tasks
• Viewing Connector Manager Status Information
• Registering a Connector Manager
• Editing a Connector Manager
• Unregistering a Connector Manager
• Viewing Logs for the Internal Connector Manager
• Changing the Connector Log Level
• Changing the Feed Log Level
• Subsequent Tasks
• For More Information

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.

If you plan to export the logs or configuration file of the internal SharePoint connector, ensure that your firewall does not block port 7843 on the search appliance.

Viewing Connector Manager Status Information

To view the status of connector managers registered on a search appliance, click Connector Administration > Connector Managers. A status table is displayed on the Connector Managers page that includes the following information about the internal connector manager and 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:
  • 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.
  • 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:
  • Edit Connector Manager
  • Unregister Connector Manager
  • Download Logs
  • Download Configuration
  • Connector Log Level
  • Feed Log Level
• 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 Connector Administration > 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 Connector Administration > 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.

Viewing Logs for the Internal Connector Manager

To view diagnostic report for the internal connector manager:

1. Click Connector Administration > Connector Managers.
2. Click Logs on the line corresponding to the internal connector manager. A Save dialog box is displayed.
3. Navigate to the location on the local computer where you want to save the logs.
4. Click Save.
5. Extract the files from the zip file.

Exporting the Configuration Files for the Internal Connector Manager

You can export the internal connector manager's configuration files from the search appliance. Ensure that your firewall does not block port 7843 on the search appliance, or you cannot export the configuration file.

To export the configuration files:

1. Click Connector Administration > Connector Managers.
2. Click Export Config on the line corresponding to the internal connector manager. A Save dialog box is displayed.
3. Navigate to the location on the local computer where you want to save the configuration files.
4. Click Save.

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 Connector Administration > 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 "On."

To change the feed log level:

1. Click Connector Administration > 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.