Installation du serveur Scrutari

La compilation du code et l'installation de Scrutari sont décrites dans 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.

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 :

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

<!ELEMENT conf (canonical-url?, default-lang?)>
 
<!ELEMENT canonical-url (#PCDATA)>
 
<!ELEMENT default-lang (#PCDATA)>

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 :

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

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 :

<!--<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>-->