PI WebParts 2013
Manual do Administrador
OSIsoft, LLC
777 Davis St., Suite 250 San Leandro, CA 94577 USA Tel: (01) 510-297-5800 Fax: (01) 510-357-8136 Site: http://www.osisoft.com
Guia do administrador do PI WebParts 2013
© 2006-2015 por OSIsoft, LLC. Todos os direitos reservados.
Nenhuma parte desta publicação pode ser reproduzida, armazenada em um sistema de recuperação ou transmitida, em qualquer forma ou por quaisquer meios, sejam mecânicos, de fotocópia, registro ou outro, sem a prévia autorização por escrito da OSIsoft, LLC.
OSIsoft, o logotipo e o logo OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI Web API, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports e RtWebParts são marcas comerciais da OSIsoft, LLC. Todas as outras marcas ou nomes comerciais usados neste documento são de propriedade de seus respectivos proprietários.
DIREITOS DO GOVERNO DOS EUA
O uso, a duplicação ou a divulgação pelo Governo dos EUA estão sujeitos às restrições definidas no contrato de licença da OSIsoft, LLC e conforme fornecido nas DFARS 227.7202, DFARS 252.227-7013, FAR 12.212, FAR 52.227, conforme aplicável. OSIsoft, LLC.
Versão: 4.0.3
Conteúdo
Introdução...1
Sobre este guia... 1
Funções dos administradores do PI WebParts ... 1
Lançamento do PI WebParts 2013...2
Arquitetura do PI WebParts 2013... 3
Requisitos do sistema... 5
Requisitos de servidor do SharePoint... 5
Requisitos dos PI WebParts Services... 5
Requisitos do cliente... 6
Instalação do PI WebParts... 9
Lista de verificação pré-instalação... 9
Atualização do SharePoint...11
Verificar se o SharePoint está em execução... 11
Permissões do SQL Server para o SharePoint... 11
Acesso a dados do PI Server e do PI AF... 11
Configurar a identidade do pool de aplicativos dos PI WebParts Services ...12
Requisitos para autenticação de identidade em uma instalação do PI WebParts...14
Iniciar o serviço do Windows para chamar no servidor do SharePoint... 15
Instalar o PI WebParts... 16
Instalar a solução do PI WebParts... 16
Implementar a solução do PI WebParts nos aplicativos da Web do SharePoint...19
Ativar o recurso Configuração de PI WebParts para os aplicativos desejados do SharePoint...20
Instalar os PI WebParts Services...20
Configurar os aplicativos da web do SharePoint para o PI WebParts...22
Ative o PI WebParts como um recurso de coleta de sites... 24
Lista de verificação pós-instalação... 25
Testar a instalação do PI WebParts... 26
Acesso ao site Administração do PI WebParts... 27
Definir o idioma da interface de usuário do PI WebParts...27
Instalar o service pack do PI WebParts... 28
Atualizar a solução do PI WebParts... 28
Atualizar os PI WebParts Services...30
Segurança...33
Acesso seguro ao PI Server...33
PI Trusts... 34
Requisitos de segurança integrada do Windows ... 34
Permissões de acesso necessárias... 35
Permitir o acesso aos arquivos de dados remotos... 35
Segurança de firewall...36 Segurança do IIS... 36 Segurança do SharePoint...36 Protocolo SSL...37
Manutenção... 39
Ajuste do desempenho... 39Performance counters personalizados...40
Contadores de amostra...40
Performance counters do Windows... 41
Performance monitors do ponto do PI...41
Arquivos de log... 41
Informações da versão... 42
Solução de problemas...42
Upgrades do PI WebParts...43
Reparos do PI WebParts...43
Habilitar PI WebParts em um novo aplicativo da Web do SharePoint... 43
Backups e restauração... 44
Conteúdo e base de dados de configuração do SharePoint...44
Dados de configuração do PI WebParts...44
Migre dados de configuração para o PI WebParts...46
Apontar o PI WebParts para um Servidor existente do PI Module Database ...47
Backups e restauração dos servidores do SharePoint...47
Remoção do PI WebParts...48
Desativar o PI WebParts como um recurso de coleta de sites do SharePoint... 48
Revogue e remova a solução do PI WebParts do SharePoint... 48
Desinstalar os PI WebParts Services...49
Site Administração de PI WebParts...51
Configurações da apresentação...51
Gerenciar configurações da tabela... 52
Gerenciar as configurações de PI Trend e PI XYPlot...60
Gerenciar as configurações dos contatos do PI Messenger... 63
Remover uma configuração do PI WebParts...66
Fontes de dados...66
Fontes de dados do PI Server... 66
Fontes de dados relacionais... 69
Fontes de dados do serviço Web... 80
Suporte do PI Asset Framework... 85
Conjuntos de dados... 85
Conjuntos de dados do cálculo de PI...85
Conjuntos de dados relacionais... 90
Conjuntos de dados do serviço Web... 95
Excluir um conjunto de dados... 103
Tópicos avançados...105
MDB para migração do PI AF...105
Servidores Web com carga balanceada da rede... 105
Network Load-Balancing (NLB) do Windows...106
Configuração do Network interface card (NIC) do NLB... 106
Configuração do modo de filtragem de afinidade... 106
conversão de URL... 106
Exceções na conversão de URLs...107
Trusts para URLs internos...108
Configuração da delegação Kerberos... 109
Pré-requisitos da delegação Kerberos... 109
Verificar se as contas de usuários podem usar a delegação Kerberos... 110
Configurar a delegação Kerberos para o servidor do SharePoint ... 110
Configurar uma conta de domínio para delegar ao PI WebParts Services... 111
Configurar uma conta local para delegar ao PI WebParts Services...111
Configure a delegação Kerberos dos PI WebParts Services ... 112
Configurar uma conta de domínio para delegar ao PI Server... 113
Configurar uma conta local para delegar ao PI Server... 113
Configuração da fonte de dados para Kerberos...114
Estabelecer os nomes principais do serviço (SPNs) para contas de pool de aplicativos... 115
Sites acessados com cabeçalhos de hosts ... 115
Acesso a arquivo remoto usando a delegação Kerberos...116 Conteúdo
Solução de problemas... 116
Verificar a configuração Kerberos no computador cliente... 116
Verificar a configuração Kerberos no servidor Web... 117
Configuração de certificados... 119
Configurar certificados para sites como modos de chamadas... 119
Tornar os PI WebParts Services cientes dos certificado do SharePoint...119
Preparar o certificado dos PI WebParts Services... 120
Atualizar o arquivo de configuração dos PI WebParts Services para suportar certificados...120
Tornar o SharePoint ciente dos certificado dos PI WebParts Services... 121
Performance counters personalizados do PI WebParts...123
Suporte técnico e outros recursos... 131
ConteúdoIntrodução
O PI WebParts é um aplicativo baseado na Web que permite aos usuários formular e
compartilhar exibições de dados para a elaboração de relatório e análise. Com o PI WebParts, os usuários sem nenhum conhecimento de desenvolvimento de HTML podem construir páginas da Web que contenham dados dinâmicos. O PI WebParts pode acessar os dados do PI System e que não sejam do PI System por meio de conexões de fontes de dados configuráveis. O PI WebParts usa a tecnologia SharePoint(R) da Microsoft, um ambiente de portal centralizado,
para armazenar exibições personalizadas e fornecer uma funcionalidade administrativa para os sites e páginas da web part. Os administradores podem usar as ferramentas do SharePoint para gerenciar configurações do site, conceder privilégios aos usuários e proteger o conteúdo dentro dos sites.
Nesta seção
• Sobre este guia
Este guia contém informações administrativas do PI WebParts. • Funções dos administradores do PI WebParts
Os administradores do PI WebParts planejam, instalam, configuram, mantêm e monitoram o aplicativo.
• Lançamento do PI WebParts 2013
O PI WebParts 2013 recebeu algumas alterações principais. • Arquitetura do PI WebParts 2013
O PI WebParts 2013 exige um servidor do SharePoint e o servidor de aplicativos dos PI WebParts Services.
• Requisitos do sistema
O PI WebParts requer software específico em um ou mais computadores.
Sobre este guia
Este guia descreve as tarefas administrativas associadas à elaboração e à manutenção de uma instalação do PI WebParts, incluindo a instalação dos serviços e da solução do PI WebParts, configuração, modelos de segurança, procedimentos de gerenciamento e técnicas básicas de solução de problemas.
O PI WebParts exige a instalação e o gerenciamento do servidor da Web Microsoft IIS e do SharePoint. Este guia discute esses aplicativos com relação ao PI WebParts e aos PI WebParts Services, mas não inclui informações abrangentes sobre os aplicativos da Microsoft. Consulte a documentação do SharePoint e do IIS para obter mais informações.
Funções dos administradores do PI WebParts
Os administradores do PI WebParts instalam o aplicativo e concluem as seguintes tarefas: • Planejamento
◦ Determine os requisitos de sistema das entradas de diretório e do volume de espaço ◦ Planeje os requisitos, a integração, as atualizações e os lançamentos de versões futuras • Configuração
◦ Implemente os diretórios e a segurança
◦ Configure o acesso ao PI Server e a outras fontes de dados
◦ Personalize o aplicativo (com o logotipo da empresa, as folhas de estilo personalizadas e os ícones personalizados)
• Manutenção
◦ Remova os arquivos não usados ou desatualizadas ◦ Atualize a lista de usuários
◦ Planeje e organize a manutenção do servidor ◦ Instale e atualize o software do servidor
◦ Gerencie as operações diárias e a disponibilidade do aplicativo • Monitoramento
◦ Controle o desempenho da rede e o consumo de recursos
◦ Aloque o registro do usuário e o uso (observando os termos de licenciamento do software)
◦ Forneça relatórios de gerenciamento de uso do aplicativo
Lançamento do PI WebParts 2013
Algumas alterações principais foram feitas no PI WebParts 2013, entre elas estão:
• Suporte ao SharePoint 2013 e ao SharePoint 2010; inclui suporte a autenticação baseada em chamadas.
• Nova arquitetura para implementação do SharePoint. Ao usar um pacote de soluções do SharePoint, o PI WebParts segue uma abordagem de instalação padronizada, que suporta grandes e pequenas farms da Web do SharePoint.
• Servidor de aplicativos independente, os PI WebParts Services. Os PI WebParts Services gerenciam conexões com qualquer PI Server e servidor do PI AF para fornecer acesso a dados. É possível instalar os PI WebParts Services no mesmo servidor do SharePoint, como o PI WebParts, ou em outro computador de servidor. A flexibilidade de instalação permite que os requisitos de segurança da organização sejam atendidos e que uma infraestrutura escalável e sustentável seja usada.
• Suporte a outros navegadores. Podem-se visualizar as páginas do PI WebParts no Internet Explorer e no Mozilla Firefox. Se o SharePoint 2013 for usado, também será possível visualizar as páginas do PI WebParts no Google Chrome.
• Suporte a renderização SVG nativa. Se um navegador com suporte nativo para renderização SVG for usado, determinadas configurações não serão necessárias para o plug-in do Adobe SVG Viewer.
• A nova interface de usuário de pesquisa é usada para localizar e selecionar pontos do PI, elementos do PI AF e atributos do PI AF ao configurar web parts.
• O novo recurso de página na web part do PI TreeView com suporte a grandes estruturas do PI AF é usado.
Arquitetura do PI WebParts 2013
O PI WebParts 2013 exige o servidor do SharePoint, no qual é possível implementar a solução do PI WebParts, e um servidor de aplicativos, os PI WebParts Services, que gerencia toda a comunicação com o PI System.
Para instalar o PI WebParts, é necessário instalar dois recursos: • Solução do SharePoint do PI WebParts
Deve-se adicionar a solução do SharePoint do PI WebParts ao servidor do SharePoint. Após a adição da solução, ela deverá ser implementada na Central de Administração do
SharePoint. Se o servidor do SharePoint for parte de uma farm, será possível implementar a solução pela farm.
• PI WebParts Services
Os PI WebParts Services são um servidor de aplicativos dedicado e exclusivo que suporta todos os servidores do SharePoint em uma farm. Os PI WebParts Services requerem um site não SharePoint. Eles contêm os componentes de acesso a dados necessários para conectar e recuperar dados do PI Server e do servidor do PI AF. Esses componentes incluem PI SDK, PI AF SDK e PI OLEDB Enterprise.
É possível instalar os PI WebParts Services no mesmo computador do servidor do SharePoint ou em outro computador. Podem-se instalá-los em outro computador por motivos de
segurança ou escalabilidade. Os PI WebParts Services podem suportar um servidor do
SharePoint exclusivo e independente ou uma única farm do SharePoint. Se houver uma farm do SharePoint, um único servidor de aplicativos poderá fornecer acesso a dados de vários sites na farm. Os PI WebParts Services usam cache de dados localizados centralmente em todos os servidores Web, evitando chamadas frequentes ao PI Server.
Instalação dos PI WebParts Services no mesmo computador do SharePoint
Instalação dos PI WebParts Services em um computador diferente do SharePoint
O PI WebParts 2013 tem suporte à autenticação baseada em chamadas do SharePoint. No SharePoint 2010, os sites podem usar o modo clássico ou de chamadas. No SharePoint 2013, o modo de chamadas deve ser usado. No modo clássico, o SharePoint usa a autenticação do Windows para transmitir informações de identidade ao se comunicar com os PI WebParts Services. Já no modo de chamadas, o SharePoint usa certificados para transmitir essas
informações. Pode-se escolher não usar certificados nos sites no modo de chamadas, mas isso é menos seguro e não é recomendado. Os requisitos e procedimentos de instalação do PI
WebParts são diferentes para os sites em modos clássico e de chamadas.
Os PI WebParts Services exigem uma identidade de pool de aplicativos com privilégios de leitura de quaisquer dados acessados pelo usuário. As identidades de pool de aplicativos do SharePoint não exigem esse acesso.
O PI Server ou o PI AF devem autenticar os usuários que fazem essas solicitações. Na maioria das configurações, o PI WebParts controla as identidades individuais e fornece acesso aos dados e aos arquivos corretos. Para uma solicitação inicial de um usuário, o PI WebParts transmite as informações da conta de login do Windows para os PI WebParts Services, que personifica esse usuário. Os PI WebParts Services transmitem essas informações da conta do usuário para o PI Server ou PI AF. O PI Server chama o PI Mapping ou o PI Trust apropriado para a conta e fornece os PI WebParts Services com o acesso apropriado aos dados do usuário. Da mesma forma, o PI AF fornece o acesso apropriado aos dados da conta do usuário. Nas solicitações subsequentes de dados, os PI WebParts Services transmitem a identidade de pool de aplicativos ao PI Server ou ao PI AF para autenticação. Os PI WebParts Services mantêm o controle sobre quais usuários podem ver determinados dados.
No entanto, com algumas configurações, o PI WebParts não controla as identidades individuais. Nessas configurações, o pI WebParts fornece a todos os usuários acesso aos dados do PI System, aos arquivos do SharePoint ou a ambos com base nos privilégios da identidade do pool de aplicativos.
O PI WebParts e os PI WebParts Services armazenam informações de configuração no PI Module Database. Durante a instalação, o PI Server que armazena o PI Module Database é designado para esses dados de configuração. O PI WebParts armazena os dados de configuração no módulo RtWebParts, e os PI WebParts Services, no módulo RtBaseline.
Requisitos do sistema
O PI WebParts exige a instalação do software em um ou mais computadores e potencialmente nas estações de trabalho clientes da Web, dependendo da implementação planejada.
Nesta seção
• Requisitos de servidor do SharePoint
Antes da instalação, o PI WebParts exige que um software específico esteja instalado no servidor do SharePoint.
• Requisitos dos PI WebParts Services
Antes de instalar os PI WebParts Services, é necessário que software específico esteja instalado no computador.
• Requisitos do cliente
Antes de usar o PI WebParts ou recursos de algumas web parts, as estações de trabalho do cliente precisam ter um software específico instalado.
Requisitos de servidor do SharePoint
O computador do servidor do Microsoft SharePoint no qual a solução do PI WebParts foi instalada requer:
• Versão de 64 bits do Microsoft Windows Server 2008 SP2, Windows Server 2008 R2 ou Windows Server 2012
• Microsoft Internet Information Server (IIS) 6.0 ou superior
• Microsoft SharePoint Foundation 2010, Microsoft SharePoint Server 2010, Microsoft SharePoint Foundation 2013 ou Microsoft SharePoint Server 2013
• Microsoft .NET Framework (versão 3.5 para SharePoint 2010 ou versão 4.5 para SharePoint 2013)
• Um aplicativo da Web do SharePoint contendo a última coleta de sites
Requisitos dos PI WebParts Services
O computador no qual os PI WebParts Services está instalado requer:
• Versão de 64 bits do Microsoft Windows Server 2008 SP2, Windows Server 2008 R2, ou Windows Server 2012
• Windows Communications Foundation • Microsoft .NET Framework, versão 4.5
• Recurso de ativação sem HTTP (um recurso .NET Framework 3.5.1) • Recurso Windows Identity Foundation (WIF)
• Recurso de ativação TCP
• Servidor de Informações da Internet (IIS) da Microsoft 7.0 ou superior • Site sem SharePoint com um número exclusivo de porta
• Acesso ao PI Server versão 3.4.380 ou superior Além disso, os serviços a seguir devem ser inicializados:
• Adaptador de listener Net.Tcp • Compartilhamento de porta Net.Tcp
Requisitos do cliente
Computares nos quais os usuários executam o PI WebParts precisam ter um navegador compatível:
• Microsoft Internet Explorer 8 ou posteriores (apenas versões de 32 bits)
Se o SharePoint 2010 com qualquer versão do Internet Explorer ou o SharePoint 2013 com o Internet Explorer 8 for usado, será necessário instalar o Adobe SVG Viewer para
renderizar gráficos nas web parts do PI Graphic, PI Gauge, PI XYPlot e PI Trend. É possível baixar este aplicativo na área de download do Adobe SVG Viewer (http://www.adobe.com/ devnet/svg/adobe-svg-viewer-download-area.edu.html). Se o SharePoint 2013 com o Internet Explorer 9 ou posteriores for usado, o Adobe SVG Viewer não será necessário. • Firefox 16 ou posteriores
Se o Firefox for usado, não será possível renderizar web parts ou recursos que confiam nos controles do ActiveX: A web part do PI Messenger, a web part do PI ActiveView, o comando
Abrir no PI ProcessBook da web part do PI Graphics ou o comando Exportar para o Excel > Abrir em qualquer web part (apesar disso, ainda é possível salvar dados em um arquivo
Excel).
• Google Chrome 24 ou posteriores
Se o Chrome for usado, não será possível renderizar web parts ou recursos que confiam nos controles do ActiveX: A web part do PI Messenger, a web part do PI ActiveView, o comando
Abrir no PI ProcessBook da web part do PI Graphics ou o comando Exportar para o Excel > Abrir em qualquer web part (apesar disso, ainda é possível salvar dados no arquivo Excel).
Para oferecer suporte aos recursos de algumas web parts, as estações de trabalho cliente precisam de um software adicional:
• PI ActiveView
Para usar a web part do PI ActiveView, o PI ActiveView 2.2 ou superiores devem estar instalados na estação de trabalho cliente. Para visualizar displays ERD no PI ProcessBook 3.2, o PI ActiveView 3.2 ou superior é necessário. A web part do PI ActiveView não funciona no Firefox ou Chrome.
• PI ProcessBook
Para usar o comando Abrir no PI ProcessBook nas web parts do PI ActiveView ou do PI
Graphic, o PI ProcessBook 3.0 ou superiores devem estar instalados nas estações de trabalho cliente. Esse comando não funciona no Firefox ou Chrome.
• Microsoft Office e software de mensagem instantânea
Para usar a web part do PI Messenger, o Microsoft Office 2003 ou posteriores e o Microsoft Lync, Microsoft Windows Messenger, Windows Live Messenger, Microsoft Office
Communicator ou MSN Messenger devem estar instalados na estação de trabalho cliente. Se o Microsoft Outlook XP ou controle do Catálogo de endereço do Outlook 2003 instalado separadamente estiverem presentes, os usuários poderão importar contatos de mensagens instantânea diretamente do catálogo de endereços do Outlook. A web part do PI Messenger não funciona no Firefox ou Chrome.
• Microsoft Excel
Para usar o comando Exportar para Excel > Abrir nas web parts do PI BatchTable, PI Table,
PI TimeSeries, PI Trend ou PI Values, o Microsoft Excel XP ou superiores devem estar instalados nas estações de trabalho cliente. Os navegadores Firefox e Chrome não são compatíveis com esse comando.
Nota:
É necessário ser um administrador no na estação de trabalho cliente para instalar o Adobe SVG Viewer ou o PI ActiveView.
Instalação do PI WebParts
Use o programa de instalação do PI WebParts para instalar a solução do SharePoint do PI WebParts e os PI WebParts Services. É necessário instalar a solução do SharePoint do PI WebParts em um computador executando o SharePoint. Os PI WebParts Services podem ser instalados no mesmo computador da solução do PI WebParts ou em outro computador.
O PI WebParts 2013 não pode estar instalado no mesmo computador das versões anteriores do RtWebParts e do PI WebParts. No entanto, ele PI WebParts 2013 pode estar no mesmo
computador das versões anteriores do RtBaselineServices e dos serviços de dados do PI. Ou seja, o PI WebParts 2013 pode ser instalado com outros aplicativos do PI System que precisem desses componentes, como os serviços Web do PI.
Depois de instalar a solução do PI WebParts, é necessário preparar os seus aplicativos da web do SharePoint para PI WebParts. Para cada aplicativo da web do SharePoint do qual você deseja usar o PI WebParts, implemente a solução do PI WebParts ao aplicativo e ative o recurso de Configuração do PI WebParts para o aplicativo. Depois de instalar os PI WebParts Services, será necessário configurar o SharePoint para usá-los. Para desinstalar o PI WebParts, consulte
Remoção do PI WebParts.
Se você já possui o PI WebParts 2013 instalado e deseja atualizá-lo para o service pack mais recente, siga o procedimento para instalar o service pack do PI WebParts. É necessário atualizar a solução do PI WebParts, atualizar o PI WebParts Services e ativar o recurso de Configuração de PI WebParts para qualquer aplicativo da web do SharePoint do qual deseja usar o PI WebParts.
Para obter uma visão geral das escolhas de instalação, consulte Arquitetura do PI WebParts 2013.
Nesta seção
• Lista de verificação pré-instalação
Antes de executar o programa de instalação do PI WebParts, verifique se o sistema está pronto.
• Instalar o PI WebParts
Execute o programa de instalação do PI WebParts e configure o SharePoint. • Lista de verificação pós-instalação
Após a instalação do PI WebParts, será necessário testar a instalação, limitar o acesso de administração, preparar as estações de trabalho cliente e instalar o pacote de idiomas. • Instalar o service pack do PI WebParts
Se você já instalou o PI WebParts 2013, atualize para o service pack mais recente
atualizando a solução PI WebParts SharePoint e fazendo o upgrade do PI WebParts Services.
Lista de verificação pré-instalação
Antes de instalar o PI WebParts, verifique se:
• O computador no qual a solução do SharePoint do PI WebParts será instaladas atende aos requisitos do servidor do SharePoint (consulte Requisitos de servidor do SharePoint). • As atualizações do SharePoint estão instaladas, e um aplicativo da Web do SharePoint com
pelo menos uma coleta de sites está em execução.
• O usuário fez login por meio de uma conta de usuário no domínio Windows com privilégios de Administrador no servidor Web.
• O computador no qual os PI WebParts Services serão instalados atende aos requisitos de servidor dos PI WebParts Services (consulte Requisitos dos PI WebParts Services). • Um site não SharePoint com um número de porta exclusivo está disponível para os PI
WebParts Services. Esse site deverá estar disponível e em execução no computar no qual os PI WebParts Services está instalado. Apesar de ser possível usar o site padrão disponível com o IIS, talvez um site com um nome mais significativo seja útil. Pode-se criar um site com o Internet Information Services (IIS) Manager.
Ao instalar os PI WebParts Services, o programa de instalação ativa o protocolo net.tcp para esse site com um vínculo à porta 808 TCP. O site requer um vínculo exclusivo. Para usar outro vínculo com esse site, ative o protocolo net.tcp com um vínculo preferido antes de executar o programa de instalação. Deve-se conhecer a porta de vinculação ao configurar o SharePoint para usar os PI WebParts Services.
• Um PI Module Database está disponível para armazenar as informações de configuração dos PI WebParts Services e do PI WebParts. Se o upgrade de uma versão anterior estiver sendo feito, será possível usar o mesmo PI Module Database para armazenar essas informações. • A identidade do pool de aplicativos dos PI WebParts Services tem acesso de leitura ao
módulo RtWebParts no PI Module Database, que armazena os dados de configuração do PI WebParts para o PI WebParts.
Use o PI System Management Tools (PI SMT) para conceder essas permissões.
• Todos os usuários do PI WebParts, inclusive a identidade do pool de aplicativos dos PI WebParts Services, têm acesso de leitura aos pontos e atributos do PI no PI Server e aos elementos e atributos do PI AF.
• O servidor do SharePoint e os PI WebParts Services são configurados para dar suporte à autenticação, se necessário. Entre eles podem estar a configuração dos certificados e a configuração da delegação Kerberos. Consulte Requisitos para autenticação de identidade em uma instalação do PI WebParts.
• O serviço do Windows para chamadas está em execução e configurado para iniciar automaticamente se os sites como modos de chamadas são usados (o modo padrão no SharePoint 2013). Consulte Iniciar o serviço do Windows para chamar no servidor do SharePoint.
Nesta seção
• Atualização do SharePoint
Siga as instruções da Microsoft para atualizar o SharePoint. • Verificar se o SharePoint está em execução
Conecte-se ao site do SharePoint para verificar se o SharePoint está em execução. • Permissões do SQL Server para o SharePoint
Consulte a documentação da Microsoft para obter informações sobre as permissões do SQL Server necessárias par ao SharePoint.
• Acesso a dados do PI Server e do PI AF
Os usuários do PI WebParts precisam de acesso a dados específicos no PI Server e no PI AF. • Configurar a identidade do pool de aplicativos dos PI WebParts Services
Encontre e configure a identidade do pool de aplicativos e crie um PI Mapping ou um PI Trust para a identidade.
• Requisitos para autenticação de identidade em uma instalação do PI WebParts
Para autenticar as identidades e garantir acesso seguro entre o SharePoint e o PI System, é necessário ativar a delegação Kerberos e instalar e referenciar corretamente os certificados em uma instalação do PI WebParts.
• Iniciar o serviço do Windows para chamar no servidor do SharePoint
No servidor do SharePoint, configure o serviço do Windows, Chamadas ao serviço de token do Windows, para iniciar automaticamente.
Atualização do SharePoint
Se estiver atualizando sua plataforma do SharePoint, siga as instruções da Microsoft para fazer isso. Atualize o SharePoint primeiro e, em seguida, atualize o PI WebParts.
Verificar se o SharePoint está em execução
Antes de instalar o PI WebParts, deve-se verificar se o aplicativo da Web do SharePoint contendo pelo menos uma coleta de sites está em execução.
Procedimento
1. Conecte-se ao site do SharePoint usando o nome do computador ou do site. Por exemplo, conecte-se usando o nome do host: http://ServerName/. 2. Se o site do SharePoint não for carregado, verifique se há um site do SharePoint
funcionando na URL desejada.
Caso seja necessário, verifique se o site do SharePoint foi ampliado para adicionar a funcionalidade do SharePoint a um determinado site.
Permissões do SQL Server para o SharePoint
Consulte a documentação da Microsoft referente às permissões do SQL Server necessárias para o SharePoint:
• Plano para as contas administrativas e de serviço (SharePoint Foundation 2010) (http:// technet.microsoft.com/en-us/library/cc288210.aspx)
• Permissões de conta e configurações de segurança (SharePoint Server 2010) (http:// technet.microsoft.com/en-us/library/cc678863(v=office.14).aspx)
• Permissões de conta e configurações de segurança no SharePoint 2013 (http:// technet.microsoft.com/en-us/library/cc678863.aspx)
Acesso a dados do PI Server e do PI AF
Os usuários do PI WebParts precisam de acesso a dados específicos no PI Server e no PI AF. Para conceder acesso ao PI Server, use o PI System Management Tools (SMT). Por exemplo, pode-se criar um PI Mapping que vincule uma ou mais contas do Windows a uma PI Identity, cujo acesso necessário é concedido.
É necessário conceder o seguinte acesso aos usuários do PI WebParts, inclusive identidade do pool de aplicativos dos PI WebParts Services:
• Acesso de leitura aos módulos de configuração no PI Module Database (por padrão,
RtWebParts e RtBaseline). O módulo RtWebParts armazena dados de configuração para o PI WebParts, e o módulo RtBaseline armazena dados de configuração para os PI WebParts
Services. Acesso de leitura que permite que os usuários se conectem às fontes de dados, acessem conjuntos de dados e configurem displays das web parts.
• Acesso de leitura a todos os servidores do PI AF que o PI WebParts usa para pesquisar e exibir dados de atributos do PI AF e que a web part do PI TreeView usa.
• Acesso de leitura à segurança de pontos e de dados para todos os pontos do PI acessados pelo PI WebParts.
Configurar a identidade do pool de aplicativos dos PI WebParts Services
Use o Internet Information Services (IIS) Manager no computador dos PI WebParts Services para configurar a identidade do pool de aplicativos que os PI WebParts Services usam para autenticar com o PI Server e o PI AF. Pode-se usar uma conta incorporada ou personalizada. A OSIsoft recomenda usar uma conta personalizada e criar um usuário do Active Directory do Windows configurado como uma conta de serviço para agir como uma conta de segurança para o pool de aplicativos.
Procedimento
1. Encontre o pool de aplicativos para o site dos PI WebParts Services:
a. Clique em Iniciar > Ferramentas administrativas > Internet Information Services (IIS) Manager.
b. No painel Conexões, expanda o servidor contendo o site e expanda Sites para listar os
sites configurados.
c. Clique com o botão direito do mouse no site dos PI WebParts Services e clique em
Gerenciar site > Configurações avançadas.
d. Observe que o pool de aplicativos está configurado para executar o aplicativo do site. Instalação do PI WebParts
e. Clique em Cancelar.
2. Configura a identidade do pool de aplicativos:
a. No painel Conexões, no servidor do site, clique em Pools de aplicativos.
b. Na lista Pools de aplicativos, clique com o botão direito do mouse no pool de aplicativos
do site dos PI WebParts Services e cliquem em Configurações avançadas.
c. Na janela Configurações avançadas, em Modelo do processo, clique no campo Identidade e no botão do navegador para abrir a janela Identidade do pool de aplicativos que mostra a conta.
d. Especifique a conta desejada para o pool de aplicativos dos PI WebParts Services: ▪ Para usar uma conta do sistema, selecione Conta incorporada e selecione a conta.
▪ Para usar uma conta personalizada, selecione Conta personalizada e clique em Configurar para determinar as credenciais da conta.
e. Clique em OK.
3. Crie um PI Mapping que dá a essa identidade do pool de aplicativos acesso de leitura a todos os pontos do PI e atributos dos pontos do PI e a quaisquer caminhos de configuração que possam ser solicitados pelo PI WebParts. Como alternativa, pode-se criar um PI Trust, apesar de esse método menos seguro não ser recomendado.
Identidade do pool de
aplicativos Opções de segurança do PI Server
Conta incorporada ◦ PI Mapping (recomendado) para a segurança principal predefinida
◦ PI Trust (não recomendado) para a execução do aplicativo w3wp.exe no endereço IP do computador com os PI WebParts Services em execução
Conta personalizada com nome
de usuário e senha específicos ◦ PI Mapping (recomendado) para a o usuário AD ou um PITrust para o nome de usuário ◦ PI Trust (não recomendado) para a execução do aplicativo
w3wp.exe no endereço IP do computador com os PI WebParts Services em execução
Para obter mais informações, consulte a documentação do Microsoft SharePoint sobre as contas administrativas e de serviço necessárias para a implementação inicial do SharePoint (http://technet.microsoft.com/en-us/library/ee662513.aspx).
Requisitos para autenticação de identidade em uma instalação do PI
WebParts
Os certificados e o Kerberos permitem que os componentes de software autentiquem as identidades. Para garantir acesso seguro entre o SharePoint e o PI System, talvez seja necessário configurar os certificados ou a delegação Kerberos em um ou mais servidores na instalação do PI WebParts.
A tabela a seguir mostra onde você deve configurar os certificados ou a delegação Kerberos. O requisito depende da arquitetura de instalação, do método do PI Server usado para autenticar os PI WebParts Services e do tipo de site do SharePoint.
Requisitos de certificado e do Kerberos para várias arquiteturas de instalação Arquitetura Método de autenticação
do PI Server Tipo de site doSharePoint Requisitos deconfiguração PI WebParts Services e
servidor do SharePoint no mesmo computador
Segurança Integrada do
Windows (recomendado) Modo clássico • Delegação Kerberospara PI WebParts Services
Modo de chamadas • Delegação Kerberos para PI WebParts Services
PI trusts (não
recomendado) Modo clássicoModo de chamadas NenhumNenhum Instalação do PI WebParts
Arquitetura Método de autenticação
do PI Server Tipo de site doSharePoint Requisitos deconfiguração PI WebParts Services e servidor do SharePoint em computadores diferentes Segurança Integrada do Windows (recomendado)
Modo clássico • Delegação do Kerberos para o servidor do SharePoint
• Delegação Kerberos para PI WebParts Services
Modo de chamadas Opção 1 (Kerberos): • Delegação do Kerberos para o servidor do SharePoint • Delegação Kerberos para PI WebParts Services Opção 2 (certificados): • Delegação Kerberos para PI WebParts Services • Certificados do servidor do SharePoint e PI WebParts Services PI trusts (não
recomendado) Modo clássico • Delegação do Kerberospara o servidor do SharePoint
Modo de chamadas Opção 1 (Kerberos): • Delegação do Kerberos para o servidor do SharePoint Opção 2 (certificados): • Certificados do servidor do SharePoint e PI WebParts Services
Para obter informações sobre como configurar a delegação Kerberos, consulte Configuração da delegação Kerberos.
Para obter informações sobre como configurar certificados, consulte Configuração de certificados.
Iniciar o serviço do Windows para chamar no servidor do SharePoint
Para oferecer suporte aos sites do modo de chamadas, o serviço do Windows, as Chamadas para o serviço de token do Windows, deve estar em execução. No servidor do SharePoint, defina esse serviço para iniciar automaticamente.
Procedimento
1. Use a ferramenta administrativa Serviços para configurar a propriedade de serviço Tipo de inicialização para Automático.
2. Use os serviços na página Servidor da Administração Central do SharePoint para verificar se o serviço foi iniciado.
Instalar o PI WebParts
Para instalar o PI WebParts, é necessário instalar a solução do SharePoint do PI WebParts e os PI WebParts Services e configurar o SharePoint.
Antes de Iniciar
Determine a arquitetura da implementação e consulte a lista de verificação de pré-instalação.
Procedimento
1. Instalar a solução do PI WebParts.
Execute o programa de instalação para instalar a solução do SharePoint do PI WebParts em um computador com o SharePoint instalado. Também é possível instalar os PI WebParts Services.
2. Implementar a solução do PI WebParts nos aplicativos da Web do SharePoint.
Use a Administração Central do SharePoint para implementar a solução do SharePoint do PI WebParts instalada nos aplicativos da Web do SharePoint.
3. Ativar o recurso Configuração de PI WebParts para os aplicativos desejados do SharePoint
Use a Administração central do SharePoint para ativar o recurso de configuração do PI WebParts para qualquer aplicativo da web do SharePoint do qual você deseja usar o PI WebParts.
4. Instalar os PI WebParts Services.
Execute o programa de instalação para instalar os PI WebParts Services, caso eles ainda não estejam instalados.
5. Configurar os aplicativos da web do SharePoint para o PI WebParts.
Use a Administração central do SharePoint para ativar o recurso de configuração para o aplicativo de administração e para inserir as configurações que o SharePoint precisa para integrar o PI WebParts.
6. Ative o PI WebParts como um recurso de coleta de sites.
Depois de ativar o PI WebParts como um recurso de coleção de sites do SharePoint, o PI WebParts aparece na galeria de web parts, e os usuários podem colocá-lo nas páginas.
Instalar a solução do PI WebParts
Execute o programa de instalação do PI WebParts para instalar a solução do SharePoint do PI WebParts em um computador com o SharePoint instalado. Durante a instalação, é possível instalar os PI WebParts Services no mesmo computador. Como alternativa, execute
separadamente o programa de instalação do PI WebParts para instalar os PI WebParts Services no mesmo computador ou em outro.
Dica:
Para instalar a solução do SharePoint PI WebParts, o programa de instalação deve reiniciar o IIS. Portanto, execute o programa de instalação em um momento conveniente para reiniciar o IIS.
Antes de Iniciar
Veja Lista de verificação pré-instalação.
Procedimento
1. Inicie o programa de configuração: Instalação do PI WebParts
◦ Inicie automaticamente o programa de configuração pelo programa de autoextração. ◦ Baixe os arquivos do programa de autoextração para um diretório particular e execute o
arquivo SetupDispatcher.exe para iniciar o programa de configuração.
O programa de configuração pesquisa o SharePoint e versões mais recentes do PI WebParts no computador e abre a janela apropriada.
2. Se o programa de configuração detectar versões do PI WebParts mais antigas que o PI WebParts 2013, desinstale os itens associados:
Para: Execute estas etapas:
Desinstalar
automaticamente a. Clique em Desinstalar.
O programa de configuração remove os itens detectados e escreve as mensagens que mostram seu progresso. Uma mensagem indica quando o processo está concluído.
b. Clique em Continuar. Desinstalar
manualmente a. Clique em Cancelar para fechar o programa de configuração. b. Remova manualmente os itens detectados.
Pode-se usar o arquivo Cleanup_Actions.txt que esse programa de configuração grava no diretório contendo o kit de instalação extraído. Esse arquivo contém os comandos necessários para remover os itens detectados.
c. Reinicie o programa de configuração após a remoção dos itens detectados.
3. No prompt de comando, selecione os recursos a serem instalados:
◦ Marque a caixa de seleção Solução do SharePoint do PI WebParts para adicionar a
solução do PI WebParts ao SharePoint no computador.
Essa caixa de seleção é desmarcada se a solução do SharePoint do PI WebParts já está instalada no computador.
◦ Marque a caixa de seleção PI WebParts Services para instalar os PI WebParts Services no
mesmo computador.
Os requisitos de certificados e delegação Kerberos serão diferentes se os PI WebParts Services forem instalados no mesmo computador no qual a solução do SharePoint do PI WebParts está instalada ou em um computador diferente. Consulte Requisitos para autenticação de identidade em uma instalação do PI WebParts para obter mais informações.
4. Clique em Continuar.
5. No prompt, clique em Reiniciar IIS agora para que o programa de instalação reinicie o IIS.
É necessário reiniciar o IIS ao instalar a solução PI WebParts. Se necessário, adie a instalação até que seja possível reiniciar o IIS.
6. Selecione um método para implementar a solução d PI WebParts no SharePoint.
O programa de instalação pode implementar automaticamente a solução do PI WebPart ao aplicativo da Web do conteúdo padrão (SharePoint - 80) e configurar o SharePoint para usar os PI WebParts Services. Como alternativa, implemente a solução na Administração Central do SharePoint.
◦ Clique em Configuração automática para que o programa de instalação implemente a
solução no SharePoint - 80.
O programa de instalação tentará agendar um trabalho do temporizador para implementar a solução.
◦ Clique em Configuração manual para configurar posterior usando a Central de
administração do SharePoint.
7. Clique em Próximo para instalar os recursos selecionados.
8. Se os PI WebParts Services forem instalados, siga os prompts para instalar os componentes necessários.
a. Siga as solicitações para instalar os componentes necessários no computador para dar suporte aos PI WebParts Services.
Entre os componentes necessários que podem ser instalados antes dos PI WebParts Services estão:
▪ OSIsoft MS Runtime Redistributables ▪ PI Software Development Kit (PI SDK)
▪ PI Software Development Kit de 64 bits (PI SDK) ▪ PI Buffer Subsystem
▪ Ferramenta cliente do PI AF 2014 ▪ PI OLEDB Enterprise
▪ PI OLEDB Enterprise x86 ▪ PI OLEDB 2013 R3
Em qualquer prompt relacionado aos arquivos, clique em Tentar novamente ou Ignorar.
b. Siga as solicitações para instalar os PI WebParts Services. Especificamente, observe: ▪ Na página do IIS, selecione site não SharePoint para os PI WebParts Services.
Se o site não tiver a ligação net.tcp definida, o programa de configuração ativará o protocolo net.tcp do site em uma ligação com a porta TCP 808. É necessário conhecer a porta de ligação ao configurar o SharePoint para usar os PI WebParts Services.
▪ No PI Data Archive da página do Module Database, identifique qual PI Data Archive (ou seja, PI Server) armazena o PI Module Database para ser usado na configuração do PI WebParts e PI WebParts Services. Insira o computador que hospeda esse PI Data Archive (PI Server).
▪ No servidor do SharePoint ou página do Farm, insira as informações sobre o servidor do SharePoint ou farm que essa instância do PI WebParts Services suporta.
Especificamente, selecione o protocolo para a URL ao serviço de token de segurança do SharePoint, o nome do host do servidor do SharePoint independente ou o nome do farm do SharePoint e a porta usada para acessar o serviço do token de segurança.
Nota:
Se for necessário reiniciar o servidor durante a instalação dos PI WebParts Services, reexecute o arquivo depois SetupDispatcher.exe de reiniciar o servidor para concluir a instalação. Nesse caso, o programa de instalação não poderá implementar automaticamente a solução do PI WebParts no aplicativo da Web de conteúdo padrão. Independentemente da seleção original, siga as etapas para implementar
manualmente a solução do PI WebParts, ativar o recurso de Configuração do PI WebParts para os aplicativos da web do SharePoint desejados, configurar os
aplicativos da web do SharePoint para o PI WebParts e ativar o PI WebParts como um recurso de coleção de sites do SharePoint.
9. Quando o progresso da instalação mostra que a instalação do PI WebParts foi concluída, clique em Continuar.
Implementar a solução do PI WebParts nos aplicativos da Web do
SharePoint
Depois de instalar a solução do SharePoint PI WebParts, você deve implementar a solução nos aplicativos da web do SharePoint nos quais deseja usar o PI WebParts. Se o programa de instalação implementou com sucesso a solução ao SharePoint - 80 e esse for o único aplicativo no qual deseja usar o PI WebParts, você pode pular esse procedimento. Se o programa de instalação tiver criado um trabalho do temporizador para implementar a solução, mas o servidor não tiver o serviço do temporizador ativado, será necessário executar manualmente os trabalhos de temporizador (consulte Executar trabalhos do temporizador do SharePoint).
Procedimento
1. Abra a pagina Gerenciamento de soluções no site Administração Central do SharePoint.
Para abrir em: Então:
Programa de instalação do PI
WebParts Clique em de instalação do PI WebParts.Continuar no SharePoint na última página do programa Site Administração Central do
SharePoint a. No painel de navegação Configurações do sistema.Administração central, clique em b. Em Gerenciamento da farm, clique em Gerenciar soluções da
farm.
2. Na página Gerenciamento de soluções, clique em pi webparts_2013.wsp.
3. Na página Propriedades da solução, clique em Implementar solução.
4. Na página Implementar solução, da lista Escolher um aplicativo da web para implementar essa solução, selecione o aplicativo no qual deseja usar o PI WebParts.
É possível selecionar Todos os aplicativos de conteúdo da web para implementar a solução
a todos os aplicativos instalados atualmente.
5. Clique em OK para implementar a solução ao aplicativo selecionado.
Depois de implementar a solução a um aplicativo, você deve ativar o recurso de
Configuração do PI WebParts para o aplicativo antes de poder usar o PI WebParts nesse aplicativo.
6. Repita as etapas de 2 a 5 para cada aplicativo no qual deseja usar o PI WebParts.
O que Fazer Depois
Ativar o recurso Configuração de PI WebParts para os aplicativos desejados do SharePoint.
Executar trabalhos do temporizador do SharePoint
Se o programa de instalação criar um trabalho do temporizador para implementar a solução do PI WebParts ao SharePoint, o servidor do SharePoint deverá ter um serviço do temporizador habilitado para executar o trabalho do temporizador. Se o serviço não estiver habilitado, use o comando stsadm.exe para executar manualmente os trabalhos do temporizador.
Procedimento
1. No prompt de comando, acesse o diretório que armazena o arquivo executável:
◦ No SharePoint 2010, Program Files\Common Files\Microsoft Shared\web server extensions\14\bin
◦ No SharePoint 2013, Program Files\Common Files\Microsoft Shared\web server extensions\15\bin
2. Digite o seguinte comando: stsadm.exe -o execadmsvcjobs.
O SharePoint executa o trabalho do temporizador criado pelo programa de instalação para implementar a solução do PI WebParts.
Ativar o recurso Configuração de PI WebParts para os aplicativos desejados
do SharePoint
Para usar o PI WebParts em um aplicativo da web do SharePoint, deve-se ativar primeiro o recurso de configuração do PI WebParts para esse aplicativo.
Procedimento
1. No painel de navegação Administração central da Administração Central do SharePoint,
clique em Gerenciamento de aplicativos.
2. Na página Gerenciamento de aplicativos em Aplicativos da Web, clique em Gerenciar aplicativos da Web.
3. Para cada aplicativo a partir do qual você deseja usar o PI WebParts, ative o recurso de configuração do PI WebParts:
a. Na lista de aplicativos, selecione o aplicativo da web do SharePoint a partir do qual você deseja usar o PI WebParts.
b. Na guia Aplicativos da Web no grupo Gerenciar, clique em Gerenciar recursos.
c. Na janela Gerenciar recursos de aplicativos da Web na linha Configuração do PI WebParts, clique em Ativar. Se o recurso já estiver ativo, desative o recurso e ative-o novamente.
d. Quando a coluna Status mostrar Ativo na linha Configuração do PI WebParts, clique em OK para fechar a janela.
Instalar os PI WebParts Services
Execute o programa de instalação do PI WebParts para instalar os PI WebParts Services. É possível instalar os PI WebParts Services no mesmo computador do servidor do SharePoint ou em outro computador. Se os PI WebParts Services tiverem sido instalados junto com a solução do PI WebParts no SharePoint, ignore este procedimento.
Antes de Iniciar
Consulte Requisitos dos PI WebParts Services.
Procedimento
1. Inicie o programa de configuração:
◦ Inicie automaticamente o programa de configuração pelo programa de autoextração. ◦ Baixe os arquivos do programa de autoextração para um diretório particular e execute o
arquivo SetupDispatcher.exe para iniciar o programa de configuração.
O programa de configuração pesquisa o SharePoint e versões mais recentes do PI WebParts no computador e abre a janela apropriada.
2. Se o programa de configuração detectar versões do PI WebParts mais antigas que o PI WebParts 2013, desinstale os itens associados:
Para: Execute estas etapas: Desinstalar
automaticamente a. Clique em Desinstalar.
O programa de configuração remove os itens detectados e escreve as mensagens que mostram seu progresso. Uma mensagem indica quando o processo está concluído.
b. Clique em Continuar. Desinstalar
manualmente a. Clique em Cancelar para fechar o programa de configuração. b. Remova manualmente os itens detectados.
Pode-se usar o arquivo Cleanup_Actions.txt que esse programa de configuração grava no diretório contendo o kit de instalação extraído. Esse arquivo contém os comandos necessários para remover os itens detectados.
c. Reinicie o programa de configuração após a remoção dos itens detectados.
3. Se o SharePoint estiver instalado no computador, selecione o recurso do PI WebParts para instalá-lo:
a. Marque a caixa de seleção PI WebParts Services para instalar os PI WebParts Services no
mesmo computador.
b. Clique em Continuar para iniciar o programa de instalação dos PI WebParts Services
4. Siga as solicitações para instalar os componentes necessários no computador para dar suporte aos PI WebParts Services.
Entre os componentes necessários que podem ser instalados antes dos PI WebParts Services estão:
◦ OSIsoft MS Runtime Redistributables ◦ PI Software Development Kit (PI SDK)
◦ PI Software Development Kit de 64 bits (PI SDK) ◦ PI Buffer Subsystem
◦ Ferramenta cliente do PI AF 2014 ◦ PI OLEDB Enterprise
◦ PI OLEDB Enterprise x86 ◦ PI OLEDB 2013 R3
Em qualquer prompt relacionado aos arquivos, clique em Tentar novamente ou Ignorar.
5. Siga as solicitações para instalar os PI WebParts Services. Especificamente, observe: ◦ Na página do IIS, selecione site não SharePoint para os PI WebParts Services.
Se o site não tiver a ligação net.tcp definida, o programa de configuração ativará o protocolo net.tcp do site em uma ligação com a porta TCP 808. É necessário conhecer a porta de ligação ao configurar o SharePoint para usar os PI WebParts Services.
◦ No PI Data Archive da página do Module Database, identifique qual PI Data Archive (ou seja, PI Server) armazena o PI Module Database para ser usado na configuração do PI WebParts e PI WebParts Services. Insira o computador que hospeda esse PI Data Archive (PI Server).
◦ No servidor do SharePoint ou página do Farm, insira as informações sobre o servidor do SharePoint ou farm que essa instância do PI WebParts Services suporta. Especificamente, selecione o protocolo para a URL ao serviço de token de segurança do SharePoint, o nome do host do servidor do SharePoint independente ou o nome do farm do SharePoint e a porta usada para acessar o serviço do token de segurança.
6. Quando o progresso da instalação mostra que a instalação do PI WebParts foi concluída, clique em Continuar.
7. Após a instalação dos PI WebParts Services, clique em Continuar no SharePoint para
configurar o SharePoint para usar os PI WebParts Services.
Configurar os aplicativos da web do SharePoint para o PI WebParts
Usar a Administração Central do SharePoint para configurar os aplicativos da web do
SharePoint para o PI WebParts. Este procedimento poderá ser ignorado se todas as seguintes condições forem verdadeiras:
• A solução do PI WebParts e o PI WebParts Services foram instalados no mesmo computador e ao mesmo tempo.
• A configuração automática foi usada, e o programa de configuração implementou a solução com êxito no SharePoint - 80.
• Você usará somente o PI WebParts no aplicativo do SharePoint - 80.
• A identidade do pool de aplicativos dos PI WebParts Services não é um nome de usuário de domínio.
Antes de Iniciar
• Instalar os PI WebParts Services.
• Implementar a solução do PI WebParts nos aplicativos da Web do SharePoint.
Procedimento
1. Ativar o recurso Configuração de PI WebParts para os aplicativos de administração do SharePoint.
Use a Administração central do SharePoint para ativar o recurso Configuração de PI WebParts para os aplicativos de administração do SharePoint.
2. Inserir as configurações que cada aplicativo SharePoint da web precisa para as PI WebParts..
Para cada aplicativo da web do SharePoint que usará as PI WebParts, use a página de Configurações de PI WebParts no SharePoint para inserir as configurações que o aplicativo precisa para integrar as PI WebParts.
O que Fazer Depois
Ative o PI WebParts como um recurso de coleta de sites.
Ativar o recurso Configuração de PI WebParts para os aplicativos de
administração do SharePoint
Para configurar o SharePoint para usar os PI WebParts Services, primeiro, é necessário ativar o recurso de configuração do PI WebParts para o aplicativo de administração do SharePoint. Só é necessário ativar esse recurso uma vez para o aplicativo de administração do SharePoint.
Procedimento
1. No painel de navegação Administração central da Administração Central do SharePoint,
clique em Gerenciamento de aplicativos.
2. Na página Gerenciamento de aplicativos em Aplicativos da Web, clique em Gerenciar aplicativos da Web.
3. Na lista de aplicativos, selecione SharePoint Central Administration v4.
4. Na guia Aplicativos da Web no grupo Gerenciar, clique em Gerenciar recursos.
5. Na janela Gerenciar recursos de aplicativos da Web na linha Configuração do PI WebParts, clique em Ativar.
6. Quando a coluna Status mostrar Ativo na linha Configuração do PI WebParts, clique em OK
para fechar a janela.
O que Fazer Depois
Inserir as configurações que cada aplicativo SharePoint da web precisa para as PI WebParts..
Inserir as configurações que cada aplicativo SharePoint da web precisa
para as PI WebParts.
Para cada aplicativo da web do SharePoint que usará as PI WebParts, insira as configurações que o aplicativo precisa para integrar as PI WebParts. Essas configurações controlam o acesso aos PI WebParts Services, a autenticação dos PI WebParts Services e as identidades usadas para o acesso a arquivos no site do PI WebParts e acesso a dados do PI System. Insira essas configurações na página Configuração do PI WebParts no SharePoint.
Antes de Iniciar
• Ativar o recurso Configuração de PI WebParts para os aplicativos de administração do SharePoint.
• Configure os certificados ou delegação Kerberos, conforme solicitado. Veja Requisitos para autenticação de identidade em uma instalação do PI WebParts.
• Ativar o recurso Configuração de PI WebParts para os aplicativos desejados do SharePoint.
Procedimento
1. Abra a página Configuração do PI WebParts no SharePoint:
a. No painel de navegação Administração central, clique em Assistentes de configuração.
b. Na página Assistentes de configuração, clique em Configuração do PI WebParts.
2. Na lista de aplicativo da web que hospeda o PI WebParts, selecione o aplicativo da web do
SharePoint que deseja configurar para o PI WebParts.
A lista contém aplicativos da web do SharePoint para os quais você ativou o recurso de Configuração do PI WebParts. A configuração nesta página controla como o aplicativo da web do SharePoint selecionado acessa o PI WebParts Services.
3. Configure a URL usada pelo aplicativo da web do SharePoint para contatar os PI WebParts Services:
a. No campo URL dos PI WebParts Services, insira a URL do site dos PI WebParts Services
especificado durante a instalação. Especifique a URL usando o protocolo net.tcp.
Por exemplo, é possível especificar net.tcp://ServerName:NNN em que ServerName é o nome do domínio totalmente qualificado e NNN é a ligação de site net.tcp configurada para o site (808 por padrão).
b. Clique em Testar para fazer a verificação Uma marca de verificação verde indica que a
URL é válida.
4. Se você especificou o aplicativo da web do SharePoint do modo de chamadas, configure como os aplicativos usam identidades para acesso a arquivos e autenticação com os PI WebParts Services:
a. Se os PI WebParts Services e o servidor do SharePoint estiverem instalados em
computadores diferentes, marque a caixa de seleção Usar certificados para sites do modo de chamadas para usar certificados.
Com essa configuração, o servidor do SharePoint poderá personificar usuários durante o processo de autenticação com os PI WebParts Services. Com a personificação, os dados retornados do PI System são baseados nos privilégios do usuários conectado
personificado. Esse é o modo de operação mais seguro. Deve-se lembrar que também é necessário configurar os certificados. Sem essa configuração, todos os usuários têm acesso aos mesmos dados.
b. Marque a caixa de seleção Personificar usuários em um servidor do SharePoint para sites do modo de chamadas para que o PI WebParts personifique usuários.
Com essa configuração, qualquer site do PI WebParts concede acesso aos arquivos baseados nos privilégios do usuário conectado personificado. Além disso, se os PI WebParts Services e o servidor do SharePoint forem instalados no mesmo computador, essa configuração permitirá que o servidor do SharePoint personifique os usuários durante a autenticação com os PI WebParts Services. Sem essa configuração, o site do PI WebParts concede acesso aos arquivos baseados nos privilégios da identidade do pool de aplicativos do SharePoint.
5. Especifique a identidade usada pelo aplicativo da web do SharePoint para autenticar os PI WebParts Services:
a. Na lista Tipo de identidade, selecione o tipo de identidade que os PI WebParts Services
usam para se comunicarem com o SharePoint.
b. No campo Identidade válida, insira o nome da identidade válida.
c. Se a identidade for um nome de domínio, clique em Testar para verificar se a identidade
inserida é válida. Uma marca de verificação verde indica uma entrada válida; um X vermelho indica uma identidade inválida.
Para verificar a comunicação dos PI WebParts Services, o SharePoint autenticará a identidade especificada.
Por exemplo, na lista Tipo de identidade, selecione Nomes de serviço principal, e depois
defina Identidade válida para um nome de serviço principal para a conta de pool de
aplicativos do PI WebParts Services, HTTP/appserver em que appsever é o computador do PI WebParts Services.
6. No campo Nome de domínio, insira o membro da farm do SharePoint que deve ser usado
pelos PI WebParts Services para acessar o serviços do token de segurança do SharePoint. O processo de implementação da solução do PI WebParts define esse campo para um servidor do SharePoint disponível. Pode-se designar um servidor diferente que hospede o serviço do token de segurança.
7. Clique em Concluído.
Ative o PI WebParts como um recurso de coleta de sites
Em cada aplicativo da web do SharePoint, deve-se ativar o PI WebParts como um recurso de coleta de sites do SharePoint para que o PI WebParts apareça na galeria de web parts e coloque-os nas novas páginas de web parts.
Procedimento
1. Efetue login como um administrador no site do SharePoint.
2. Na página Início do conjunto de sites (o site pai), vá para a página Configurações do site: ◦ No SharePoint 2010, clique em Ações do Site > Configurações do Site.
◦ No SharePoint 2013, clique em Configurações e em Configurações do Site.
3. Em Administração da reunião de sites, clique em Recursos da reunião de sites.
4. Na página Recursos na linha OSIsoft PI WebParts, clique em Ativar.
PI WebParts como um recurso de coleta de sites do SharePoint
Os administradores podem controlar o acesso aos aplicativos da web e componentes configurados como recursos de coleção de sites do SharePoint. Os recursos ativados estão disponíveis para os usuários com permissões correspondentes. Os recursos desativados são desabilitados de maneira efetiva até que sejam reativados.
Quando o recurso de coleta de sites do PI WebParts é ativado, as web parts são adicionadas à galeria "Site da equipe". Quando o recurso de coleta de sites do PI WebParts é desativado, as web parts deixam de aparecer na galeria de web parts e não podem ser colocadas em novas páginas de web parts. As páginas que usam o PI WebParts e que são criadas antes da desativação do recursos continuam a funcionar corretamente.
O programa de instalação não ativa o PI WebParts como um recurso de coleta de sites. Se as coletas de sites forem adicionadas ao aplicativo da Web no qual o PI WebParts está instalado, será necessário ativar explicitamente o recurso de coleta de sites do PI WebParts antes de ele ser disponibilizado para uso na nova coleta de sites. Se não for possível ver o PI WebParts na lista das web parts disponíveis para uma página, talvez o PI WebParts tenha sido desativado.
Lista de verificação pós-instalação
Após a instalação do PI WebParts: • Teste a instalação do PI WebParts.
• Limite o acesso ao site Administração do PI WebParts.
• Instale o software apropriado e os níveis de segurança razoáveis do navegador nas estações de trabalho cliente.
• Instale o pacote de idiomas MUI (interface de usuário multilíngue) para visualizar a interface do PI WebParts em outros idiomas.
Nesta seção
• Testar a instalação do PI WebParts
No site do SharePoint, adicione uma web part do PI Trend para verificar se o PI WebParts está funcionando corretamente.
• Acesso ao site Administração do PI WebParts
Pode-se limitar o acesso padrão obtido às páginas Administração do PI WebParts. • Definir o idioma da interface de usuário do PI WebParts
Para visualizar a interface de usuário do PI WebParts em outros idiomas, instale o MUI do PI WebParts e configure o site ou o navegador.
Testar a instalação do PI WebParts
Após a instalação do PI WebParts e dos PI WebParts Services, será possível verificar se a instalação do PI WebParts é operacional.
Procedimento
1. No navegador, acesse o site do SharePoint no computador em que o PI WebParts está instalado.
2. Ative as ferramentas de edição:
◦ No SharePoint 2010, clique em Ações do site > Configurações do site.
◦ No SharePoint 2013, clique em Configurações e em página de Edição.
3. Na guia Inserir, clique no botão Web part.
4. Adicione a web part do PI Trend à página: a. Em Categorias, clique em PI WebParts.
b. Em Web parts (SharePoint 2010) ou Parts (SharePoint 2013), clique em PI Trend.
c. Clique em Adicionar.
Se necessário, será solicitado o download do Adobe SVG Viewer.
5. Clique na seta do Menu da web part do PI Trend no canto superior direito da web part e
clique em Editar web part.
A página adiciona o painel de ferramentas PI Trend no lado direito da página (talvez seja
necessário rolar).
6. Especifique os dados a serem mostrados na tendência:
a. Em Dados selecionados, clique em Selecionar PI Data para abrir a janela Selecionar PI Data.
b. No caminho na parte superior da janela, defina o escopo da pesquisa do PI Server. c. No campo Texto de pesquisa, digite o texto para identificar um ponto do PI e clique em
Pesquisar .
Por exemplo, digite sinusoid. Pode-se incluir um asterisco (*) como curinga para vários caracteres, mas é necessário inserir pelo menos um caractere não curinga.
O painel Resultados da pesquisa mostra os pontos do PI que correspondem aos critérios de pesquisa inseridos.
Se uma mensagem de erro for exibida, verifique o PI Mapping ou o PI Trust no PI Server para garantir que os privilégios de acesso corretos foram configurados. Também é possível verificar a página Fontes de dados do PI no site Administração do PI WebParts para garantir que o PI Server seja acessível ou verificar os critérios de pesquisa. d. Clique em um ponto no painel Resultados da pesquisa e clique em Adicionar
selecionados para adicionar o painel Itens selecionados.
e. No caminho na parte superior da janela, defina o escopo da pesquisa do servidor e do banco de dados do PI AF.
f. No campo Texto de pesquisa, digite o texto para identificar um atributo do PI e clique em Pesquisar .
g. Clique em um atributo no painel Resultados da pesquisa e clique em Adicionar selecionados para adicionar o painel Itens selecionados.
h. Clique em OK para usar os itens de dados selecionados na tendência.
7. No painel de ferramentas PI Trend, clique em Aplicar para mostrar os dados da tendência
configurada na web part.
Acesso ao site Administração do PI WebParts
A configuração padrão dá acesso a todos às páginas Administração do PI WebParts. Pode-se restringir o acesso criando um grupo do Windows chamado RtWebPartsAdmin. Se esse grupo existir, apenas os seus membros poderão acessar as páginas Administração do PI WebParts. Os usuários com acesso à essas páginas ainda precisam ter os privilégios apropriados para editar o banco de dados de configuração, por exemplo, para criar fontes de dados, conjuntos de dados, formatos de tabela ou ajustes de configurações. Ou seja, esses usuários precisam de acesso de leitura e gravação aos módulos RtWebParts e RtBaseline do PI Module Database.
Tipo de instalação URL do site Administração de PI WebParts
Sem farm, no SharePoint - 80 http://server/_layouts/PI_WebParts/admin.aspx Farm do SharePoint http://loadbalancer/_layouts/PI_WebParts/admin.aspx
em que loadbalancer é o nome do computador que executa o balanceador de carga para o farm do SharePoint
Definir o idioma da interface de usuário do PI WebParts
Para permitir que os usuários vejam a interface do PI WebParts em qualquer idioma com suporte, instale o pacote de idiomas do MUI do PI WebParts e defina o idioma. Dependendo da versão do SharePoint, será possível definir o idioma ao criar o site ou alterar o idioma do navegador.
Procedimento
1. Baixe o pacote de idiomas MUI do PI WebParts da página Downloads do Suporte Técnico da OSIsoft (https://techsupport.osisoft.com/Downloads/All-Downloads/).
2. Instale o pacote de idiomas MUI do PI WebParts. 3. Defina o idioma da interface de usuário do PI WebParts:
◦ No SharePoint 2010, defina o idioma do site ao criá-lo.
◦ No SharePoint 2013, defina o idioma do navegador em cada navegador cliente antes de carregar o site.
Idiomas suportados
Com o pacote de idiomas MUI do PI WebParts instalado, é possível visualizar a interface de usuário do PI WebParts nos seguintes idiomas:
• francês • alemão • japonês • coreano
