Gestire i componenti di ricerca in SharePoint Server

SI APPLICA A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

Le procedure e gli esempi in questo articolo presuppongono che SharePoint ServerSharePoint Server e l'applicazione del servizio di ricerca siano installati e che sia presente una topologia di ricerca ed elementi esistenti nell'indice di ricerca di SharePoint Server. Se SharePoint Server e l'applicazione del servizio di ricerca vengono installati di recente e non sono presenti elementi nell'indice di ricerca di SharePoint Server, seguire le procedure illustrate in Modificare la topologia di ricerca predefinita in SharePoint Server.

Le procedure illustrate in questo articolo si applicano ai componenti di ricerca seguenti:

  • Componente di elaborazione dei dati analitici

  • Componente di elaborazione del contenuto

  • Componente di ricerca per indicizzazione

  • Componente di amministrazione delle ricerche

  • Componente di elaborazione delle query

Per informazioni sulle procedure per la gestione del componente di indicizzazione, vedere Gestire il componente di indicizzazione in SharePoint Server.

Prima di iniziare

Prima di iniziare, verificare i prerequisiti seguenti.

  • È necessario che sia stato installato SharePoint Server e che sia stata creata un'applicazione del servizio di ricerca con una topologia di ricerca. L'applicazione del servizio di ricerca deve funzionare correttamente e non deve essere sospesa per alcun motivo.

  • L'account utente utilizzato per eseguire le procedure illustrate in questo articolo deve essere membro del gruppo Amministratori farm.

  • Si è pianificata una topologia di ricerca di destinazione.

  • SharePoint Server deve essere installato in tutti i server in cui si desidera ospitare i componenti di ricerca. I server vengono aggiunti alla farm e si diventa amministratori per tutti questi server. È possibile creare nuovi server applicazioni o definire server applicazioni in una distribuzione esistente.

Importante

[!IMPORTANTE] Per le procedure descritte in questo articolo viene utilizzato Microsoft PowerShell. È possibile eseguire i comandi di Microsoft PowerShell in qualsiasi server della farm. Tuttavia, se si eseguono più procedure di topologia di ricerca, è necessario usare la stessa Shell di gestione di SharePoint per tutti i comandi di Microsoft PowerShell in modo da poter condividere i riferimenti agli oggetti di Microsoft PowerShell tra i comandi.

Avviare un'istanza del servizio di ricerca in un server

Prima di aggiungere i componenti di ricerca a un nuovo server, è necessario innanzitutto avviare un'istanza del servizio di ricerca nel server. Tale istanza avvia tutti i servizi Windows necessari che vengono utilizzati dal servizio di ricerca (OSearch16 e SPSearchHostController).

Per avviare un'istanza del servizio di ricerca

  1. Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.

  2. Avviare SharePoint Management Shell in uno dei server della farm.

  3. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

    $<host n > = Get-SPEnterpriseSearchServiceInstance -Identity "<Server name>"
    Start-SPEnterpriseSearchServiceInstance -Identity $<host n >
    

    Dove:

    • $ <host n> specifica il riferimento all'oggetto di PowerShell per l'istanza del servizio di ricerca.

    • <Server name> specifica il server in cui si desidera aggiungere un componente di indicizzazione. L'input deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un server (ad esempio , myserver1 ) o un'istanza di un oggetto SearchServiceInstance valido.

    Ad esempio:

    $hostA = Get-SPEnterpriseSearchServiceInstance -Identity "myserver1"
    $hostB = Get-SPEnterpriseSearchServiceInstance -Identity "myserver2"
    Start-SPEnterpriseSearchServiceInstance -Identity $hostA
    Start-SPEnterpriseSearchServiceInstance -Identity $hostB 
    
    

    Usare i riferimenti ($<host n>) per specificare il server di destinazione quando si aggiungono componenti di ricerca.

  4. Attendere che siano in esecuzione tutte le istanze del servizio di ricerca. Per ognuna di tali istanze, al prompt dei comandi di Microsoft PowerShell digitare il comando seguente e attendere che venga restituito lo stato Online:

    Get-SPEnterpriseSearchServiceInstance -Identity $<host n >
    
    

    Ad esempio:

    Get-SPEnterpriseSearchServiceInstance -Identity $hostA
    TypeName    : SharePoint Server Search
    Description : Index content and serve search queries
    Id          : 82ce8815-ecbd-4cf3-a98e-33f20bd86039
    Server      : SPServer Name=myserver1.example.com
    Service     : SearchService Name=OSearch16
    Role        : None
    Status      : Online
    
    

Recuperare la topologia di ricerca attiva

Per visualizzare la topologia di ricerca attiva dell'applicazione del servizio di ricerca, è necessario utilizzare Microsoft PowerShell.

Per visualizzare la topologia di ricerca attiva

  1. Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.

  2. Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.

  3. Al prompt dei comandi di Microsoft PowerShell digitare il comando seguente:

    $ssa = Get-SPEnterpriseSearchServiceApplication
    $active = Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa 
    $active
    

Questo comando restituisce informazioni sulla topologia attiva, ad esempio:TopologyId : 2d7bb046-1ad4-43a9-9984-754c4551a3ec CreationDate : 1/25/2016 3:06:00 AM State : Active ComponentCount : 6

Recuperare un elenco dei componenti di ricerca

Per visualizzare un elenco di componenti di ricerca nella topologia di ricerca attiva con le relative proprietà, è necessario usare Microsoft PowerShell. Una delle proprietà del componente di ricerca è l'ID del componente di ricerca. Sarà necessario solo l'ID del componente di ricerca per rimuovere un componente di ricerca.

Per visualizzare l'elenco di tutti i componenti di ricerca

  1. Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.

  2. Avviare una SharePoint Management Shell. Se si dispone già di una Shell di gestione SharePoint aperta in cui sono stati creati riferimenti a oggetti di SharePoint Management Shell riutilizzabili, usare invece la shell aperta.

  3. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

    $ssa = Get-SPEnterpriseSearchServiceApplication
    $active = Get-SPEnterpriseSearchTopology -SearchApplication $ssa -Active
    Get-SPEnterpriseSearchComponent -SearchTopology $active
    

    Il comando restituisce un elenco dei componenti di ricerca nella topologia di ricerca attiva con le relative proprietà.

Clonare la topologia di ricerca attiva

Per apportare qualsiasi modifica alla topologia di ricerca in un'installazione di ricerca con elementi nell'indice di ricerca, è necessario innanzitutto creare un nuovo oggetto topologia. È possibile modificare tale nuovo oggetto, che è un clone della topologia attiva, aggiungendo o rimuovendo componenti di ricerca. Dopo aver apportato le modifiche all'oggetto topologia clone, è possibile impostare il clone come topologia attiva.

Per clonare la topologia attiva

  1. Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.

  2. Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.

  3. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

    $ssa = Get-SPEnterpriseSearchServiceApplication
    $active = Get-SPEnterpriseSearchTopology -SearchApplication $ssa -Active
    $clone = New-SPEnterpriseSearchTopology -SearchApplication $ssa -Clone -SearchTopology $active
    

    Il comando crea una topologia di ricerca clone a cui è possibile fare riferimento con $clone se si continua a usare la stessa Shell di gestione di SharePoint per aggiungere o rimuovere i componenti di ricerca e per attivare la topologia di ricerca.

  4. (Facoltativo) Se si desidera rimuovere componenti di ricerca dalla topologia di ricerca, è necessario recuperare l'ID di tali componenti. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

    Get-SPEnterpriseSearchComponent -SearchTopology $clone
    

    Il comando restituisce un elenco dei componenti di ricerca nella topologia di ricerca clonata con le relative proprietà, incluso l'ID di tali componenti.

Aggiungere un componente di ricerca

Non è possibile modificare direttamente la topologia di ricerca attiva. In questa procedura si presuppone che sia stato creato un oggetto topologia clone come illustrato in Clonare la topologia di ricerca attiva. È possibile utilizzare i cmdlet di Microsoft PowerShell seguenti per ogni componente di ricerca:

  • New-SPEnterpriseSearchAdminComponent

  • New-SPEnterpriseSearchAnalyticsProcessingComponent

  • New-SPEnterpriseSearchContentProcessingComponent

  • New-SPEnterpriseSearchCrawlComponent

  • New-SPEnterpriseSearchQueryProcessingComponent

Nota

[!NOTA] La procedura per aggiungere un componente di indicizzazione è diversa. Per ulteriori informazioni, vedere Gestire il componente di indicizzazione in SharePoint Server.

Per aggiungere un componente di ricerca

  1. Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.

  2. Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.

  3. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

    New-SPEnterpriseSearch<SearchComponent> -SearchTopology $clone -SearchServiceInstance $<host n >
    

    Dove:

    Ad esempio, il comando seguente aggiunge un componente di elaborazione del contenuto alla topologia clone nel server identificato dal riferimento all'istanza del servizio di ricerca $hostA.

    New-SPEnterpriseSearchContentProcessingComponent -SearchTopology $clone -SearchServiceInstance $hostA
    
  4. Verificare che il nuovo componente di ricerca sia stato aggiunto alla topologia clone. Al prompt dei comandi di Microsoft PowerShell digitare il comando:

    Get-SPEnterpriseSearchComponent -SearchTopology $clone
    

Rimuovere un componente di ricerca

Per rimuovere un componente di ricerca, è necessario utilizzare Windows PowerShell. Non è possibile modificare direttamente la topologia di ricerca attiva. In questa procedura si presuppone che sia stato creato un oggetto topologia clone come illustrato in Clonare la topologia di ricerca attiva.

Nota

[!NOTA] La procedura per rimuovere un componente di indicizzazione è diversa. Per ulteriori informazioni, vedere Gestire il componente di indicizzazione in SharePoint Server.

Per rimuovere un componente di ricerca

  1. Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.

  2. Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.

  3. Verificare che la topologia attiva corrente sia integra e che il componente di ricerca da rimuovere sia Attivo. Visualizzare lo stato della topologia di ricerca nella pagina Amministrazione ricerca in Amministrazione centrale o eseguire il cmdlet Get-SPEnterpriseSearchStatusdi Windows PowerShell.

  4. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

    Remove-SPEnterpriseSearchComponent -Identity <Search component id> -SearchTopology $clone
    

    Dove:

  5. Quando richiesto, confermare che si desidera rimuovere il componente di ricerca.

Spostare un componente di ricerca

Se si desidera spostare un componente di ricerca da un server a un altro, è consigliabile aggiungere un nuovo componente di ricerca alla topologia di ricerca prima di rimuovere il componente di ricerca precedente.

Per spostare un componente di ricerca

  1. Clonare la topologia di ricerca attiva. Vedere Clonare la topologia di ricerca attiva.

  2. Aggiungere un nuovo componente di ricerca al server in cui si desidera poi ospitare il componente. Vedere Aggiungere un componente di ricerca.

  3. Attivare la topologia di ricerca. In questa topologia sarà presente un componente di ricerca superfluo. Vedere Attivare una topologia di ricerca.

  4. Verificare che la topologia attiva corrente sia integra. Visualizzare lo stato della topologia di ricerca nella pagina Amministrazione ricerca in Amministrazione centrale o eseguire il cmdlet Get-SPEnterpriseSearchStatusdi Windows PowerShell.

  5. Clonare di nuovo la topologia di ricerca. Vedere Clonare la topologia di ricerca attiva.

  6. Rimuovere il componente di ricerca superfluo. Vedere Rimuovere un componente di ricerca.

  7. Attivare di nuovo la topologia di ricerca. Vedere Attivare una topologia di ricerca.

Attivare una topologia di ricerca

Per attivare una topologia di ricerca, è necessario utilizzare Windows PowerShell.

Per attivare una topologia di ricerca

  1. Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.

  2. Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.

  3. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:

    Set-SPEnterpriseSearchTopology -Identity $clone
    

    Dove:

  4. Verificare che la nuova topologia sia attiva. Al prompt dei comandi di Windows PowerShell digitare i comandi seguenti:

    Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa
    

    Il comando restituisce una panoramica delle topologie attive e inattive, ad esempio:

    TopologyId     : fce8507d-61c6-4498-8038-4fd2d0a62c6e
    CreationDate   : 1/30/2016 2:52:00 AM
    State          : Inactive
    ComponentCount : 6
    TopologyId     : b63d48b2-df5c-41be-a7f4-9abaee483611
    CreationDate   : 1/30/2016 4:30:00 AM
    State          : Active
    ComponentCount : 7
    

    Si noterà che il conteggio dei componenti della topologia attiva riflette le modifiche apportate.