Instale ou desinstale o complemento Reporting Services para SharePoint (SSRS)

Aplica-se a: SQL Server Reporting Services (2016) Power BI Report Server SharePoint

Execute o pacote de instalação Microsoft SQL Server Reporting Services Add-in para produtos SharePoint (rsSharePoint.msi) em servidores SharePoint para ativar funcionalidades de Reporting Services dentro de uma implementação SharePoint. As funcionalidades incluem Power View, uma Web Part do Visualizador de Relatórios, um endpoint proxy de URL, tipos de conteúdo dos Serviços de Relatórios e páginas de aplicação para que possa criar, visualizar e gerir relatórios, fontes de dados e outros conteúdos de servidores de relatórios num site SharePoint. O Add-in de Serviços de Relatórios para produtos SharePoint é um componente obrigatório para um servidor de relatórios que funciona em modo SharePoint. O complemento pode ser instalado através do assistente de configuração do SQL Server 2016 ou descarregando o rsSharePoint.msi do pacote de funcionalidades do SQL Server 2016. Para uma lista das versões das páginas adicionais e de download, veja Onde encontrar o complemento Serviços de Relatórios para produtos SharePoint.

Pré-requisitos

Instalar o Add-in de Serviços de Relatórios é um dos vários passos necessários para integrar um servidor de relatórios com uma instância de um produto SharePoint. Para mais informações sobre a instalação e configuração dos Serviços de Relatórios, consulte Instalar o primeiro Servidor de Relatórios em modo SharePoint.

• Se estiver a integrar os Serviços de Relatórios com uma farm SharePoint que tenha várias aplicações frente Web, instale o suplemento em cada computador da farm que tenha uma frente de servidor Web. Instale este complemento apenas para interfaces Web usadas para aceder ao conteúdo do servidor de relatórios.

• Para instalar o suplemento dos Serviços de Relatório, é necessário ser administrador do computador. Por exemplo, se vais executar o rsSharePoint.msi no prompt de comandos, deves abrir o prompt com privilégios de administrador usando a opção Executar como administrador .

• Para instalar o suplemento Reporting Services, deve ser membro do grupo SharePoint Farm Administrators.

• Deve ser administrador de Site Collection para ativar a funcionalidade de integração dos Serviços de Relatório.

O que é que o add-in instala?

O processo de instalação adicional é composto por duas fases, ambas sendo concluídas automaticamente quando conclui uma instalação padrão:

• A primeira fase é instalar ficheiros nas pastas corretas. As pastas são padrão para implementações do SharePoint. Um dos ficheiros instalados é rsCustomAction.exe.

• A segunda parte da instalação consiste em executar um conjunto de ações personalizadas para registar os ficheiros dos Serviços de Relatórios no SharePoint. As ações personalizadas são executadas a partir de rsCustomAction.exe. O exe é removido quando a instalação bifásica completa está concluída. Podes executar uma instalação só de ficheiros e rsCustomAction.exe não é executada no final da instalação e permanece no disco.

Ordem de instalação dos Serviços de Relatórios

O complemento pode ser instalado antes de instalar o SharePoint ou após a instalação do SharePoint. O complemento segue os padrões de pré-implementação do SharePoint e instala ficheiros nos locais usados pela instalação do SharePoint.

Visão geral dos métodos de instalação

O suplemento SQL Server 2016 Reporting Services para produtos SharePoint pode ser instalado usando um dos seguintes dois métodos:

• O assistente de instalação: No SQL Server 2016, pode instalar o complemento com o assistente de instalação do SQL Server. Escolha o Suplemento de Serviços de Relatórios para produtos SharePoint na página de Seleção de Funcionalidades do assistente.

• rsSharepoint.msi: O complemento pode ser instalado diretamente a partir do suporte de instalação ou descarregado e instalado. O rsSharepoint.msi suporta tanto uma interface gráfica de utilizador como uma instalação em linha de comandos. Deve executar o .msi com privilégios de administrador abrindo primeiro um prompt de comandos com permissões elevadas e depois executando o rsSharepoint.msi a partir da linha de comandos. Para mais informações sobre o download do complemento, consulte Onde encontrar o complemento Reporting Services para produtos SharePoint.

  Observação

  Se usar o interruptor /q para uma instalação silenciosa na linha de comandos, o contrato de licença do utilizador final não será exibido. Independentemente do método de instalação, a utilização deste software é regida por um acordo de licença e é responsável por cumprir o acordo de licença.

Instala o complemento usando o ficheiro de instalação rsSharePoint.msi

Esta secção está relacionada com a instalação direta do rssharepoint.msi, seja através da execução do assistente de instalação .msi ou de uma instalação na linha de comandos. Se instalou o complemento usando o Assistente de Instalação do SQL Server, não precisa de seguir estes passos.

Pode ver uma lista completa de trocas de linha de comandos executando o seguinte comando:

Rssharepoint.msi /?  

1. Descarregue o programa de Configuração (rsSharepoint.msi) para o suplemento de Serviços de Relatório. Para mais informações sobre o download do complemento, consulte Onde encontrar o complemento Serviços de Relatórios para Produtos SharePoint.

2. Como administrador, execute rsSharepoint.msi para executar o Assistente de Instalação. O assistente apresenta uma página de boas-vindas, os termos da licença do software e uma página de informações de registo. O Setup cria pastas sob o seguinte caminho e copia ficheiros para as pastas:

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

   ou

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

3. Configure as definições do servidor de relatórios e a ativação de funcionalidades na Administração Central do SharePoint. Para mais informações sobre a instalação e configuração do modo SharePoint dos Serviços de Relatório, consulte Instalar o primeiro Servidor de Relatórios no modo SharePoint.

Instalação apenas com ficheiros

Para instalar os ficheiros mas saltar a fase de ação personalizada da instalação, execute a rssharepoint.msi a partir da linha de comandos com a opção SKIPCA.

1. Abre um prompt de comandos com permissões de administrador.

2. Execute o seguinte comando:

   Msiexec.exe /i rsSharePoint.msi SKIPCA=1  
   

A interface de utilizador da instalação abre e executa normalmente e ficheiro rsCustomAction.exe é instalado. No entanto, o .exe não corre no final da instalação e rsCustomAction.exe permanece no computador quando a instalação está concluída.

Use uma instalação em dois passos para resolver problemas de instalação

Se aparecer erros durante a instalação, pode executar o Setup como um processo em dois passos a partir da linha de comandos:

1. Abra um prompt de comandos com permissões de administrador e execute uma instalação apenas de ficheiros, conforme descrito na secção anterior.

2. Execute o executável de ações personalizadas:

   1. Navegue até à pasta que contém o ficheiro rsCustomAction.exe. A instalação apenas dos ficheiros do complemento copia este ficheiro para o seu computador. rsCustomAction.exe encontra-se no diretório %Temp% . Para navegar até ao ficheiro, introduza o seguinte exemplo no prompt de comandos:

      CD %temp%.

      O ficheiro deve estar localizado em: \Users\<o teu nome>\AppData\Local\Temp

   2. Digite o seguinte comando. Esta etapa de configuração demora vários minutos a ser concluída. O serviço W3SVC reinicia durante este processo. Várias mensagens de Estado são exibidas enquanto o programa copia ficheiros, regista componentes e executa o Assistente de Configuração do Produto SharePoint.

      rsCustomAction.exe /i  
      

   3. O tempo que as alterações demoram a entrar em vigor pode variar, dependendo do ambiente do seu servidor. Também podes correr o iisreset para forçar uma atualização mais rápida.

Instalação silenciosa para scripting

Podes usar os interruptores /q ou /quiet para uma instalação "silenciosa" que não mostre diálogos ou avisos. A instalação silenciosa é útil se quiseres fazer um script para a instalação do complemento.

Para realizar uma instalação silenciosa:

1. Abre um prompt de comandos com permissões de administrador.

2. Execute o seguinte comando:

   Msiexec.exe /i rsSharePoint.msi /q  
   

Como remover o complemento de Serviços de Relatórios

Pode desinstalar o Complemento de Serviços de Relatórios para Produtos SharePoint a partir do painel de controlo do Microsoft Windows ou da linha de comandos.

1. Usar o painel de controlo executa uma desinstalação completa dos ficheiros no computador atual E remove o objeto e as funcionalidades dos Serviços de Relatórios da quinta do SharePoint. Quando o objeto e as funcionalidades dos Serviços de Relatórios são removidos, já não pode rever nem atualizar relatórios.

2. O método de linha de comandos para desinstalar o complemento permite usar o parâmetro LocalOnly para remover apenas os ficheiros do complemento do computador local, e o objeto e as funcionalidades do Reporting Services no servidor não mudam.

Desinstalar o complemento remove funcionalidades de integração com servidores que são usadas para processar relatórios num servidor de relatórios. Também remove as páginas de Serviços de Relatórios da Administração Central do SharePoint e de outras páginas personalizadas de Serviços de Relatório. Também poderá querer remover quaisquer relatórios e outros elementos do servidor de relatórios que já não utilize nos sites SharePoint afetados. Eles não funcionam depois da remoção do Suplemento de Serviços de Relatório.

Para desinstalar o complemento Reporting Services, deve ter uma instalação do SharePoint ainda a funcionar. Se desinstalar o SharePoint primeiro, deve reinstalá-lo para desinstalar o complemento de Serviços de Relatório.

Os passos para desinstalar o complemento são os mesmos tanto para servidores autónomos como para fazendas de servidores. A configuração remove ficheiros de programa e quaisquer definições de configuração que tenham sido adicionadas durante a instalação.

Desinstalar o complemento não remove os seguintes elementos:

• Logins criados para a conta do serviço do Servidor de Relatórios que é usada para aceder à configuração do SharePoint e às bases de dados de conteúdo. Deve eliminar quaisquer logins da conta do serviço Report Server da instância do SQL Server Database Engine usada para alojar as bases de dados do SharePoint.

• Permissões ou grupos que criou para os utilizadores dos relatórios. Se criou níveis de permissões personalizados ou grupos SharePoint para conceder acesso a funcionalidades do servidor de relatórios, deve revogar quaisquer permissões que já não sejam necessárias.

• Ficheiros de dados que carregaste para uma biblioteca SharePoint, incluindo definição de relatório (.rdl), fonte de dados partilhada (.rsds) e ficheiros de itens de relatório publicados (.rsc). Não são apagados, mas já não funcionam. Tens de apagar os ficheiros manualmente.

• A configuração não apaga a base de dados do servidor de relatórios nem modifica a instância do servidor de relatórios usada para operações integradas.

Desinstalar do Painel de Controlo do Windows

Para iniciar o assistente a partir do Painel de Controlo do Microsoft Windows e remover o complemento:

1. No Painel de Controlo, em Programas, selecione Desinstalar um Programa

2. Selecione o suplemento Microsoft SQL Server RS para SharePoint. Também podes iniciar o assistente de desinstalação correndo rssharepoint.msi a partir do prompt de comandos sem interruptores.

3. Selecione Remover.

Desinstalar a partir da linha de comando

Para desinstalar o complemento da linha de comandos:

1. Abre um prompt de comandos com permissões de administrador.

2. Execute o seguinte comando:

   msiexec.exe /uninstall rsSharePoint.msi  
   

3. Vês uma caixa de mensagem de confirmação. Selecione Sim.

Desinstale o complemento apenas do servidor local

Os métodos anteriores de desinstalação do complemento removem as funcionalidades e o objeto dos Serviços de Relatórios da quinta. Se tiver uma farm multi-servidor e quiser desinstalar o complemento apenas do computador local e deixar a farm SharePoint em estado funcional, complete os seguintes passos:

1. Abre um prompt de comandos com permissões de administrador.

2. Execute o seguinte comando:

   Msiexec.exe /uninstall rsSharePoint.msi LocalOnly=1  
   

Esta etapa desregista os componentes de Serviços de Relatórios do SharePoint e remove os ficheiros, mas apenas para o computador local.

Se quiser desregistar as funcionalidades de Serviços de Relatórios do SharePoint mas deixar os ficheiros no disco para uso posterior, complete os seguintes passos:

1. Abre um prompt de comandos com permissões de administrador.

2. Execute o seguinte comando:

   rsCustomAction.exe /p  
   

Os passos acima assumem que concluiu a instalação do .msi com SkipCA=1 e que o rscusstomaction.exe está disponível. Para mais informações, consulte a secção que descreve a instalação apenas de ficheiros.

Como reparar rssharepoint.msi a partir da linha de comandos

Para reparar ou desinstalar o complemento Reporting Services usando a linha de comandos, complete os seguintes passos:

1. Abre um prompt de comandos com permissões de administrador.

2. Execute o seguinte comando:

   msiexec.exe /f rssharepoint.msi  
   

Ficheiros de registo da instalação

Quando a Configuração é executada, regista a informação num ficheiro de registo na pasta %temp% para o utilizador que instalou o suplemento de Serviços de Relatório. Por exemplo, c:\Users\\<username\>\AppData\Local\Temp . O nome do ficheiro é RS_SP_<número>.log, por exemplo RS_SP_0.log. Cada erro no registo começa com a cadeia "SSRSCustomActionError".

Ver um ficheiro de registo com o Bloco de Notas do Windows

1. Os seguintes comandos alteram o caminho do prompt de comandos, listam os ficheiros de registo RS e depois abrem um dos ficheiros com o Windows Notepad:

   cd %temp%  
   

   Dir rs_sp*.log  
   

   notepad rs_sp_3.log  
   

Ver um ficheiro de registo com o PowerShell

1. Introduza o seguinte comando do SharePoint Management Shell para devolver uma lista filtrada de linhas do ficheiro que contêm "ssrscustomactionerror":

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

2. O resultado deverá ter um aspeto semelhante ao seguinte exemplo:

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

Aprimoramento

Se tiver uma instalação existente do suplemento do Reporting Services, pode fazer a atualização para a versão mais recente. A configuração do complemento deteta a versão existente e pede para confirmar a atualização. A mensagem deve ser semelhante ao seguinte exemplo:

Foi detetada uma versão inferior deste produto no seu sistema. Gostaria de atualizar a sua instalação atual?

Se confirmares, a versão antiga do complemento é removida e depois a nova versão instala-se.

O suplemento de Serviços de Relatórios não reconhece instâncias. Só podes ter uma instância do complemento num computador. Não podes correr versões diferentes lado a lado com a versão atual.

RsCustomAction.exe

A tabela seguinte resume os rscustomaction.exe interruptores:

Configurar Serviços de Relatórios

Depois de instalar o complemento em todos os computadores necessários, precisa de configurar o servidor de relatórios a partir da Administração Central do SharePoint. Os passos necessários dependem da ordem em que as diferentes tecnologias são instaladas. Para mais informações, consulte Instalar o primeiro Servidor de Relatórios em modo SharePoint e Servidor de Relatórios do Reporting Services (Modo SharePoint)

Conteúdo relacionado

• Instale o primeiro servidor de relatórios em modo SharePoint
• Servidor de relatórios dos Serviços de Relatórios (modo SharePoint)
• Tente perguntar ao fórum do Reporting Services