Navigating faster using Full-Text Search feature

Introduction

The Full-Text Search feature provided by the Control Panel allows you to search for the necessary string not only among the names of documents, emails, etc. but also within their content.

ONLYOFFICE uses Elasticsearch, an open-source, broadly-distributable, and ready-scalable search engine. Elasticsearch is built on top of Lucene, a free and open-source search engine software library, and, therefore, it is excellent for fast full-text search. The documents stored in Elasticsearch are distributed across different containers known as shards, which are duplicated to provide redundant copies of the data in case of hardware failure.

Using Elasticsearch not only significantly reduces the time spent searching for a particular file or a text line but also enhances the search precision.

Enabling the Full-Text Search feature

To enable the full-text search within document contents:

  1. Sign in to your portal and click the Control Panel icon on the Start Page. Alternatively, you can go to the portal Settings and select the Control Panel link in the left-side panel.
  2. Go to the Full-Text Search section.
  3. Select the Search in documents content and/or Search in mail messages content checkbox to enable the full-text search in the Documents module or in the Mail module, respectively, and click Save. The stored files will be indexed in the corresponding modules.
Since Elasticsearch indexes all stored files, enabling this feature requires at least an equal amount of free disk space as the overall disk space required for all documents, emails, and other content.
Full-Text Search Full-Text Search

Reindex Full-Text Search

If the file you are looking for is not among the search results (e.g., in the Documents module), and you are sure that it exists, an indexing error might have occurred.

To rebuild indexes in a separately selected portal module:

  1. Go to the Full-Text Search section in the Control Panel.
  2. Click Reindex to the right of the module section you need.

To rebuild all indexes:

  1. Go to the Full-Text Search section in the Control Panel.
  2. Click Reindex all.
Reindex Reindex

Changing the memory consumed by Elasticsearch

In some cases, you might need to change the amount of memory consumed by Elasticsearch.

To change the consumed memory:

  1. Open the configuration file:
    • For Windows systems: C:\ProgramData\Elastic\Elasticsearch\config\jvm.options
    • For Linux systems: /etc/elasticsearch/jvm.options
  2. Change the following parameters:
    1. -Xms1g
    2. -Xmx1g

    The number indicates the amount of used RAM in GB.

  3. After changing the configuration file, restart the elasticsearch service.
Article with the tag:
Browse all tags