Google Search Appliance Upgrade and Migration Handbook - Manual (Page 12)

Chapter 3 ­ Upgrading a Connector
Overview
GSA connector releases generally follow an independent update cycle to GSA software releases. The
overall release schedule of the GSA connector suite is marked by the incremental releases of the Google
Connector Installer (GCI), which contains an installer for every supported GSA connector.
The list of versions of the GSA Connectors can be found via the Google Enterprise Support Portal under
Resources > Google Search Appliance Connectors Software Updates.
The version numbering of each GSA connector follows a three­segment naming convention and can include
a special version identifier, as shown in the following format:
Connector name ­
Some examples of this numbering scheme are:
● GSA Connector for Livelink 2.8.4
● GSA Connector for SharePoint 3.0.4
● GSA Connector for SharePoint 3.0.6 ­ RC1
Versions containing a special version identifier are typically unsupported versions which should not be used
in Production. Eg. RC1 is a Release Candidate version.
General Upgrade Steps
The simplest way to upgrade a connector is to install a new instance of the connector and re­index all
content. Unless otherwise stated in connector release notes, re­indexing of all connector content is
recommended for every version upgrade of a connector.
The general steps for achieving this with a production environment would include:
● Switch serving to a production backup GSA environment
● Install the new version of the connector and re­index content into the production GSA. If license
capacity allows, documents indexed via the old version of the connector can be retained and tested
against documents indexed from the new connector (eg. via separate collections). This will allow for
comparison of content and simpler rollback if any issues are encountered.
● Test and verify documents from new connector have been indexed successfully and any connector
dependent security mechanisms are still functional (eg. connector authentication or authorization,
ACL indexing)
● Reinstate and resume serving from production GSAs, and perform upgrade connectors in the
production backup GSA environment.
12