====== Installation du serveur Scrutari ======

La compilation du code et l'installation de Scrutari sont décrites dans [[https://framagit.org/Scrutari/scrutari|le dépôt du logiciel]]

Pour la compréhension de la suite, il est important de rappeler que pour fonctionner Scrutari a besoin qu'on lui indique deux répertoires distincts :

  * le répertoire de configuration
  * le répertoire des données

Toute la configuration de Scrutari se fait via des fichiers contenus dans le répertoire de configuration et ses sous-répertoires. L'interface d'administration du logiciel permet de vérifier la validité de la configuration mais pas de la modifier.

===== Fichier conf.xml =====

Le fichier conf.xml de configuration globale doit être placé directement dans le répertoire de configuration. Il n'est pas obligatoire, Scrutari peut fonctionner sans. Le terme ''Configuration globale'' permet de distinguer la configuration de l'application Scrutari de la configuration propre à chaque moteur.

Le fichier XML de configuration globale a comme racine l'élément !!<-conf>!!qui contient les éléments suivants :

  * un élément optionnel !!<canonical-url>!! indiquant l'url à utiliser lorsque l'adresse du moteur doit être transmise (par exemple, la version http et la version https peuvent fonctionner l'une et l'autre indépendemment  mais on transmettra de préférence la version https)
  * un élément optionnel !!<default-lang>!! indiquant la langue à utiliser par défaut pour l'interface

Voici l'exemple de l'instance de Scrutari servant entre autres à la Coredem :

<code xml>
<conf>
    <canonical-url>https://sct1.scrutari.net/sct/</canonical-url>
    <default-lang>fr</default-lang>
</conf>
</code>



===== DTD du fichier de configuration globale =====


<code xml>
<!ELEMENT conf (canonical-url?, default-lang?)>

<!ELEMENT canonical-url (#PCDATA)>

<!ELEMENT default-lang (#PCDATA)>

</code>


===== Problème de codage des caractères =====

Suivant la configuration de Tomcat, il peut arriver que les caractères accentuées ne passent pas au moment d'une requête. Dans ce cas, il faut rajouter dans le fichier de configuration ''server.xml'' de Tomcat l'attribut ''URIEncoding'' avec la valeur UTF-8 :

<code xml>
<Connector URIEncoding="UTF-8" connectionTimeout="20000" port="8080" protocol="HTTP/1.1" ...>
</code>

S'il n'est possible de changer cet attribut (conflit avec une autre application hébergée par exemple), il faut désactiver dans le fichier ''web.xml'' de Scrutari la définition du filtre SetCharacterEncodingFilter :

<code xml>
<!--<filter>
        <filter-name>SetCharacterEncodingFilter</filter-name>
        <filter-class>net.mapeadores.util.servlets.SetCharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>SetCharacterEncodingFilter</filter-name>
        <servlet-name>Scrutari</servlet-name>
    </filter-mapping>-->
</code>