De Reporting Services-invoegtoepassing voor SharePoint (SSRS) installeren of verwijderen

Van toepassing op: SQL Server Reporting Services (2016) Power BI Report Server SharePoint

Voer het installatiepakket microsoft SQL Server Reporting Services-invoegtoepassing uit voor SharePoint-producten (rsSharePoint.msi) op SharePoint-servers om Reporting Services-functies in te schakelen binnen een SharePoint-implementatie. Functies zijn Power View, een webonderdeel Rapportviewer, een URL-proxy-eindpunt, Reporting Services-inhoudstypen en toepassingspagina's, zodat u rapporten, gegevensbronnen en andere rapportserverinhoud op een SharePoint-site kunt maken, weergeven en beheren. De Reporting Services-invoegtoepassing voor SharePoint-producten is een vereist onderdeel voor een rapportserver die wordt uitgevoerd in de SharePoint-modus. De invoegtoepassing kan worden geïnstalleerd via de installatiewizard van SQL Server 2016 of door de rsSharePoint.msi te downloaden uit het onderdelenpakket van SQL Server 2016. Voor een lijst met de versies van de invoegtoepassing en downloadpagina's, zie Waar u de Reporting Services-invoegtoepassing voor SharePoint-producten kunt vinden.

Vereiste voorwaarden

Het installeren van de Reporting Services-invoegtoepassing is een van de verschillende stappen die nodig zijn voor het integreren van een rapportserver met een exemplaar van een SharePoint-product. Zie De eerste rapportserver installeren in de SharePoint-modus voor meer informatie over het installeren en configureren van Reporting Services.

• Als u Reporting Services integreert met een SharePoint-farm met meerdere web-front-endtoepassingen, installeert u de invoegtoepassing op elke computer in de farm met een front-end voor webservers. Installeer deze invoegtoepassing alleen voor webfront-ends die worden gebruikt voor toegang tot inhoud van de rapportserver.

• Als u de Reporting Services-invoegtoepassing wilt installeren, moet u een beheerder op de computer zijn. Als u bijvoorbeeld de rsSharePoint.msi wilt uitvoeren bij de opdrachtprompt, moet u de opdrachtprompt met beheerdersbevoegdheden openen met behulp van de optie Als administrator uitvoeren .

• Als u de Reporting Services-invoegtoepassing wilt installeren, moet u lid zijn van de groep Administrators van de SharePoint-farm.

• U moet een beheerder van de siteverzameling zijn om de integratiefunctie van Reporting Services te activeren.

Wat installeert de invoegtoepassing?

Het installatieproces van de invoegtoepassing bestaat uit twee fasen. Beide worden automatisch voltooid wanneer u een standaardinstallatie voltooit:

• De eerste fase is het installeren van bestanden in de juiste mappen. De mappen zijn standaard voor SharePoint-implementaties. Een van de geïnstalleerde bestanden is rsCustomAction.exe.

• Het tweede gedeelte van de installatie is het uitvoeren van een set aangepaste acties om de Reporting Services-bestanden te registreren bij SharePoint. De aangepaste acties worden uitgevoerd vanaf rsCustomAction.exe. De exe wordt verwijderd wanneer de volledige installatie van twee fasen is voltooid. U kunt een installatie van alleen bestanden uitvoeren, waarbij rsCustomAction.exe niet wordt uitgevoerd aan het einde van de installatie en rsCustomAction.exe op de schijf blijft staan.

De Installatievolgorde van Reporting Services

De invoegtoepassing kan worden geïnstalleerd voordat u SharePoint installeert of na de installatie van SharePoint. De invoegtoepassing volgt de sharePoint-predeploymentstandaarden en installeert bestanden op locaties die door de SharePoint-installatie worden gebruikt.

Overzicht van de installatiemethoden

De SQL Server 2016 Reporting Services-invoegtoepassing voor SharePoint-producten kan worden geïnstalleerd met een van de volgende twee methoden:

• De installatiewizard: In SQL Server 2016 kunt u de invoegtoepassing installeren met de installatiewizard van SQL Server. Kies de Reporting Services-invoegtoepassing voor SharePoint-producten op de pagina Functieselectie van de wizard.

• rsSharepoint.msi: De invoegtoepassing kan rechtstreeks vanaf de installatiemedia worden geïnstalleerd of gedownload en geïnstalleerd. De rsSharepoint.msi ondersteunt zowel een grafische gebruikersinterface als een opdrachtregelinstallatie. U moet de .msi met beheerdersbevoegdheden uitvoeren door eerst een opdrachtprompt met verhoogde machtigingen te openen en vervolgens de rsSharepoint.msi vanaf de opdrachtregel uit te voeren. Zie waar u de Reporting Services-invoegtoepassing voor SharePoint-producten kunt vinden voor meer informatie over het downloaden van de invoegtoepassing.

  Opmerking

  Als u de /q-schakel gebruikt voor een stille installatie via de opdrachtregel, wordt de eindgebruikerslicentieovereenkomst niet weergegeven. Ongeacht de installatiemethode is het gebruik van deze software onderworpen aan een gebruiksrechtovereenkomst en bent u verantwoordelijk voor het naleven van de gebruiksrechtovereenkomst.

Installeer de invoegtoepassing met behulp van het installatiebestand rsSharePoint.msi

Deze sectie is gerelateerd aan het rechtstreeks installeren van de rssharepoint.msi door de .msi installatiewizard of een opdrachtregelinstallatie uit te voeren. Als u de invoegtoepassing hebt geïnstalleerd met behulp van de installatiewizard van SQL Server, hoeft u deze stappen niet uit te voeren.

U ziet een volledige lijst met opdrachtregelswitches door de volgende opdracht uit te voeren:

Rssharepoint.msi /?  

1. Download het installatieprogramma (rsSharepoint.msi) voor de Reporting Services-invoegtoepassing. Zie Waar u de Reporting Services-invoegtoepassing voor SharePoint-producten kunt vinden voor meer informatie over het downloaden van de invoegtoepassing.

2. Voer als beheerderrsSharepoint.msi uit om de installatiewizard uit te voeren. De wizard geeft een welkomstpagina, de licentievoorwaarden voor software en een pagina met registratiegegevens weer. Setup maakt mappen onder het volgende pad en kopieert bestanden naar de mappen:

   %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. Configureer de instellingen en functieactivering van de rapportserver in Centraal beheer van SharePoint. Zie De eerste rapportserver installeren in de SharePoint-modus van Reporting Services voor meer informatie over het installeren en configureren van de SharePoint-modus.

Alleen bestanden installeren

Als u de bestanden wilt installeren, maar de aangepaste actiefase van de installatie wilt overslaan, voert u de rssharepoint.msi uit vanaf de opdrachtregel met de optie SKIPCA.

1. Open een opdrachtprompt met beheerdersmachtigingen.

2. Voer de volgende opdracht uit:

   Msiexec.exe /i rsSharePoint.msi SKIPCA=1  
   

De gebruikersinterface voor installatie wordt geopend en wordt als normaal uitgevoerd en het rsCustomAction.exe-bestand is geïnstalleerd. De .exe wordt echter niet uitgevoerd aan het einde van de installatie en rsCustomAction.exe blijft op de computer staan wanneer de installatie is voltooid.

Een installatie in twee stappen gebruiken om installatieproblemen op te lossen

Als er fouten optreden tijdens de installatie, kunt u Setup uitvoeren als een proces in twee stappen vanaf de opdrachtregel:

1. Open een opdrachtprompt met beheerdersmachtigingen en voer alleen een installatie van bestanden uit, zoals beschreven in de vorige sectie.

2. Voer het uitvoerbare bestand voor aangepaste acties uit:

   1. Navigeer naar de map met het bestand rsCustomAction.exe. De installatie van alleen de bestanden van de invoegtoepassing kopieert deze bestanden naar uw computer. rsCustomAction.exe bevindt zich in de map%Temp% . Als u naar het bestand wilt navigeren, voert u het volgende voorbeeld in de opdrachtprompt in:

      CD-%temp%.

      Het bestand moet zich bevinden in: \Users\<your name>\AppData\Local\Temp

   2. Voer de volgende opdracht in. Deze configuratiestap duurt enkele minuten. De W3SVC-service wordt opnieuw opgestart tijdens dit proces. Verschillende statusberichten worden weergegeven als het programma bestanden kopieert, onderdelen registreert en de wizard Productconfiguratie van SharePoint uitvoert.

      rsCustomAction.exe /i  
      

   3. De hoeveelheid tijd die nodig is voordat de wijzigingen van kracht worden, kan variëren, afhankelijk van uw serveromgeving. U kunt iisreset ook uitvoeren om een snellere update af te dwingen.

Stille installatie voor scripting

U kunt de /q - of /quiet-switches gebruiken voor een 'stille' installatie die geen dialoogvensters of waarschuwingen weergeeft. De stille installatie is handig als u de installatie van de invoegtoepassing wilt scripten.

Een stille installatie uitvoeren:

1. Open een opdrachtprompt met beheerdersmachtigingen.

2. Voer de volgende opdracht uit:

   Msiexec.exe /i rsSharePoint.msi /q  
   

De Reporting Services-invoegtoepassing verwijderen

U kunt de Reporting Services-invoegtoepassing voor SharePoint-producten verwijderen vanuit het Configuratiescherm van Microsoft Windows of de opdrachtregel.

1. Als u het configuratiescherm gebruikt, wordt het verwijderen van de bestanden op de huidige computer voltooid en worden het Reporting Services-object en de functies uit de SharePoint-farm verwijderd. Wanneer het Reporting Services-object en de functies worden verwijderd, kunt u rapporten niet meer bekijken en bijwerken.

2. Met de opdrachtregelmethode voor het verwijderen van de invoegtoepassing kunt u de parameter LocalOnly gebruiken om alleen de invoegtoepassingsbestanden van de lokale computer te verwijderen, en het Reporting Services-object en de functies in de farm worden niet gewijzigd.

Als u de invoegtoepassing verwijdert, worden serverintegratiefuncties verwijderd die worden gebruikt voor het verwerken van rapporten op een rapportserver. De Reporting Services-pagina's worden ook verwijderd van Centraal beheer van SharePoint en andere aangepaste Reporting Services-pagina's. Mogelijk wilt u ook alle rapporten en andere rapportserveritems verwijderen die u niet meer gebruikt op de betreffende SharePoint-sites. Ze worden niet uitgevoerd nadat de Reporting Services-invoegtoepassing is verwijderd.

Als u de Reporting Services-invoegtoepassing wilt verwijderen, moet er al een SharePoint-installatie actief zijn. Als u SharePoint eerst verwijdert, moet u deze opnieuw installeren om de Reporting Services-invoegtoepassing te verwijderen.

De stappen voor het verwijderen van de invoegtoepassing zijn hetzelfde voor zowel zelfstandige servers als serverfarms. Setup verwijdert programmabestanden en eventuele configuratie-instellingen die tijdens de installatie zijn toegevoegd.

Als u de invoegtoepassing verwijdert, worden de volgende items niet verwijderd:

• Aanmeldingen die zijn gemaakt voor het Report Server-serviceaccount dat wordt gebruikt voor toegang tot de SharePoint-configuratie- en inhoudsdatabases. U moet alle inloggegevens voor het Report Server-serviceaccount verwijderen uit het exemplaar van de SQL Server Database Engine dat wordt gebruikt om de SharePoint-databases te hosten.

• Machtigingen of groepen die u hebt gemaakt voor rapportgebruikers. Als u aangepaste machtigingsniveaus of SharePoint-groepen hebt gemaakt om toegang te verlenen tot rapportserverfuncties, moet u alle machtigingen intrekken die niet meer nodig zijn.

• Gegevensbestanden die u hebt geüpload naar een SharePoint-bibliotheek, waaronder rapportdefinitiebestanden (.rdl), gedeelde gegevensbronbestanden (.rsds) en gepubliceerde rapportitems (.rsc). Ze worden niet verwijderd, maar worden niet meer uitgevoerd. U moet de bestanden handmatig verwijderen.

• Setup verwijdert de rapportserverdatabase niet of wijzigt het exemplaar van de rapportserver dat is gebruikt voor geïntegreerde bewerkingen.

Verwijderen uit het Configuratiescherm van Windows

De wizard starten vanuit het Configuratiescherm van Microsoft Windows en de invoegtoepassing verwijderen:

1. Selecteer een programma verwijderen in het Configuratiescherm in Programma's

2. Selecteer de invoegtoepassing Microsoft SQL Server RS voor SharePoint. U kunt de wizard Verwijderen ook starten door rssharepoint.msi uit te voeren vanaf de opdrachtprompt zonder schakelopties.

3. Selecteer verwijderen.

Deïnstalleren vanaf de opdrachtregel

De invoegtoepassing verwijderen via de opdrachtregel:

1. Open een opdrachtprompt met beheerdersmachtigingen.

2. Voer de volgende opdracht uit:

   msiexec.exe /uninstall rsSharePoint.msi  
   

3. U ziet een bevestigingsvenster. Selecteer Ja.

De invoegtoepassing alleen van de lokale server verwijderen

Met de vorige methoden voor het verwijderen van de invoegtoepassing verwijdert u de Reporting Services-functies en -objecten uit de farm. Als u een farm met meerdere servers hebt en de invoegtoepassing alleen van de lokale computer wilt verwijderen en de SharePoint-farm in een functionele status wilt laten staan, voert u de volgende stappen uit:

1. Open een opdrachtprompt met beheerdersmachtigingen.

2. Voer de volgende opdracht uit:

   Msiexec.exe /uninstall rsSharePoint.msi LocalOnly=1  
   

Met deze stap worden de registratie van de Reporting Services-onderdelen van SharePoint opgehefd en worden de bestanden verwijderd, maar alleen voor de lokale computer.

Als u de registratie van de Reporting Services-functies van SharePoint ongedaan wilt maken, maar de bestanden op de schijf wilt achterlaten voor later gebruik, voert u de volgende stappen uit:

1. Open een opdrachtprompt met beheerdersmachtigingen.

2. Voer de volgende opdracht uit:

   rsCustomAction.exe /p  
   

In de bovenstaande stappen wordt ervan uitgegaan dat u een installatie van de .msi hebt voltooid met SkipCA=1 en dat de rscusstomaction.exe beschikbaar is. Zie de sectie waarin de bestanden alleen worden geïnstalleerd voor meer informatie.

Hoe rssharepoint.msi via de opdrachtregel te repareren

Voer de volgende stappen uit om de Reporting Services-invoegtoepassing te herstellen of te verwijderen met behulp van de opdrachtregel:

1. Open een opdrachtprompt met beheerdersmachtigingen.

2. Voer de volgende opdracht uit:

   msiexec.exe /f rssharepoint.msi  
   

Logboekbestanden instellen

Wanneer Setup wordt uitgevoerd, worden gegevens vastgelegd in een logboekbestand in de %temp% map voor de gebruiker die de Reporting Services-invoegtoepassing heeft geïnstalleerd. Bijvoorbeeld c:\Users\\<username\>\AppData\Local\Temp . De bestandsnaam is RS_SP_<getal>.log bijvoorbeeld RS_SP_0.log. Elke fout in het logboek begint met de tekenreeks 'SSRSCustomActionError'.

Een logboekbestand weergeven met Windows Notepad

1. Met de volgende opdrachten wijzigt u het opdrachtpromptpad, geeft u de rs-logboekbestanden weer en opent u vervolgens een van de bestanden met Windows Kladblok:

   cd %temp%  
   

   Dir rs_sp*.log  
   

   notepad rs_sp_3.log  
   

Een logboekbestand weergeven met PowerShell

1. Voer de volgende opdracht uit de SharePoint Management Shell in om een gefilterde lijst met rijen te retourneren uit het bestand dat 'ssrscustomactionerror' bevat:

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

2. De uitvoer moet er als in het volgende voorbeeld uitzien:

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

Upgrade

Als u een bestaande installatie van de Reporting Services-invoegtoepassing hebt, kunt u een upgrade uitvoeren naar de huidige versie. De installatie van de invoegtoepassing detecteert de bestaande versie en vraagt u om de update te bevestigen. Het bericht moet er ongeveer uitzien als in het volgende voorbeeld:

Er is een lagere versie van dit product op uw systeem gedetecteerd. Wilt u uw bestaande installatie upgraden?

Als u bevestigt, wordt de oudere versie van de invoegtoepassing verwijderd en wordt de nieuwe versie geïnstalleerd.

De Reporting Services-invoegtoepassing is niet exemplaarbewust. U kunt slechts één exemplaar van de invoegtoepassing op een computer hebben. U kunt geen verschillende versies naast de huidige versie uitvoeren.

RsCustomAction.exe

De volgende tabel bevat een overzicht van de schakelopties voor rscustomaction.exe:

Reporting Services configureren

Nadat u de invoegtoepassing op alle benodigde computers hebt geïnstalleerd, moet u de rapportserver configureren vanuit Centraal beheer van SharePoint. Welke stappen nodig zijn, is afhankelijk van de volgorde waarin de verschillende technologieën zijn geïnstalleerd. Zie De eerste rapportserver installeren in de SharePoint-modus en Reporting Services Report Server (SharePoint-modus) voor meer informatie.

Verwante inhoud

• De eerste rapportserver installeren in de SharePoint-modus
• Reporting Services-rapportserver (SharePoint-modus)
• Probeer het eens bij het Reporting Services forum