<commit_before>## Installing the OpenSearchServer module for Drupal 7

### Requirements

In addition to the required modules detailed below you will need a running instance of OpenSearchServer. [SaaS hostings](http://www.opensearchserver.com/#saas) are perfectly suited for this.

### Installing dependencies

Several modules are required by the OpenSearchServer module. 

The main one is **Search API**. This module also has some dependencies.

Here is the full list of modules that must be enabled for OpenSearchServer module to work porperly:

* Search API
* Entity
* Facet API
* Libraries

You may also want to install and enable from now on these modules. They will be useful for creating search pages:

* Views
* CTools
 
#### Full installation process

Here are the full steps to follow for a fresh new Drupal website for being able to start OpenSearchServer module:

##### Installing Search API

You could for example use the built in installation feature. In _/admin/modules_, click "Install new module".

![Add new module](drupal_newmodule.png)

Copy/past link for a `.tar.gz` or a `.zip` link for module Search API.

![Install Search API](drupal_searchapi.png)

Click "Install", and then click "Enable newly added modules" to come back to the Modules page.

![Go back to list of modules](drupal_enable.png)

##### Installing required modules for Search API

You now see that Search API, Search facets and Search views also have dependencies. We will install them all.

![Dependencies for Search API](drupal_searchapi_dependencies.png)

Following the above process, install modules **Entity**, **Views** and **Facetapi**.

New dependencies are now shown. Install module **CTools**.

##### Enabling modules

Check modules **Search API**, **Search facets**, **Search views** and click on "Save configuration". 
 
![Enable Search API](drupal_enablemodules.png)

On next page click on button "Continue" to also enable required modules.

![Accept enabling of other modules](drupal_enablemodules2.png)

### Installing OpenSearchServer module

Download the module (_-- download link will be added soon --_) and upload it to `/sites/all/modules`. Go to page _/admin/modules_.

OpenSearchServer module needs module **Libraries**. Using steps explained above, install this module.

![Dependency for OpenSearchServer](drupal_searchossdependency.png)
 
#### Enabling OpenSearchServer

Check module "Search API OpenSearchServer" and click on "Save configuration". 

![Enable OpenSearchServer](drupal_searchossenable.png)

On next page click on button "Continue".
 
![Enable OpenSearchServer](drupal_searchossenable2.png)
 
### Installing OpenSearchServer's PHP library

Download version 1 of OpenSearchServer's PHP library: [https://github.com/jaeksoft/opensearchserver-php-client/archive/1.x.zip](https://github.com/jaeksoft/opensearchserver-php-client/archive/1.x.zip).

Unzip it to `/sites/all/libraries` and rename folder from `opensearchserver-php-client-1.x` to `opensearchserver`.

**Take care**: destination folder is **`/sites/all/libraries`**, not `/sites/all/modules/libraries`.


---

Installation is over! It's time for [some configuration](configuring.md).<commit_msg>Update installing.md<commit_after>## Installing the OpenSearchServer module for Drupal 7

### Requirements

In addition to the required modules detailed below, you will need a running instance of OpenSearchServer. We recommend using our [SaaS hosting solution](http://www.opensearchserver.com/#saas) for the latter.

### Installing dependencies

The main required module for the OpenSearchServer module is **Search API**. However, Search API has its own requirements. Thus the full prerequisites are :

* Search API
* Entity
* Facet API
* Libraries

You'll probbaly also want to install and enable the following modules to create search pages:

* Views
* CTools
 
#### Full installation process

Assuming a fresh new Drupal website, follow these steps:

##### Installing Search API

We suggest using the built-in installation feature. In _/admin/modules_, click on "Install new module".

![Add new module](drupal_newmodule.png)

Copy/past the link for a `.tar.gz` or a `.zip` packaging of the Search API module.

![Install Search API](drupal_searchapi.png)

Click "Install", and then click on "Enable newly added modules". This will take you back to the Modules page.

![Go back to list of modules](drupal_enable.png)

##### Installing the required modules for Search API

You can now see that Search API, Search facets and Search views also have dependencies. We shall install them all!

![Dependencies for Search API](drupal_searchapi_dependencies.png)

Repeating the above process, install the **Entity**, **Views** and **Facetapi** modules.

The dependencies for these are now displayed. Which means you have to install the **CTools** module as well.

##### Enabling modules

Check the boxes for the **Search API**, **Search facets** and **Search views** modules, then click on "Save configuration". 
 
![Enable Search API](drupal_enablemodules.png)

On the next page, click on the "Continue" button to also enable the required modules.

![Accept enabling of other modules](drupal_enablemodules2.png)

### Installing the OpenSearchServer module

Download the module (_-- download link will be added soon --_) and upload it to `/sites/all/modules`. Then go to the _/admin/modules_ page.

The OpenSearchServer module requires the **Libraries** module. Repeating those steps explained above, install **Libraries**.

![Dependency for OpenSearchServer](drupal_searchossdependency.png)
 
#### Enabling OpenSearchServer

Check the box for the "Search API OpenSearchServer" module then click on "Save configuration". 

![Enable OpenSearchServer](drupal_searchossenable.png)

On the next page, click on the "Continue" button.
 
![Enable OpenSearchServer](drupal_searchossenable2.png)
 
### Installing OpenSearchServer's PHP library

Download version 1 of OpenSearchServer's PHP library there -  [https://github.com/jaeksoft/opensearchserver-php-client/archive/1.x.zip](https://github.com/jaeksoft/opensearchserver-php-client/archive/1.x.zip).

Unzip it to `/sites/all/libraries` and rename the folder from `opensearchserver-php-client-1.x` to `opensearchserver`.

**Duly note that** the destination folder is **`/sites/all/libraries`**, not `/sites/all/modules/libraries`.


---

Installation is over! It's time for [some configuration](configuring.md).
{'fraction_non_alphanumeric': 0.09460090244281935, 'fraction_numerical': 0.002178310253617551, 'mean_word_length': 5.007476635514019, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 4, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4551195', 'n_tokens_mistral': 1776, 'n_tokens_neox': 1708, 'n_words': 737}