Gestire i componenti di ricerca in SharePoint Server

 

**Si applica a:**SharePoint Server 2013, SharePoint Server 2016

**Ultima modifica dell'argomento:**2017-09-08

Sintesi: informazioni su come utilizzare Windows PowerShell per gestire i componenti di ricerca in una topologia di ricerca esistente con contenuto nell'indice di ricerca di SharePoint Server. Utilizzare queste procedure per implementare la scalabilità orizzontale o verticale per la topologia di ricerca dell'applicazione del servizio di ricerca.

Le procedure e gli esempi in questo articolo presuppongono che SharePoint ServerSharePoint Server 2016 e l'applicazione del servizio di ricerca siano installati e che sia presente una topologia di ricerca esistente ed elementi 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.

Contenuto dell'articolo:

• Prima di iniziare

• Avviare un'istanza del servizio di ricerca in un server

• Recuperare la topologia di ricerca attiva

• Clonare la topologia di ricerca attiva

• Aggiungere un componente di ricerca

• Rimuovere un componente di ricerca

• Spostare un componente di ricerca

• Attivare una topologia di ricerca

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

Per le procedure descritte in questo articolo viene utilizzato Microsoft PowerShell. È possibile eseguire i comandi di Microsoft PowerShell in qualsiasi server della farm. Se tuttavia si stanno eseguendo più procedure relative a una topologia di ricerca, utilizzare la stessa SharePoint 2016 Management Shell 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, oppure 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 
   

   È necessario utilizzare 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 : 25/01/2016 03:06:00 State : Attivo ComponentCount : 6

Recuperare un elenco dei componenti di ricerca

Per visualizzare l'elenco dei componenti di ricerca nella topologia di ricerca attiva, con le relative proprietà, è necessario utilizzare Microsoft PowerShell. Una delle proprietà dei componenti di ricerca è l'ID. Sarà necessario solo tale ID 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 è già aperta una SharePoint 2016 Management Shell in cui sono stati creati riferimenti a oggetti di SharePoint Management Shell 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
   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 sarà possibile fare riferimento con $clone se si continua a utilizzare la stessa SharePoint Management Shell per aggiungere o rimuovere 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

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:

   • <SearchComponent> è il nome del tipo di componente di ricerca da aggiungere.

   • $clone è la topologia clonata che si desidera modificare. Vedere Clonare la topologia di ricerca attiva.

   • $<host n> è il riferimento all'oggetto di PowerShell per l'istanza del servizio di ricerca in esecuzione nel server in cui si desidera aggiungere il componente di ricerca. Vedere Avviare un'istanza del servizio di ricerca in un server.

   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

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 di Amministrazione centrale oppure eseguire il cmdlet Get-SPEnterpriseSearchStatus di Windows PowerShell.

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

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

   Dove:

   • <Search component id> è l'ID del componente di ricerca che si desidera rimuovere. Utilizzare l'ID derivante dalla topologia clone. Per recuperare l'ID del componente di ricerca, vedere il passaggio 4 in Clonare la topologia di ricerca attiva.

   • $clone è la topologia clonata che si desidera modificare. Vedere Clonare la topologia di ricerca attiva.

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 di Amministrazione centrale oppure eseguire il cmdlet Get-SPEnterpriseSearchStatus di 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:

   • $clone è la topologia clonata che si desidera modificare. Vedere Clonare la topologia di ricerca attiva.

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.