Installare o disinstallare il componente aggiuntivo Reporting Services per SharePoint (SSRS)

  • Articolo

Si applica a:✅ SQL Server Reporting Services (2016) ❌ Server di report di Power BI ✅ SharePoint

Eseguire il pacchetto di installazione del componente aggiuntivo Microsoft SQL Server Reporting Services per prodotti SharePoint (rsSharePoint.msi) in server SharePoint, per abilitare le funzionalità di Reporting Services in una distribuzione di SharePoint. Le funzionalità includono Power View, una web part Visualizzatore report, un endpoint proxy dell'URL, tipi di contenuto di Reporting Services e pagine dell'applicazione che consentono di creare, visualizzare e gestire report, origini dati e altri tipi di contenuto del server di report in un sito di SharePoint. Il componente aggiuntivo Reporting Services per prodotti SharePoint è un componente obbligatorio per un server di report eseguito in modalità SharePoint. È possibile installare il componente aggiuntivo mediante l'Installazione guidata di SQL Server 2016 o scaricando rsSharePoint.msi dal Feature Pack di SQL Server 2016. Per un elenco delle versioni del componente aggiuntivo e le pagine di download, vedere Posizione in cui trovare il componente aggiuntivo Reporting Services per prodotti SharePoint.

Nota

L'integrazione di Reporting Services con SharePoint non è più disponibile nelle versioni successive a SQL Server 2016. Il supporto di Power View non è più disponibile dopo SQL Server 2017.

Prerequisiti

L'installazione del componente aggiuntivo Reporting Services rappresenta uno dei diversi passaggi necessari per l'integrazione di un server di report in un'istanza di un prodotto SharePoint. Per altre informazioni sull'installazione e la configurazione di Reporting Services, vedere Installare il primo server di report in modalità SharePoint.

  • Se si integra Reporting Services in una farm di SharePoint in cui sono presenti più applicazioni front-end Web, installare il componente aggiuntivo in ogni computer nella farm in cui è presente un server front-end Web. Installare questo componente aggiuntivo solo per i front-end Web che verranno utilizzati per accedere al contenuto del server di report.

  • Per installare il componente aggiuntivo Reporting Services è necessario essere un amministratore del computer. Se, ad esempio, si eseguirà rsSharePoint.msi al prompt dei comandi, è consigliabile aprire il prompt con i privilegi di amministratore usando l'opzione Esegui come amministratore.

  • Per installare il componente aggiuntivo Reporting Services, è necessario essere un membro del gruppo Administrators della farm di SharePoint.

  • È necessario essere un amministratore della raccolta siti per attivare la funzionalità di integrazione con Reporting Services.

Informazioni sull'installazione del componente aggiuntivo

Il processo di installazione del componente aggiuntivo è costituito da due fasi. Entrambe vengono completate automaticamente al termine di un'installazione standard:

  • La prima fase consiste nell'installazione dei file nelle cartelle appropriate. Si tratta di cartelle standard per le distribuzioni di SharePoint. Uno dei file installati è rsCustomAction.exe.

  • La seconda fase dell'installazione consiste nell'esecuzione di un set di azioni personalizzate che consente di registrare i file di Reporting Services con SharePoint. Le azioni personalizzate vengono eseguite da rsCustomAction.exe. Il file exe viene rimosso al termine dell'installazione in due fasi. È possibile eseguire un'installazione di tipo solo file; in questo caso rsCustomAction.exe non viene eseguito e alla fine dell'installazione rimane sull'unità.

Ordine dell'installazione di Reporting Services

È possibile installare il componente aggiuntivo prima o dopo l'installazione di SharePoint. L'installazione del componente aggiuntivo segue gli standard di pre-distribuzione di SharePoint e installa file nei percorsi utilizzati dall'installazione di SharePoint.

Nota

Il vantaggio di installare il componente aggiuntivo prima dei prodotti SharePoint consiste nel fatto che se alla farm vengono aggiunti nuovi server, il componente aggiuntivo Reporting Services verrà configurato e attivato dalla farm di SharePoint.

Panoramica sui metodi di installazione

È possibile installare il componente aggiuntivo di SQL Server 2016 Reporting Services per prodotti SharePoint mediante uno dei due metodi seguenti:

  • Installazione guidata: in SQL Server 2016 è possibile installare il componente aggiuntivo con l'Installazione guidata di SQL Server. Scegliere Componente aggiuntivo Reporting Services per prodotti SharePoint nella pagina Selezione funzionalità della procedura guidata.

  • rsSharepoint.msi: il file del componente aggiuntivo può essere installato direttamente dal supporto di installazione o scaricato e installato. Il file rsSharepoint.msi supporta sia l'installazione tramite interfaccia utente grafica che quella da riga di comando. È necessario eseguire il file con estensione msi con privilegi di amministratore aprendo innanzitutto una finestra del prompt dei comandi con autorizzazioni elevate ed eseguendo quindi rsSharepoint.msi dalla riga di comando. Per altre informazioni, vedere Posizione in cui trovare il componente aggiuntivo Reporting Services per prodotti SharePoint.

    Nota

    Se si usa l'opzione /q per un'installazione da riga di comando invisibile all'utente, il contratto di licenza con l'utente finale non verrà visualizzato. Indipendentemente dal metodo di installazione, l'utilizzo di questo software è governato da un contratto di licenza e l'utente è tenuto a rispettarlo.

Installare il componente aggiuntivo utilizzando il file di installazione rsSharePoint.msi

In questa sezione vengono fornite informazioni relative all'installazione diretta di rssharepoint.msi, mediante l'installazione guidata msi o un'installazione da riga di comando. Se il componente aggiuntivo è stato installato utilizzando l'installazione guidata di SQL Server, non è necessario effettuare i passaggi riportati di seguito.

È possibile visualizzare un elenco completo di opzioni della riga di comando eseguendo il comando seguente:

Rssharepoint.msi /?

  1. Scaricare il programma di installazione (rsSharepoint.msi) per il componente aggiuntivo Reporting Services. Per altre informazioni, vedere Posizione in cui trovare il componente aggiuntivo Reporting Services per prodotti SharePoint.

  2. Eseguire rsSharepoint.msi come amministratore per avviare l'Installazione guidata. Verranno visualizzati una pagina iniziale, le condizioni di licenza software e una pagina contenente le informazioni per la registrazione. Durante l'installazione, le cartelle vengono create nel percorso indicato di seguito e i file vengono copiati in tali cartelle:

    %program files%\common files\Microsoft Shared\Web Server Extensions\15\ (SharePoint 2013)

    or

    %program files%\common files\Microsoft Shared\Web Server Extensions\16\ (SharePoint 2016)

  3. Nell'Amministrazione centrale SharePoint configurare le impostazioni e l'attivazione delle funzionalità del server di report. Per altre informazioni sull'installazione e la configurazione della modalità SharePoint in Reporting Services, vedere Installare il primo server di report in modalità SharePoint.

Installazione di tipo "solo file"

Per installare i file ignorando la fase di installazione delle azioni personalizzate, eseguire rssharepoint.msi dalla riga di comando con l'opzione SKIPCA.

  1. Aprire un prompt dei comandi con autorizzazioni di amministratore.

  2. Esegui questo comando:

    Msiexec.exe /i rsSharePoint.msi SKIPCA=1

L'interfaccia utente dell'installazione viene visualizzata ed eseguita normalmente. Il file rsCustomAction.exe viene installato. Il file .exe non verrà tuttavia eseguito al termine dell'installazione e rsCustomAction.exe rimane nel computer una volta completata l'installazione.

Utilizzare un'installazione in due passaggi per risolvere i problemi di installazione

Se si verificano errori durante l'installazione, sarà possibile eseguire l'installazione come processo in due passaggi dalla riga di comando:

  1. Aprire un prompt dei comandi con autorizzazioni di amministratore ed eseguire un'installazione di tipo "solo file" come descritto nella sezione precedente.

  2. Eseguire il file eseguibile di azioni personalizzate:

    1. Passare alla cartella contenente il file eseguibile rsCustomAction.exe. Questo file viene copiato nel computer dal programma di installazione di tipo "solo file" del componente aggiuntivo. rsCustomAction.exe si trova nella directory %Temp% . Per passare al file, al prompt dei comandi immettere:

      CD %temp%.

      Il file si trova in: \Users<nome utente>\AppData\Local\Temp

    2. Immettere il comando seguente. Il completamento di questo passaggio di configurazione richiede alcuni minuti. Durante questo processo viene riavviato il servizio W3SVC. Vengono visualizzati diversi messaggi di stato durante la copia dei file, la registrazione dei componenti e l'esecuzione della Configurazione guidata del prodotto SharePoint.

      rsCustomAction.exe /i

    3. La quantità di tempo necessaria per rendere effettive le modifiche varia a seconda dell'ambiente server. È inoltre possibile eseguire iisreset per forzare un aggiornamento più rapido.

Installazione non interattiva per lo scripting

È possibile usare le opzioni /q o /quiet per un'installazione non interattiva durante la quale non verranno visualizzati avvisi o finestre di dialogo. L'installazione non interattiva è utile se si desidera creare uno script dell'installazione del componente aggiuntivo.

Nota

Se si usa l'opzione /q per un'installazione da riga di comando invisibile all'utente, il contratto di licenza con l'utente finale non verrà visualizzato. Indipendentemente dal metodo di installazione, l'utilizzo di questo software è governato da un contratto di licenza e l'utente è tenuto a rispettarlo.

Per eseguire un'installazione non interattiva:

  1. Aprire un prompt dei comandi con autorizzazioni di amministratore.

  2. Esegui questo comando:

    Msiexec.exe /i rsSharePoint.msi /q

Procedura: Rimozione del componente aggiuntivo di Reporting Services

È possibile disinstallare il componente aggiuntivo Reporting Services per prodotti SharePoint dal Pannello di controllo o dalla riga di comando di Microsoft Windows.

  1. Se si usa il Pannello di controllo viene eseguita una disinstallazione completa dei file nel computer corrente E vengono rimossi l'oggetto e le funzionalità di Reporting Services dalla farm di SharePoint. Quando l'oggetto e le funzionalità di Reporting Services vengono rimossi, non è più possibile verificare e aggiornare i report.

  2. Il metodo della riga di comando per disinstallare il componente aggiuntivo consente all'utente di usare il parametro LocalOnly per rimuovere solo i file del componente aggiuntivo dal computer locale, mentre l'oggetto e le funzionalità di Reporting Services nella farm non vengono modificati.

Durante la disinstallazione del componente aggiuntivo vengono rimosse anche le funzionalità di integrazione del server utilizzate per l'elaborazione di report in un server di report. Vengono inoltre rimosse le pagine di Reporting Services da Amministrazione centrale SharePoint e le altre pagine personalizzate di Reporting Services. È possibile rimuovere anche tutti i report e gli altri elementi del server di report non più utilizzati nei siti di SharePoint interessati. Non verranno eseguiti dopo la rimozione del componente aggiuntivo Reporting Services.

Per disinstallare il componente aggiuntivo Reporting Services, è necessario che l'installazione di SharePoint sia ancora in esecuzione. Se prima si disinstalla SharePoint, per disinstallare il componente aggiuntivo Reporting Services sarà necessario reinstallarlo.

Per disinstallare il componente aggiuntivo, è possibile usare la stessa procedura sia nei server autonomi che nelle server farm. Vengono rimossi tutti i file di programma e le impostazioni di configurazione aggiunti durante l'installazione.

La disinstallazione del componente aggiuntivo non comporta la rimozione degli elementi seguenti:

  • Account di accesso creati per l'account del servizio del server di report utilizzato per accedere ai database di configurazione e del contenuto di SharePoint. È necessario eliminare tutti gli account di accesso per l'account del servizio del server di report dall'istanza del motore di database di SQL Server usata per ospitare i database di SharePoint.

  • Autorizzazioni o gruppi creati per gli utenti dei report. Se sono stati creati livelli di autorizzazione personalizzati o gruppi di SharePoint per consentire l'accesso alle funzionalità del server di report, sarà necessario revocare tutte le autorizzazioni non più necessarie.

  • File di dati caricati nelle raccolte di SharePoint, inclusi i file di definizione dei report (con estensione rdl), i file delle origini dati condivise (con estensione sds) e i file degli elementi dei report pubblicati (con estensione rsc). Tali file non vengono eliminati, ma non vengono più eseguiti. I file dovranno essere eliminati manualmente.

  • Il programma di installazione non elimina il database del server di report né modifica l'istanza del server di report usata per le operazioni in modalità integrata.

Eseguire la disinstallazione dal Pannello di controllo di Windows

Per avviare la procedura guidata dal Pannello di controllo di Microsoft Windows e rimuovere il componente aggiuntivo:

  1. In Programminel Pannello di controllo selezionare Disinstalla un programma

  2. Selezionare Componente aggiuntivo Microsoft SQL Server RS per SharePoint. È inoltre possibile avviare la disinstallazione guidata eseguendo rssharepoint.msi dal prompt dei comandi senza opzioni.

  3. Selezionare Rimuovi.

Eseguire la disinstallazione dalla riga di comando

Per disinstallare il componente aggiuntivo dalla riga di comando:

  1. Aprire un prompt dei comandi con autorizzazioni di amministratore.

  2. Esegui questo comando:

    msiexec.exe /uninstall rsSharePoint.msi

  3. Viene visualizzata una finestra di messaggio di conferma. Selezionare Sì.

Disinstallare il componente aggiuntivo solo dal server locale

Con i metodi di disinstallazione del componente aggiuntivo illustrati è possibile rimuovere le funzionalità e l'oggetto Reporting Services dalla farm. Se si dispone di una farm multiserver e si desidera disinstallare il componente aggiuntivo solo dal computer locale lasciando la farm di SharePoint in uno stato funzionale, completare i passaggi seguenti:

  1. Aprire un prompt dei comandi con autorizzazioni di amministratore.

  2. Esegui questo comando:

    Msiexec.exe /uninstall rsSharePoint.msi LocalOnly=1

Questa operazione consente di annullare la registrazione dei componenti di Reporting Services da SharePoint e rimuovere i file ma solo per il computer locale.

Per annullare la registrazione delle funzionalità di Reporting Services da SharePoint senza rimuovere i file dal disco per usarli in un secondo momento, seguire questa procedura:

  1. Aprire un prompt dei comandi con autorizzazioni di amministratore.

  2. Esegui questo comando:

    rsCustomAction.exe /p

I passaggi precedenti presuppongono il completamento di un'installazione del file con estensione msi con SkipCA=1 e la disponibilità del file rscusstomaction.exe. Per altre informazioni, vedere la sezione relativa all'installazione di tipo "solo file".

Procedura di ripristino di rssharepoint.msi dalla riga di comando

Per ripristinare o disinstallare il componente aggiuntivo Reporting Services usando la riga di comando, seguire questa procedura:

  1. Aprire un prompt dei comandi con autorizzazioni di amministratore.

  2. Esegui questo comando:

    msiexec.exe /f rssharepoint.msi

File di log del programma di installazione

Durante l'esecuzione, il programma di installazione registra le informazioni in un file di log nella cartella %temp% per l'utente che ha installato il componente aggiuntivo Reporting Services. Ad esempio, c:\Users\\<username\>\AppData\Local\Temp. Il nome del file è RS_SP_<number>.log, ad esempio RS_SP_0.log. Tutti gli errori nel log iniziano con la stringa "SSRSCustomActionError".

Nota

AppData è una cartella nascosta del sistema operativo Windows. Potrebbe essere necessario modificare le impostazioni delle cartelle di Esplora risorse per poter visualizzare file e cartelle nascosti.

Visualizzare un file di log con il Blocco note di Windows

  1. I comandi seguenti permettono di modificare il percorso del prompt dei comandi, elencare i file di log rs e quindi aprire uno dei file con il Blocco note di Windows:

    cd %temp%  

    Dir rs_sp*.log  

    notepad rs_sp_3.log

Visualizzare un file di log con PowerShell

  1. Immettere il comando seguente nella shell di gestione SharePoint per ottenere un elenco filtrato di righe del file contenenti "ssrscustomactionerror":

    Get-content -path C:\Users\<UserName\AppData\Local\Temp\rs_sp_0.log | select-string "ssrscustomactionerror"

  2. L'output deve essere simile all'esempio seguente:

    2011-05-23 12:40:12: SSRSCustomActionError: SharePoint is installed, but not configured.

Aggiornamento

Se si dispone di un'installazione esistente del componente aggiuntivo di Reporting Services, è possibile eseguire l'aggiornamento alla versione corrente. Durante l'installazione del componente aggiuntivo viene rilevata la versione esistente e viene richiesto di confermare l'aggiornamento. Il messaggio dovrebbe essere simile all'esempio seguente:

Sul sistema è stata rilevata una versione precedente di questo prodotto. Aggiornare l'installazione esistente?

In caso di conferma, la versione precedente del componente aggiuntivo viene rimossa e viene quindi installata la nuova versione.

Il componente aggiuntivo Reporting Services non è specifico dell'istanza. In un computer è possibile installare una sola istanza del componente aggiuntivo. Non è consentita l'esecuzione affiancata di versioni differenti con la versione corrente.

rsCustomAction.exe

Nella tabella seguente vengono riepilogate le opzioni di rscustomaction.exe:

Switch Descrizione
i Installazione delle azioni personalizzate. Questa azione registra i componenti di Reporting Services in SharePoint. W3SVCservice viene riavviato.
r Riparazione
u Disinstalla. Consente di annullare la registrazione dei componenti di Reporting Services dall'intera farm di SharePoint, senza rimuovere i file dal disco. W3SVCservice viene riavviato.
p Disinstallazione locale. Consente di annullare la registrazione dei componenti di Reporting Services unicamente dal computer locale. I file non vengono rimossi dal disco. W3SVCservice viene riavviato.
t Solo SQL Server Reporting Services 2005. L'opzione consente di verificare se il server di report dispone di una connessione funzionante al database del server di report.

Configurare Reporting Services

Una volta installato il componente aggiuntivo in tutti i computer necessari, è necessario configurare il server di report da Amministrazione centrale SharePoint. I passaggi necessari dipendono dall'ordine con il quale sono state installate le diverse tecnologie. Per altre informazioni, vedere Installare il primo server di report in modalità SharePoint e Server di report di Reporting Services (Modalità SharePoint)

Contenuto correlato

Altre domande? Visitare il forum su Reporting Services.