### 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:

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) {

    /** 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";

    }

    /**
     * Processes search preferences specifically for GSA (Google Search Appliance) compatible requests.
     * This method determines the preference value based on configuration and query content.
     *
     * @param req the HTTP servlet request
     * @param query the search query string
     * @return the preference value for GSA search requests, or null if not applicable
     */

        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");

    }

    @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);