PI Coresight 2016
Guia de instalação e administração
San Leandro, CA 94577 USA Tel: (01) 510-297-5800 Fax: (01) 510-357-8136 Web: http://www.osisoft.com
Guia de instalação e administração do PI Coresight 2016 © 2011-2016 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 a logomarca da OSIsoft, Managed PI, OSIsoft Advanced Services, OSIsoft Cloud Services, OSIsoft Connected Services, PI ACE, PI Advanced Computing Engine, PI AF SDK, PI API, PI Asset Framework, PI Audit Viewer, PI Builder, PI Cloud Connect, PI Connectors, PI Coresight, PI Data Archive, PI DataLink, PI DataLink Server, PI Developer’s Club, PI Integrator for Business Analytics, PI Interfaces, PI JDBC driver, PI Manual Logger, PI Notifications, PI ODBC, PI OLEDB Enterprise, PI OLEDB Provider, PI OPC HDA Server, PI ProcessBook, PI SDK, PI Server, PI Square, PI System, PI System Access, PI Visualization Suite, PI Web API, PI Web Services e RLINK são todos 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: 3.0.0.4
Arquitetura do PI Coresight e requisitos do sistema... 1
Arquitetura do PI Coresight...1
Fluxo de dados... 2
Sobre o servidor da Web do PI Coresight... 3
Conjuntos de aplicativos e contas de serviço do PI Coresight...3
Grupos de acesso do PI Coresight...4
Requisitos de software e hardware... 4
Requisitos de software para o servidor de aplicativo do PI Coresight... 5
Requisitos de software do PI Coresight Application Server...6
Requisitos do Microsoft SQL Server... 6
Requisitos do PI System para o PI Coresight...6
Versão de display do PI ProcessBook...7
Requisitos do cliente... 7
Upgrades do PI Coresight... 9
Fazer upgrade de uma instalação do PI Coresight... 9
Backups automáticos de atualização do PI Coresight...11
Instalação do PI Coresight... 13
Entendendo o processo de instalação...13
Fase 1: preparando o servidor de aplicativo... 14
Verificar exigências de hardware e software... 14
Preparar o computador do PI Coresight Application Server... 14
Adicionar funções e recursos do servidor... 15
Configurar o acesso do Secure Sockets Layer (SSL)...18
Fase 2: criando uma conta de serviço e configurando permissões...19
Crie uma conta de serviço para o PI Coresight... 19
Conceder permissões de acesso da conta de serviço do PI Coresight... 21
Fase 3: executando o processo de instalação... 30
Recomendações de instalação...30
Lista de verificação pré-instalação... 31
Instalar o PI Coresight...33
UI de vários idiomas disponível para instalação... 36
Executar uma instalação silenciosa...36
Fase 4: configurando o PI Coresight após a instalação... 37
Adicionar um servidor PI Data Archive ou um PI AF Server à lista de servidores registrados...38
Configure os pools de aplicativos do PI Coresight para usar a conta de serviço do PI Coresight...38
Criação do banco de dados do PI Coresight... 39
Permitir acesso a cada servidor PI Data Archive por meio do PI Coresight... 44
Permitir acesso a cada PI AF Server por meio do PI Coresight...44
Configurar pastas de importação do PI ProcessBook... 45
Fase 5: configurando a delegação do Kerberos... 47
Criar PI mappings... 47
Ativar a delegação de Kerberos... 48
Configurar navegadores da Web para os clientes do PI Coresight... 54
Autenticação do servidor PI Data Archive nos dispositivos móveis... 56
Autenticação básica... 56
Tarefas de administração do PI Coresight...59
O site de administração do PI Coresight...60
Gerenciar usuários e recursos...62
Configurar o acesso do usuário no aplicativo do PI Coresight...62
Redefinir as configurações do usuário...63
Reatribuir a propriedade do display... 63
Alterar o servidor AF usado para armazenar AF identities...63
Restringir o acesso do usuário a bancos de dados do AF...64
Restringir a pesquisa definindo raízes de pesquisa do banco de dados do AF...65
Configurar permissões para que os usuários possam anotar e reconhecer eventos...66
Alterar os tipos de arquivo de anotações do evento e os limites de tamanho...68
Atualizar a instância do SQL Server e o banco de dados do PI Coresight... 69
Estratégia de backup para o banco de dados do PI Coresight...70
Alterar a conta do banco de dados do PI Coresight... 71
Configurações de fuso horário e regionalização... 71
Alterar as configurações de fuso horário... 71
Alterar as configurações de regionalização...74
Desinstalar o PI Coresight... 74
Parâmetros da URL para controlar a apresentação de displays... 75
Caminhos de URL base...76
Referência de parâmetros de URL... 76
Criar um novo display temporário (ad hoc) com itens de dados especiais... 78
Abrindo um display salvo existente... 79
Aplicar modo de quiosque para um display... 80
Reutilizar as exibições para construir ativos a partir do mesmo modelo AF...81
Especificar o elemento para as exibições de elemento relativas do ProcessBook de PI ... 82
Configurar o fuso horário para um display...82
Ocultar a barra de ferramentas ou a barra de tempo ...83
Evitar o redirecionamento automático para um website para dispositivo móvel do PI Coresight...84
Opções de alta disponibilidade para o PI Coresight... 85
Apêndice A: Visualizar e configurar o registro de mensagens do PI Coresight...89
Visualizar os registros de mensagem... 89
Coletar eventos de análise de depuração com o Monitor de Desempenho do Windows... 90
Suprimir mensagens duplicadas (supressão de mensagem)... 90
Vídeos de tutoriais... 91
Arquitetura do PI Coresight e requisitos do sistema
Nesta seção• Arquitetura do PI Coresight
• Requisitos de software e hardware
Arquitetura do PI Coresight
O PI Coresight é um aplicativo baseado em navegador que permite recuperar, monitorar e analisar as informações de engenharia de processo facilmente.
Os componentes principais para uma instalação do PI Coresight são:
• (1) Clientes
Os clientes são usuários individuais do PI Coresight que acessam dados de PI. O PI Coresight é suportado pelos navegadores mais modernos em uma ampla variedade de computadores, inclusive tablets e telefones que executam os sistemas operacionais iOS ou Android. • (2) PI Coresight Application Server
O servidor de aplicativo fornece o ambiente de execução para o PI Coresight. O servidor de aplicativo manipula todas as operações de aplicativo entre usuários (clientes) e servidores PI Data Archive, PI AF Servers, Microsoft SQL Server e PI Web API.
• (3) PI Web API
A PI Web API fornece acesso programático, de plataforma cruzada, para vários usuários aos dados do PI System.
• (4) PI Web API Crawler
O PI Web API Crawler permite a funcionalidade de pesquisa do PI Coresight ao fazer rastreamento periodicamente dos servidores registrados para metadados e criando um índice de pesquisa.
• (5) Servidor PI Data Archive
O PI Data Archive é o coração do PI System. Ele fornece um armazenamento e arquivamento eficiente de dados de séries cronológicas, permitindo a recuperação de dados de alto desempenho por software cliente. O PI Coresight recupera dados do PI System do servidor PI Data Archive e PI AF Server.
• (6) PI AF server
PI Asset Framework (PI AF) é um repositório único para modelos cêntricos de ativos, hierarquias, objetos e equipamentos. Ele integra, contextualiza, refina, referencia e analisa detalhadamente dados de várias fontes, incluindo um ou mais servidores PI Data Archive. Juntos, esses metadados e dados de séries cronológicas fornecem uma descrição detalhada de equipamento de ativos.
• (7) Banco de dados do PI Coresight em um Microsoft SQL Server
O PI Coresight armazena as configurações e definições de display do usuário em um banco de dados Microsoft SQL. As definições de display incluem dados como nome do display e proprietário do display, símbolos no display, permissões do usuário, etc.
Nota:
A OSIsoft recomenda que o PI Coresight use o mesmo Microsoft SQL Server que o PI AF usa. Caso contrário, é possível instalar um SQL Server no mesmo computador que o PI Coresight Application Server, ou usar uma instalação do SQL Server dedicada. A OSIsoft recomenda fortemente que os servidores PI Data Archive e os PI AF Servers estejam no mesmo domínio que o PI Coresight Application Server e SQL Server hospedando o banco de dados do PI Coresight.
Nesta seção • Fluxo de dados
• Sobre o servidor da Web do PI Coresight
• Conjuntos de aplicativos e contas de serviço do PI Coresight
• Grupos de acesso do PI Coresight
Fluxo de dados
Segue abaixo um exemplo de um típico fluxo de dados que ocorre à medida que elementos de arquitetura diferente interagem para fornecer dados do PI System ao cliente.
Ao buscar por dados em um novo display do PI Coresight:
1. Quando um usuário realiza uma busca por um item de dados (ativos, atributo ou ponto PI), o cliente envia uma solicitação para esse item de dados para o PI Coresight Application Server. A solicitação é retransmitida para o PI Web API, que preenche os resultados de pesquisa recuperados do índice local criado pelo PI Web API Crawler.
2. Com base nos resultados de pesquisa, o usuário pode criar um símbolo para o item de dados arrastando-o para o display. O símbolo no display ainda não contém nenhum valor de dados do PI.
3. A criação do símbolo aciona uma solicitação para os dados PI, os quais PI Coresight Application Server retransmite para o servidor do PI Data Archive ou PI AF. Quando os dados PI retornam ao cliente, os símbolos no display são preenchidos com valores de dados. 4. Quando um usuário salva o display, a definição de display (configurações de display) é
enviada para o Microsoft SQL Server e armazenada no banco de dados do PI Coresight.
Ao abrir um display existente do PI Coresight:
1. Quando um usuário abre um display existente, o cliente envia uma solicitação para uma definição de display para o PI Coresight Application Server, que é retransmitida para o Microsoft SQL Server. O SQL Server retorna a definição de display da qual o cliente gera um display com símbolos. Os símbolos ainda não contém nenhum valor de dados.
2. A criação do símbolo aciona uma solicitação para os dados PI, os quais PI Coresight Application Server retransmite para o servidor do PI Data Archive ou PI AF. Quando os dados PI retornam ao cliente, os símbolos são preenchidos com valores de dados.
Sobre o servidor da Web do PI Coresight
O PI Coresight usa três sites:
• O site de administração: https://webServer/Coresight/Admin • O site de aplicativo principal: https://webServer/Coresight/
• A página do banco de dados anexado por PI Web API: https://webServer/piwebapi/ Admin/search/database.html
Em que webServer é o nome do servidor da Web do PI Coresight. O PI Coresight usa o servidor da Web do Internet Information Services (IIS) da Microsoft.
Conjuntos de aplicativos e contas de serviço do PI Coresight
A instalação do PI Coresight cria dois pools de aplicativos e dois serviços do Windows. Os pools de aplicativos executam nas contas de serviço do Windows que possuem as permissões de acesso pelo PI System:
• CoresightAdminAppPool executa o site de administração, localizado em: https://
webServer/Coresight/Admin
• CoresightServiceAppPool executa o site de aplicativo principal do PI Coresight, localizado em https://webServer/Coresight
Os serviços do Windows que o programa de instalação cria são: • PI Web API: uma API RESTful para o PI System
• PI Web API Crawler: as origens de dados dos rastreadores do PI System fornecem metadados para pesquisa indexada
Nota:
O PI Web API Crawler exige acesso de leitura a tabelas PIUSER, PIDBSEC, PIMAPPING e PIPOINT. O acesso a essas tabelas pode ser definido no plug-in de segurança do banco de dados no PI System Management Tools (SMT). Note que por padrão, a identidade PIWorld tem acesso de leitura ao PIUSER, PIPOINT e PIDBSEC. Portanto, o acesso explícito somente é necessário para PIMAPPING, a menos que você tenha desativado o PIWorld. Se o PIWorld estiver desativado, você deve conceder acesso explícito ao PI Web API Crawler a cada uma das quatro tabelas mencionadas acima.
Os pools de aplicativo e as contas de serviço do PI Coresight são executados na conta de serviço do PI Coresight. Esta é a conta que PI Coresight usa para conectar-se aos servidores PI Data Archive e PI AF Servers. Para que os usuários clientes visualizem os dados de PI, a conta doo serviço de PI Coresight necessita de acesso apropriado a esses servidores.
Quando o PI Coresight é instalado, o kit de instalação configura, por padrão, as contas de serviço na conta da máquina do próprio servidor do aplicativo e configura as contas para cada serviço a seguir:
Serviço Conta
CoresightAdminAppPool NT Authority\Network Service
CoresightServiceAppPool NT Authority\Network Service
PI Web API NT Service\piwebapi
PI Web API Crawler NT Service\picrawler
A conta de serviço do PI Coresight nesta configuração é a conta do Active Directory da máquina do servidor. Geralmente, esta conta é nomeada domain\server-name$. Por exemplo,
MyEnterprise\CoresightServer$.
Por motivos de segurança, o OSIsoft recomenda a criação de uma conta de domínio no lugar para os serviços do PI Coresight:
1. Altere a conta de serviço do PI Coresight para uma conta de domínio dedicada. Consulte Crie uma conta de serviço para o PI Coresight.
2. Configure os conjuntos e os serviços de aplicativo para executar nesta conta. Consulte
Configure os pools de aplicativos do PI Coresight para usar a conta de serviço do PI Coresight.
CUIDADO:
O OSIsoft recomenda fortemente a criação de uma conta de domínio para os serviços do PI Coresight. Se usar a conta da máquina, todos os aplicativos em execução no
computador do servidor possuem permissões de acesso no SQL Server, servidor do PI Data Archive e máquinas de PI AF Server. Este é um risco de segurança. No mínimo, considere remover alguns ou todos os aplicativos em execução neste computador.
Grupos de acesso do PI Coresight
O acesso do site de administração do PI Coresight e do site do PI Coresight são controlados através de grupos do Microsoft Windows separados. O programa de configuração do PI Coresight cria estes grupos de usuários locais no servidor do aplicativo do PI Coresight:
• PI Coresight Admins • PI Coresight Users • PI Web API Admins
Para obter mais informações, consulte Configurar o acesso do usuário no aplicativo do PI Coresight e O site de administração do PI Coresight.
Requisitos de software e hardware
Nesta seção• Requisitos do Microsoft SQL Server
• Requisitos do PI System para o PI Coresight
• Versão de display do PI ProcessBook
• Requisitos do cliente
Requisitos de software para o servidor de aplicativo do PI Coresight
Requisitos do banco de dados do Microsoft SQL ServerOs requisitos a seguir têm como base o Microsoft SQL Server, que reside no servidor de aplicativo do PI Coresight. O banco de dados do Microsoft SQL Server exige aproximadamente 200 MB de armazenamento, mais 5 MB por usuário (supondo 200 exibições de tamanho médio por usuário). Se planeja importar as exibições de ProcessBook de PI, permita um mínimo de 500 KB por exibição (supondo exibições de tamanho médio) no SQL Server.
Por padrão, o banco de dados crescerá 200 MB automaticamente cada vez que o limite de tamanho atual for atingido.
Requisitos dos arquivos de índice
Os arquivos de índice podem ser grandes, especialmente se você tiver muitos servidores PI Data Archive ou bancos de dados complexos. Eles estão localizados em sua pasta
ProgramData.
Como orientação aproximada para estimar o tamanho dos arquivos de índice: • Para 1000 pontos PI, permitir cerca de 4MB
• Para 1000 elementos AF (supondo 10 atributos cada), permitir cerca de 14MB Resumo dos requisitos de hardware
Nº de usuários 1 a 50 50 a 250 250 a 500 CPU (principais) 4 4 8 Velocidade da CPU (GHz) 2 2.5 3 Memória (GB) 6 12 24
Você pode estimar o espaço em disco total necessário em MB usando a expressão:
DiskSpace = 250 + 5*Users + 0.004*PIPoints + 0.014*AFElements
Onde os parâmetros são:
• DiskSpace: espaço em disco necessário (MB) • Users: o número de usuários que criam exibições
• PIPoints: o número total de pontos PI em todos os servidores permitidos
• AFElements: o número total de elementos em todas as bases de dados AF permitidas (assume uma média de 10 atributos por elemento)
Nota:
Se seus elementos, atributos e pontos tiverem muitas descrições exclusivas, o tamanho do arquivo de índice poderá ser significativamente maior.
Requisitos de software do PI Coresight Application Server
Os requisitos para o software na máquina hospedando o PI Coresight Application Server estão listados a seguir:
• Microsoft Windows Server 2008 R2 SP1 de 64 bits ou superior • Microsoft Internet Information Services (IIS) 7.5 ou superior • Microsoft .NET Framework 4
• Funções e recursos do Gerenciador do servidor. Consulte Adicionar funções e recursos do servidor para obter detalhes de quais funções e recursos são necessários para o PI Coresight.
Requisitos do Microsoft SQL Server
O PI Coresight exige o Microsoft SQL Server 2008 R2 ou superior. As versões Standard, Enterprise e Express são todas suportadas.
Para aproveitar os mesmos procedimentos de backup usados para PIFD com o banco de dados do PI Coresight, a OSIsoft recomenda que você hospede seu banco de dados do PI Coresight no mesmo SQL Server que o PI AF usa.
Certifique-se de que a configuração do SQL Server Permitir que gatilhos disparem outros gatilhos esteja configurado como True. Para verificar esta configuração:
1. No SQL Server Management Studio, clique com o botão direito do mouse e escolha
Propriedades.
2. Selecione a página Avançado.
3. Permitir que gatilhos disparem outros gatilhos é a primeira configuração na seção Miscelânea.
Nota:
Para cargas mais pesadas (acima de 500 usuários), é exigida uma versão completa do SQL Server executada em um servidor dedicado.
Requisitos do PI System para o PI Coresight
Versão de display do PI ProcessBook
O PI Coresight permite configurar o seu servidor de aplicativo para que os usuários possam visualizar os displays do PI ProcessBook. Os arquivos PDI e SVG produzidos pelo PI
ProcessBook, versão 2.35 ou superior, são importados automaticamente das pastas configuradas.
Para melhores resultados, use os displays salvos do PI ProcessBook usando a versão 3.3.2 ou superior. Isto é especialmente importante para suporte a gráficos e formato numérico regional. Para obter mais informações sobre a importação dos displays do PI ProcessBook, consulte
Configurar pastas de importação do PI ProcessBook.
Requisitos do cliente
Os clientes do PI Coresight precisam usar navegadores da Web compatíveis com HTML5.
Nota:
Esse produto usa cookies que podem ter implicações legais com base na localização geográfica do licenciado. Consulte o departamento legal local para ter certeza de que está de acordo com as leis, regras e regulamentações pertinentes, incluindo, entre outros, proteção de dados e diretrizes de cookies.
Navegadores compatíveis com o PI Coresight
O PI Coresight 2016 é compatível com os seguintes navegadores:• No Windows com o Microsoft Internet Explorer versão 11 e versões atuais do Microsoft Edge, Mozilla Firefox e Google Chrome.
• No Apple Macintosh com a versão atual do Safari. • No iPad e iPhone com o iOS versão 7 ou posterior.
• Em dispositivos Android com versão Android 4 ou posterior.
Nota:
Para que a ajuda online abra com êxito ao clicar no botão Ajuda (?), pode ser necessário desativar o bloqueio de pop-up em seu navegador.
Dispositivos móveis como clientes
Quando um usuário de um dispositivo ou navegador menor acessa o site do aplicativo: https://
webServer/Coresight/ ele é direcionado para o Website para dispositivo móvel do PI Coresight:
https://webServer/Coresight/m por padrão. (É possível substituir este redirecionamento por displays específicos, como em um painel, se necessário. Para obter mais informações, consulte
Prevenir redirecionamento automático para Website para dispositivo móvel do PI Coresight.) No Website para dispositivo móvel, símbolos de valor são mostrados juntamente com uma tendência para displays que não forem importadas. Todos os símbolos são exibidos para displays importados do ProcessBook semelhantes ao comportamento do aplicativo principal do Coresight.
Upgrades do PI Coresight
Quando é feito um upgrade para uma nova versão do PI Coresight, as suas configurações existentes são levadas para a instalação do PI Coresight atualizado. Isso inclui as configurações para os servidores PI Data Archive, os bancos de dados PI AF e o banco de dados do PI
Coresight que forem permitidos.
Fazer upgrade de uma instalação do PI Coresight
Siga as etapas deste procedimento para fazer o upgrade de uma instalação existente do PI Coresight.
Nota:
Durante a instalação, serão visualizadas as telas de configuração para o software a seguir: 1. PI Web API
2. PI Web API Crawler 3. PI Coresight
Se a participação no domínio do computador em que você instalou o PI Coresight for alterada depois da instalação, será preciso desinstalar e reinstalar a PI Web API e o PI Web API Crawler. Se foi usado um certificado autoassinado, será necessário gerar um novo certificado ao reinstalar.
Antes de Iniciar
CUIDADO:
• Deve-se possuir um certificado digital para concluir a instalação (o programa de instalação permite a criação e o uso de um certificado autoassinado, se necessário). • Deve-se especificar o seu PI AF Server durante a instalação. As versões do PI AF Server
e do servidor do PI Data Archive foram alteradas; consulte Requisitos do PI System para o PI Coresight.
• É necessário saber o nome da conta de serviço do PI Coresight no uso atual para o PI Coresight. Para obter mais informações sobre como recuperar esta conta, consulte
Conjuntos de aplicativos e contas de serviço do PI Coresight.
• Se planeja importar os displays do PI ProcessBook, libere espaço extra no disco (aproximadamente 500 KB por display).
• Os PI mappings são necessários para todos os usuários clientes para pesquisar os servidores PI Data Archive e AF (uma PI trust não é suficiente para a pesquisa, mas ainda pode ser usada para visualizar os dados). Um PI mapping associa um usuário ou um grupo do Windows Active Directory a uma PI identity.
• Os administradores do PI Coresight devem ser membros do grupo Admins da PI Web API para permitir os servidores PI Data Archive e os bancos de dados do AF de maneira apropriada.
Consulte Lista de verificação pré-instalação para obter mais informações sobre os requisitos de instalação.
Nota:
Para fazer o upgrade do banco de dados do PI Coresight, o usuário que executa o upgrade (usando o programa de instalação, o site de administração ou o script go.bat) deve possuir a propriedade mínima da função de banco de dados ou ser um membro da função de banco de dados db_owner.
• db_datareader • db_datawriter • db_ddladmin Procedimento
1. Efetue logon no servidor do aplicativo como um Administrador do sistema, usando uma conta de usuário do domínio que pertence ao grupo de administradores local.
2. Verifique se todas as funções e recursos necessários estão instalados. As funções e os recursos necessários estão listados na seção Preparar o computador do servidor de aplicativos Coresight.
3. Faça o download do kit de instalação do PI Coresight no site de suporte técnico da OSIsoft. 4. Clique com o botão direito do mouse na configuração executável do PI Coresight e selecione
Executar como administrador para ativar o assistente de instalação.
5. Para a instalação da PI Web API, escolha o tipo de configuração Personalizar.
6. Quando for solicitada uma conta durante a instalação da PI Web API, escolha a conta do Active Directory usada atualmente pela versão anterior dos pools de aplicativos do site do PI Coresight. Uma exceção é: se o PI Coresight estava usando a conta de serviço de rede, escolha a opção para executar a PI Web API como o usuário virtual NT Service\piwebapi. 7. Quando um certificado confiável for solicitado durante a instalação da PI Web API, selecione um certificado SSL ou escolha a opção para criar um certificado autoassinado e selecione-o. Para obter mais informações, consulte Configurar o acesso do Secure Sockets Layer (SSL). 8. Após a conclusão do upgrade, reinicie a máquina e siga as instruções em Configure os pools
de aplicativos do PI Coresight para usar a conta de serviço do PI Coresight para garantir que todos os serviços estejam em execução nas contas corretas.
9. Se tiver habilitado a autenticação básica, ela poderá ser desabilitada quando fizer o upgrade do PI Coresight. Se estiver usando dispositivos móveis no SSL, será necessário reabilitar a autenticação básica. Para obter mais informações, consulte Autenticação do servidor PI Data Archive nos dispositivos móveis.
Fazendo upgrade do banco de dados do PI Coresight
• Se o Microsoft SQL Server estiver no computador do PI Coresight Application Server, o banco de dados do PI Coresight fará upgrade automaticamente.
• Se o SQL Server estiver em um servidor remoto, será necessário fazer o upgrade manualmente do banco de dados do PI Coresight.
Nota:
Podem haver casos em que você será notificado no site de administração do PI Coresight que o upgrade do banco de dados do PI Coresight é necessário. Se possuir as permissões necessárias (descritas no início deste procedimento), é possível efetuar o upgrade a qualquer momento. O site de administração está localizado em https://webServer/ Coresight/Admin onde webServer é o nome do seu servidor da Web do PI Coresight.
Backups automáticos de atualização do PI Coresight
Quando o PI Coresight é atualizado, o programa de instalação cria uma cópia do banco de dados do PI Coresight.
Esse arquivo de backup chama-se CoresightDatabase.backup e está localizado no diretório de backup padrão do Microsoft SQL Server. Por exemplo:
Program Files\Microsoft SQL Server\MSSQL10_50.SQLEXPRESS\MSSQL\Backup
Se um banco de dados de backup de uma atualização anterior do PI Coresight já existir neste local, o kit de instalação substituirá o arquivo de backup mais antigo.
O programa de instalação também cria cópias dos arquivos web.config atualizados, localizados em:
Instalação do PI Coresight
Este capítulo descreve o fluxo de trabalho passo a passo para instalar e configurar o PI Coresight em um servidor de aplicativo.
Nota:
Para vídeos de tutoriais sobre como instalar o PI Coresight, verifique o tour de instalação do PI Coresight na nossa lista de reprodução do YouTube (https://www.youtube.com/ playlist?list=PLMcG1Hs2Jbct0EHchLIiJTegzXSv3XVWF).
Entendendo o processo de instalação
Aqui está uma visão geral rápida do processo de instalação do PI Coresight, que consiste em cinco fases de alto nível. As etapas para concluir cada uma das fases estão detalhadas nas seções seguintes desse capítulo. As cinco fases de instalação do PI Coresight são as seguintes:
• Fase 1: preparar o servidor de aplicativo
Antes de instalar o PI Coresight em um servidor, você precisa primeiro preparar o servidor de aplicativo abrindo as portas necessárias, baixando o kit de instalação e outros softwares necessários, bem como habilitando funções e recursos do gerenciador de servidor.
• Fase 2: criar uma conta de serviço e configurar permissões
Depois que o servidor de aplicativo estiver preparado, você criará uma conta de serviço (conta de domínio) para o PI Coresight. Depois de criar uma conta de serviço, você
concederá permissões de acesso à conta de serviço para o Microsoft SQL Server, servidores PI Data Archive e PI AF Servers.
• Fase 3: executar o kit de instalação
Quando executar o kit de instalação, ele instalará todos os componentes de software necessários para o PI Coresight. O kit de instalação passará por uma série de prompts que pedirão a especificação de informações de configuração para o PI AF Server e a PI Web API. • Fase 4: configurar o PI Coresight após a instalação
Agora você está pronto para configurar o PI Coresight no site de administração dele. Essa configuração de pós-instalação envolve a configuração de acesso aos servidores PI Data Archive e PI AF e a criação do banco de dados do PI Coresight que é usado para armazenar as configurações de display dele.
• Fase 5: configurar a delegação do Kerberos
A última fase da instalação foca em configurar a autenticação do servidor PI Data Archive para o PI Coresight ao habilitar a delegação do Kerberos. A delegação do Kerberos é um protocolo de autenticação de rede que permite aos usuários um ambiente de aplicativo distribuindo o acesso seguro a fontes de dados remotas.
Fase 1: preparando o servidor de aplicativo
Antes de instalar o PI Coresight, você precisa primeiro preparar o servidor de aplicativo abrindo as portas necessárias, baixando o kit de instalação e outros softwares necessários e habilitando funções e recursos do gerenciador de servidor.
Vídeos de tutoriais
Para vídeos de tutoriais sobre como instalar o PI Coresight, verifique o tour de instalação do PI Coresight na nossa lista de reprodução do YouTube (https://www.youtube.com/playlist? list=PLMcG1Hs2Jbct0EHchLIiJTegzXSv3XVWF).
Nesta seção
• Verificar exigências de hardware e software
• Preparar o computador do PI Coresight Application Server
• Adicionar funções e recursos do servidor
• Configurar o acesso do Secure Sockets Layer (SSL)
Verificar exigências de hardware e software
Antes de iniciar a instalação do PI Coresight, você precisará do seguinte:
• Sistema operacional: Windows Server 2008 R2 SP1 de 64 bits ou mais recente • Microsoft Internet Information Services (IIS) 7.5 ou superior
• Microsoft .NET Framework 4
• Microsoft SQL Server 2008 R2 (Express, Standard ou Enterprise) ou posterior para hospedar o banco de dados SQL do PI Coresight
• PI Asset Framework (AF) para hospedar a configuração da PI Web API
• Hardware (consulte Hardware Requisitos de software para o PI Coresight Application Server)
Preparar o computador do PI Coresight Application Server
Procedimento1. Abra as portas necessárias para o site do PI Coresight configurado. Todas as portas necessárias deve ser abertas para que o PI Coresight funcione adequadamente.
Portas necessárias típicas
Porta Usado por
a. No Gerenciador de Servidor de informações da Internet (IIS), selecione o site em que deseja instalar o PI Coresight, clique com o botão direito do mouse e selecione Editar ligações.
b. Em Ligações de site, selecione a primeira linha e clique em Editar.
c. Altere o número da porta para um numero exclusivo e clique em OK.
d. Após a instalação, é possível alterar o número da porta para o seu número original.
Nota:
Se estiver instalando em um servidor de aplicativo do PI WebParts ou PI Web Services existente, deve-se criar um site separado com um número da porta exclusivo. Não é possível instalar o PI Coresight em um aplicativo Web existente. Tome nota deste site. Durante a instalação, digite-o quanto o site o solicitar.
2. Faça o download do software a seguir:
◦ O kit de instalação do PI Coresight. É possível fazer download desses kits no site de suporte técnico da OSIsoft (http://techsupport.osisoft.com/).
◦ O kit de instalação do Microsoft SQL Server (é possível ignorar esta etapa se planeja usar uma instalação do SQL Server existente). O kit de instalação para o SQL Server Express está disponível para download no site de suporte técnico da OSIsoft. Consulte Requisitos do Microsoft SQL Server para obter uma lista das versões compatíveis.
3. Instale o Microsoft SQL Server (se planeja usar uma instalação do SQL Server existente, ignore esta etapa).
Adicionar funções e recursos do servidor
Antes de instalar o PI Coresight, você precisa instalar funções, recursos e serviços de função do servidor no servidor de aplicativo. Para obter mais informações, consulte o artigo da Microsoft
Funções, serviços de função e recursos (https://technet.microsoft.com/en-us/library/ cc754923.aspx).
Nota:
Para o Windows Server 2008 R2, a OSIsoft recomenda, mas não exige, que seja instalada a função Servidor de aplicativo.
Procedimento
1. No gerenciador de servidores da Microsoft, clique em Adicionar funções e recursos para
abrir o assistente e escolha Instalação baseada em função ou baseada em recurso como o
tipo de instalação.
2. Na página Funções do servidor do assistente, selecione Servidor de aplicativo e funções do Web Server (IIS).
3. Na página Recursos, selecione os recursos necessários do servidor a seguir.
Windows Server 2008 R2 Windows Server 2012 Windows Process Activation
Service ◦◦ Modelo de processo
.NET Environment ◦ APIs de configuração
◦ Modelo de processo ◦ .NET Environment 3.5 ◦ APIs de configuração
Serviços de função Windows Server 2008 R2 Windows Server 2012 Recursos comuns
de HTTP Necessários:◦ Conteúdo estático ◦ Documento padrão ◦ Erros de HTTP Recomendado:
◦ Todos, exceto a publicação de WebDAV Necessários: ◦ Conteúdo estático ◦ Documento padrão ◦ Erros de HTTP Recomendado:
◦ Todos, exceto a publicação de WebDAV
Funcionamento e
diagnóstico Necessários:◦ Nenhum Recomendado:
◦ Registro em log HTTP
◦ Ferramentas de registro em log ◦ Monitor de solicitação ◦ Rastreio Necessários: ◦ Nenhum Recomendado: ◦ Registro em log HTTP
◦ Ferramentas de registro em log ◦ Monitor de solicitação ◦ Rastreio Desempenho Necessários: ◦ Todos Necessários: ◦ Todos Segurança Necessários: ◦ Autenticação do Windows ◦ Solicitar filtro ◦ Autorização de URL ◦ Autenticação básica Recomendado: ◦ Todos Necessários: ◦ Autenticação do Windows ◦ Solicitar filtro ◦ Autorização de URL ◦ Autenticação básica Recomendado: ◦ Todos Desenvolvimento
do aplicativo Necessários:◦ .NET Extensibility Recomendado: ◦ ASP .NET ◦ Extensões ISAPI ◦ Filtros ISAPI Necessários: ◦ .NET Extensibility 4.5 Recomendado: ◦ ASP .NET 4.5 ◦ Extensões ISAPI ◦ Filtros ISAPI Ferramentas de
gerenciamento Necessários:◦ Console de gerenciamento do IIS Recomendado: ◦ Scripts e ferramentas de gerenciamento do IIS ◦ Serviço de gerenciamento Necessários:
◦ Console de gerenciamento do IIS Recomendado:
◦ Scripts e ferramentas de gerenciamento do IIS ◦ Serviço de gerenciamento 5. Na página Serviços de função para o servidor de aplicativo, selecione pelo menos os
Windows Server 2008 R2 Windows Server 2012 Recomendado:
◦ .NET Framework
◦ Suporte do Process Activation Service do Windows - Ativação de HTTP
◦ Suporte do Web Server (IIS)
Necessários:
◦ .NET Framework 4.5
◦ Suporte do Process Activation Service do Windows - Ativação de HTTP
Recomendado:
◦ Suporte do Web Server (IIS)
6. Na página Confirmação, clique em Instalar.
Configurar o acesso do Secure Sockets Layer (SSL)
A OSIsoft recomenda habilitar o Secure Sockets Layer (SSL) para o site do PI Coresight a fim de criptografar as comunicações por HTTPS; isso é necessário para a maioria dos clientes móveis. Para obter mais informações, consulte Autenticação do servidor PI Data Archive nos
dispositivos móveis.
Para o acesso ao PI Coresight seguro completo, use um certificado digital obtido de um registro de terceiro confiável ou de sua autoridade de certificado particular da empresa. Embora o programa de instalação possa criar um certificado autoassinado, deve-se usar essa opção somente se o site do PI Coresight não for seguro usando o SSL.
Por padrão, durante a nova instalação, o PI Coresight 2016 configurará o site do IIS designado para o PI Coresight para ser HTTPS. O PI Coresight usa a mesma certificação digital que é especificada durante a configuração do PI Web API no PI Web API Admin Utility.
Se uma versão anterior do PI Coresight for atualizada para o PI Coresight 2016, o site não é automaticamente configurado para HTTPS. Para configurar manualmente o site IIS que hospeda o PI Coresight para usar SSL, consulte os seguintes artigos: Como implementar SSL no IIS (http://support.microsoft.com/kb/299875) e SSL Certificate Installation no Microsoft IIS 8 e IIS 8.5 (http://www.digicert.com/ssl-certificate-installation-microsoft-iis-8.htm).
Nota:
Esse produto usa cookies que podem ter implicações legais com base na localização geográfica do licenciado. Consulte o departamento legal local para ter certeza de que está de acordo com as leis, regras e regulamentações pertinentes, incluindo, entre outros, proteção de dados e diretrizes de cookies.
Se configurar o SSL para o site do PI Coresight, a OSIsoft recomenda proteger os cookies do PI Coresight adicionando atributos "seguros" ao arquivo do PI Coresight web.config. Adicione o seguinte flag em web.config:
<configuration> <system.web>
<httpCookies httpOnlyCookies = "true" requireSSL ="true"/> </system.web>
</configuration>
Fase 2: criando uma conta de serviço e configurando
permissões
Depois que o servidor de aplicativo estiver preparado, você criará uma conta de serviço (conta de domínio) para o PI Coresight. Depois de criar uma conta de serviço, você concederá
permissões de acesso à conta de serviço para o Microsoft SQL Server, servidores PI Data Archive e PI AF Servers. Para obter mais informações, consulte o artigo da Microsoft MSDN
Contas de usuário do domínio (https://msdn.microsoft.com/en-us/library/ms675915).
Nota:
A OSIsoft recomenda fortemente a criação de uma conta de serviço personalizada para o PI Coresight. Se escolher ignorar esta recomendação e usar as contas de máquina padrão, então deve-se revisar os outros aplicativos em execução no computador do servidor de aplicativo. Todos os aplicativos em execução neste computador terão permissões de acesso do PI Coresight nos servidores SQL, PI Data Archive e PI AF. Por motivos de segurança, considere a remoção de alguns ou de todos os aplicativos em execução neste computador.
Nesta seção
• Crie uma conta de serviço para o PI Coresight
• Conceder permissões de acesso da conta de serviço do PI Coresight
Crie uma conta de serviço para o PI Coresight
Por padrão, o aplicativo do PI Coresight é executado em uma conta de máquina do próprio servidor de aplicativo. Em vez disso, a OSIsoft recomenda a criação de uma conta dedicada (conta de domínio) para o serviço de aplicativo do PI Coresight.
Nota:
Na maioria das organizações, os procedimentos nessa etapa são realizados por um profissional de TI. Para obter mais informações, consulte o artigo da Microsoft Criar uma nova conta de usuário (https://technet.microsoft.com/en-us/library/Cc732336.aspx).
Procedimento
1. No controlador de domínio, crie uma nova conta de usuário em Usuários e computadores do Active Directory.
2. Clique com o botão direito na pasta Usuários e selecione Novo > Usuário.
3. Insira o nome da conta e clique em Próximo. A OSIsoft recomenda nomear esta conta de
serviço CoresightService. É possível inserir Coresight como nome, Service como sobrenome e CoresightService como nome de logon do usuário.
4. Insira a senha da conta e marque as caixas de seleção Usuário não pode alterar a senha e Senha nunca expira. Clique em Próximo.
5. Anote o nome da conta e a senha, já que serão necessárias durante a instalação. Após a instalação, você configurará os serviços e os pools de aplicativos do PI Coresight para execução nesta nova conta. Para obter mais informações, consulte Configure os pools de aplicativos do PI Coresight para usar a conta de serviço do PI Coresight.
6. Conceda todas as permissões ao serviço de conta listadas em Conceder permissões de acesso da conta de serviço do PI Coresight.
Conceder permissões de acesso da conta de serviço do PI Coresight
A conta de serviço do PI Coresight exige as permissões de acesso a seguir.• Para cada servidor do PI Data Archive permitido: a conta de serviço do PI Coresight precisa ter acesso de leitura a todos os pontos PI acessados por usuários clientes. Consulte
Configurar permissões de acesso do servidor do PI Data Archive.
• Para cada PI AF Server permitido: a conta de serviço do PI Coresight precisa ter acesso de leitura aos PI AF Servers e a todos os bancos de dados PI AF permitidos em cada PI AF Server. Além disso, a conta de serviço do PI Coresight precisa de acesso de leitura para todos os elementos e todas as tabelas PI AF que podem ser acessados por usuários clientes. Consulte Configurar as permissões do PI AF Server.
• Pastas configuradas para importar displays do PI ProcessBook: a identidade do pool de aplicativos deve ter acesso de leitura a qualquer pasta da qual você importar arquivos PDI ou SVG. Consulte Configurar o acesso à pasta de importação do PI ProcessBook.
Configurar permissões de acesso ao servidor do PI Data Archive
A conta de serviço do PI Coresight requer acesso de leitura à segurança e segurança do ponto em cada servidor PI Data Archive disponível para os usuários do PI Coresight.
As permissões de acesso do servidor PI Data Archive são definidas em uma PI identity (ou um usuário PI ou um grupo PI).
PI identities são o link entre a autenticação do Windows e a autorização do PI Data Archive (permissões de acesso). Cada PI identity representa um conjunto de permissões de acesso no servidor do PI Data Archive. Por exemplo, uma PI identity pode ter permissão para criar pontos, enquanto outra PI identity pode ter permissão para ler dados de pontos, mas não para criar novos pontos.
Nota:
Para obter mais informações sobre segurança do ponto PI, consulte PI Data Archive
System Management Guide ou verifique o seguinte tópico em Live Library (https:// livelibrary.osisoft.com/LiveLibrary/content/en/server-v7/GUID-0CB3445F-932E-4C06-A2FA-ABA419D67CE4).
Para cada servidor PI Data Archive que será acessado por meio do PI Coresight, siga estas etapas:
Procedimento
1. Identifique uma PI identity existente que tenha as permissões de acesso necessárias. (Uma vez que é necessário o acesso de leitura a cada ponto PI, é mais fácil usar uma PI identity existente que já tenha esse acesso.) Caso não tenho uma PI identity existente, consulte Criar uma PI identity.
2. Caso tenha criado uma nova PI identity para o PI Coresight, é necessário conceder à PI identity acesso de leitura aos pontos PI. Consulte Conceder à PI identity as permissões de acesso necessárias.
3. Mapeie a PI identity nova ou existente para a conta de serviço do PI Coresight. Consulte
Mapear a PI identity. Criar uma PI identity Procedimento
1. Execute o aplicativo PI System Management Tools (SMT). 2. Em Servidores, selecione um servidor.
3. Em Ferramentas de Gerenciamento do Sistema, selecione Segurança > Identidades, Usuários & Grupos.
4. Selecione a guia PI Identities e clique no botão Nova identidade para abrir a caixa de
5. Na caixa de diálogo Nova Identidade, digite um nome para a nova identidade. Esse é o único campo necessário para criar uma nova identidade. Observe as seguintes restrições sobre os nomes da identidade:
◦ O nome deve ser exclusivo.
◦ O nome não pode conter o caractere barra vertical (|) ou o caractere dois-pontos (:).
◦ O nome não pode ser um número inteiro positivo, apesar de poder conter números. Por exemplo, o nome "407" não é válido, mas o nome "Admins407" é válido.
◦ O nome não é sensível a maiúsculas e minúsculas.
Se for tentado criar uma identidade com nome inválido, uma mensagem de erro será exibida e a identidade não será criada. Observe que é possível alterar um nome de identidade a qualquer momento após a sua criação.
6. Selecione o servidor apropriado da lista suspensa Server. Esta lista é preenchida com os
servidores selecionados em Servidores. Apenas servidores PI Data Archive versão 3.4.380 e
posterior aparecem na lista. Versões anteriores do servidor PI Data Archive não são compatíveis com as PI identities.
7. Como alternativa, insira uma breve descrição em Description. Não há restrições sobre o
conteúdo desse campo.
8. Na parte inferior da caixa de diálogo, marque a caixa de seleção Identidade não pode ser excluída. Isso evita que a identidade seja acidentalmente excluída. Para excluir esta
identidade, primeiro, é necessário editá-la e desmarcar a caixa de seleção. 9. Clique em Criar. A nova PI identity aparece na guia PI Identities.
Conceder à PI identity as permissões de acesso exigidas
Para conceder à PI identity o acesso de leitura aos pontos PI em um servidor do PI Data Archive, é necessário conceder à identidade o acesso de leitura nas tabelas de banco de dados PIPOINT e PIMAPPING:
Procedimento
1. Execute o aplicativo PI System Management Tools (SMT).
2. Em Ferramentas de gerenciamento do sistema, selecione Segurança > Segurança de banco de dados.
3. Clique duas vezes na tabela de banco de dados PIPOINT.
5. Na caixa de diálogo Selecionar, encontre a PI identity, clique em Adicionar e em OK.
6. Na caixa de diálogo Segurança de PIPOINT, selecione a PI identity recém-adicionada e permita o acesso de leitura selecionando a caixa de seleção Leitura.
7. Depois de conceder acesso de leitura à tabela de banco de dados PIPOINT, realize as mesmas etapas para a tabela de banco de dados PIMAPPING. Se você estiver rodando o PI Web API Crawler na mesma conta, a PI identity também exigirá permissões às tabelas de banco de dados DBSEC e PIUSER. Se você estiver rodando o PI Web API Crawler em uma conta diferente por meio do pool de aplicativos do PI Coresight, a PI identity dessa conta precisará ter acesso de leitura às tabelas de banco de dados PIPOINT, PIMAPPING, DBSEC e PIUSER.
8. Conceda acesso de leitura aos dados de ponto para cada ponto PI. O método mais simples é usar o plug-in PI Builder para editar os pontos em massa. Como alternativa, é possível usar a ferramenta Point Builder no PI SMT para editar a segurança do ponto em cada ponto. a. Acesse Pontos > Point Builder.
b. Na caixa de diálogo Pesquisa da tag, pesquise os pontos PI aos quais a nova PI identity precisa ter acesso e adicione-os ao Point Builder.
c. Clique no ícone Pesquisar.
d. Selecione a guia Segurança e os pontos PI. Em seguida, adicione a PI identity desejada
nos menus Segurança dos dados e Segurança do ponto.
Para obter mais informações sobre a segurança do ponto PI, consulte PI Data Archive
Introduction to System Management Guide ou leia o tópico a seguir na Live Library (https:// livelibrary.osisoft.com/LiveLibrary/content/en/server-v7/GUID-0CB3445F-932E-4C06-A2FA-ABA419D67CE4).
Mapeie a PI identity para a conta de serviço
Para mapear a PI identity até a conta de serviço do PI Coresight, crie um PI mapping: Procedimento
1. Abra o PI System Management Tools (SMT). 2. Em Servidores, selecione o servidor.
3. Em Ferramentas de Gerenciamento do Sistema, selecione Segurança > Identidades, Usuários & Grupos.
4. Selecione a PI identity que deseja mapear.
5. Na barra de ferramentas, clique no botão Propriedades . A caixa de diálogo Propriedades é aberta.
6. Na caixa de diálogo Propriedades, clique na guia Mapeamentos e Trusts. A parte superior da caixa de diálogo mostra todos os mapeamentos existentes para a PI identity. A parte inferior
mostra todos os PI Trusts existentes.
7. Clique no botão Adicionar na parte de mapeamentos da caixa de diálogo. A caixa de diálogo
Adicionar Novo Mapeamento é aberta.
Nota:
O botão Adicionar será desativado se a PI identity estiver marcada como desativada ou
não puder ser usada em um mapeamento.
8. No campo Conta do Windows, insira a conta de serviço do PI Coresight criada
anteriormente. Para selecionar a conta:
◦ Clique no botão do navegador para ir até a conta.
◦ Digite o nome da conta. Se você escolher digitar o nome da conta, clique no botão resolução de SID para verificar se é uma conta válida. Se a conta for válida, um SID será exibido no campo. Caso contrário, uma caixa de diálogo com uma mensagem de erro será aberta.
9. Clique em Criar.
10. Na caixa de diálogo Propriedades, clique em OK. O que Fazer Depois
Configurar as permissões do PI AF Server
O PI Asset Framework (AF) usa a segurança do Windows. Se possuir um grupo do Windows (domínio, não local) que atualmente tenha as permissões necessárias de acesso, então será possível adicionar a conta de serviço do PI Coresight a este grupo. Caso contrário, será necessário conceder o acesso exigido manualmente por meio de configuração do acesso de leitura para a conta de serviço do PI Coresight. Para cada PI AF Server que será acessado por meio do PI Coresight, siga estas etapas:
• a. Criar PI AF identity e mapeamento.
b. Conceder à PI AF identity as permissões de acesso exigidas.
c. Configurar o acesso a um banco de dados PI AF para cada banco de dados AF que se deseja acessar por meio do PI Coresight.
d. Configurar acesso de leitura a objetos do PI AF para todos os elementos PI AF, estruturas de evento e tabelas que se deseja acessar por meio do PI Coresight.
Os usuários individuais do PI Coresight acessam os dados do PI AF Server por meio de suas próprias contas do Windows. Se os usuários existentes PI AF obtiverem acesso PI AF através das suas contas de domínio, então não haverá a necessidade de configurar o acesso para esses usuários. Se os usuários obtiverem acesso PI AF por meio de um grupo ou conta local no PI AF Server, então eles não poderão visualizar os objetos AF no PI Coresight.
Criar PI AF identity e mapeamento
Realize esse procedimento para cada PI AF Server que você desejar acessar por meio do PI Coresight.
Nota:
Para obter mais informações sobre PI AF identities e mapeamentos, consulte PI System
Explorer User Guide ou verifique o tópico seguinte em Live Library (https:// livelibrary.osisoft.com/LiveLibrary/content/en/server-v6/GUID-AF9F91EB-E6F9-4B5C-9338-A2C8F86004F5).
Procedimento
1. Abra o PI System Explorer.
2. Escolha Arquivo > Conexões. A caixa de diálogo Servidores é aberta e lista todos os PI AF
Servers.
4. Na janela Propriedades PI AF Server, navegue na guia Identidades. Clique com o botão direito e selecione Nova identidade.
5. Insira o nome da nova identidade no campo Nome.
6. Na janela Propriedades da identidade, navegue na guia Mapeamentos. 7. Clique em Adicionar.
8. Na janela Propriedades de mapeamento insira a conta de serviço do PI Coresight criada no campo Conta.
9. Pressione a lupa para selecionar a conta de serviço.
10. Na janela Selecionar usuário, computador, conta de serviço ou grupo insira o nome da conta de serviço do PI Coresight, clique em Verificar nome e clique em OK. A conta de serviço do
PI Coresight aparecerá na janela Propriedades de mapeamento. 11. Clique em OK.
Conceder à PI AF identity as permissões de acesso necessárias
Conceda à PI AF identity o acesso de leitura ao PI AF Server e aos bancos de dados PI AF que você deseja acessar por meio do PI Coresight.
Procedimento
1. Clique com o botão direito do mouse no PI AF Server conectado e selecione Segurança.
2. Clique em Adicionar para adicionar a identidade criada.
3. Na janela Selecionar identidade, selecione a PI AF identity necessária e conceda permissões de leitura selecionando Permitir.
4. Clique em Aplicar e em OK.
Configurar o acesso a um banco de dados PI AF Procedimento
1. Abra o PI System Explorer.
2. Clique no botão Banco de dados. A caixa de diálogo Selecionar banco de dados é aberta e
lista todos os bancos de dados PI AF no PI AF Server conectado atualmente.
3. Se o PI AF Server atualmente conectado for o servidor para o qual você deseja configurar o acesso, pule esta etapa. Caso contrário, clique com o botão direito do mouse no nome do servidor a ser configurado na lista e selecione Conectar.
4. Clique com o botão direito no banco de dados PI AF e selecione Segurança. A caixa de
diálogo Permissões desse banco de dados é exibida.
5. Clique em Adicionar. A caixa de diálogo Identidades é aberta.
6. Selecione a identidade para a qual a conta de serviço do PI Coresight foi mapeada. 7. No campo Permissões, marque a caixa de seleção Leitura na coluna Permitir.
8. Clique em OK.
Configurar acesso de leitura a objetos do PI AF
A conta de serviço do PI Coresight precisa de acesso de leitura para acessar cada estrutura de evento, tabela e elemento do AF que se deseja acessar com o PI Coresight. Você pode definir permissões de acesso para objetos do AF no PI System Explorer ou no PI AF Builder. O PI AF Builder é um plug-in do Microsoft Excel que permite que você edite objetos do PI AF em massa. Para editar as configurações de segurança de vários objetos, o PI AF Builder é a escolha ideal.
Nota:
No PI AF, os objetos da biblioteca sempre podem ser lidos, independentemente de suas configurações de segurança. Isso significa que você não precisa conceder acesso de leitura aos seguintes objetos do AF: categorias, templates, conjuntos de enumeração, tipos de referência e UDMs.
Configurar acesso à pasta de importação do PI ProcessBook
A conta de serviço do Coresight exige acesso de leitura a qualquer pasta de importação do PI ProcessBook, das quais se importa arquivos PDI ou SVG. O acesso pode ser concedido a uma pasta compartilhada usando o Windows Explorer.
Fase 3: executando o processo de instalação
Nessa fase, você executará o kit de instalação para instalar o PI Coresight. Quando executar o kit de instalação, ele instalará os componentes de software necessários para o PI Coresight. O kit de instalação passará por uma série de prompts que pedirão a especificação de informações de configuração para o PI AF Server e a PI Web API.
Nesta seção
• Recomendações de instalação
• Lista de verificação pré-instalação
• Instalar o PI Coresight
• UI de vários idiomas disponível para instalação
• Executar uma instalação silenciosa
Recomendações de instalação
A OSIsoft recomenda a configuração a seguir:
• Para o banco de dados do PI Coresight, use o mesmo Microsoft SQL Server que o PI AF usa. • Os servidores PI Data Archive e os PI AF Servers estão no domínio em que:
◦ O servidor de aplicativo onde o PI Coresight reside
CUIDADO:
• Deve-se possuir um certificado digital SSL para concluir a instalação (o programa de instalação permite a criação e o uso de um certificado autoassinado, se necessário). • Deve-se especificar o seu servidor AF durante a instalação. As versões mínimas do
Servidor AF e do servidor do PI Data Archive foram alteradas; consulte Requisitos do PI System para o PI Coresight.
• É necessário saber o nome da conta de serviço do PI Coresight no uso atual para o PI Coresight. Para obter mais informações sobre como recuperar esta conta, consulte
Conjuntos de aplicativos e contas de serviço do PI Coresight.
• Se planeja importar os displays do PI ProcessBook, libere espaço extra no disco (aproximadamente 500 KB por display).
• Os PI mappings são necessários para todos os usuários clientes para pesquisar os servidores PI Data Archive e AF (uma PI trust não é suficiente para a pesquisa, mas ainda pode ser usada para visualizar os dados). Um PI mapping associa um usuário ou um grupo a uma PI identity.
• Os administradores do PI Coresight devem ser membros do grupo Admins da PI Web API, para permitir os servidores PI Data Archive e os bancos de dados PI AF.
Lista de verificação pré-instalação
Pré-requisitos Recomendação ou requisito Para obter mais informações Espaço de armazenamento Aproximadamente 250 MB + 5 MB
por usuário Nota:
Para cada display do PI ProcessBook importado, permita um extra de 500 KB.
Requisitos de software para o servidor de aplicativo do PI Coresight
Conta de serviço para o PI Coresight Para manter os seus dados seguros, a OSIsoft recomenda a criação de uma conta de serviço (conta de domínio) para o serviço do PI Coresight.
Nota:
Após a instalação, deve-se configurar os pools de aplicativos para usar esta identidade.
Crie uma conta de serviço para o PI Coresight
Configure os pools de aplicativos do PI Coresight para usar a conta de serviço do PI Coresight
Pré-requisitos Recomendação ou requisito Para obter mais informações As permissões de acesso da conta de
serviço do PI Coresight Se você criar uma conta de serviço,você deve conceder à conta as seguintes permissões:
• Acesso de leitura para PIUsers, PIDBSEC, PIMappings e PIPOINT. • A conta de serviço do PI
Coresight pode acessar o servidor PI Data Archive com uma trust ou um mapeamento.
CUIDADO:
Os mapeamentos devem existir para cada usuário do PI Coresight para o servidor PI Data Archive.
• O acesso de leitura a todos os pontos PI em cada servidor do PI Data Archive permitido
• O acesso de leitura para os PI AF Servers, permitidos nos bancos de dados PI AF, bem como para os elementos e as tabelas. • O acesso de leitura para
qualquer pasta configurada para importar os arquivos PDI ou SVG.
Conceder permissões de acesso da conta de serviço do PI Coresight Configurar pastas de importação do PI ProcessBook
O software no PI Coresight
Application Server • Windows Server 2008 R2 SP1 de64 bits ou superior • IIS 7.5 ou superior
• Microsoft .NET Framework, versão 4
Requisitos de software do PI Coresight Application Server
Microsoft SQL Server 2008 R2 ou superior
A Standard, Enterprise e Express são todas suportadas.
Assegurar Permitir que os acionadores demitam outros está configurado como True.
Nota:
O OSIsoft recomenda a hospedagem do seu banco de dados do PI Coresight no mesmo SQL Server que o PI AF usa.
Requisitos do Microsoft SQL Server
PI System • Servidor PI Data Archive versão
3.4.380 e superior
• PI Asset Framework 2010 e superior
Requisitos do PI System para o PI Coresight
Funções e recursos do Gerenciador
do servidor A função Web server (IIS) devepossuir ao menos os serviços de função mínimos mostrados em Adicionar funções e recursos do servidor
Pré-requisitos Recomendação ou requisito Para obter mais informações Portas relevantes • 80 ou 443: servidor da Web do
PI Coresight
Preparar o computador do PI Coresight Application Server Instalando os privilégios do usuário • Função do servidor db_creator
• Permissão ALTER ANY LOGIN • Acesso de gravação para o banco
de dados Configuração no PI AF Server padrão
Efetue logon no servidor do aplicativo como um Administrador do sistema, usando uma conta de usuário que pertence ao grupo de administradores local.
Instalar o PI Coresight
O certificado digital SSL Durante a instalação, é necessário especificar um certificado que tenha comprado de uma autoridade de certificado, ou é possível criar e usar um certificado autoassinado. Nome do servidor de AF Durante a instalação, é necessário
especificar o nome do PI AF Server padrão.
Instalar o PI Coresight
Siga as etapas neste procedimento para instalar o PI Coresight pela primeira vez. Antes de Iniciar
Ao instalar o PI Coresight pela primeira vez, o banco de dados do PI Coresight será criado. Portanto, o usuário desempenhando a instalação (por meio do programa de instalação, site de administração ou usando o script go.bat) deve ter os privilégios a seguir, que geralmente você pode obter do administrador do banco de dados da sua organização:
• A função de servidor db_creator.
• Permissão ALTER ANY LOGIN. Os usuários podem obter esta permissão usando a instrução GRANT ALTER ANY LOGIN TO "domain\account". Se um usuário for membro da função de servidor securityadmin, eles já possuem a permissão ALTER ANY LOGIN.
O usuário de instalação também exige acesso de gravação para o banco de dados Configuração no PI AF Server padrão. Acesse o banco de dados Configuração usando o PI System Explorer. Certifique-se de os pré-requisitos listados em Lista de verificação pré-instalação foram atendidos.
Nota:
Durante a instalação, serão visualizadas as telas de configuração a seguir: 1. PI Web API
2. PI Web API Crawler 3. PI Coresight
Se o computador em que o PI Coresight estiver instalado for adicionado posteriormente a um domínio, deve-se desinstalar e reinstalar a PI Web API e o rastreador de PI Web API. Se foi usado um certificado autoassinado, será necessário gerar um novo certificado quando for fazer a reinstalação.
Procedimento
1. Efetue logon no servidor do aplicativo como um Administrador do sistema, usando uma conta de usuário do domínio que pertence ao grupo de administradores local.
2. Clique com o botão direito do mouse na configuração executável do PI Coresight e selecione
Executar como administrador para ativar o assistente de instalação. O instalador exibe uma
lista de componentes de software exigidos pelo PI Coresight. Alguns componentes já podem estar presentes em seu computador.
3. Revise a lista de componentes do software e clique em OK para continuar com a instalação.
Clique em Avançar à medida que progride pelos prompts.
A configuração de instalação solicita que você inicie a instalação e instala os componentes necessários, incluindo a ferramenta cliente PI AF e a PI Web API.
4. No assistente de configuração da PI Web API, clique em Avançar nos prompts à medida em
5. Depois de concluir a configuração da PI Web API, configure-a usando o assistente Alterar a configuração de instalação da PI Web API. O assistente solicitará a especificação de:
◦ Telemetria: escolha se deseja participar do programa de melhoria de produtos da
OSIsoft, permitindo a coleta de dados de usuários anônimos.
◦ Armazenamento de configuração: insira o nome de um Servidor de ativos padrão (PI AF
Server).
◦ Porta de escuta: insira a porta de comunicação para a PI Web API. Geralmente, é a porta
443.
◦ Certificado: insira um certificado que você comprou de uma autoridade de certificação.
Se você não tiver um certificado, o programa de instalação permite que você crie e use um certificado autoassinado. Este certificado é usado para a comunicação interna entre os componentes de servidor do PI Coresight e não é necessariamente usado para o assegurar o acesso de cliente no site. Para obter mais informações sobre a segurança de site com SSL, consulte Configurar o acesso do Secure Sockets Layer (SSL).
◦ Serviço de API: se você criou uma conta de serviço personalizada do PI Coresight (conta
de domínio), escolha Personalizadono menu suspenso e insira o nome da conta (domain name\account name) e a senha. Clique no botão Testar e então clique em OK. Para obter
mais informações, consulte Fase 2: criando uma conta de serviço e configurando permissões.
◦ Serviço de rastreador: se você criou uma conta de serviço personalizada do PI Coresight
(conta de domínio), escolha Personalizadono menu suspenso e insira o nome da conta
(domain name\account name) e a senha. Clique no botão Testar e então clique em OK.
◦ Enviar URL: digite a URL raiz da instância PI Web API pretendida.
◦ Revisar alterações : revise suas configurações, marque a caixa de seleção Aceitar e clique
em Avançar para aplicar as alterações. Na página Confirmação, clique em Concluir. Nota:
Conclua a configuração da PI Web API antes de continuar com o assistente de instalação PI Coresight.
6. Execute o assistente de instalação PI Coresight, que o solicitará a especificação de:
◦ Uma pasta de destino para o PI Coresight. A OSIsoft recomenda fortemente que todos os
componentes da OSIsoft sejam instalados na mesma pasta raiz. Por exemplo, Program
Files\PIPC.
O assistente de instalação PI Coresight cria os itens a seguir:
◦ Os grupos pré-preenchidos do Windows no servidor de aplicativo: PI Coresight Admins, PI Coresight Users e PI Web API Admins
◦ O site de administração do PI Coresight
◦ O site do PI Coresight, mais os pools de aplicativo: CoresightServiceAppPool e CoresightAdminAppPool
◦ Dois serviços do Windows: PI Web API e rastreador de PI Web API
UI de vários idiomas disponível para instalação
A Multilingual User Interface (MUI) do PI Coresight está disponível no Site de suporte técnico do OSIsoft (http://techsupport.osisoft.com/).
Após a instalação da MUI no servidor da web, os usuários podem alterar o idioma visto no PI Coresight modificando as configurações de idioma em seu navegador.
O suporte da Multilingual User Interface (MUI) do PI Coresight permite que os usuários visualizem o aplicativo em oito idiomas diferentes:
• Francês • Alemão • Espanhol • Português • Chinês simplificado • Japonês • Coreano • Russo
Executar uma instalação silenciosa
O PI Coresight 2016 pode ser instalado silenciosamente pelos scripts do command prompt especificando as informações da configuração padrão para a PI Web API e o PI Coresight. O recurso de instalação silenciosa permite a instalação do PI Coresight sem interação do usuário. Para isso, você deve conhecer o PI Data Archive padrão e os servidores AF que serão usados pelo PI Coresight.
Procedimento
1. Extraia o executável do PI Coresight clicando duas vezes no arquivo.EXE. Anote a pasta para a qual a configuração é extraída na máquina de destino.
2. Abra essa pasta no Windows Explorer.
3. Abra o arquivo SilentConfig.json no Bloco de notas.
Esse arquivo contém uma configuração padrão para a PI Web API: {
"ConfigAssetServer": "MyAFServer", "ConfigInstance": "MachineName", "IsFirewallExceptionEnabled": true, "IsTelemetryEnabled": false,
