Doc produitsMenu

Première installation de Coveo .NET Front-End

Si vous installez les composantes de Coveo .NET Front-End pour la première fois dans un serveur, le programme d'installation a automatiquement accès à la page de recherche à la fin du processus d'installation. La page Web Configuration du serveur d'interfaces semble vous permettre de compléter la première configuration de Front-End.

En tant qu’administrateur Coveo, vous pouvez également accéder à la page Configuration du serveur d'interface encore une fois plus tard à partir du menu En faire plus de l'interface de recherche (voir Contenu du menu En faire plus), ou en utilisant l'URL suivante :

http://[MyCoveoFrontEndServer]:8080/Coveo/FirstTimeSetup/default.aspx

Note : L'URL utilisée afin d'accéder à la page Configuration du serveur d'interfaces est également utilisée afin de définir automatiquement l'URL de pré-chargement dans le serveur d'index. L'URL de préchargement est utilisée afin de réchauffer la page de recherche du serveur d'interface, éliminant ainsi les excès de temps d'attente pour les utilisateurs finaux.

Si les composantes des serveurs d'interface et d'index sont installées sur différents serveurs, utilisez, si vous pouvez, une URL de recherche que le serveur d'index peut résoudre pour accéder à la page Configuration du serveur d'interface et définir correctement l'URL de pré-chargement.

Exemple : Utilisez http://MyCoveoSearchServer:8080 plutôt que http://localhost:8080.

Sinon, un avertissement apparaît (Back-End and Front-End components appear to be installed on separate servers. You may need to change the default pre-loading search page URL from the Administration Tool in the Configuration > Pre-loading page.). Vous pouvez alors facilement modifier l'URL de pré-chargement de façon manuelle (voir Pré-chargement d'une page de recherche afin d'empêcher les délais d'affichage).

Dans la page Configuration du serveur d'interfaces, vous devez fournir des paramètres de connexion de l'administrateur afin de configurer le serveur d'index que ce serveur d'interface utilise afin d'envoyer des requêtes et de recevoir des résultats de recherche. Vous pouvez également sélectionner ou créer le certificat de sécurité de la recherche nécessaire pour sécuriser la connexion entre les processus d'interface et d'index (voir À propos du certificat de sécurité de la recherche).

Si l'interface de recherche Coveo est installée dans un serveur qui utilise Claims afin d'authentifier les utilisateurs (comme un serveur SharePoint), vous devez également fournir des paramètres Claims.

Note : Vous pouvez obtenir de l'assistance pour Claims dans Coveo.Net Front-End 12.0.49+ et CES 7.0.4855+.

Pour effectuer la première configuration de Coveo .NET Front-End

  1. Dans la page Configuration du serveur d'interfaces (Front-End Server Configuration), la section Paramètres du serveur d'interfaces (Front-End Server Settings) n'apparaît que si l'utilisateur présent ne possède pas de permissions d'administrateur dans le serveur d'interface.

    Exemple : La section Paramètres du serveur d'interfaces apparaît si vous accédez à la page Configuration du serveur d'interfaces d'une interface de recherche Coveo installée dans un serveur SharePoint qui utilise Claims afin d'authentifier les utilisateurs.

    1. Dans les boîtes Nom d'utilisateur (Username) et Mot de passe (Password), tapez les paramètres de connexion d'un compte d'administrateur dans le serveur d'interface afin de pouvoir sauvegarder la configuration effectuée dans cette page.

    2. Cliquez sur Login.

  2. Dans la section Paramètres du serveur Coveo Enterprise Search (Coveo Enterprise Search Server Settings) qui apparaît :

    1. Dans la section Information de connexion (Connection Information) :

      1. Dans la boîte Nom de serveur (Hostname), saisissez le nom du serveur maître de Coveo, où Coveo Enterprise Search (CES) est installé.

        Si la composante de Coveo Front-End est installée sur le même serveur que le serveur maître Coveo, vous pouvez utiliser localhost. Lorsqu'ils sont dans des serveurs différents, saisissez le nom du serveur maître de Coveo, même si vous souhaitez connecter ce serveur d'interface à un serveur miroir (vous le sélectionnerez le serveur miroir plus tard dans cette page).

      2. Si votre serveur maître Coveo utilise un service de recherche web de Coveo autre que celui par défaut (52810), agrandissez la section Configuration avancée et, dans le Port des services, saisissez la valeur appropriée (voir À propos du service de recherche Web Coveo).

        Note : Ne confondez pas ce port avec le port de service CES (voir À propos du port de service CES). Le Front-End utilise Coveo Search Web Service afin d'obtenir du serveur d'index davantage d'informations sur la configuration, dont le port de service (52800 par défaut) que l'interface de recherche utilisera afin de communiquer avec le serveur.

      3. Cliquez sur Valider l'information du serveur.

        Si la connexion a été établie, un indicateur vert () apparaît à côté du bouton.

        Si la connexion ne peut être complétée, un indicateur rouge et un message ( Information de serveur invalide) apparaissent à côté du bouton, et un message d'erreur apparaît dans la section supérieure de la page. Dans ce cas, ajustez l'information de connexion et réessayez.

    2. Dans la section Paramètres de connexion d'administrateur (Administrator Credentials) qui apparaît :

      1. Dans les boîtes Username et Password, saisissez les paramètres de connexion d'un compte d'administrateur Coveo pour le serveur maître (Index) de Coveo.

      2. Dans la liste déroulante Fournisseur (Provider), sélectionnez le fournisseur de sécurité qui peut valider ces paramètres de connexion d'utilisateur, fort probablement Active Directory.

      3. Cliquez sur Login.

  3. Dans la section Configurations du miroir (Mirror Settings) :

    • Lorsque votre implémentation de Coveo ne contient pas de serveurs miroirs :

      Sélectionnez l'option Sélectionner un miroir (Select a mirror), puis dans la boîte déroulante, laissez Par défaut (Default).

    • Lorsque votre implémentation de Coveo contient un ou plusieurs serveur miroir :

      Vous pouvez décider vers quel serveur miroir ce serveur d'interface envoie des requêtes.

      Exemple : Si vous souhaitez libérer le serveur maître de la gestion des requêtes, vous pouvez plutôt lier le Front-End à un serveur miroir.

      Astuce : Si vous avez au moins deux serveurs d'interface Coveo, vous pouvez les configurer, plus tard, dans un groupe d'équilibrage de charge réseau (voir Configuration de serveurs Coveo dans un groupe d'équilibrage de charge réseau).

      • Sélectionnez l'option Sélectionner un miroir (Select a mirror), puis dans la boîte déroulante, sélectionnez le miroir vers lequel vous souhaitez que ce serveur d'interface envoie les requêtes.

        OU

      1. Lorsque vous avez configuré votre serveur miroir pour qu'il utilise un port de service CES autre que celui par défaut (52800), sélectionnez l'option Configurer le miroir manuellement (Configure mirror manually).

      2. Dans la boîte Nom de l'hôte du miroir (Mirror Hostname), saisissez le nom d'hôte du miroir. Sinon, saisissez le même nom de machine que dans Nom de serveur.

      3. Dans la boîte Port du miroir (Mirror Port), saisissez le port que votre serveur miroir utilise (voir À propos du port de service CES).

  4. Si l'interface de recherche Coveo est installée sur un serveur comme SharePoint qui utilise Claims afin d'authentifier les utilisateurs, dans la section Paramètres d'authentification Claims (Claims-Based Authentication Settings) qui apparaît :

    1. Dans la liste déroulante Fournisseur de sécurité Claims (Claims Security Provider), sélectionnez le fournisseur de sécurité Claims que vous avez créé pour ce serveur d'interface Claims

      Exemple : Vous pourriez indexer du contenu à partir d'un serveur SharePoint Claims sur site et aussi de SharePoint Online. Vous devez créer un fournisseur de sécurité Claims pour chacune de ces instances SharePoint.

      Note : Le message suivant apparaît lorsqu'aucun fournisseur de sécurité Claims n'est disponible (voir Fournisseurs de sécurité à utiliser):

      Un fournisseur de sécurité Claims est nécessaire, ajoutez-en un avec l'Outil d'administration.

    2. Dans la liste déroulante Fournisseur de sécurité Active Directory (Active Directory Security Provider), sélectionnez le fournisseur de sécurité Active Directory à utiliser.

      Note : Le message An Active Directory Security Provider is required, add one with the Administration Tool. apparaît si aucun fournisseur de sécurité AD n'est disponible (voir Configuration d'un fournisseur de sécurité Active Directory).

    3. Dans la liste Type de Claim qui contient les utilisateurs Active Directory :

      • Si vous souhaitez que les utilisateurs finaux puissent rechercher des documents provenant d'autres sources analysées dans un environnement Active Directory, sélectionnez le Type de la Claim (Claim Type) à utiliser pour résoudre une identité Active Directory d'une identité Claims. Vous devez sélectionner un Type de Claim qui contient une Valeur de Claim sous la forme MyDomain\UserName ou UserName@MyDomain.com. Seul le Type de Claim est sauvegardé et utilisé afin d'obtenir la Valeur de Claim pour chaque utilisateur lorsqu'ils effectuent des requêtes.

      • Si les utilisateurs finaux ne peuvent rechercher que des documents protégés par Claims, vous pouvez sélectionner (Aucun) (None).

  5. Dans la section Paramètres de certificat de recherche (Search Certificate Settings) qui apparaît :

    1. Pour Sélectionner ou créer le certificat de recherche à utiliser pour être autorisé à communiquer avec le serveur d'index (Select or create the search certificate to use to be trusted when communicating with the Back-End server) sélectionnez l'une des options suivantes :

      Utiliser le certificat par défaut (Use the default certificate)

      Le certificat par défaut fait confiance à tous ceux qui ont accès à l'interface de recherche, et le serveur d'interface peut être n'importe quelle machine (n'importe quelle adresse IP).

      Utiliser un certificat existant (Use an existing certificate)

      Lorsque vous avez déjà créé un ou plusieurs certificats de sécurité de la recherche dans le serveur d'index, sélectionnez le certificat souhaité dans la liste qui apparaît.

      Créer un nouveau certificat (Create a new certificate)

      Utilisez cette option afin de créer un certificat qui ne fait confiance qu'à des utilisateurs et/ou groupes spécifiques et à des serveurs avec des adresses IP spécifiques.

    2. Si vous sélectionnez Créer un nouveau certificat (Create a new certificate), utilisez les paramètres qui apparaissent afin de générer le certificat :

      • Dans la boîte Nom (Name), saisissez un nom pour votre nouveau certificat de sécurité de la recherche.

      • Dans la section Utilisateurs/groupes approuvés (Trusted Users/Groups), vous pouvez, si vous le désirez, définir les utilisateurs approuvés :

        1. Sélectionnez Utilisateurs et/ou groupes spécifiques (Specific user and/or groups) si vous souhaitez que ce certificat n'approuve que des utilisateurs spécifiques.

        2. Dans la boîte Nom, tapez le nom d'un utilisateur ou d'un groupe qui sera approuvé.

        3. Dans la liste déroulante Type, sélectionnez si le nom est pour un utilisateur ou pour un groupe.

        4. Dans la liste déroulante Fournisseur (Provider), sélectionnez le fournisseur de sécurité dans lequel cet utilisateur ou ce groupe est défini.

        5. Cliquez sur Ajouter.

          L'utilisateur ou le groupe spécifié apparaît dans la liste.

        6. Si vous souhaitez ajouter d'autres utilisateurs ou groupes approuvés, répétez les étapes précédentes.

      • Dans la section Serveurs d'interface approuvés (Trusted Front-End Servers), définissez l'adresse IP d'un ou de plusieurs serveurs d'interface qui seront approuvés par le serveur d'index :

        1. Sélectionnez Adresses IP spécifiques (Specific IP addresses) si vous souhaitez que ce certificat n'approuve que certaines machines spécifiques.

        2. Dans la boîte Adresse IP (IP address), tapez une adresse IP qui sera approuvée.

        3. Cliquez sur Ajouter.

          L'adresse IP spécifiée apparaît dans la liste.

        4. Si vous souhaitez ajouter d'autres serveurs d'interface approuvés, répétez les étapes précédentes.

  6. Dans la section Search Analytics Settings, vous pouvez facultativement configurer ce serveur d'interface de recherche pour qu'il envoie des informations sur l'utilisation de la recherche à une base de données locale et/ou au service de nuage Coveo Usage Analytics pour pouvoir, plus tard, évaluer des données d'utilisation de la recherche :

    Note : CES 7.0.7711+ (juin 2015) Soutien pour l’envoi d’analytiques au service nuage Analytiques de Coveo.

    1. Lorsque vous avez accès à un module local déployé d'Analytiques de Coveo (voir Module Analytiques sur site), dans la section On-Premise Analytics Module :

      1. Cochez Activer.

      2. Dans la boîte Database Connection String, saisissez la chaîne de connexion de la base de données de votre modèle Analytiques.

      3. Cliquez sur Test pour valider la chaîne.

    2. Coveo .NET Front-End 12.0.1242+ (juin 2015) Lorsque vous avez accès au service de nuage Usage Analytics de Coveo (voir À propos du service nuage d’Analytiques), dans la section Cloud Platform :

      1. Cochez Activer.

      2. Selon votre installation, sélectionnez l’une des cases d’option suivantes :

        • Dans une installation autre que NLB (Network Load Balancing), sélectionnez la case d’option Push usage analytics information directly to the Coveo Usage Analytics cloud service.

        • Dans une installation NLB (Network Load Balancing), sélectionnez la case d’option Push usage analytics information directly to the Coveo Usage Analytics cloud service dans un serveur.NET Front-End, et la case d’option Delegate pushing usage analytics information to another Coveo .NET Front-End NLB server dans le ou les autre(s).

          Notes :

          • Pour les environnements à haut volume, la meilleure pratique consiste à établir un serveur.NET Front-End distinct, à l’extérieur de NLB, et dont la seule responsabilité est de placer des événements dans le service de nuage.

          • L’URI du (des) Front-End dans lesquels la case d’option Delegate pushing usage analytics information to another Coveo .NET Front-End NLB server est sélectionné devrait pointer vers le Front-End qui place les événements dans le service de nuage.

      3. Selon la case d’option que vous sélectionnez :

        • Lorsque vous sélectionnez la case d'option Push usage analytics information directly to the Coveo Usage Analytics cloud service, dans le champ API Key, saisissez la clé d’API à utiliser pour appeler le point de terminaison Usage Analytics REST, puis cliquez sur Test pour valider le point de terminaison.

          Note : Contactez Assistance Coveo pour obtenir une clé d’API.

        • Lorsque vous sélectionnez la case d'option Delegate pushing usage analytics information to another Coveo .NET Front-End NLB server, dans le champ, entrez URL of the Coveo .NET Front-End to delegate pushing usage analytics information to dans la forme  suivante :

          http://[CoveoFrontEndServer]:8080/PushCloudAnalyticsInfo.aspx

  7. Cliquez sur Apply Settings.

  8. Activez le Front-End qui place les informations d’UA dans le service de nuage Coveo Usage Analytics afin d’enregistrer les erreurs dans un dossier de votre choix :

    Note : Les journaux d’erreurs sont un bon point de départ pendant les enquêtes sur les problèmes.

    1. À l’aide d’un éditeur de texte, ouvrez le fichier Web.config (par défaut C:\Program Files\Coveo .NET Front-End 12\Web.config).

    2. Dans le fichier, ajoutez le paramètre logFolder (en rouge) dans la section analytics comme suit :

      <analytics enabled="False" connectionString="Data Source=yourServerName;Initial Catalog=CoveoAnalytics;Integrated Security=SSPI;" cloudEnabled="True" logFolder="D:\[folderPath]" platformEndpoint="" analyticsEndpoint="https://usageanalyticsdev.coveo.com/rest/v13" accessToken="YOURACCESSTOKEN" analyticsCloudDelegateUri="http://YOURHOSTNAME:8080/PushCloudAnalyticsInfo.aspx" analyticsCloudDelegateEnabled="False" />

La première configuration est terminée et l'interface de recherche par défaut apparaît.

Prochaines étapes?

Vous pouvez maintenant personnaliser ou créer des hubs de recherche et des interfaces de recherche à l'aide de l'Éditeur d'interface (voir Éditeur d’interface de Coveo .NET Front-End).