Doc produitsMenu

Affinement du service de rappel d'Exchange

Pour Microsoft Exchange Server 2007, 2010 et 2013 (sur site et hybride), le connecteur Exchange (WebServices) de Coveo utilise l'API (Application Programming Interface) du service de rappel Microsoft Exchange afin d'exiger des avis d'Exchange si du contenu est modifié dans une boîte de réception contrôlée. Avec ces informations, le connecteur peut immédiatement mettre à jour les bons dossiers et éléments lors de la prochaine actualisation incrémentale, au lieu de rechercher chaque dossier dans chaque boîte de réception. Cette capacité améliore de façon drastique les actualisations incrémentales et réduit l'utilisation de la bande passante. Le programme d'installation de CES (Coveo Enterprise Search) déploie le service de rappel, qui démarre si un connecteur Exchange WebServices le demande. Par défaut, une nouvelle source d'Exchange WebServices est prête à utiliser le service de rappel d'Exchange.

Le paramètre de source Callback Service Url indique l'emplacement du service de rappel d'Exchange (voir Configuration et indexation d'une source Microsoft Exchange).

Important : Veillez à ouvrir le port 8181 dans le pare-feu. Le serveur Exchange doit se connecter au service de rappel d'Exchange afin d'envoyer des avis.

Le service de rappel d'Exchange exige qu'une identité d'utilisateur soit définie sur la source à travailler.

Lorsque une source Exchange WebServices démarre, un message apparaît dans le journal de CES afin de spécifier si le service de rappel Exchange est utilisé ou non, soit parce qu'il ne peut être configuré correctement ou ne peut démarrer.

État du service de rappel Message dans le journal de CES lorsqu'une source Exchange (WebServices) démarre
Utilisé [SourceName] – Using Push Notifications.
Non utilisé Un message d'erreur, suivi par :
[SourceName] – Using Standard Mode.

Le service de rappel d'Exchange est configuré afin de fonctionner correctement dans la plupart des cas, à l'aide des valeurs par défaut des paramètres. Vous pouvez toutefois configurer manuellement les paramètres avancés dans le fichier de configuration du service de rappel d'Exchange afin d'affiner les comportements standards.

Pour affiner le fichier de configuration du service de rappel d'Exchange

  1. Consultez la liste suivantes des paramètres disponibles du fichier de configuration afin de vérifier si vous devez changer la valeur par défaut d'un ou de plusieurs d'entre eux.

    LogFileLifeTime

    Durée avant qu'un fichier journal soit automatiquement supprimé par le service. S'effectue, par défaut, après 30 jours.

    LogMaxSize

    Taille maximale avant de fractionner un fichier journal. Par défaut, 10 Mo (10485760 octets).

    MaxConnections

    Nombre maximal de connexions concurrentes que le service peut créer en appelant Exchange WebServices. Par défaut, 4 connexions.

    ShowAllCounters

    Affiche les statistiques d'utilisation sur le service dans la console CES et les journaux avant chaque actualisation incrémentale. Par défaut, false.

    DataFilePath

    Emplacement des fichiers de données qui sont utilisés par le service. Par défaut, les fichiers de données sont dans le dossier [Index_Path]\Index\Crawlers\EchangeCallbackService.

    LogFilePath

    Emplacement des fichiers journaux créés par le service. Par défaut, les fichiers journaux sont enregistrés dans le même dossier que les autres fichiers journaux de CES ([Index_Path]\Log).

    SubscriptionTimeout

    Durée avant qu'une inscription d'Exchange soit considérée comme étant invalide. Cette valeur ne devrait pas être modifiée, à moins qu'il y ait des problèmes en utilisant la valeur par défaut. Se produit, par défaut, après 30 minutes. La valeur maximale permise est 1440 minutes.

    hostname

    Nom d'hôte utilisé de façon interne afin de générer l'URL du service web. Changer cette valeur affecte directement le paramètre Callback Service Url qui est défini dans une source Exchange. Par défaut, le nom de l'ordinateur.

    PortNumber

    Numéro de port utilisé de façon interne afin de générer l'URL du service Web. Changer cette valeur affecte directement le paramètre Callback Service Url qui est défini dans une source Exchange. Par défaut, 8181.

    ReaderQuotas

    Limites par défaut pour la complexité des messages reçus (voir XmlDictionaryReaderQuotas Class). Peut-être à augmenter lorsque conseillé par Coveo Support afin de veiller à ce de bonnes communications d'Exchange jusqu'au service de rappel.

    Les valeurs par défaut et conseillées sont :

    <readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647" maxArrayLength="2147483647" maxBytesPerRead="2147483647" maxNameTableCharCount="2147483647" />

    Note : Le paramètre readerquotas est disponible à partir de CES 7.0.6607 (avril 2014).

  2. Connectez-vous au serveur maître de Coveo avec un compte d'administrateur.

  3. Naviguez vers le dossier de la corbeille de CES ([CES_Path]\Bin).

  4. À l'aide d'un éditeur de texte :

    1. Ouvrez le fichier CESExchangeCallbackService.exe.config.

    2. Sous <configuration>, dans le contenu du fichier, repérez la section <appSettings>.

    3. Ajoutez un paramètre personnalisé par ligne sous <appSettings> en utilisant le format suivant :

      <add key=”parameter_name” value=”value”>

    4. Enregistrez le fichier.

      Exemple : Pour spécifier un nombre maximal de connexions qui est égal à 6, ajoutez la ligne 4, comme affiché dans l'extrait de fichier suivant.
      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <appSettings>
      	<add key=”MaxConnections” value=”6”>
        </appSettings>
        ...
      </configuration>