### Google Search Appliance (GSA) / Google Mini

Fess provides comprehensive GSA migration support through configuration import and API compatibility.

#### Configuration Import

Fess can directly import GSA XML configuration files, automatically converting them to native Fess configurations.

**Step 1: Export GSA Configuration**

Export your GSA configuration as XML. A typical GSA configuration includes:

        Throwable intermediateCause = new RuntimeException("Intermediate problem", rootCause);
        GsaConfigException exception = new GsaConfigException("Top level GSA error", intermediateCause);

        assertNotNull(exception);
        assertEquals("Top level GSA error", exception.getMessage());

        // Check first level cause
        assertNotNull(exception.getCause());

import org.xml.sax.helpers.DefaultHandler;

/**
 * Parser for Google Search Appliance (GSA) configuration files.
 * This SAX-based parser reads GSA XML configuration files and converts them into
 * Fess configuration objects including web crawling configurations, file crawling
 * configurations, and label types for access control.
 *
 * <p>The parser handles the following GSA configuration elements:
 * <ul>
 * <li>Collections with good/bad URL patterns</li>

            logger.debug("GSA XML import started: fileName={}", fileName);
        }

        final GsaConfigParser configParser = ComponentUtil.getComponent(GsaConfigParser.class);
        try (final InputStream in = new FileInputStream(tempFile)) {
            configParser.parse(new InputSource(in));
        } catch (final IOException e) {

query.additional.not.analyzed.fields=
# Fields for GSA response in queries.
query.gsa.response.fields=UE,U,T,RK,S,LANG
# Default language for GSA queries.
query.gsa.default.lang=en
# Default sort for GSA queries.
query.gsa.default.sort=
# Meta prefix for GSA queries.
query.gsa.meta.prefix=MT_
# Charset field for GSA index queries.
query.gsa.index.field.charset=charset
# Content type field for GSA index queries.

    /** Property key for suggest web API configuration. */
    public static final String WEB_API_SUGGEST_PROPERTY = "web.api.suggest";

    /** Property key for GSA web API configuration. */
    public static final String WEB_API_GSA_PROPERTY = "web.api.gsa";

    /** Property key for popular word web API configuration. */
    public static final String WEB_API_POPULAR_WORD_PROPERTY = "web.api.popularword";

        LabelType[] labelTypes = parser.getLabelTypes();
        assertEquals(3, labelTypes.length);
    }

    @Test
    public void test_escape() {
        // https://www.google.com/support/enterprise/static/gsa/docs/admin/70/gsa_doc_set/admin_crawl/url_patterns.html#1076127
        assertEscapePattern("", "# Test");
        assertEscapePattern(".*\\Q!/\\E.*", "!/");
        assertEscapePattern("\\Qindex.html\\E", "index.html");

    String QUERY_GSA_RESPONSE_FIELDS = "query.gsa.response.fields";

    /** The key of the configuration. e.g. en */
    String QUERY_GSA_DEFAULT_LANG = "query.gsa.default.lang";

    /** The key of the configuration. e.g.  */
    String QUERY_GSA_DEFAULT_SORT = "query.gsa.default.sort";

    /** The key of the configuration. e.g. MT_ */
    String QUERY_GSA_META_PREFIX = "query.gsa.meta.prefix";

    }

    @Test
    public void test_accessType_constantValues() {
        assertEquals("json", Constants.SEARCH_LOG_ACCESS_TYPE_JSON);
        assertEquals("gsa", Constants.SEARCH_LOG_ACCESS_TYPE_GSA);
        assertEquals("web", Constants.SEARCH_LOG_ACCESS_TYPE_WEB);
        assertEquals("admin", Constants.SEARCH_LOG_ACCESS_TYPE_ADMIN);