PI Vision 2021

Guia de Instalação e Administração

OSIsoft, LLC
1600 Alvarado Street
San Leandro, CA 94577 EUA
Web: https://www.osisoft.com

Guia de Instalaçao e Administraçao do PI Vision 2021

© 2017-2021 por OSIsoft, LLC. Todos os direitos reservados.
Nenhuma parte desta publicaçao pode ser reproduzida, armazenada em um sistema de recuperaçao ou,
transmitida de qualquer forma ou por qualquer meio, mecanico, fotocopia, gravaçao ou outro, sem a
permissao previa por escrito da OSIsoft, LLC.
OSIsoft, a logomarca e o logotipo OSIsoft, Managed PI, OSIsoft Advanced Services, OSIsoft Cloud Services,
OSIsoft Connected Services, OSIsoft EDS, 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 Data Archive,
PI DataLink, PI DataLink Server, PI Developers Club, PI Integrator for Business Analytics, interfaces do PI,
PI JDBC Driver, PI Manual Logger, PI Notifications, driver ODBC do PI, PI OLEDB Enterprise,
PI OLEDB Provider, PI OPC DA Server, PI OPC HDA Server, PI ProcessBook, PI SDK, PI Server, PI Square,
PI System, PI System Access, PI Vision, PI Visualization Suite, PI Web API, PI WebParts, PI Web Services,
RLINK e RtReports sao marcas comerciais da OSIsoft, LLC. Todas as outras marcas ou nomes comerciais
usados aqui sao de propriedade de seus respectivos proprietarios.
DIREITOS DO GOVERNO DOS EUA
O uso, a duplicaçao ou a divulgaçao pelo Governo dos EUA estao sujeitos as restriçoes 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-19, ou nas sucessoras, conforme aplicavel. OSIsoft, LLC.
Versao: 3.6.0
Publicado em: 22 de setembro de 2021
Conteúdo

Requisitos do sistema e arquitetura do PI Vision...................................................... 1

Arquitetura do PI Vision............................................................................................................................ 1
Fluxo de dados...................................................................................................................................... 2
Sobre o servidor Web do PI Vision......................................................................................................... 3
Pools de aplicativos e contas de serviço do PI Vision.............................................................................. 3
Requisitos de software e hardware............................................................................................................4
Requisitos de software para o servidor de aplicativo do PI Vision...........................................................4
Requisitos de software do servidor de aplicativo do PI Vision................................................................ 4
Requisitos do Microsoft SQL Server...................................................................................................... 5
Requisitos do PI System para o PI Vision............................................................................................... 5
Versão de display do PI ProcessBook.....................................................................................................6
Requisitos do cliente............................................................................................................................. 6

Atualizações do PI Vision....................................................................................... 9
Atualizar uma instalação do PI Vision........................................................................................................9
Desinstalar ou desativar o PI Web API..................................................................................................10
Backups automáticos de atualização do PI Vision.................................................................................... 10

Instalação do PI Vision......................................................................................... 11
Entendendo o processo de instalação......................................................................................................11
Fase 1: preparando o servidor de aplicativo............................................................................................. 12
Verificar exigências de hardware e software........................................................................................ 12
Preparar o computador do servidor de aplicativo do PI Vision..............................................................12
Adicionar funções e recursos do servidor............................................................................................. 13
Proteja seu site do PI Vision com HTTPS............................................................................................. 14
Fase 2: criando uma conta de serviço e configurando permissões............................................................ 15
Criar uma conta de serviço para o PI Vision.......................................................................................... 15
Conceder permissões de acesso da conta de serviço do PI Vision......................................................... 17
Fase 3: execução do kit de instalação...................................................................................................... 24
Recomendações de instalação.............................................................................................................25
Lista de verificação pré-instalação....................................................................................................... 25
Instalar o PI Vision............................................................................................................................... 27
Interface do usuário em vários idiomas disponível para instalação.......................................................28
Executar uma instalação silenciosa..................................................................................................... 29
Fase 4: configurando o PI Vision após a instalação.................................................................................. 29
Adicionar um servidor PI Data Archive ou um servidor AF do PI à lista de servidores registrados......... 30
Configurar os pools de aplicativos do PI Vision para usar a conta de serviço do PI Vision......................30
Criar ou fazer upgrade do banco de dados do PI Vision........................................................................ 31
Selecione um certificado diferente para usar no site do PI Vision......................................................... 34
Permitir acesso a cada servidor PI Data Archive por meio do PI Vision................................................. 35
Permitir acesso a cada PI AF Server por meio do PI Vision....................................................................35
Configurar pastas de importação do PI ProcessBook........................................................................... 36
Fase 5: configurando a delegação do Kerberos........................................................................................ 38
Criar PI mappings................................................................................................................................ 40
Habilitar a delegação de Kerberos....................................................................................................... 40
Configurar navegadores da Web para clientes do PI Vision.................................................................. 46
Configure uma delegação restrita baseada em recursos...................................................................... 48
Habilitar a autenticação básica............................................................................................................49
Autenticação do servidor do PI Data Archive em dispositivos móveis.................................................. 50

Utilitário do display do PI Vision .......................................................................... 53

Requisitos do PI Vision Display Utility......................................................................................................53

Guia de Instalação e Administração do PI Vision 2021 iii

Conteúdo

Configurar os pools de aplicativos do PI Vision para usar a conta de serviço do PI Vision......................... 54

Diretrizes para copiar displays ou alterar fontes de dados....................................................................... 55
Copiar displays e alterar fontes de dados................................................................................................ 56
Excluir displays, atribuir novos proprietários ou alterar definições de função...........................................58

Tarefas de administração do PI Vision................................................................... 61

Site de administração do PI Vision...........................................................................................................61
Verificar o status do PI Vision...............................................................................................................63
Tipos de relatório................................................................................................................................ 63
Grupos de acesso do PI Vision................................................................................................................. 72
Gerenciar usuários e recursos.................................................................................................................. 72
Acesso do usuário ao aplicativo do PI Vision........................................................................................ 73
Estabelecer pastas...............................................................................................................................74
Redefinir as configurações do usuário..................................................................................................76
Alterar a política de segurança de conteúdo........................................................................................ 76
Gerenciar nível de acesso de usuário com base na função.................................................................... 77
Reatribuir a propriedade do display .................................................................................................... 78
Alterar o PI AF Server usado para armazenar PI AF Identities...............................................................78
Restringir o acesso de utilitário ao PI Vision......................................................................................... 79
Restringir o acesso do usuário a bancos de dados do PI AF.................................................................. 80
Restringir a pesquisa definindo raízes de pesquisa do banco de dados do PI AF................................... 80
Configurar permissões para que os usuários possam anotar e reconhecer eventos.............................. 81
Alterar os tipos de arquivo de anotações do evento e os limites de tamanho....................................... 83
Anular as configurações de segurança referentes a links de navegação............................................... 84
Atualizar a instância do SQL Server e o banco de dados do PI Vision....................................................... 85
Estratégia de backup para o banco de dados do PI Vision........................................................................86
Alterar a conta do banco de dados do PI Vision........................................................................................87
Alterar o parâmetro UpdateRate do display do PI Vision......................................................................... 87
Altere o comportamento de cálculo padrão............................................................................................ 88
Alterar a configuração padrão do curinga de pesquisa ............................................................................ 88
Solucionar problemas de displays que não são migrados devido ao tamanho do arquivo de imagem...... 89
Displays de patches com PIVisionPatchDisplayAFids ............................................................................. 89
Configurações de fuso horário e região................................................................................................... 90
Alterar as configurações de fuso horário..............................................................................................91
Alterar as configurações regionais.......................................................................................................94
Desinstalar o PI Vision............................................................................................................................. 95

URLs para abrir displays.......................................................................................97

Caminhos de URL base........................................................................................................................... 98
Referência de parâmetros de URL...........................................................................................................98
Displays integrados............................................................................................................................... 102
Displays temporários (ad hoc) com tag(s) ou atributo(s) especiais......................................................... 102
Displays temporários (ad hoc) com cálculos...........................................................................................103
Referência do parâmetro de cálculo ......................................................................................................104
Displays existentes salvos......................................................................................................................105
Displays no modo kiosk......................................................................................................................... 107
Reutilizar as exibições para construir ativos a partir do mesmo modelo AF............................................ 107
Especificar o elemento para as exibições de elemento relativas do PI ProcessBook .............................. 108
Configurar o fuso horário para um display............................................................................................. 109
Esconder a barra de ferramentas, a barra de tempo ou a barra lateral ...................................................110
Evitar o redirecionamento automático ao Website para dispositivo móvel do PI Vision......................... 110

Opções de alta disponibilidade para o PI Vision.................................................... 113

Apêndice A Visualizar e configurar o registro de mensagens do PI Vision................117

Exibir os logs de mensagens...................................................................................................................117
Coleção de eventos de depuração e análise do Monitor de Desempenho do Windows...........................119

iv Guia de Instalação e Administração do PI Vision 2021

 Conteúdo

Suprimir mensagens duplicadas (supressão de mensagem)................................................................... 119

Vídeos de tutoriais............................................................................................. 121

Suporte técnico e outros recursos........................................................................123

Guia de Instalação e Administração do PI Vision 2021 v

Conteúdo

vi Guia de Instalação e Administração do PI Vision 2021

Requisitos do sistema e arquitetura do PI Vision
Bem-vindo(a) ao PI Vision 2021. Esta seçao detalha os requisitos de arquitetura e de hardware
e software do PI Vision.

Nesta seção
• Arquitetura do PI Vision
• Requisitos de software e hardware

Arquitetura do PI Vision
O PI Vision e um aplicativo baseado em navegador que permite recuperar, monitorar e analisar
facilmente informaçoes de engenharia de processo.
Os componentes principais de instalaçao do PI Vision sao:

• (1) Clientes
Clientes sao usuarios individuais do PI Vision que acessam dados do PI. O PI Vision e
suportado pelos navegadores mais modernos em uma ampla variedade de dispositivos,
inclusive tablets e telefones rodando os sistemas operacionais iOS ou Android.

• (2) Servidor de aplicativo do PI Vision

O servidor de aplicativo fornece o ambiente de execuçao do PI Vision. O servidor de
aplicativo manipula todas as operaçoes de aplicativo entre usuarios (clientes) e servidores
PI Data Archive, PI AF Servers e Microsoft SQL Server.

• (3) Servidor PI Data Archive

O PI Data Archive e o coraçao do PI System. Ele fornece um armazenamento e arquivamento
eficiente de dados de series cronologicas, permitindo a recuperaçao de dados de alto
desempenho por software cliente. O PI recupera dados do PI System do servidor PI Data
Archive e PI AF Server.

Guia de Instalação e Administração do PI Vision 2021 1

Requisitos do sistema e arquitetura do PI Vision
• (4) PI AF server
O PI Asset Framework (PI AF) e um repositorio unico para modelos, hierarquias, objetos e
equipamentos baseados em ativos. Ele integra, contextualiza, refina, referencia e analisa
detalhadamente dados de varias fontes, incluindo um ou mais servidores PI Data Archive.
Juntos, esses metadados e dados de series cronologicas fornecem uma descriçao detalhada
de equipamento de ativos.

• (5) Banco de dados do PI Vision em Microsoft SQL Server

O PI Vision armazena as definiçoes e as configuraçoes do display do usuario em um banco
de dados Microsoft SQL. As definiçoes de display incluem dados como nome do display e
proprietario do display, símbolos no display, permissoes do usuario, etc.
Nota:
A OSIsoft recomenda que o PI Vision use o mesmo Microsoft SQL Server usado pelo PI AF.
Caso contrario, voce pode instalar um SQL Server no mesmo computador do servidor de
aplicativo do PI Vision ou fazer uma instalaçao de SQL Server dedicado. A OSIsoft
recomenda fortemente que os servidores PI Data Archive e os PI AF Servers estejam no
mesmo domínio que o servidor de aplicativo do PI Vision e o SQL Server que hospeda o
banco de dados do PI Vision.

Nesta seção
• Fluxo de dados
• Sobre o servidor Web do PI Vision
• Pools de aplicativos e contas de serviço do PI Vision

Fluxo de dados
Segue abaixo um exemplo de um típico fluxo de dados que ocorre a medida que elementos de
arquitetura diferente interagem para fornecer dados do PI System ao cliente.
Ao pesquisar dados em um novo display:
1. Quando um usuario pesquisa uma tag (ativos, atributo ou tag do PI), o cliente envia uma
solicitaçao referente a essa tag para o servidor de aplicativo do PI Vision. A solicitaçao e
retransmitida para o AF SDK, que preenche os resultados de pesquisa recuperados do PI
Data Archive e do PI AF Server.
2. Com base nos resultados de pesquisa, o usuario pode criar um símbolo para o item de dados
arrastando-o para o display. O símbolo no display ainda nao contem nenhum valor de dados
do PI. O numero maximo de ativos devolvidos pela fonte de dados e baseado no parametro
do sistema AFDBMaxSearchResults; no entanto, voce pode receber mais resultados, uma
vez que o pai de qualquer ativo devolvido nao e contado como parte do maximo.
3. A criaçao do símbolo aciona uma solicitaçao para os dados do PI, que o servidor de
aplicativo do PI Vision retransmite para o servidor do PI Data Archive ou PI AF Server.
Quando os dados PI retornam ao cliente, os símbolos no display sao preenchidos com
valores de dados.
4. Quando um usuario salva o display, a definiçao de display (configuraçoes do display) e
enviada para o Microsoft SQL Server e armazenada no banco de dados do PI Vision.
Ao abrir um display existente:
1. Quando um usuario abre um display existente, o cliente envia uma solicitaçao referente a
uma definiçao de display para o servidor de aplicativo do PI Vision, que e retransmitida para

2 Guia de Instalação e Administração do PI Vision 2021

 Requisitos do sistema e arquitetura do PI Vision

o Microsoft SQL Server. O SQL Server retorna a definiçao de display da qual o cliente gera um
display com símbolos. Os símbolos ainda nao contem nenhum valor de dados.
2. A criaçao do símbolo aciona uma solicitaçao para os dados do PI, que o servidor de
aplicativo do PI Vision retransmite para o servidor do PI Data Archive ou PI AF Server.
Quando os dados PI retornam ao cliente, os símbolos sao preenchidos com valores de dados.

Sobre o servidor Web do PI Vision

O PI Vision usa dois sites:
• O site de aplicativo principal: https://webServer/PIVision/
• O site de administraçao: https://webServer/PIVision/Admin
Em que webServer e o nome do servidor Web PI Vision. O PI Vision usa o servidor Web Internet
Information Services (IIS) da Microsoft.

Pools de aplicativos e contas de serviço do PI Vision

A instalaçao do PI Vision cria os seguintes pools de aplicativos e serviços do Windows.
Os conjuntos de aplicativo executam nas contas de serviço do Windows que possuem as
permissoes de acesso pelo sistema PI:
• PIVisionAdminAppPool executa o site de administraçao, localizado em: https://
webServer/PIVision/Admin
• PIVisionServiceAppPool executa os principais sites de aplicativo do PI Vision,
localizados em https://webServer/PIVision
• PIVisionUtilityAppPool executa os PI Vision serviços de utilidade, localizados em
https://webServer/PIVision/Utility
Para esses pools de aplicativos, o campo Maximum Worker Processes deve ser definido como 1
na configuraçao do Internet Information Services (IIS) Manager.
Os pools de aplicativos e as contas de serviço do PI Vision sao executados na conta de serviço
do PI Vision. Essa e a conta que o PI Vision usa para conectar-se ao PI Data Archive e aos PI AF
Servers. Para que os usuarios clientes visualizem os dados do PI System, a conta de serviço do
PI Vision precisa ter o devido acesso a esses servidores.
Por padrao, quando voce instala o PI Vision, o kit de instalaçao configura as contas de serviço
na conta da maquina do proprio servidor de aplicativo e configura as contas para cada serviço,
conforme a seguir:
Serviço Conta
PIVisionAdminAppPool NT Authority\Network Service
PIVisionServiceAppPool NT Authority\Network Service
PIVisionUtilityAppPool NT Authority\Network Service

A conta de serviço do PI Vision nessa configuraçao e a conta do Active Directory da maquina do

servidor. Geralmente, esta conta e nomeada domain\server-name$. Por exemplo,
MyEnterprise\PIVisionServer$.
Por motivos de segurança, a OSIsoft recomenda a criaçao de uma conta de domínio no lugar
dela para os serviços do PI Vision:

Guia de Instalação e Administração do PI Vision 2021 3

Requisitos do sistema e arquitetura do PI Vision

1. Altere a conta de serviço do PI Vision para uma conta de domínio dedicada. Consulte Criar
uma conta de serviço para o PI Vision.
2. Configure os conjuntos e os serviços de aplicativo para executar nesta conta. Consulte
Configurar os pools de aplicativos do PI Vision para usar a conta de serviço do PI Vision.
CUIDADO:
A OSIsoft recomenda fortemente a criaçao de uma conta de domínio para os serviços do
PI Vision. Se usar a conta da maquina, todos os aplicativos em execuçao no computador
do servidor possuem permissoes de acesso no SQL Server, servidor do PI Data Archive e
maquinas de PI AF Server. Isso e um risco para a segurança. No mínimo, considere a
remoçao de alguns ou de todos os outros aplicativos rodando neste computador.

Requisitos de software e hardware

Revise todos os requisitos de hardware e software do PI Vision antes de instalar ou atualizar
para a versao mais recente.

Requisitos de software para o servidor de aplicativo do PI Vision

Requisitos do banco de dados do Microsoft SQL Server
Os requisitos a seguir tem como base o Microsoft SQL Server, localizado no servidor de
aplicativo do PI Vision. O banco de dados do Microsoft SQL Server exige aproximadamente 200
MB de armazenamento, mais 5 MB por usuario (supondo 200 exibiçoes de tamanho medio por
usuario). Se planeja importar os displays do PI ProcessBook, permita um mínimo de 500 KB
por exibiçao (supondo exibiçoes de tamanho medio) no SQL Server.
Por padrao, o banco de dados crescera 200 MB automaticamente cada vez que o limite de
tamanho atual for atingido.

Resumo dos requisitos de hardware

Nº de usuários 1 a 50 50 a 250 250 a 500
CPU (nucleos) 4 4 8
Velocidade da CPU 2 2,5 3
(GHz)
Memoria (GB) 6 12 24

Voce pode usar o site da Administraçao PI Vision para gerar um relatorio que lista o numero de
usuarios que acessaram PI Vision dentro de um intervalo de tempo específico.

Requisitos de software do servidor de aplicativo do PI Vision

Os requisitos de software na maquina que hospeda o servidor de aplicativo do PI Vision sao
listados a seguir:

• Microsoft Windows Server 2012 de 64 bits ou mais recente, incluindo as versoes do Server
Core
• Microsoft Internet Information Services (IIS) 8.0 ou superior
• Microsoft .NET Framework 4

4 Guia de Instalação e Administração do PI Vision 2021

 Requisitos do sistema e arquitetura do PI Vision

• Funçoes e recursos do Gerenciador do servidor. Consulte Adicionar funçoes e recursos do

servidor para obter detalhes de quais funçoes e recursos sao necessarios para o PI Vision.
• Unidade de destino formatada para NTFS
Nota:
A instalaçao do PI Vision em um controlador de domínio nao e suportada.

Requisitos do Microsoft SQL Server

O PI Vision requer o Microsoft SQL Server 2014 ou superior. As versoes Standard, Enterprise e
Express sao todas compatíveis.
Para aproveitar os mesmos procedimentos de backup usados para PIFD com o banco de dados
do PI Vision, a OSIsoft recomenda que voce hospede seu banco de dados do PI Vision no mesmo
SQL Server usado pelo PI AF.
Certifique-se de que a configuraçao do SQL Server Permitir que gatilhos disparem outros
gatilhos esteja configurado como True. Para verificar esta configuraçao:
1. No SQL Server Management Studio, clique com o botao direito do mouse e escolha
Propriedades.
2. Selecione a pagina Avançado.
3. Permitir que gatilhos disparem outros gatilhos e a primeira configuraçao na seçao
Miscelânea.

Nota:
Para cargas mais pesadas (acima de 500 usuarios), e exigida uma versao completa do SQL
Server executada em um servidor dedicado.

Requisitos do PI System para o PI Vision

O PI Vision 2021 e compatível com as versoes a seguir do PI Data Archive e PI Asset Framework
(PI AF):

• PI Data Archive versao 3.4.380 e posterior.

• A OSIsoft recomenda o uso do PI AF versao 2018 (2.10) ou posterior com o PI Vision 2021.

Guia de Instalação e Administração do PI Vision 2021 5

Requisitos do sistema e arquitetura do PI Vision

Nota:
Versoes anteriores do PI AF começando com o PI AF 2015 (2.7) ou posteriores devem
funcionar, mas nao foram oficialmente testadas. A funcionalidade de pesquisa e os
resultados retornados diferem com base na versao do PI AF. As versoes do banco de
dados do PI AF abaixo de 2.10.5 so suportam correspondencias de nomes em
pesquisas. As versoes do banco de dados PI AF 2.10.5 e acima suportam
correspondencias de nome e descriçao em pesquisas. Sites com versoes variadas do
banco de dados do PI AF sao compatíveis com correspondencias de descriçao se a
versao do servidor for 2.10.5 ou superior.
◦ Para ver eventos relacionados no PI Vision, voce deve usar o PI AF 2015 (2.7) ou
posterior.
◦ Para usar a filtragem de valor de atributo na pesquisa utilizada em Coleçoes ou nos
criterios de pesquisa dinamica para tabelas, voce deve usar a versao 2017 ou
posterior. Alguns recursos exigem versoes mínimas do PI AF 2017 R2 (2.9.5.8352)
ou posterior.
• Para usar calculos baseados em ativos, o PI Analysis Service deve estar instalado; no
entanto, ele nao precisa estar em execuçao e pode ser desativado apos a instalaçao. Para
obter instruçoes de instalaçao, consulte o topico do PI Server Instalaçao do PI Analysis
Service (https://docs.osisoft.com/bundle/pi-server/page/install-pi-analysis-service.html).

Versão de display do PI ProcessBook

O PI Vision permite configurar o seu servidor de aplicativo para que os usuarios possam
visualizar os displays do PI ProcessBook. Os arquivos PDI e SVG produzidos pelo PI
ProcessBook, versao 3.1 ou superior, sao importados automaticamente das pastas
configuradas.
Para melhores resultados, use os displays salvos do ProcessBook de PI usando a versao 3.3.2 ou
superior. Isto e especialmente importante para suporte a graficos e formato numerico regional.
Nota:
Se voce estiver importando displays que contenham links de botao para outros displays
do PI ProcessBook, os links podem nao ser importados corretamente caso os displays
forem salvos em uma versao anterior ao PI ProcessBook 3.1.
Para obter mais informaçoes sobre a importaçao dos displays do PI ProcessBook, consulte
Configurar pastas de importaçao do PI ProcessBook.

Requisitos do cliente
Os clientes do PI Vision precisam usar navegadores da Web compatíveis com HTML5.
Nota:
Esse produto usa cookies que podem ter implicaçoes legais com base na localizaçao
geografica do licenciado. Consulte o seu departamento jurídico para garantir que voce
esteja em conformidade com as leis, regras e regulamentos relevantes, incluindo, entre
outros, diretivas de proteçao de dados e de cookies.

Navegadores suportados para PI Vision

PI Vision foi testado e e compatível com as versoes mais recentes dos seguintes navegadores:
• Microsoft Internet Explorer

6 Guia de Instalação e Administração do PI Vision 2021

 Requisitos do sistema e arquitetura do PI Vision

Nota:
A Microsoft anunciou o final do ciclo de vida do Internet Explorer 11. Para obter mais
informaçoes, consulte a pagina da Microsoft, https://docs.microsoft.com/en-us/
lifecycle/faq/internet-explorer-microsoft-edge (https://docs.microsoft.com/en-us/
lifecycle/faq/internet-explorer-microsoft-edge). A OSIsoft recomenda apenas o uso de
navegadores compatíveis para acessar o PI Vision.
• Microsoft Edge
• Google Chrome
• Mozilla Firefox
• Safari on macOS
• IOS Safari on iOS
• Google Chrome em celulares Android
Nota:
Para que a ajuda online abra com exito ao clicar no botao Ajuda (?), pode ser necessario
desativar o bloqueio de pop-up em seu navegador.

Dispositivos móveis como clientes

Quando os usuarios de navegadores ou dispositivos menores acessam o site do aplicativo
(https://webServer/PIVision/), eles sao redirecionados ao site para dispositivo movel do
PI Vision (https://webServer/PIVision/m) por padrao. (É possível substituir este
redirecionamento por displays específicos, como em um painel, se necessario. Para obter mais
informaçoes, consulte Prevenir redirecionamento automatico ao site para dispositivo movel do
PI Vision.) O site para dispositivo movel mostra os símbolos de valor juntamente com uma
tendencia para displays que nao foram importados. Todos os símbolos sao exibidos para
displays do PI ProcessBook importados semelhantes ao comportamento do aplicativo principal
do PI Vision.

Guia de Instalação e Administração do PI Vision 2021 7

Requisitos do sistema e arquitetura do PI Vision

8 Guia de Instalação e Administração do PI Vision 2021

Atualizações do PI Vision
Quando voce atualiza o PI Vision para uma nova versao, suas configuraçoes existentes sao
transferidas para a instalaçao do PI Vision atualizado. Isso inclui as configuraçoes dos
servidores do PI Data Archive permitidos, os bancos de dados do PI AF e o banco de dados do
PI Vision permitido.
Voce pode fazer backup e copiar bancos de dados para o novo servidor ou usar o PI Vision
Utilitario display para mover o display para dentro dos servidores PI Vision.

Atualizar uma instalação do PI Vision

Para fazer o upgrade do PI Vision, execute o programa de instalaçao do PI Vision, que atualiza o
PI Vision. Éntao, configure as contas do pool de aplicativos e faça o upgrade do banco de dados
do PI Vision, se necessario.
Nota:
Se voce nao usar mais o PI Web API, deve desinstala-lo.

Antes de Iniciar
Revise os requisitos e as recomendaçoes de instalaçao para o PI Vision. Consulte
Recomendaçoes de instalaçao e Lista de verificaçao pre-instalaçao.

Procedimento
1. Efetue logon no servidor do aplicativo como um administrador do sistema, usando uma
conta de usuario do domínio que pertence ao grupo de Administrators local.
2. Verifique se todas as funçoes e os recursos necessarios estao instalados. Para uma lista de
recursos e funçoes exigidos, consulte Preparar o computador do servidor de aplicativo do PI
Vision.
3. Faça o download do novo kit de instalaçao do PI Vision em Pagina de produtos no portal do
cliente da OSIsoft (https://customers.osisoft.com/s/products).
4. Clique com o botao direito na configuraçao executavel do PI Vision e clique em Run as
Administrator (Executar como administrador) para iniciar o assistente de instalaçao.
5. Se necessario, faça o upgrade do banco de dados do PI Vision:
◦ Se o programa de instalaçao atualizar automaticamente o banco de dados do PI Vision,
nenhum trabalho adicional sera necessario.
◦ Se a instalaçao nao atualizou com sucesso o banco de dados, voce deve atualiza-lo
manualmente apos o termino do kit de instalaçao. Para obter detalhes, consulte Criar ou
fazer upgrade do banco de dados do PI Vision.
Nota:
Se voce nao conseguir gerenciar displays com o utilitario de exibiçao do PI Vision, o
pool de aplicativos de utilitario do PI Vision pode nao ser configurado para ser
executado sob a mesma conta de serviço que os pools de aplicativos Administrador e
Serviço. Para obter informaçoes adicionais, veja Configurar pools de aplicativos do PI
Vision para usar a conta de serviço do PI Vision.

Guia de Instalação e Administração do PI Vision 2021 9

Atualizações do PI Vision

Nota:
Voce tem a opçao de executar o PIVisionPatchDisplayAFids ao fazer upgrade do
PI Vision ou posteriormente. PIVisionPatchDisplayAFids patches existentes
PI Vision sao exibidos de modo que elementos e atributos renomeados ou movidos em
um PI AF Serversao atualizados automaticamente se o display estiver recem-aberto ou
em execuçao ativa. Para obter mais informaçoes, consulte Displays de patches com
PIVisionPatchDisplayAFids.
A execuçao do PIVisionPatchDisplayAFids durante a atualizaçao pode falhar caso
a atualizaçao seja do PI Coresight 2016 R2 ou anterior. Neste caso, reinicie o servidor
apos a atualizaçao e execute o PIVisionPatchDisplayAFids mais uma vez
manualmente.

Desinstalar ou desativar o PI Web API

O PI Vision nao depende mais do PI Web API. Se voce nao tiver outros aplicativos que o exijam
em seu servidor PI Vision, e recomendavel que voce remova o PI Web API do seu sistema. Se
voce nao quiser remover o PI Web API, deve, no mínimo, desativar o serviço PI Web API
Crawler nesse servidor.

Procedimento
• Desinstalar o PI Web API
• Abra Programs and Features (Programas e recursos) e selecione a versao do PI Web API
listada na tela.
• Clique em Uninstall (Desinstalar) e siga as etapas para remover o PI Web API do servidor.
Isso removera os serviços PI Web API e PI Web API Crawler em execuçao no servidor.
• Desativar o PI Web API Crawler
Nota:
O PI Web API Crawler e removido automaticamente se voce desinstalar o PI Web API
na etapa anterior.
• Em Start > Run abra services.msc.
• Clique com o botao direito do mouse no PI Web API Crawler e selecione Properties.
• Na guia General, selecione Stop para interromper o serviço.
• Na guia General, altere o Startup type para Disabled.
• Clique em Apply e OK para salvar as configuraçoes.

Backups automáticos de atualização do PI Vision

Quando o PI Vision e atualizado, o programa de instalaçao cria uma copia do banco de dados do
PI Vision.
Esse backup e chamado PIVisualizationDatabase.backup e esta localizado no diretorio de
backup padrao 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çao anterior do PI Vision ja existir neste local,
o kit de instalaçao substituira o arquivo de backup mais antigo.
O programa de instalaçao tambem cria copias dos arquivos web.config atualizados,
localizados em:
Program Data\OSIsoft\Coresight\PIDSTemp

10 Guia de Instalação e Administração do PI Vision 2021

Instalação do PI Vision
Esta seçao descreve passo a passo o fluxo de trabalho para instalar e configurar o PI Vision em
um servidor de aplicativo.
Nota:
Para assistir a vídeos de tutoriais sobre como instalar o PI Vision, confira o processo de
instalaçao do PI Vision na nossa lista de reproduçao: https://www.youtube.com/embed/
playlist?list=PLMcG1Hs2Jbct0EHchLIiJTegzXSv3XVWF (https://www.youtube.com/
embed/playlist?list=PLMcG1Hs2Jbct0EHchLIiJTegzXSv3XVWF).

Entendendo o processo de instalação

O processo de instalaçao do PI Vision consiste em cinco fases de alto nível. As etapas para
concluir cada uma das fases estao detalhadas nas seçoes seguintes desse capítulo. As cinco
fases de instalaçao do PI Vision sao as seguintes:

• Fase 1: preparar o servidor de aplicativo

Antes de instalar o PI Visionem um servidor, voce precisa primeiro preparar o servidor de
aplicativo abrindo as portas necessarias, fazendo download do kit de instalaçao e de outros
softwares necessarios e habilitando funçoes 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, voce criara uma conta de serviço
(conta de domínio) para o PI Vision. Depois de criar uma conta de serviço, voce concedera
permissoes de acesso a 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 voce executa o kit de instalaçao, ele instalara todos os componentes de software
necessarios para o PI Vision. O kit de instalaçao passara por uma serie de prompts que
pedirao a especificaçao de informaçoes de configuraçao para o PI AF Server.

• Fase 4: configurar o PI Vision após a instalação

Agora, voce esta pronto(a) para configurar o PI Vision no site de administraçao do PI Vision.
Essa configuraçao de pos-instalaçao envolve a configuraçao de acesso aos servidores PI Data
Archive e PI AF e a criaçao do banco de dados do PI Vision que e usado para armazenar as
configuraçoes do display do PI Vision.

• Fase 5: configurar a delegação do Kerberos

A ultima fase da instalaçao foca em configurar a autenticaçao do servidor PI Data Archive
para o PI Vision habilitando a delegaçao de Kerberos. A delegaçao do Kerberos e um
protocolo de autenticaçao de rede que permite aos usuarios um ambiente de aplicativo
distribuindo o acesso seguro a fontes de dados remotas.

Guia de Instalação e Administração do PI Vision 2021 11

Instalação do PI Vision

Fase 1: preparando o servidor de aplicativo

Antes de instalar o PI Vision, voce precisa primeiro preparar o servidor de aplicativo abrindo as
portas necessarias, fazendo download do kit de instalaçao e de outros softwares necessarios e
habilitando funçoes e recursos do gerenciador de servidor.

Nesta seção
• Verificar exigencias de hardware e software
• Preparar o computador do servidor de aplicativo do PI Vision
• Adicionar funçoes e recursos do servidor
• Proteja seu site do PI Vision com HTTPS

Verificar exigências de hardware e software

Antes de iniciar a instalaçao do PI Vision, voce precisara do seguinte:

• Sistema operacional: Windows Server 2012 de 64 bits ou mais recente, incluindo as versoes
do Server Core
• Microsoft Internet Information Services (IIS) 8.0 ou superior
• Microsoft .NET Framework 4
• Microsoft SQL Server 2014 (Express, Standard ou Enterprise) ou posterior para hospedar o
banco de dados SQL do PI Vision
• Hardware (consulte Requisitos de software para o servidor de aplicativo do PI Vision)

Preparar o computador do servidor de aplicativo do PI Vision

Antes de instalar o PI Vision, prepare o servidor do aplicativo abrindo as portas necessarias,
baixando o software necessario e instalando o Microsoft SQL Server, se necessario.

Procedimento
1. Abra as portas necessarias para o site do PI Vision configurado. Todas as portas necessarias
devem ser abertas para que o PI Vision funcione adequadamente.
Portas necessárias típicas
Porta Usado por
80 ou 443 Servidor Web do PI Vision

Se estiver instalando em um servidor da Web que hospeda varios sites na mesma porta, sera
necessario alterar temporariamente o numero da porta antes da instalaçao:
a. No Internet Information Server (IIS) Manager, selecione o site em que deseja instalar o
PI Vision, clique com o botao direito do mouse e selecione Edit Bindings (Editar ligaçoes).
b. Em Ligações de site, selecione a primeira linha e clique em Editar.

12 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

c. Altere o numero da porta para um numero exclusivo e clique em OK.

d. Apos a instalaçao, e possível alterar o numero da porta para o seu numero 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 numero da porta exclusivo. Voce nao
pode instalar o PI Vision em um aplicativo Web existente. Tome nota deste site.
Durante a instalaçao, digite-o quanto o site o solicitar.
2. Faça o download do software a seguir:
◦ Kit de instalaçao do PI Vision. É possível fazer o download dos kits de instalaçao do
Pagina de produtos no portal do cliente da OSIsoft (https://customers.osisoft.com/s/
products).
◦ O kit de instalaçao do Microsoft SQL Server (e possível ignorar esta etapa se planeja usar
uma instalaçao do SQL Server existente). O kit de instalaçao para o SQL Server Express
esta disponível para download no site de suporte tecnico da OSIsoft. Consulte Requisitos
do Microsoft SQL Server.
3. Instale o Microsoft SQL Server (se planeja usar uma instalaçao do SQL Server existente,
ignore esta etapa).

Adicionar funções e recursos do servidor

Antes de instalar o PI Vision, a OSIsoft recomenda que voce instale funçoes, recursos e serviços
de funçao do servidor no servidor de aplicativo. Como alternativa, voce tem a opçao de
configurar automaticamente as funçoes e os recursos necessarios do PI Vision durante a
instalaçao. Para obter mais informaçoes, consulte o artigo da Microsoft Funçoes, serviços de
funçao e recursos (https://technet.microsoft.com/en-us/library/cc754923.aspx).
Nota:
A funçao Web Server deve ser habilitada antes da execuçao do kit de instalaçao do
PI Vision.

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 recurso como o tipo de
instalaçao.
2. Na pagina Selecionar funções de servidor do assistente, selecione as funçoes apropriadas
para seu sistema operacional:
Sistema operacional Funções
Windows Server 2012 e Windows Server 2012 Servidor de aplicativos e Servidor Web
R2
Windows Server 2016 e Windows Server 2019 Servidor Web

3. Na pagina Selecionar recursos, selecione os recursos necessarios do servidor a seguir:

◦ Serviço de ativação de processos do Windows
▪ Modelo de processo
▪ APIs de configuração
4. Na pagina Selecionar serviços de função para a funçao do Servidor Web (IIS), selecione pelo
menos os serviços mínimos de funçao listados abaixo:

Guia de Instalação e Administração do PI Vision 2021 13

Instalação do PI Vision

Serviços de função Obrigatório Recomendado

Recursos comuns de ◦ Conteudo estatico ◦ Erros de HTTP
HTTP
◦ Documento padrao ◦ Redirecionamento de HTTP
Funcionamento e Nenhum ◦ Registro em log HTTP
diagnóstico
◦ Ferramentas de registro em log
◦ Monitor de solicitaçao
◦ Rastreio
Performance ◦ Compressao de conteudo Nenhum
estatico
◦ Compressao de conteudo
dinamico
Segurança ◦ Autenticaçao do Windows ◦ IP e restriçoes de domínio
◦ Solicitar filtragem
◦ Autorizaçao de URL
Desenvolvimento ◦ Windows Server 2012 e mais ◦ Éxtensoes ISAPI
do aplicativo recente: ◦ Filtros ISAPI
▪ .NET Extensibility 4.5/4.6/4.7
▪ ASP.NET 4.5/4.6/4.7
Ferramentas de Nenhum ◦ Console de gerenciamento do IIS
gerenciamento (nao aplicavel para a opçao de
instalaçao mínima do Server Core
no Windows Server 2012 e mais
recente)
◦ Scripts e ferramentas de
gerenciamento do IIS
◦ Serviço de Gestao

5. Na pagina Confirmação, clique em Instalar.

Proteja seu site do PI Vision com HTTPS

A OSIsoft recomenda que voce habilite o Transport Layer Security (TLS) / Secure Sockets Layer
(SSL) para o site do PI Vision a fim de criptografar as comunicaçoes por HTTPS; isso e
necessario para a maioria dos clientes moveis. Para obter mais informaçoes, consulte
Autenticaçao do servidor do PI Data Archive em dispositivos moveis.
Para proteger completamente o acesso ao PI Vision, use um certificado digital obtido de um
registro de terceiro confiavel. Embora o programa de instalaçao possa criar um certificado
autoassinado, esse certificado nao sera confiavel pelos clientes do navegador e resultara em
avisos de certificado quando os usuarios visitarem o PI Vision.
Por padrao, durante uma nova instalaçao, o PI Vision configurara o site do IIS designado para o
PI Vision para usar HTTPS.
Ao atualizar uma versao anterior do PI Vision que nao usava HTTPS, o site atualizado nao e
automaticamente configurado para HTTPS. Para configurar manualmente o site do IIS que
hospeda o PI Vision para usar TLS/SSL, consulte os seguintes artigos da Microsoft e Digicert:
• Como implementar o SSL no IIS ( https://docs.microsoft.com/en-US/iis/manage/
configuring-security/how-to-set-up-ssl-on-iis)
• Instalaçao do certificado SSL no Microsoft IIS 8 e IIS 8.5 (https://www.digicert.com/ssl-
certificate-installation-microsoft-iis-8.htm)

14 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

Nota:
Esse produto usa cookies que podem ter implicaçoes legais com base na localizaçao
geografica do licenciado. Consulte o seu departamento jurídico para garantir que voce
esteja em conformidade com as leis, regras e regulamentos relevantes, incluindo, entre
outros, proteçao de dados e diretivas de cookies. Se voce configurar o PI Vision para nao
usar SSL, pode desativar cookies seguros para o PI Vision. Localize e edite a configuraçao
em negrito abaixo e defina o valor de requireSSL como false:
<configuration>
<system.web>
<httpCookies httpOnlyCookies="true" requireSSL="false"/>
</system.web>
</configuration>

Fase 2: criando uma conta de serviço e configurando

permissões

Apos preparar o servidor de aplicativo, crie uma conta de serviço (conta de domínio) para
PI Vision e conceda a essa conta de serviço permissoes para acessar os servidores que
executam o Microsoft SQL Server, o PI Data Archive e o PI AF. Para obter mais informaçoes,
consulte o artigo Using a Domain User Account as a Service Logon Account (https://
msdn.microsoft.com/en-us/library/ms675915) do Microsoft Developer Network.
Nota:
A OSIsoft recomenda fortemente a criaçao de uma conta de serviço personalizada para o
serviço de aplicativo do PI Vision. Se ignorar esta recomendaçao e usar as contas de
maquina padrao, entao sera necessario revisar os outros aplicativos rodando no
computador do servidor de aplicativo. Todos os aplicativos rodando nesse computador
terao as mesmas permissoes de acesso que PI Vision aos servidores que executam
Microsoft SQL Server, PI Data Archive e PI AF. Por motivos de segurança, considere a
remoçao de alguns ou de todos os aplicativos rodando neste computador.

Nesta seção
• Criar uma conta de serviço para o PI Vision
• Conceder permissoes de acesso da conta de serviço do PI Vision

Criar uma conta de serviço para o PI Vision

Por padrao, o aplicativo do PI Vision e executado em uma conta de maquina do proprio
servidor de aplicativo. Em vez disso, a OSIsoft recomenda a criaçao de uma conta de serviço
dedicada (conta de domínio) para o serviço de aplicativo do PI Vision. Crie essa conta no
controlador de domínio com os usuarios e computadores no Active Directory.
Nota:
Na maioria das organizaçoes, os procedimentos nessa etapa sao realizados por um
profissional de TI. Para obter mais informaçoes, consulte o artigo da Microsoft Criar uma
nova conta de usuario (https://technet.microsoft.com/en-us/library/Cc732336.aspx).

Guia de Instalação e Administração do PI Vision 2021 15

Instalação do PI Vision

Procedimento
1. No controlador de domínio, abra Usuarios e computadores no Active Directory.
2. Clique com o botao direito na pasta Usuários e clique, na parte superior, em Novo > Usuários
para abrir a janela Novo objeto - Usuário.

3. Insira o nome da conta e clique em Avançar.

A OSIsoft recomenda nomear esta conta de serviço PIVisionService. É possível inserir
Vision como nome, Service como sobrenome e PIVisionService como nome de logon
do usuario.
4. Insira a senha da conta e marque as caixas de seleçao Usuário não pode alterar a senha e
Senha nunca expira.
Anote o nome da conta e a senha, ja que serao necessarias durante a instalaçao. Apos a
instalaçao, voce configurara os serviços e pools de aplicativo do PI Vision a serem
executados nessa nova conta. Para obter mais informaçoes, consulte Configurar os pools de
aplicativos do PI Vision para usar a conta de serviço do PI Vision.

5. Clique em Avançar.
6. Conceda todas as permissoes ao serviço de conta listadas em Conceder permissoes de
acesso da conta de serviço do PI Vision.

16 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

Conceder permissões de acesso da conta de serviço do PI Vision

A conta de serviço do PI Visionrequer estas permissoes de acesso:

• Para cada servidor do PI Data Archive permitido: a conta de serviço do PI Vision precisa ter
acesso de leitura a todas as tags do PI acessadas por usuarios clientes. Consulte Configurar
permissoes de acesso do servidor do PI Data Archive.
• Para cada PI AF Server permitido: a conta de serviço do PI Vision precisa ter acesso de
leitura aos PI AF Servers e a todos os bancos de dados do PI AF permitidos em cada PI AF
Server. Alem disso, a conta de serviço do PI Vision precisa ter acesso de leitura a todos os
elementos e tabelas do PI AF que podem ser acessados por usuarios clientes. Consulte
Configurar as permissoes 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 voce importar arquivos PDI
ou SVG. Consulte Configurar o acesso a pasta de importaçao do PI ProcessBook.
• Direitos do usuario da política de segurança local: execute aspnet_regiis -ga domain
\serviceAccount de C:\Windows\Microsoft.NET\Framework\<.NET version>
\directory.

Configurar permissões de acesso ao servidor do PI Data Archive

A conta de serviço do PI Vision requer acesso de leitura em relaçao a segurança da tag e dos
dados em cada servidor do PI Data Archive disponível para os usuarios do PI Vision.
As permissoes de acesso do servidor do PI Data Archive sao definidas em uma PI identity (ou
um PI User ou um PI group).
As PI Identities vinculam a autenticaçao do Windows e a autorizaçao do PI Data Archive
(permissoes de acesso). Cada PI Identity representa um conjunto de permissoes de acesso no
servidor do PI Data Archive. Por exemplo, uma PI Identity pode ter permissao para criar tags,
enquanto outra PI Identity pode ter permissao para ler dados de tags, mas nao para criar novas
tags.
Nota:
Para obter mais informaçoes sobre a segurança da tag do PI, consulte o topico Gerenciar
PI Identities do PI Server no SMT (https://docs.osisoft.com/bundle/pi-server/page/
manage-pi-identities-in-smt.html).
Em cada servidor do PI Data Archive que voce pretende acessar por meio do PI Vision, siga
estas etapas:

Procedimento
1. Identifique uma PI identity existente que tenha as permissoes de acesso necessarias. (Uma
vez que e necessario o acesso de leitura a cada ponto PI, e mais facil usar uma PI identity
existente que ja tenha esse acesso.) Se voce nao tiver uma identidade PI existente, consulte
Criar uma PI identity.
2. Se tiver criado uma nova PI Identity para o PI Vision, voce precisara conceder a PI Identity
acesso de leitura as tags do PI. Consulte Conceder a PI identity as permissoes de acesso
necessarias.
3. Mapeie a PI identity nova ou existente a conta de serviço do PI Vision. Consulte Mapeie a PI
identity para a conta de serviço.

Guia de Instalação e Administração do PI Vision 2021 17

Instalação do PI Vision

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 botao Nova identidade para abrir a caixa de
dialogo Nova identidade.

5. Na caixa de dialogo Nova Identidade, digite um nome para a nova identidade. Este e o unico
campo que e necessario quando voce cria uma nova identidade. Observe as seguintes
restriçoes sobre os nomes da identidade:
◦ O nome deve ser exclusivo.
◦ O nome nao pode conter o caractere barra vertical (|) ou o caractere dois-pontos (:).
◦ O nome nao pode ser um numero inteiro positivo, mas pode conter numeros. Por
exemplo, o nome 407 nao e valido, mas Admins407 e um nome valido.
◦ O nome nao diferencia maiusculas por minusculas.

18 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

Se for tentado criar uma PI identity com nome invalido, uma mensagem de erro sera exibida
e a PI identity nao sera criada. Observe que e possível alterar o nome de uma PI identity a
qualquer momento apos sua criaçao.
6. Selecione o servidor apropriado da lista suspensa Server. Esta lista e preenchida com os
servidores selecionados em Servidores. Apenas servidores PI Data Archive versao 3.4.380 e
posterior aparecem na lista. Versoes anteriores do servidor PI Data Archive nao sao
compatíveis com as PI Identities.
7. Como alternativa, insira uma breve descriçao em Description. Nao ha restriçoes sobre o
conteudo desse campo.
8. Na parte inferior da caixa de dialogo, marque a caixa de seleçao Identidade não pode ser
excluída. Isso impede que a PI identity seja acidentalmente excluída. Para apagar essa
identity, primeiro, e necessario edita-la e desmarcar essa caixa de seleçao.
9. Clique em Criar. A nova PI Identity aparece na guia PI Identities.

Conceder uma PI Identity que exige permissões de acesso

Para conceder a uma PI Identity o acesso de leitura as tags do PI em um servidor do PI Data
Archive, e necessario conceder a 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 do PIPOINT.
4. Na janela Security for PIPOINT, clique em Add para adicionar uma nova PI Identity.

Guia de Instalação e Administração do PI Vision 2021 19

Instalação do PI Vision

5. Na janela Select, encontre e selecione a PI Identity, clique em Add e em OK.

6. Na janela Security for PIPOINT, selecione a PI Identity recem-adicionada e marque a caixa de

seleçao Read para conceder acesso de leitura da identidade.
7. Depois de conceder acesso de leitura da identidade a tabela de banco de dados PIPOINT,
realize as mesmas etapas para a tabela de banco de dados PIMAPPING.
8. Conceda acesso de leitura aos dados de ponto para cada ponto PI.
O metodo mais simples e usar o plug-in PI Builder para editar as tags em massa. Consulte o
topico sobre o PI Server Editar tags do PI (https://docs.osisoft.com/bundle/pi-server/
page/edit-pi-points.html).
Como alternativa, e possível usar a ferramenta Point Builder no PI SMT para editar a
segurança da tag em cada tag:

a. No painel Ferramentas de gerenciamento do sistema do PI SMT, expanda Points > Point

Builder .
b. Clique em Search para abrir a janela Tag Search.
c. Pesquise as tags do PI que a nova PI Identity precisa acessar, selecione-as e clique em OK
para adiciona-las ao Point Builder.

20 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

d. Clique na guia Security e selecione as tags do PI adicionadas ao Point Builder.

e. Em Point Security, selecione a PI Identity e clique na caixa de seleçao Read.
f. Em Data Security, selecione a PI Identity e clique na caixa de seleçao Read.
Para obter mais informaçoes, consulte o topico Configurar segurança do ponto (https://
docs.osisoft.com/bundle/pi-server/page/configure-point-security.html) do PI Server.

Mapeie a PI identity para a conta de serviço

Para mapear a PI identity em relaçao a conta de serviço do PI Vision, 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 botao de propriedades . A janela Properties e exibida.
6. Na janela Properties, clique na guia Mappings and Trusts.

A parte superior da janela mostra todos os mappings existentes para a PI Identity. A parte
inferior mostra todos os PI Trusts existentes.
7. Clique no botao Add na parte de mappings da janela.
Nota:
O botao Add sera desabilitado se a PI identity estiver marcada como desabilitada ou
nao puder ser usada em um mapping.

A janela Add New Mapping e aberta.

8. No campo Conta do Windows, insira a conta de serviço do PI Vision criada anteriormente.
Para selecionar a conta:

Guia de Instalação e Administração do PI Vision 2021 21

Instalação do PI Vision

◦ Clique no botao do navegador para ir ate a conta.

◦ Digite o nome da conta. Se voce escolher digitar o nome da conta, clique no botao
resoluçao de SID para verificar se e uma conta valida. Se a conta for valida, um SID
sera exibido no campo. Caso contrario, uma caixa de dialogo com uma mensagem de erro
sera aberta.

9. Clique em Criar.
10. Na janela Properties, clique em OK.

O que Fazer Depois

Se tiver problemas para criar o mapeamento, clique no botao Ajuda no PI SMT.

Configurar as permissões do PI AF Server

O PI Asset Framework (AF) usa a segurança do Windows. Se voce tiver um grupo do Windows
(domínio, nao local) que ja possui as permissoes de acesso necessarias, voce so precisara
adicionar a conta de serviço do PI Vision a esse grupo. Caso contrario, voce precisara conceder
manualmente o acesso necessario configurando o acesso de leitura para a conta de serviço do
PI Vision. Em cada PI AF Server que sera acessado por meio do PI Vision, siga estas etapas:

1. Criar PI AF identity e mapeamento.

2. Conceder a PI AF identity as permissoes de acesso exigidas.
3. Configurar o acesso a um banco de dados PI AF para cada banco de dados do AF que voce
deseja acessar por meio do PI Vision.
4. Acesso de leitura a objetos do PI AF para todos os elementos do AF do PI, estruturas de
eventos e tabelas do PI AF que voce deseja acessar atraves do PI Vision.
Os usuarios individuais do PI Vision acessam os dados do servidor AF do PI por meio de suas
proprias contas do Windows. Se os usuarios existentes PI AF obtiverem acesso PI AF atraves
das suas contas de domínio, entao nao havera a necessidade de configurar o acesso para esses
usuarios. Se os usuarios obtiverem acesso ao PI AF por meio de um grupo ou uma conta local
no PI AF Server, eles nao poderao visualizar os objetos AF no PI Vision.

Criar PI AF Identity e Mapping

Para cada servidor do PI AF que voce deseja que o PI Vision acesse, sera necessario criar uma
identidade do PI AF mapeada para a conta de serviço do PI Vision.

22 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

Procedimento
1. Abra o PI System Explorer.
2. Clique em File > Connections . A janela Servers e aberta e lista todos os servidores do PI AF.
3. Clique com o botao direito no servidor do PI AF conectado e clique em Properties.
4. Na janela PI AF Server Properties, clique na guia Identities.
5. Clique com o botao direito na lista de identidades e clique em New Identity para abrir a
janela Security Identity Properties.
6. No campo Name, insira o nome da nova identidade.
7. Clique na guia Mappings e clique em Add para abrir a janela Security Mapping Properties.
8. No campo Account, insira a conta de serviço do PI Vision criada anteriormente.
a. Clique na lupa para selecionar a conta de serviço.
b. Na janela Select User, Computer, Service Account or Group, insira o nome da conta de
serviço do PI Vision.
c. Clique em Check Name.
d. Clique em OK.
A conta de serviço do PI Vision aparecera na janela Mapping Properties.
9. Clique em OK.

Conceder à PI AF identity as permissões de acesso necessárias

Conceda a PI AF identity o acesso de leitura ao PI AF Server e aos bancos de dados do PI AF que
voce deseja acessar por meio do PI Vision.

Procedimento
1. Clique com o botao 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 necessaria e conceda permissoes
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 botao Banco de dados. A caixa de dialogo Selecionar banco de dados e 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 voce deseja configurar o
acesso, pule esta etapa. Caso contrario, clique com o botao direito do mouse no nome do
servidor a ser configurado na lista e selecione Conectar.
4. Clique com o botao direito no banco de dados PI AF e selecione Segurança. A caixa de
dialogo Permissões desse banco de dados e exibida.
5. Clique em Adicionar. A caixa de dialogo Identidades e aberta.
6. Selecione a identidade a qual a conta de serviço do PI Vision foi mapeada.

Guia de Instalação e Administração do PI Vision 2021 23

Instalação do PI Vision

7. No campo Permissões, marque a caixa de seleçao Leitura na coluna Permitir.

8. Clique em OK.

Acesso de leitura a objetos do PI AF

A conta de serviço do PI Vision precisa ter acesso de leitura e de leitura de dados em relaçao a
cada event frame, tabela e elemento do PI AF que voce deseja acessar por meio do PI Vision.
É possível definir as permissoes de acesso para objetos do PI AF com o PI System Explorer.
Consulte o topico sobre o PI Server Segurança de objeto do PI AF (https://docs.osisoft.com/
bundle/pi-server/page/pi-af-object-security.html).
Tambem e possível definir as permissoes de acesso para objetos do PI AF com PI Builder. O PI
Builder e um suplemento do Microsoft Excel que permite a ediçao de objetos do PI AF em
massa. Se desejar editar as configuraçoes de segurança de varios objetos, o PI Builder e a
escolha ideal. Consulte o topico sobre o PI Server Segurança (https://docs.osisoft.com/
bundle/pi-server/page/security.html).
Nota:
No PI AF, os objetos de biblioteca sao sempre legíveis, independentemente de suas
configuraçoes de segurança. Ou seja, voce nao precisa conceder acesso de leitura aos
seguintes objetos do PI AF: categorias, templates, enumeration sets, tipos de referencia e
UDMs.

Configurar acesso à pasta de importação do PI ProcessBook

A conta de serviço do PI Vision exige acesso de leitura a qualquer pasta de importaçao do PI
ProcessBook, da qual voce importa arquivos PDI ou SVG. Use o Windows Explorer para
conceder acesso de leitura a pasta.

Procedimento
1. No Windows Explorer, clique com o botao direito na pasta de importaçao do PI ProcessBook
e clique em Properties para abrir a janela Properties.
2. Clique na guia Security.
A janela lista nomes de usuario e grupo aos quais foram concedido acesso. Clique em um
nome para ver as permissoes concedidas ao grupo ou usuario.
3. Clique em Edit para abrir a janela Permissions, na qual e possível adicionar ou alterar
permissoes.
4. Para adicionar a conta de serviço do PI Vision, clique em Add e especifique a conta.
5. Para conceder acesso de leitura a conta, selecione a conta na lista e marque a caixa de
seleçao Allow ao lado de Read.

Fase 3: execução do kit de instalação

Nesta fase, voce executara o kit de instalaçao para instalar o PI Vision. Quando voce executa o
kit de instalaçao, ele instalara todos os componentes de software necessarios para o PI Vision.

24 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

O kit de instalaçao passara por uma serie de prompts que pedirao a especificaçao de
informaçoes de configuraçao para o PI AF Server.

Nesta seção
• Recomendaçoes de instalaçao
• Lista de verificaçao pre-instalaçao
• Instalar o PI Vision
• Interface do usuario em varios idiomas disponível para instalaçao
• Executar uma instalaçao silenciosa

Recomendações de instalação
A OSIsoft recomenda a configuraçao a seguir:
• Para o banco de dados do PI Vision, use o mesmo Microsoft SQL Server usado pelo PI AF.
• Os servidores PI Data Archive e PI AF estao no domínio em que:
◦ A localizaçao do servidor de aplicativo do PI Vision
◦ O Microsoft SQL Server hospeda o banco de dados do PI Vision
CUIDADO:
• É necessario ter um certificado digital SSL para concluir a instalaçao.
• Deve-se especificar o seu servidor do PI AF durante a instalaçao. As versoes mínimas
dos servidores PI AF e PI Data Archive foram alteradas. Consulte Requisitos do PI
System para o PI Vision.
• Voce precisa saber o nome da conta de serviço do PI Vision usado atualmente para o
PI Vision. Para obter mais informaçoes sobre como recuperar esta conta, consulte
Pools de aplicativos e contas de serviço do PI Vision.
• Se planeja importar os displays do PI ProcessBook, libere espaço extra no disco
(aproximadamente 500 KB por display).
• Os PI mappings sao necessarios para todos os usuarios clientes para pesquisar os
servidores do PI Data Archive e PI AF (um PI Trust nao e suficiente para a pesquisa,
mas ainda pode ser usado para visualizar os dados). Um PI mapping associa um
usuario ou um grupo a uma PI identity.

Lista de verificação pré-instalação

Pré-requisitos Recomendação ou requisito Para obter mais
informações
Espaço de Aproximadamente 250MB + 5 MB por usuario Requisitos de software
armazenamento para o servidor de
Nota: aplicativo do PI Vision
Para cada display do PI ProcessBook
importado, permita um extra de 500 KB.

Guia de Instalação e Administração do PI Vision 2021 25

Instalação do PI Vision

Pré-requisitos Recomendação ou requisito Para obter mais

informações
Conta de serviço para o Para manter os seus dados seguros, a OSIsoft Criar uma conta de
PI Vision recomenda a criaçao de uma conta de serviço serviço para o PI Vision
(conta de domínio) para o serviço do PI Vision.
Configurar os pools de
Nota: aplicativos do PI Vision
Apos a instalaçao, sera necessario configurar para usar a conta de
os pools de aplicativos para usar esta serviço do PI Vision
identidade.

Permissoes de acesso da Se voce criar uma conta de serviço, voce deve Conceder permissoes de
conta de serviço do conceder a conta as seguintes permissoes: acesso da conta de
PI Vision • Acesso de leitura ao PIMAPPING e PIPOINT. serviço do PI Vision
• A conta de serviço do PI Vision pode acessar o Configurar pastas de
servidor do PI Data Archive com um trust ou importaçao do PI
um mapping. ProcessBook
CUIDADO:
Os mappings devem existir para cada usuario
do PI Vision em relaçao ao servidor do PI
Data Archive.
• Acesso de leitura a todos os pontos PI em cada
servidor do PI Data Archive permitido.
• O acesso de leitura para os servidores do PI AF,
permitidos nos bancos de dados do PI AF, e os
elementos e as tabelas.
• O acesso de leitura para qualquer pasta
configurada para importar os arquivos PDI ou
SVG.
Software no servidor de • Windows Server 2012 ou mais recente Requisitos de software
aplicativo do PI Vision do servidor de aplicativo
• IIS 8.0 ou superior
do PI Vision
• Microsoft .NET Framework, versao 4
Microsoft SQL Server 2014 ou mais tarde Requisitos do Microsoft
SQL Server
A Standard, Enterprise e Express sao todas
suportadas.
Certifique-se de que a opçao Allow Triggers to
Fire Others esteja definida como True.
Nota:
A OSIsoft recomenda a hospedagem do seu
banco de dados do PI Vision no mesmo SQL
Server usado pelo PI AF.

PI System • Servidor PI Data Archive versao 3.4.380 e Requisitos do PI System

superior para o PI Vision
• PI Asset Framework 2018 e superior
Funçoes e recursos do A funçao do servidor da web (IIS) exige serviços Consulte Adicionar
Gerenciador do servidor mínimos de funçao e o servidor exige recursos funçoes e recursos do
específicos. servidor.
Portas relevantes • 80 ou 443: servidor Web do PI Vision Preparar o computador
do servidor de aplicativo
do PI Vision

26 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

Pré-requisitos Recomendação ou requisito Para obter mais

informações
Instalando os privilegios • Funçao de servidor db_creator Instalar o PI Vision
do usuario
• Permissao ALTER ANY LOGIN
• Acesso de gravaçao para o banco de dados
Configuration no PI AF server padrao
Certificado digital SSL Durante a instalaçao, especifique um certificado
que voce comprou de uma autoridade de
certificaçao.
Nome do servidor do PI Durante a instalaçao, e necessario especificar o
AF nome do servidor do PI AF padrao.
Capacidade de rodar Durante a instalaçao, e necessario rodar o script Executar o script go.bat
script no SQL Server go.bat no SQL Server a menos que uma das para configurar o banco
seguintes opçoes condiçoes for aplicavel: de dados do PI Vision
• A delegaçao de Kerberos esta configurada entre
o servidor de aplicativo do PI Vision e o
computador do SQL Server.
• O banco de dados do PI Vision esta localizado
no mesmo computador que o servidor de
aplicativo do PI Vision.
• Voce esta rodando o seu navegador localmente
no mesmo computador que o servidor de
aplicativo do PI Vision.

Instalar o PI Vision
Siga as etapas neste procedimento para instalar o PI Vision pela primeira vez.

Antes de Iniciar
Quando voce instala o PI Vision pela primeira vez, e criado o banco de dados do PI Vision.
Portanto, o usuario desempenhando a instalaçao (por meio do programa de instalaçao, site de
administraçao ou usando o script go.bat) deve ter os privilegios a seguir, que geralmente voce
pode obter do administrador do banco de dados da sua organizaçao:
• A funçao de servidor db_creator.
• Permissao ALTER ANY LOGIN. Os usuarios podem obter esta permissao usando a instruçao
GRANT ALTER ANY LOGIN TO "domain\account". Se um usuario for membro da funçao
de servidor securityadmin, ele ja possuira a permissao ALTER ANY LOGIN.
O usuario de instalaçao tambem exige acesso de gravaçao para o banco de dados Configuration
no servidor do PI AF padrao. Acesse o banco de dados Configuration usando o PI System
Explorer.
Nota:
PI Vision e configurado automaticamente para ler identidades PI AF (usadas para
controlar o acesso a displays PI Vision) a partir do PI AF Server que esta marcado como o
Servidor AF padrão no momento da instalaçao para PI Vision. Para mudar essa
configuraçao para outro PI AF Server, consulte Alterar o PI AF Server usado para
armazenar PI AF Identities.
Certifique-se de que esteja condizente com os pre-requisitos listado na Lista de verificaçao
pre-instalaçao.

Guia de Instalação e Administração do PI Vision 2021 27

Instalação do PI Vision

Procedimento
1. Efetue logon no servidor do aplicativo usando uma conta de usuario do domínio que
pertença ao grupo de administradores local.
2. Clique com o botao direito do mouse na configuraçao executavel do PI Visione selecione Run
as Administrator (Executar como Administrador) para ativar o assistente de instalaçao. O
instalador exibe uma lista de componentes de software exigidos pelo PI Vision. Alguns
componentes ja podem estar presentes.
3. Revise a lista de componentes do software e clique em OK para continuar com a instalaçao.
Clique em Avançar a medida que progride pelos prompts.
4. Execute o assistente de instalaçao do PI Vision, que solicitara que voce especifique:
◦ Uma pasta de destino para o PI Vision. A OSIsoft recomenda fortemente que todos os
componentes da OSIsoft sejam instalados na mesma pasta raiz. Por exemplo, Program
Files\PIPC.
◦ Um nome do site em que o PI Vision sera instalado. Selecione o nome de um site dedicado
onde nao esteja instalado nenhum aplicativo.
◦ Um tipo de conta para que a conta execute os pools de aplicativos que acessam os
servidores SQL, PI Data Archive e PI AF. Selecione Default para usar a conta do
ApplicationPoolIdentity ou selecione Custom e digite o nome de usuario e senha da
conta. Para alterar a conta apos a instalaçao, consulte Configurar os pools de aplicativos
do PI Vision para usar a conta de serviço do PI Vision.
CUIDADO:
A OSIsoft recomenda fortemente a criaçao de uma conta de domínio para o serviço do
PI Vision. Ao usar uma conta da maquina (o padrao), todos os aplicativos rodando no
computador do servidor do aplicativo terao as mesmas permissoes de acesso que o
serviço do PI Vision ao SQL, PI Data Archivee servidores PI AF. Isso e um risco para a
segurança. No mínimo, considere a remoçao de alguns ou de todos os outros
aplicativos rodando neste computador. Para obter mais informaçoes, consulte Fase 2:
criando uma conta de serviço e configurando permissoes.
O assistente de instalaçao do PI Visioncria estes itens:
◦ Os grupos pre-preenchidos do Windows no servidor de aplicativo: PI Vision Admins e
PI Vision Users
◦ O site de administraçao do PI Vision
◦ O site do PI Vision, mais os pools de aplicativos: PIVisionServiceAppPool,
PIVisionAdminAppPool e PIVisionUtilityAppPool

Interface do usuário em vários idiomas disponível para instalação

A Multilingual User Interface (MUI) do PI Vision esta disponível para fazer download no Portal
do cliente da OSIsoft (https://my.osisoft.com/).
Apos a instalaçao da MUI no servidor Web, os usuarios podem alterar o idioma visto no
PI Vision modificando as configuraçoes de idioma em seu navegador.
O suporte da Multilingual User Interface (MUI) do PI Vision permite que os usuarios visualizem
o aplicativo em oito idiomas diferentes:
• Frances
• Alemao
• Espanhol

28 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

• Portugues
• Chines simplificado
• Japones
• Coreano
• Russo

Executar uma instalação silenciosa

É possível instalar o PI Vision silenciosamente ao rodar um script de um command prompt. Use
uma instalaçao silenciosa para instalar o PI Vision sem interaçao do usuario. Antes de executar
o script de instalaçao silenciosa, edite as propriedades de configuraçao para o PI Vision e edite
o script para definir o PI Data Archive padrao e os servidores do PI AF para a sua instalaçao do
PI Vision.
Nota:
Voce deve instalar o .NET Framework 4.8 antes de executar a instalaçao silenciosa, pois
isso fornece a experiencia de instalaçao silenciosa mais consistente para o PI Vision.

Procedimento
1. Extraia os arquivos de instalaçao do PI Vision clicando duas vezes no arquivo .exe.
Observe a pasta na qual os arquivos de instalaçao sao extraídos.
2. Abra o arquivo silent.ini em um editor de texto.
Esse arquivo lista a execuçao dos comandos durante a instalaçao silenciosa do PI Vision.
3. Na seçao [COMMANDLINE] desse arquivo, edite os comandos para refletir sua configuraçao:
a. No comando 8, substitua MyPIServer pelo seu servidor padrao do PI Data Archive e
substitua MyAFServer pelo seu servidor padrao do PI AF.
8 = /qn REBOOT=Suppress ALLUSERS=1 PI_SERVER=MyPIServer
PI_USER=pidemo AF_SERVER=MyAFServer ADDLOCAL=FD_AFSDK,
FD_AFExplorer,FD_AFBuilder,FD_AFDocs
4. Salve o arquivo silent.ini.
5. Inicie um command prompt como administrador e navegue ate a pasta que contem os
arquivos de instalaçao extraídos.
6. Insira o seguinte comando para iniciar a instalaçao silenciosa:
setup.exe –f silent.ini

Fase 4: configurando o PI Vision após a instalação

Nesta fase, voce configurara o PI Vision no site de administraçao do PI Vision. Essa

configuraçao de pos-instalaçao envolve a configuraçao de acesso aos servidores PI Data Archive
e PI AF e a criaçao do banco de dados do PI Vision que e usado para armazenar as
configuraçoes do display do PI Vision.

Guia de Instalação e Administração do PI Vision 2021 29

Instalação do PI Vision

Nesta seção
• Adicionar um servidor PI Data Archive ou um servidor AF do PI a lista de servidores
registrados
• Configurar os pools de aplicativos do PI Vision para usar a conta de serviço do PI Vision
• Criar ou fazer upgrade do banco de dados do PI Vision
• Selecione um certificado diferente para usar no site do PI Vision
• Permitir acesso a cada servidor PI Data Archive por meio do PI Vision
• Permitir acesso a cada PI AF Server por meio do PI Vision
• Configurar pastas de importaçao do PI ProcessBook

Adicionar um servidor PI Data Archive ou um servidor AF do PI à lista de

servidores registrados
Se a lista de servidores AF do PI e bancos de dados registrados no PI System Explorer nao
incluir o servidor AF desejado, siga estas etapas para configurar uma conexao entre o servidor
de aplicativo do PI Vision e cada servidor AF do PI que planeja usar com o PI Vision.

Procedimento
1. Execute o PI System Explorer localmente no servidor de aplicativo do PI Vision. O PI System
Explorer faz parte da instalaçao do PI Vision.
2. Escolha Arquivo > Conexões. A janela Servidores e aberta. Esta janela lista todos os
servidores PI Data Archive e PI AF Servers para os quais uma conexao esta configurada. O PI
Data Archive e os PI AF Servers conectados no momento sao indicados com círculos verdes.
3. Clique em Adicionar servidor de ativos para o servidor AF do PI ou em Adicionar servidor de
dados para PI Data Archive.
4. Na janela Propriedades do servidor, insira o nome do seu servidor AF do PI ou servidor PI
Data Archive no campo Host.
5. Clique em Conectar.

Configurar os pools de aplicativos do PI Vision para usar a conta de serviço

do PI Vision
Se estiver usando uma conta de domínio para a conta de serviço do PI Vision, sera necessario
configurar os pools de aplicativo para usar essa identidade, conforme descrito abaixo. Se
pretender usar a conta da maquina para o serviço do PI Vision, voce nao precisara configurar os
pools de aplicativos. No entanto, sera necessario verificar as configuraçoes do pool de
aplicativos descritas na etapa 4. Os pools de aplicativos sao configurados durante a instalaçao.
Se necessario, siga o procedimento abaixo para alterar a configuraçao dos pools de aplicativos.
CUIDADO:
A OSIsoft recomenda fortemente a criaçao de uma conta de domínio para o serviço do
PI Vision. Ao usar uma conta da maquina (o padrao), todos os aplicativos rodando no
computador do servidor do aplicativo terao as mesmas permissoes de acesso que o
serviço do PI Vision ao SQL, PI Data Archivee servidores PI AF. Isso e um risco para a
segurança. No mínimo, considere a remoçao de alguns ou de todos os outros aplicativos
rodando neste computador. Para obter mais informaçoes, consulte Fase 2: criando uma
conta de serviço e configurando permissoes.

30 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

Procedimento
1. Execute o Internet Information Services (IIS) Manager.
2. Em Conexões, clique em Conjuntos de aplicativo para exibir a lista dos conjuntos de
aplicativo. A lista inclui tres pools de aplicativos do PI Vision:
◦ PIVisionAdminAppPool executa o site de administraçao, localizado em: https://
webServer/PIVision/Admin
◦ PIVisionServiceAppPool executa os principais sites de aplicativo do PI Vision,
localizados em https://webServer/PIVision
◦ PIVisionUtilityAppPool executa os PI Vision serviços de utilidade, localizados em
https://webServer/PIVision/Utility
3. Na lista de pools de aplicativos, clique com o botao direito em um pool de aplicativos do
PI Vision e clique em Advanced Settings para abrir a janela Advanced Settings.
4. Verificar as configuraçoes para o pool de aplicativos:
a. Em General, verifique se a configuraçao Enable 32-bit Applications e False. O PI Vision e
um aplicativo de 64 bits e nao funcionara apropriadamente em um pool de aplicativos de
32 bits.
b. Em Process Model, verifique se a configuraçao Maximum Worker Processes e 1. Outros
valores podem causar erros no PI Vision.
5. Definir a identidade para o pool de aplicativos:
a. Em Process Mode, clique no campo Identity e em Browse para abrir a janela Application
Pool Identity.
b. Clique em Custom account e clique em Set para abrir a janela Set Credentials.
c. Insira o nome de usuario e a senha para a conta de serviço personalizada do PI Vision e
clique em OK para fechar as janelas abertas.
6. Repita as etapas 3 a 5 para os outros pools de aplicativos do PI Vision.

Criar ou fazer upgrade do banco de dados do PI Vision

Apos executar o programa de instalaçao do PI Vision, use o site de administraçao do PI Vision
para criar ou fazer upgrade do banco de dados do PI Vision. Com algumas configuraçoes, sera
necessario executar um script no SQL Server.

Antes de Iniciar
Verifique se voce tem as permissoes necessarias para criar ou fazer o upgrade do banco de
dados.
Processo Permissão necessária
Criar o banco de dados Sera necessario:
• Funçao de servidor db_creator
• Permissao ALTER ANY LOGIN
Voce recebe essa permissao com a instruçao GRANT ALTER ANY LOGIN
TO "domain\account". Se for membro da funçao de servidor
securityadmin, voce ja possui a permissao ALTER ANY LOGIN.

Guia de Instalação e Administração do PI Vision 2021 31

Instalação do PI Vision

Processo Permissão necessária

Fazer o upgrade do É necessario ter a funçao de banco de dados db_owner ou as seguintes
banco de dados funçoes de banco de dados:
• db_datareader
• db_datawriter
• db_ddladmin

Procedimento
1. No seu navegador da Web, acesse o site de administraçao do PI Vision.
Por padrao, esse site esta localizado em: https://webServer/PIVision/Admin em que
webServer e o nome do servidor web do PI Vision .
Nota:
Se acessar o site de administraçao do PI Vision em um navegador que esta rodando
localmente no servidor de aplicativo do PI Vision, voce devera executar o navegador
como administrador. Para fazer isso, clique com o botao direito no ícone de atalho do
navegador e clique em Executar como administrador.
2. Clique em Configuração no painel de navegaçao a esquerda e clique na guia PI Vision
Database.

3. Na lista SQL Server, selecione a instancia do Microsoft SQL Server que abriga o banco de
dados do PI Vision. Tambem e possível digitar o nome do servidor diretamente no campo,
como .\sqlexpress.
Uma unica instancia do SQL Server pode hospedar ambos os bancos de dados do PI Vision e
do PI AF, ou diferentes instancias do SQL Server podem hospedar cada banco de dados.
4. Na lista Database, selecione o banco de dados em que deseja armazenar os dados do
PI Vision ou digite o nome do banco de dados no campo.
Para um melhor desempenho, o PI Vision precisa de um banco de dados dedicado. Nao
selecione o banco de dados do PI AF para armazenar dados do PI Vision.
5. Clique em Salvar.

32 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

◦ Se criou o banco de dados com exito, uma mensagem indicara o exito e marcas de
verificaçao na cor verde serao exibidas ao lado dos campos.
◦ Se precisar fazer o upgrade do banco de dados, uma janela abrira solicitando o upgrade
do banco de dados. Clique em OK na mensagem para fazer o upgrade do banco de dados
para a versao atual.
◦ Se a mensagem nao indicar que o banco de dados foi criado ou teve o upgrade feito com
exito, use um script para criar ou fazer o upgrade do banco de dados no SQL Server.
Consulte Executar o script go.bat para configurar o banco de dados do PI Vision.

Executar o script go.bat para configurar o banco de dados do PI Vision

Quando nao puder criar ou fazer o upgrade diretamente de um banco de dados do site de
administraçao do PI Vision, sera necessario executar o script go.bat no SQL Server para criar
ou fazer upgrade do banco de dados. O programa de instalaçao coloca o script go.bat no
diretorio do SQL no servidor de aplicativo.

Procedimento
1. No servidor de aplicativo do PI Vision, copie o diretorio do SQL. Este diretorio esta
normalmente localizado aqui:
Program Files/PIPC/PIVision/Admin/SQL
2. Na maquina rodando o SQL Server, cole a pasta e todo o seu conteudo em um diretorio local.
3. Na maquina rodando o SQL Server, abra o command prompt como administrador, navegue
para o diretorio local colado na etapa 2 e execute o script Go.bat: Tipo:
Go.bat DBServer DBName PIVisionService LogFile
em que:
◦ DBServer e o nome do SQL Server
Nota:
Se DBServer contiver qualquer espaço ou incluir uma porta personalizada, coloque
a string entre aspas duplas.
◦ DBName e o nome do banco de dados do PI Vision
◦ PIVisionService e o nome da conta de serviço do PI Vision
É necessario formatar o PIVisionService de acordo com o tipo de conta que estiver
usando:
Tipo de conta PIVisionService Formatar para PIVisionService
Usuario do domínio domain\service account name
O serviço de rede e o SQL Server nao estao Digite a conta de domínio do computador do
instalados no servidor de aplicativo do PI Vision servidor de aplicativos. As contas do
computador do Active Directory sempre
terminam com um cifrao. Por exemplo:
"domain\computer name$"
O serviço de rede e o SQL Server estao "NT AUTHORITY\Network Service"
instalados localmente no servidor de aplicativo
do PI Vision

Nota:
Se PIVisionService contiver algum espaço, coloque a string entre aspas duplas.
◦ LogFile e o arquivo onde o script grava as informaçoes de log. Esse parametro e opcional.
Se especificado, o script e escrito para este arquivo no diretorio que contem o script do

Guia de Instalação e Administração do PI Vision 2021 33

Instalação do PI Vision

go.bat. Se nao especificado, o script grava no arquivo do go_outputfile.log no

diretorio definido pela variavel de usuario TEMP.
4. Apos o comando ter sido concluído, repita as etapas para definir o banco de dados no site de
administraçao do PI Vision.
Para obter detalhes, consulte Criar ou fazer upgrade do banco de dados do PI Vision.

Exemplos de parâmetros de entrada para go.bat

Os exemplos a seguir demostram o uso de parametros de entrada com o script Go.bat.

• Instância local padrão do SQL Server, conta de domínio personalizado

Go.bat .\ PIVision mydomain\PIVisionaccount

◦ O banco de dados SQL do PI Vision e chamado PIVision.

◦ A instancia local padrao do SQL Server e usada.
◦ Usa-se uma conta de domínio personalizado.

• Instância específica do SQL Server, conta da máquina

Go.bat sqlserver\sqlinstance PIVision mydomain\PIVisionserver$

◦ O banco de dados SQL do PI Vision e chamado PIVision.

◦ Uma instancia em particular do SQL Server e usada.
◦ A conta da maquina do servidor de aplicativo do PI Vision e usada.

• Banco de dados SQL Express local, serviços rodando em um pool de aplicativos

padrão
Go.bat .\SQLEXPRESS PIVision "NT AUTHORITY\NETWORK SERVICE" output.log

◦ O banco de dados SQL do PI Vision e um banco de dados SQL Express chamado PIVision
e e local.
◦ Os serviços Web do PI Vision sao rodados no pool de aplicativos padrao.
◦ O script grava os resultados no arquivo do output.logno diretorio que contem o
arquivo go.bat.

• SQL Server usando porta personalizada, conta de domínio personalizada

Go.bat "sqlserver,4452" PIVision mydomain\PIVisionaccount

◦ O banco de dados SQL do PI Vision e chamado PIVision.

◦ A porta personalizada do 4452 esta sendo usada para o SQL Server.
◦ Usa-se uma conta de domínio personalizado.

Selecione um certificado diferente para usar no site do PI Vision

Se quiser selecionar um certificado SSL diferente para o site do PI Vision Internet
Information Services (IIS) a ser usado depois que a instalaçao do PI Vision for
concluída, voce pode alterar este certificado atraves do Internet Information Services (IIS)
Manager. Para obter mais informaçoes sobre a obtençao de um certificado SSL a ser usado com
o PI Vision e instala-lo no servidorInternet Information Services (IIS), consulte
Acesso SSL (Secure Sockets Layer, camada de soquetes seguros).

34 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

Procedimento
1. Execute o Internet Information Services (IIS) Manager.
2. Em Conexões,expanda sites para exibir a lista de sites no servidor da maquina de Internet
Information Services (IIS) destino. Localize o site que tem o aplicativo "PIVision"
instalado sob ele. Por padrao, este e o site padrão.
3. Clique no nome do site e, no painel Actions (Açoes), selecione Bindings (Vinculaçoes).
4. Na caixa de dialogo Site Bindings (Vinculaçoes do site), selecione a linha https e clique em
Edit (Editar).
5. Na caixa de dialogo Edit Site Bindings (Editar vinculaçoes do site), clique na lista suspensa
abaixo do certificado SSL e selecione um certificado diferente para vincular ao protocolo
HTTPS para o site do PI Vision Internet Information Services (IIS).

Permitir acesso a cada servidor PI Data Archive por meio do PI Vision

Use o site de administraçao do PI Vision para permitir acesso a cada servidor do PI Data
Archive usado pelos usuarios:
Nota:
Somente os servidores que estao na tabela de servidores conhecidos sao mostrados na
lista de servidores disponíveis.

Procedimento
1. No seu navegador da Web, acesse o site de administraçao do PI Vision.
Por padrao, esse site esta localizado em: https://webServer/PIVision/Admin em que
webServer e o nome do servidor web do PI Vision .
2. Na pagina Overview, clique em Manage Configuration, proximo a lista Data Servers Allowed.
Ou clique em Configuration na arvore de navegaçao e escolha a guia Data Servers.
3. Para adicionar um servidor do PI Data Archive, marque a caixa de seleçao Allowed ao lado
desse servidor.
Nota:
O botao Testar conexão testa se e possível conectar-se ao servidor PI Data Archive
apropriado usando a conta PIVisionService. Essa e a identidade usada pelos pools
de aplicativo do PI Vision.
4. Apos finalizar as alteraçoes, clique em Save para atualizar o servidor de aplicativo do
PI Vision com as suas seleçoes.

Permitir acesso a cada PI AF Server por meio do PI Vision

Use o site de administraçao do PI Vision para permitir acesso a cada servidor PI AF e bancos de
dados do PI AF usados pelos usuarios.

Procedimento
1. No seu navegador da Web, acesse o site de administraçao do PI Vision.
Por padrao, esse site esta localizado em: https://webServer/PIVision/Admin em que
webServer e o nome do servidor Web do PI Vision.
2. Na pagina Visão geral, clique em Gerenciar configuração ao lado da lista Servidor de ativos/
banco de dados permitidos ou clique em Configuração na arvore de navegaçao e escolha a
guia Servidores de ativos.

Guia de Instalação e Administração do PI Vision 2021 35

Instalação do PI Vision

A pagina PI AF Servers and bancos de dados abre. Essa pagina apresenta os servidores do PI
AF reconhecidos pelo PI Vision. Para adicionar um servidor do PI AF a lista, consulte
Adicionar um servidor PI Data Archive ou um servidor AF do PI a lista de servidores
registrados.
3. Se um servidor do PI AF tiver um símbolo de triangulo ao lado dele, sera possível expandi-lo
para visualizar uma lista de banco de dados do PI AF naquele servidor na coluna Bancos de
dados:
a. Para verificar a conexao a um servidor do PI AF, clique em Test Connection na coluna
Connection Status.
b. Para permitir o acesso a todos os bancos de dados, clique na caixa de seleçao All.
Alternativamente, para habilitar o acesso a um subconjunto de bancos de dados, marque
as caixas de seleçao somente daqueles bancos de dados para os quais deseja permitir
acesso.

4. Se um servidor do PI AF nao possuir um símbolo de triangulo ao lado dele, clique em Test

Connection para iniciar uma conexao para aquele servidor.
Se a conexao for bem-sucedida, entao sera possível visualizar os bancos de dados que
residem naquele servidor.
5. Apos finalizar as alteraçoes, clique em Salvar para atualizar o servidor de aplicativo do
PI Vision com as suas seleçoes.

Configurar pastas de importação do PI ProcessBook

É possível configurar o servidor do aplicativo para que os usuarios possam visualizar os
displays do PI ProcessBook.
Use o site de administraçao do PI Vision para especificar quais pastas deseja que o PI Vision
monitore em relaçao a displays do PI ProcessBook. Quando o serviço de monitoramento
detecta um arquivo PI ProcessBook novo, modificado ou excluído nessas pastas, ele faz
automaticamente a sua adiçao, atualizaçao ou exclusao no PI Vision. Todos os arquivos PDI e
SVG nas pastas especificadas e quaisquer subpastas sao importados automaticamente para o
servidor de aplicativo do PI Vision. Voce pode importar os arquivos PIW do PI ProcessBook no
PI Vision. O arquivo PIW e apresentado como uma pasta na pasta de importaçao contendo
subpastas para cada guia.
Displays do PI ProcessBook importados sao propriedade do usuario AD que possui o arquivo
PDI e sao compartilhados com a identidade do PI AF World por padrao. Voce pode ajustar as
configuraçoes de compartilhamento dos displays do PI ProcessBook depois que eles forem
importados para compartilha-los com uma identidade específica do PI AF. No entanto, se esse

36 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

display do PI ProcessBook for removido e, em seguida, adicionado novamente a pasta de

importaçao, ele sera compartilhado novamente com a identidade do World PI AF.
CUIDADO:
Para manter a segurança e a atualizaçao dos dados, implemente as medidas a seguir:
• Acesso restrito a rede para as pastas importadas, permitindo apenas que usuarios e
grupos que precisarem disso adicionem displays. É possível autorizar os usuarios e
grupos usando as configuraçoes de segurança do sistema operacional Windows para as
pastas e os volumes compartilhados. Observe que os displays importados estarao
disponíveis para visualizaçao por usuarios clientes no PI Vision. As permissoes nos
arquivos de display nas pastas importadas nao sao aplicadas aos displays importados.
• Conceda uma permissao de conta do pool de aplicativos do
PIVisionServiceAppPool para leitura da pasta de importaçao e de quaisquer
subpastas. Se a conta nao tiver permissao de leitura para qualquer subpasta, o serviço
de monitoramento nao podera adicionar, atualizar nem excluir automaticamente os
arquivos alterados do PI ProcessBook do PI Vision.
• Habilite a auditoria de segurança do Windows para rastrear quem adiciona, exclui ou
modifica os arquivos nas pastas importadas. Para obter mais informaçoes, consulte o
artigo Aplicar ou modificar as configuraçoes de diretiva de auditoria de um arquivo ou
pasta local (http://technet.microsoft.com/en-US/library/cc771070.aspx) do Microsoft
TechNet.
Nota:
O PI Vision nunca modifica o conteudo de uma pasta importada.

Procedimento
1. No seu navegador da Web, acesse o site de administraçao do PI Vision.
Por padrao, esse site esta localizado em: https://webServer/PIVision/Admin em que
webServer e o nome do servidor Web do PI Vision.
2. Na arvore de navegaçao, clique em Gerenciar a importação de pasta.
3. Para adicionar uma nova pasta, insira o caminho na coluna Pasta.
Opcionalmente, e possível inserir um alias na pasta no campo Nome amigável. Em seguida,
clique em Adicionar.
O campo Pasta acessível indica se a pasta esta acessível pelo serviço de monitoramento.
Depois que voce adiciona uma pasta, o status Pasta acessível mostrara um ponto de
interrogaçao ate que a pagina de administraçao do PI Vision seja atualizada. Se o caminho
para a nova pasta estiver acessível e sem nenhum erro, ele mostra uma marca de seleçao
verde.
Um X vermelho indica que ha um problema com o processo de monitoramento do arquivo
ao acessar a pasta especificada. Para determinar a causa, investigue erros no log de eventos
do PISymbols Admin. Em geral, os erros de monitoramento de arquivo ocorrem por causa
de um caminho invalido ou talvez porque a conta do pool de aplicativos do
PIVisionServiceAppPool nao tenha privilegios suficientes para acessar a hierarquia da
pasta de importaçao.

Guia de Instalação e Administração do PI Vision 2021 37

Instalação do PI Vision

Nota:
Isso pode demorar alguns minutos para o processo de monitoramento de pasta
começar a importar arquivos, pois o processo procura por todos os arquivos antes de
começar o processo de importaçao real.
A pasta e acessada usando a identidade do conjunto de aplicativo
PIVisionServiceAppPool.
4. (Opcional) Clique em Show Status para ver as informaçoes sobre quaisquer erros que
ocorreram durante a importaçao.
5. (Opcional) Para modificar um nome amigavel, insira as suas alteraçoes no campo Nome
amigável e clique em Aplicar.
6. (Opcional) Se nao desejar mais importar os displays do PI ProcessBook de uma pasta, clique
no botao Remove.
Todos os arquivos dessa pasta serao removidos do servidor de aplicativo do PI Vision; os
arquivos do PI ProcessBook nao sao afetados.
Nota:
Depois de excluir as pastas de importaçao, refaça a indexaçao do banco de dados do
SQL Server do PI Vision e atualize as estatísticas.
Para saber mais sobre como refazer a indexaçao do Microsoft SQL Server, consulte o
artigo do Microsoft TechNet, Como recriar um índice (SQL Server Management Studio)
(https://technet.microsoft.com/en-us/library/ms187874(v=sql.105).aspx).
Para saber mais sobre a atualizaçao de estatísticas de consulta no Microsoft SQL
Server, consulte o documento Update Statistics (Transact-SQL) (https://
docs.microsoft.com/en-us/sql/t-sql/statements/update-statistics-transact-sql) da
Microsoft.

Fase 5: configurando a delegação do Kerberos

Nesta ultima fase da instalaçao, voce configurara a autenticaçao de servidor do PI Data Archive
para o PI Vision por meio do Windows Integrated Security (WIS). A OSIsoft recomenda que
voce configure o WIS habilitando a delegaçao do Kerberos. A delegaçao do Kerberos e um
protocolo de autenticaçao de rede que permite aos usuarios um ambiente de aplicativo
distribuindo o acesso seguro a fontes de dados remotas. A delegaçao do Kerberos foi

38 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

desenvolvida para fornecer uma autenticaçao forte para aplicativos do servidor/cliente usando
criptografia de chave secreta. Os clientes obtem chamados do Centro de distribuiçao de chaves
do Kerberos e apresentam os chamados aos servidores quando as conexoes sao estabelecidas.
O WIS exige o uso de PI mappings para autenticar os usuarios no servidor PI Data Archive. Se
ainda nao estiver usando PI mappings para autenticar os usuarios do servidor PI Data Archive,
sera necessario configurar primeiro os PI mappings solicitados. Consulte Criar PI mappings.
CUIDADO:
A OSIsoft recomenda o uso de PI mappings para configurar a autenticaçao em vez de usar
PI trusts.
Se voce suportar usuarios do PI Vision em dispositivos moveis e usar o WIS para autenticar
usuarios do servidor do PI Data Archive, tambem precisara configurar Secure Sockets Layer
(SSL) (se ainda nao tiver feito isso) e executar a autenticaçao basica. Depois de habilitar a
delegaçao do Kerberos, siga as instruçoes em Autenticaçao do servidor do PI Data Archive em
dispositivos moveis.
Em relaçao as seguintes funcionalidades, a delegaçao restrita de Kerberos deve ser configurada
entre o servidor de aplicativo do PI Vision e o servidor do PI AF, ou a autenticaçao basica deve
ser configurada para o aplicativo Web do PI Vision:
• Anotaçao e reconhecimento de evento
• Criterios de pesquisa de evento
• Criterios de pesquisa de coleçao
• Criterios de pesquisa de tabela em comparaçao a ativo
Nota:
Uma configuraçao no arquivo web.config controla o comportamento dos criterios de
pesquisa ao filtrar os valores dos atributos. Essa configuraçao nao esta incluída no
arquivo padrao web.config e deve ser adicionada manualmente, se necessario:
SearchFilterValueSecurity: Auto (default) | System | Disable

◦ Auto
Se passar pelo usuario atual se a fonte de referencia de dados tiver sua
propria configuraçao de segurança.

◦ Sistema
Use sempre o conjunto de identidades do sistema na conta do pool de
aplicativos.

◦ Desativar
Nao permita filtragem de valor de atributo.

Nesta seção
• Criar PI mappings
• Habilitar a delegaçao de Kerberos
• Configurar navegadores da Web para clientes do PI Vision
• Configure uma delegaçao restrita baseada em recursos
• Habilitar a autenticaçao basica
• Autenticaçao do servidor do PI Data Archive em dispositivos moveis

Guia de Instalação e Administração do PI Vision 2021 39

Instalação do PI Vision

Criar PI mappings
PI Identities e PI Mappings sao os componentes centrais do modelo de segurança do PI Data
Archive. Juntos, eles determinam quais usuarios do Windows estao autenticados no servidor do
PI Data Archive e quais permissoes de acesso eles tem. Para obter mais informaçoes sobre o PI
mappings, consulte o topico Gerenciamento de mapping (https://docs.osisoft.com/bundle/pi-
server/page/mapping-management.html) do PI Server.

Procedimento
1. Abra o PI System Management Tools (SMT).
2. Em Collectives and Servers, selecione o servidor.
3. Em System Management Tools, selecione Security > Identities, Users, & Groups.
4. Selecione a identidade, usuario ou grupo que deseja mapear.
5. Na barra de ferramentas, clique no botao Propriedades . A janela Properties e exibida.
6. Na janela Properties, clique na guia Mappings and Trusts. A parte superior da janela mostra
todos os mappings existentes para PI Identity, PI User ou PI Group. A parte inferior mostra
todos os PI trusts existentes.
7. Clique emAdicionar (Add) na parte de mappings da janela.
A janela Add New Mapping e aberta.
Nota:
O botao Add sera desabilitado se a PI identity estiver marcada como desabilitada ou
nao puder ser usada em um mapping.

8. Insira a conta do Windows para usuarios em grupo ou individuais. Ela pode ser um AD
principal ou um grupo ou usuario local do Windows. Para selecionar a conta:
◦ Clique no botao de navegaçao para navegar pela conta.

◦ Digite o nome da conta para usuarios em grupo ou individuais e clique no botao

solucionar SID para identificar se essa conta e valida. Se a conta for valida, um SID
sera exibido no campo. Caso contrario, uma janela com uma mensagem de erro sera
exibida.

Habilitar a delegação de Kerberos

Para habilitar o PI Vision para que ele se conecte por meio do Windows Integrated Security
(WIS), configure a delegaçao de Kerberos para o servidor de aplicativo do PI Vision. Na maioria
das organizaçoes, em geral, a delegaçao do Kerberos e habilitada por um administrador de TI.
Para saber mais sobre a delegaçao do Kerberos, consulte o artigo Microsoft Kerberos (https://
msdn.microsoft.com/en-us/library/windows/desktop/aa378747(v=vs.85).aspx) da Microsoft.
Nota:
Se estiver usando um nome de host personalizado em vez de um nome de NetBIOS,
consulte o artigo Service Principal Name (SPN) checklist for Kerberos authentication with
IIS 7.0/7.5 (https://blogs.msdn.microsoft.com/webtopics/2009/01/19/service-
principal-name-spn-checklist-for-kerberos-authentication-with-iis-7-07-5/) do Microsoft
Developer.
Os procedimentos a seguir para configurar a delegaçao restrita presumem que voce esta
acessando o servidor Web com um nome NetBIOS, como https://webServer/PIVision.

40 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

Nota:
Se os componentes do sistema atenderem aos requisitos, voce pode, como alternativa,
optar por configurar a delegaçao restrita baseada em recursos usando os cmdlets do
Active Directory no PowerShell. Para obter mais informaçoes, consulte Configurar
delegaçao restrita baseada em recursos. Para habilitar a delegaçao restrita baseada em
recursos, os domínios de conta de front-end e back-end precisam ter o Server 2012 ou
KDCs mais altos. O servidor de front-end deve estar sendo executado no Microsoft
Windows Server 2012 ou em sistema operacional mais recente.
Em alguns casos, voce pode querer usar um alias DNS personalizado em vez do nome da
maquina para acessar o aplicativo PI Vision. O uso do alias DNS personalizado impacta o PI
Vision em algumas maneiras.
• Autenticaçao kerberos: Consulte Configuraçao de Kerberos para aliases DNS (ANAME e
CNAME) (https://customers.osisoft.com/s/knowledgearticle?
knowledgeArticleUrl=KB01574) para obter mais detalhes.
• Recurso de pesquisa: Configuraçao do PI Vision para ser acessado por um alias DNS
(https://customers.osisoft.com/s/knowledgearticle?knowledgeArticleUrl=KB01691)

Procedimento
1. Siga o procedimento adequado, dependendo do seu tipo de conta de serviço.
◦ Habilitar a delegaçao de Kerberos por meio de uma conta da maquina padrao
◦ Habilite a delegaçao de Kerberos por meio de uma conta de serviço personalizada do PI
Vision

Habilitar a delegação de Kerberos por meio de uma conta da máquina

padrão
Por padrao, os serviços do Windows e pools de aplicativos associados ao PI Vision usam as
seguintes contas:
Serviço Conta
PIVisionAdminAppPool NT Authority\Network Service
PIVisionServiceAppPool NT Authority\Network Service

Quando essa configuraçao for usada, os nomes de serviço principal (SPNs) do HOST abaixo
deverao existir para a conta da maquina do servidor de aplicativo do PI Vision. Esses SPNs ja
devem existir por padrao, mas voce pode verificar a existencia usando o comando do setspn -
l netbios-server-name, que retorna as seguintes linhas:
HOST/netbios-server-name
HOST/fully-qualified-DNS-name

A autenticaçao por modo kernel e habilitada por padrao nos Internet Information Services (IIS)
e deve permanecer habilitada para essa configuraçao.
Para obter mais informaçoes sobre SPNs, consulte o artigo da Microsoft TechNet Service
Principal Names (https://technet.microsoft.com/en-us/library/cc961723.aspx).

Procedimento
1. Em seu controlador de domínio, abra Usuários e computadores no Active Directory.
2. Selecione Computadores no domínio do servidor de aplicativo do PI Vision.
3. Clique com o botao direito no servidor de aplicativo do PI Vision e clique em Propriedades.

Guia de Instalação e Administração do PI Vision 2021 41

Instalação do PI Vision

4. Na janela Propriedades, clique na guia Delegação e especifique uma configuraçao confiavel

para o computador. Selecione as seguintes opçoes:
◦ Confiar neste computador para delegação de serviços específicos apenas
◦ Usar qualquer protocolo de autenticação
Selecionar Usar qualquer protocolo de autenticação permite a transiçao de um protocolo.
Isso permite que o PI Vision autentique usuarios com NTLM e ainda seja capaz de usar a
delegaçao de Kerberos em relaçao aos serviços especificados na proxima etapa.

5. Adicione serviços para cada servidor do PI Data Archive que o PI Vision acessara.
a. Clique em Adicionar para abrir a janela Adicionar serviços.
b. Clique em Usuários ou computadores.

42 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

c. Insira o nome do servidor do PI Data Archive e clique em Verificar nomes.

d. Clique em OK para retornar a janela Adicionar serviços preenchida com a lista de todos os
tipos de serviço.
e. Na lista Serviços disponíveis, clique em PIServer e clique em OK para adicionar o SPN ao
PI Data Archive Server.

6. Adicione serviços para cada servidor do PI AF que o PI Vision acessara.

Repita a etapa 5, mas insira o nome do seu servidor do PI AF e clique em AFServer como o
tipo de serviço.

Guia de Instalação e Administração do PI Vision 2021 43

Instalação do PI Vision

Nota:
Se o servidor do PI AF estiver sendo executado como conta de serviço personalizada,
pesquise o SPN do servidor do PI AF por essa conta de serviço no lugar do nome da
maquina.
Os serviços que voce adicionou agora serao exibidos na janela Properties.
7. Clique em Apply.

Habilite a delegação de Kerberos por meio de uma conta de serviço

personalizada do PI Vision
Quando o PI Vision usa uma conta de domínio personalizada, os serviços do Windows e os
pools de aplicativos associados ao PI Vision sao executados como essa conta. Para habilitar a
delegaçao do Kerberos, e necessario configurar o site do PI Vision para usar as credenciais do
pool de aplicativos, criar os nomes de serviço principal (SPNs) necessarios e configurar a conta
de serviço para dar suporte ao Kerberos, incluindo a habilitaçao da delegaçao aos servidores do
PI Data Archive e do PI AF necessarios.

Antes de Iniciar
Verifique se voce tem o privilegio Validated Write to Service Principal Names no
objeto do computador ou usuario no Active Directory. Esse privilegio e necessario para criar
SPNs nesse procedimento. Entre em contato com o administrador de TI se voce nao tiver
privilegios suficientes.

Procedimento
1. Configure o site do PI Vision para usar as credenciais do pool de aplicativos:
a. No Internet Information Services (IIS) Manager, selecione o site do PIVision e, em
Management, clique duas vezes no ícone do Editor de configuração para abrir a pagina
do Editor de configuração.
b. Na lista Section, selecione system.webServer/security/authentication/
windowsAuthentication.
c. Defina a propriedade useAppPoolCredentials como True e clique em Apply.
d. Abra um command prompt e execute o comando iisreset.
2. Crie dois nomes de serviço principal (SPNs) do Active Directory:
a. Abra um command prompt.
b. Use o comando setspn -S para criar um SPN para o nome do netbios e o nome do DNS
totalmente qualificado do servidor de aplicativo do PI Vision:
setspn -S http/netbios-server-name domain\service-account
setspn -S http/fully-qualified-DNS-name domain\service-account

Por exemplo:
setspn -S http/myserver mydomain\PIVisionService
setspn -S http/myserver.mydomain.int mydomain\PIVisionService

Nota:
Se apontar para seu host com um registro A (registro de endereço), registre o SPN
para o host em vez de para o nome do servidor. Se apontar para seu host com um
registro CNAME (registro de nome canonico), registre o SPN para o nome do
servidor. Para obter mais informaçoes, consulte o artigo da Base de Conhecimento
da OSIsoft Configuring Kerberos for DNS Aliases (ANAME and CNAME), no Portal do
Cliente OSIsoft (https://customers.osisoft.com/s/knowledgearticle?
knowledgeArticleUrl=KB01574).

44 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

3. Em seu controlador de domínio, abra Usuarios e computadores no Active Directory.

4. No domínio do servidor de aplicativo do PI Vision, clique em Users.

5. Clique com o botao direito no nome da conta de domínio do PI Vision e clique em Properties.
6. Na janela Properties, clique na guia Delegation e selecione duas configuraçoes para a conta:
◦ Confiar neste usuário para delegação de serviços específicos apenas
◦ Usar qualquer protocolo de autenticação
Selecionar Usar qualquer protocolo de autenticação permite a transiçao de um protocolo.
Isso permite que o PI Vision autentique usuarios com NTLM e ainda seja capaz de usar a
delegaçao do Kerberos em relaçao aos serviços especificados.
7. Adicione serviços para cada servidor do PI Data Archive que o PI Vision acessara.
a. Clique em Add para abrir a janela Add Services.
b. Clique em Users or Computers.

c. Insira o nome de um servidor do PI Data Archive ou servidor do PI AF acessado pelo

PI Vision. Se o seu PI Data Archive ou PI AF estiver usando uma conta de serviço
personalizada, procure por esse nome. Em seguida, clique em Check Names.

Guia de Instalação e Administração do PI Vision 2021 45

Instalação do PI Vision

d. Clique em OK para retornar a janela Add Services preenchida com a lista de todos os
tipos de serviço.
e. Na lista Available services, clique em PIServer e clique em OK para adicionar o SPN ao PI
Data Archive Server.

8. Adicione serviços para cada servidor do PI AF que o PI Vision acessara.

Repita a etapa 7, mas insira o nome do seu servidor do PI AF e clique em AFServer como o
tipo de serviço.
Nota:
Se o servidor do PI AF estiver sendo executado como conta de serviço personalizada,
pesquise o SPN do servidor do PI AF por essa conta de serviço no lugar do nome da
maquina.
Os serviços que voce adicionou agora serao exibidos na janela Properties.
9. Clique em Apply.

Configurar navegadores da Web para clientes do PI Vision

Para usar navegadores da Web para clientes do PI Vision, uma autenticaçao do Windows deve
estar habilitada no navegador. Siga estas instruçoes para habilitar a autenticaçao do Windows
para Internet Explorer, Mozilla Firefox e Google Chrome.

Procedimento
1. No Internet Explorer, va para Configurações > Opções de internet.
2. Clique na guia Avançado.

46 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

3. Marque a caixa de seleçao para Habilitar autenticação integrada do Windows.

4. Para habilitar a autenticaçao Kerberos para Google Chrome, habilite a autenticaçao Kerberos
no Internet Explorer seguindo as instruçoes acima.
5. Para habilitar a autenticaçao Kerberos para Mozilla Firefox, abra o Firefox e digite
about:config na barra de endereço.

Confirme qualquer caixa de dialogo de aviso que possa aparecer.

6. Insira network.negotiate no campo Pesquisar para filtrar a lista.
7. Localize e clique network.negotiate-auth.trusted-uris.

Guia de Instalação e Administração do PI Vision 2021 47

Instalação do PI Vision

8. Na janela Inserir valor de string insira o nome do domínio e clique em OK.

Configure uma delegação restrita baseada em recursos

Ha varios benefícios da delegaçao restrita baseada em recursos em comparaçao com a
delegaçao restrita de Kerberos tradicional:
• A permissao para delegaçao ao recurso de back-end esta associada a identidade de back-
end, e nao a identidade de front-end.
• A configuraçao da delegaçao requer permissao do Write Account Restrictions apenas
no recurso de back-end específico (usuario ou computador do Active Directory).
• A delegaçao funciona alem dos limites do domínio e da floresta.
A delegaçao restrita com base em recursos e uma excelente escolha para aqueles que nao sao
administradores de TI. Ela permite que os administradores do PI controlem se recursos como
os servidores PI Data Archive e PI AF recebem ou nao credenciais delegadas. No entanto, para a
delegaçao restrita baseada em recursos funcionar, os seguintes requisitos devem ser atendidos:
• O domínio da conta de front-end (identidade do pool de aplicativos do PI Vision) deve ter
um nível Windows Server 2012 ou KDC mais alto.
• O domínio da conta de back-end (conta da maquina do PI Data Archive ou conta de serviço
do servidor do PI AF) deve ter o Windows Server 2012 ou KDC mais alto.
• O servidor de front-end deve estar rodando no Windows Server 2012 ou em sistema
operacional mais recente.
Para obter mais informaçoes, consulte o artigo da Microsoft Visao geral da delegaçao restrita de
Kerberos (https://docs.microsoft.com/en-us/windows-server/security/kerberos/kerberos-
constrained-delegation-overview).
Para configurar a delegaçao restrita baseada em recursos, voce define um atributo na
identidade do serviço de back-end. O atributo especifica as identidades do serviço de front-end
que pode enviar credenciais delegadas para a identidade de back-end. Para definir esse
atributo, use cmdlets do Active Directory no PowerShell. Voce pode executar esses cmdlets em
qualquer maquina com o recurso Remote Server Administration Tools (RSAT-AD-PowerShell)
instalado. Para executar os cmdlets, voce precisa de acesso de gravaçao aos atributos do objeto
back-end do Active Directory. Use os cmdlets apropriados para sua conta de serviço:

48 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

• Se o serviço estiver rodando em uma conta de domínio, use Get-ADUser e Set-ADUser.

• Se o serviço for executado em uma conta de serviço gerenciada por grupo (gMSA), use Get-
ADServiceAccount ou Set-ADServiceAccount. Veja o artigo da Microsoft Visao geral das
contas de serviço gerenciadas por grupo (https://docs.microsoft.com/en-us/windows-
server/security/group-managed-service-accounts/group-managed-service-accounts-
overview).
• Se o serviço for executado em uma conta de maquina como Network Service ou uma
conta virtual, use Get-ADComputer ou Set-ADComputer.

Procedimento
1. Abra o PowerShell
2. Defina as variaveis que contem as identidades de front-end e back-end.
Por exemplo, se o servidor da web do PI Vision (o serviço de front-end) e executado na conta
do usuario do domínio PIVisionServicee o PI AF Server PIAF01(o serviço de back-end) e
executado na conta virtual padrao NT Service\AFService, digite o seguinte:
$frontendidentity = Get-ADUser -Identity PIVisionService
$backendidentity = Get-ADComputer -Identity PIAF01
3. Atribua a identidade de front-end ao atributo PrincipalsAllowedToDelegateToAccount
da identidade de back-end.
Por exemplo, se o serviço de back-end for executado em uma conta de maquina, insira o
seguinte cmdlet:
Set-ADComputer $backendidentity -PrincipalsAllowedToDelegateToAccount
$frontendidentity

Para permitir que multiplos princípios deleguem ao mesmo recurso de back-end, defina o
atributo PrincipalsAllowedToDelegateToAccount com todas as identidades desejadas.
Por exemplo, se o serviço de back-end for executado em uma conta de maquina, insira o
seguinte cmdlet:
Set-ADComputer $backendidentity -PrincipalsAllowedToDelegateToAccount
$frontendidentity1, $frontendidentity2
4. Veja o atributo PrincipalsAllowedToDelegateToAccount atualizado da identidade
back-end para verificar se ela esta definida corretamente.
Por exemplo, se o serviço de back-end for executado em uma conta de maquina, insira o
seguinte cmdlet:
Get-ADComputer $backendidentity -Properties
PrincipalsAllowedToDelegateToAccount

Nota:
Se voce estiver usando uma conta de serviço do PI Vision, deve criar nomes principais
de serviço (SPNs) para a conta para que a delegaçao restrita baseada em recursos
funcione. Para obter mais informaçoes sobre a criaçao de SPNs, consulte as etapas 1 e
2 em Habilite a delegaçao de Kerberos por meio de uma conta de serviço
personalizada do PI Vision.

Habilitar a autenticação básica

A OSIsoft recomenda que voce habilite a delegaçao do Kerberos. Caso seu domínio nao ofereça
suporte a delegaçao do Kerberos (por exemplo, varios domínios em diferentes florestas), sera
necessario habilitar a autenticaçao basica.

Guia de Instalação e Administração do PI Vision 2021 49

Instalação do PI Vision

Com a autenticaçao basica, o PI Vision pode garantir uma segurança específica ao usuario.
Entretanto, a autenticaçao basica envia as credenciais do usuario para o servidor da Web em
texto simples; portanto, voce deve configurar o site do PI Vision para que ele use o acesso
Secure Sockets Layer (SSL).

Procedimento
1. No Internet Information Services (IIS) Manager, selecione o aplicativo Web do PI Vision e
clique duas vezes no ícone Autenticação na visualizaçao de recursos.

2. Selecione Autenticação básica e clique no link Habilitar no painel a direita.

3. Para configurar dispositivos moveis para usar a autenticaçao basica:
a. Selecione Autenticação do Windows.
b. Clique no link Fornecedores no painel a direita.
c. Exclua o NTLM da janela que e aberta.
4. Para configurar navegadores de desktop para usar a autenticaçao basica:
a. Selecione Autenticação do Windows e clique no link Desabilitar no painel a direita.
Nota:
Isto impedira que os navegadores de desktop usem a autenticaçao do Windows.

Autenticação do servidor do PI Data Archive em dispositivos móveis

O OSIsoft recomenda o uso da autenticaçao basica com a criptografia SSL para os usuarios de
dispositivo movel. Isso habilita todos os aplicativos e navegadores moveis suportados para
autenticar o servidor do PI Vision com exito. Alguns dispositivos tambem podem suportar a
autenticaçao de Kerberos.

50 Guia de Instalação e Administração do PI Vision 2021

 Instalação do PI Vision

A autenticação de Kerberos no Safari móvel para iPhones e iPads

Use um perfil de configuraçao para enviar informaçoes de configuraçao aos dispositivos iOS.
Inclua uma carga de conta de logon unico para enviar informaçoes ao Kerberos. Para obter mais
informaçoes, consulte a documentaçao do Apple Developer:
• Configuration Profile Reference (https://developer.apple.com/library/content/
featuredarticles/iPhoneConfigurationProfileRef/Introduction/Introduction.html)
• Single Sign-On Account Payload (https://developer.apple.com/library/content/
featuredarticles/iPhoneConfigurationProfileRef/Introduction/Introduction.html#//
apple_ref/doc/uid/TP40010206-CH1-SW44)

Autenticação básica
Com a autenticaçao basica, as credenciais do usuario sao passadas para o PI System. Deve-se
usar o metodo de autenticaçao basica se usar os mapeamentos no servidor do PI Data Archive
para fornecer segurança específica ao usuario. Entretanto, a autenticaçao basica envia as
credenciais do usuario para o servidor Web em texto simples; portanto, voce tambem devera
configurar o site do PI Vision para usar o SSL. Consulte Proteja seu site do PI Vision com HTTPS.
Para configurar a autenticaçao basica, consulte Habilitar a autenticaçao basica.

Guia de Instalação e Administração do PI Vision 2021 51

Instalação do PI Vision

52 Guia de Instalação e Administração do PI Vision 2021

Utilitário do display do PI Vision
O PI Vision Display Utility e um aplicativo de desktop independente instalado com o servidor
de aplicativo do PI Vision. Com esse utilitario, e possível fazer o seguinte:
• Copiar displays de um PI Vision para outro.
• Exportar displays do PI Vision para um sistema de arquivos do Windows.
• Importar displays do PI Vision para um servidor PI Vision.
• Alterar as fontes de dados dos displays alterando os servidores do PI AF, os bancos de dados
do PI AF ou os servidores do PI Data Archive.
• Excluir displays, reatribuir proprietarios de display e alterar as opçoes de
compartilhamento de display.
Por exemplo, voce pode usar o PI Vision Display Utility para copiar displays de um ambiente de
teste para um ambiente de produçao. Voce tambem pode indicar os símbolos nos displays de
teste para novas fontes de dados.

Nesta seção
• Requisitos do PI Vision Display Utility
• Configurar os pools de aplicativos do PI Vision para usar a conta de serviço do PI Vision
• Diretrizes para copiar displays ou alterar fontes de dados
• Copiar displays e alterar fontes de dados
• Excluir displays, atribuir novos proprietarios ou alterar definiçoes de funçao

Requisitos do PI Vision Display Utility

Requisitos de segurança
Para usar o utilitario de display do PI Vision 2021, o usuario que executa o utilitario deve ser
membro do grupo de usuarios no Windows do utilitario do PI Vision no servidor PI Vision ao
qual o utilitario de display esta se conectando. Para copiar displays entre servidores, o usuario
deve ser um membro desse grupo tanto nos servidores de origem e de destino.
Nota:
Os membros do grupo Utility Users do PI Vision tem autorizaçao para ler e modificar
qualquer display no sistema de computador associado, por isso tenha cuidado ao
adicionar usuarios a esse grupo.
Antes do PI Vision 2019, o PI Vision Display Utility se conectava diretamente aos bancos de
dados do SQL Server e a pessoa que executava o Display Utility precisava receber os direitos de
acesso ao banco de dados apropriados no SQL Server. Na versao atual, o Display Utility interage
com os displays do PI Vision usando serviços Web. Os direitos de acesso ao banco de dados nao
sao mais necessarios. O unico requisito e que o usuario que executa o Display Utility esteja no
grupo de Usuarios do PI Vision Utility no(s) servidor(es) apropriado(s) do PI Vision.
Nota:
O pool de aplicativos do PI Vison Utility precisa de acesso ao SQL; idealmente a mesma
conta que os outros dois pools de aplicativos para que possa usar o mesmo conjunto de
permissoes DVService SQL. Para obter mais informaçoes sobre pools de aplicativos,
consulte Configurar os pools de aplicativos do PI Vision para usar a conta de serviço do PI
Vision.

Guia de Instalação e Administração do PI Vision 2021 53

Utilitário do display do PI Vision

Requisitos do PI Vision
• Versao do PI Vision
Para a maioria das operaçoes, o Display Utility do PI Vision 2021requer um servidor PI
Vision 2021. Isto inclui:
◦ Excluir, reatribuir a propriedade do display ou configurar o acesso ao display em um
servidor PI Vision.
◦ Exportar displays de PI Vision para arquivo.
◦ Importar arquivos de display do PI Vision para um servidor PI Vision.
O Display Utility do PI Vision 2021 pode copiar displays do PI Vision de servidores do
PI Vision 2019 e PI Vision 2020 para um servidor do PI Vision 2021. Se o servidor de origem
PI Vision for uma versao PI Vision 2021 anterior, o Display Utility nao PI Vision 2021
fornecera a capacidade de copiar a estrutura da pasta dos displays selecionados no servidor
de PI Vision destino.
Se os displays do PI Vision estiverem sendo copiados de um servidor do PI Vision 2021 para
outro, a estrutura da pasta do servidor de origem PI Vision pode ser criada no servidor de
destino PI Vision.
Nota:
Para copiar ou modificar displays em um servidor do PI Vision antes do PI Vision
2021, a versao do Display Utility correspondente a essa versao deve ser usada.
• Conexao ativa ao PI Vision
Ao copiar displays de um sistema para outro, o PI Vision Display Utility deve se conectar ao
servidor de origem e de destino ao mesmo tempo.
• Autenticaçao do Windows
O PI Vision Display Utility deve usar autenticaçao do Windows para se conectar ao(s)
servidor(es) do PI Vision.

Configurar os pools de aplicativos do PI Vision para usar a

conta de serviço do PI Vision
Se estiver usando uma conta de domínio para a conta de serviço do PI Vision, sera necessario
configurar os pools de aplicativo para usar essa identidade, conforme descrito abaixo. Se
pretender usar a conta da maquina para o serviço do PI Vision, voce nao precisara configurar os
pools de aplicativos. No entanto, sera necessario verificar as configuraçoes do pool de
aplicativos descritas na etapa 4. Os pools de aplicativos sao configurados durante a instalaçao.
Se necessario, siga o procedimento abaixo para alterar a configuraçao dos pools de aplicativos.
CUIDADO:
A OSIsoft recomenda fortemente a criaçao de uma conta de domínio para o serviço do
PI Vision. Ao usar uma conta da maquina (o padrao), todos os aplicativos rodando no
computador do servidor do aplicativo terao as mesmas permissoes de acesso que o
serviço do PI Vision ao SQL, PI Data Archivee servidores PI AF. Isso e um risco para a
segurança. No mínimo, considere a remoçao de alguns ou de todos os outros aplicativos
rodando neste computador. Para obter mais informaçoes, consulte Fase 2: criando uma
conta de serviço e configurando permissoes.

Procedimento
1. Execute o Internet Information Services (IIS) Manager.
2. Em Conexões, clique em Conjuntos de aplicativo para exibir a lista dos conjuntos de
aplicativo. A lista inclui tres pools de aplicativos do PI Vision:

54 Guia de Instalação e Administração do PI Vision 2021

 Utilitário do display do PI Vision

◦ PIVisionAdminAppPool executa o site de administraçao, localizado em: https://

webServer/PIVision/Admin
◦ PIVisionServiceAppPool executa os principais sites de aplicativo do PI Vision,
localizados em https://webServer/PIVision
◦ PIVisionUtilityAppPool executa os PI Vision serviços de utilidade, localizados em
https://webServer/PIVision/Utility
3. Na lista de pools de aplicativos, clique com o botao direito em um pool de aplicativos do
PI Vision e clique em Advanced Settings para abrir a janela Advanced Settings.
4. Verificar as configuraçoes para o pool de aplicativos:
a. Em General, verifique se a configuraçao Enable 32-bit Applications e False. O PI Vision e
um aplicativo de 64 bits e nao funcionara apropriadamente em um pool de aplicativos de
32 bits.
b. Em Process Model, verifique se a configuraçao Maximum Worker Processes e 1. Outros
valores podem causar erros no PI Vision.
5. Definir a identidade para o pool de aplicativos:
a. Em Process Mode, clique no campo Identity e em Browse para abrir a janela Application
Pool Identity.
b. Clique em Custom account e clique em Set para abrir a janela Set Credentials.
c. Insira o nome de usuario e a senha para a conta de serviço personalizada do PI Vision e
clique em OK para fechar as janelas abertas.
6. Repita as etapas 3 a 5 para os outros pools de aplicativos do PI Vision.

Diretrizes para copiar displays ou alterar fontes de dados

Observe as seguintes diretrizes ao usar o PI Vision Display Utility para copiar displays ou
alterar fontes de dados:
• Ao copiar displays que contem hiperlinks de um PI Vision Server para outro, voce deve
copiar todos os displays vinculados de uma so vez. Caso contrario, os hiperlinks nao
funcionarao no servidor de destino.
• Ao exportar displays que contem hiperlinks para o formato de arquivo do PDIX e importar
esses arquivos para um PI Vision Server diferente, os hiperlinks entre os displays serao
mantidos, mesmo que os displays de origem e destino nao tenham sido importados durante
a mesma operaçao.
• Se houver displays com o mesmo nome, mas IDs diferentes, no servidor de origem e de
destino, o PI Vision Display Utility criara um display duplicado no PI Vision Server de
destino. O display duplicado tera o mesmo nome, mas uma ID diferente. A OSIsoft
recomenda fortemente que voce evite duplicaçoes renomeando os displays com o mesmo
nome no PI Vision Server de origem ou de destino antes de rodar o PI Vision Display Utility.
• Se houver displays com o mesmo nome e a mesma ID em ambos os servidores de origem e
de destino, o PI Vision Display Utility substituira esses displays no PI Vision Server de
destino. Se voce deseja criar um display duplicado em vez de substituir o display de destino,
renomeie o display no PI Vision Server de origem ou de destino antes de executar o PI Vision
Display Utility.

Guia de Instalação e Administração do PI Vision 2021 55

Utilitário do display do PI Vision

Nota:
Os displays so terao o mesmo nome e ID em ambos os bancos de dados de origem e
destino se o banco de dados de destino for um backup SQL restaurado do banco de
dados de origem. Atualmente, o PI Vision Display Utility nao da suporte a opçao de
criar um display no banco de dados de destino com o mesmo nome e ID em relaçao ao
banco de dados de origem.
• Todas as alteraçoes no nome ou na hierarquia do PI AF desfazem a conexao de dados dos
displays existentes. Somente alteraçoes no servidor do PI AF ou nos nomes do banco de
dados do PI AF, com suporte do PI Vision Display Utility, sao possíveis sem a necessidade de
atribuir novamente dados de itens do PI AF.
• Ao migrar um servidor do PI Data Archive, todas as alteraçoes no nome de tags no servidor
do PI Data Archive devem ser feitas depois que os displays que usam esse servidor tiverem
sido copiados por meio do PI Vision Display Utility.

Copiar displays e alterar fontes de dados

Use o PI Vision Display Utility para copiar displays de um servidor do PI Vision ou do Windows
para outro e para alterar as fontes de dados dos displays.

Antes de Iniciar
Revise as diretrizes em Diretrizes para copiar displays ou alterar fontes de dados. Essas
diretrizes discutem quais displays voce deve copiar, informaçoes importantes sobre displays
duplicados e alteraçoes em PI AF e PI Data Archive.

Procedimento
1. Execute o PI Vision Display Utility:
a. Va para o diretorio Program Files\PIPC\PIVisionUtilities.
b. Clique duas vezes no arquivo executavel do PIVisionDisplayUtility.exe.
2. Na pagina inicial, clique em Copy and Map Displays.
Por padrao, o PI Vision Display Utility copia os displays para um novo local e,
opcionalmente, edita PI Data Archives e bancos de dados do AF.
3. Na guia Pi Vision Server, selecione uma das seguintes opçoes:
◦ Displays Importar, Exportar ou Copiar - Padrao. Selecione esta opçao para importar ou
exportar displays usando arquivos do PDIX ou para copiar displays de um servidor do
PI Vision para outro. Voce precisara especificar a origem e o destino na proxima etapa.
◦ Editar PI Data Archives e bancos de dados do AF em displays existentes - Selecione esta
opçao para alterar as fontes de dados dos displays sem copiar os displays. Voce precisara
inserir a conexao de origem e o banco de dados na proxima etapa.
4. Na guia PI Vision Server, especifique os locais de origem e destino e, em seguida, clique em
Avançar:

56 Guia de Instalação e Administração do PI Vision 2021

 Utilitário do display do PI Vision

Para especificar um... Faça isso...

Servidor do PI Vision como a origem a. No campo Connect to the PI Vision Serve,
insira a URL do servidor PI Vision de onde
copiar e clique em Connect.
Nota:
O formato da URL do PI Vision Server e:
https://webServer/PIVision
em que webServer e o nome do servidor da
Web do PI Vision.
b. No campo Pasta, clique em Procurar para
encontrar e definir a pasta de origem do
PI Vision.
Pasta do Windows como fonte No campo Pasta do Windows, clique em Procurar
para navegar ate o local.
Servidor do PI Vision como destino a. No campo Destination PI Vision Server, insira
a URL do servidor do PI Vision para gravar os
displays copiados ou modificados e clique em
Connect.
b. No campo Pasta, clique em Procurar para
encontrar e definir a pasta de destino do
PI Vision.
Éspecifique uma pasta do Windows como destino No campo Pasta do Windows, clique em Procurar
para navegar ate o local.

5. Na guia Displays, selecione os displays para copiar ou modificar.

a. Insira o nome do display ou o proprietario do display no campo de filtro ou role a pagina
para baixo ate encontrar os displays.
b. Assim que voce encontrar os displays desejados, marque a caixa de seleçao ao lado de
cada um e clique na seta a direita. Para mover uma pasta e seu conteudo, marque a caixa
de seleçao ao lado da pasta e clique na seta para a direita.
c. Sob Opções de display, marque a caixa de seleçao Persistir estrutura de pasta no local de
destino para usar a mesma estrutura de pasta no novo local.
d. Selecione como resolver nomes de display duplicados se um display no destino tiver o
mesmo nome de um display selecionado para copia:
▪ Ignorar - Nao copie o display.
▪ Substituir - Substitua o display existente pelo que esta sendo copiado.
▪ Renomear - Crie uma nova copia do display com um numero anexado ao nome, por
exemplo, (1).
e. Se o destino for um servidor do PI Vision, no campo Proprietário do display de destino,
selecione quem sera o proprietario dos displays depois de copia-los. Se voce deixar este
campo em branco, o usuario atual do Windows se tornara o proprietario do display.
f. Se o destino for um servidor do PI Vision, clique em Escolher para definir quais grupos de
identidade do AF terao acesso de leitura e gravaçao aos displays apos serem copiados.
Nota:
Por padrao, a identidade World tem acesso de leitura.
g. Clique em Próximo.
6. Se o destino for um servidor do PI Vision, na guia Servidor AF (AF Server), guia, especifique
uma nova fonte de dados do PI AF para os displays selecionados.

Guia de Instalação e Administração do PI Vision 2021 57

Utilitário do display do PI Vision

Para usar a mesma fonte de dados do PI AF, deixe os campos vazios e clique em Próximo
para avançar para a guia PI Data Archive.

a. No campo Origem, insira o nome do servidor de origem do PI AF e digite um nome do

banco de dados do PI AF abaixo ou selecione um banco de dados da lista. Enquanto o
utilitario se conecta ao servidor do PI AF e fornece uma lista de bancos de dados, e
possível remapear servidores que nao existem ou com os quais nao se pode conectar.
b. No campo Destination , insira o nome do servidor do PI AF de destino e digite um nome
para o banco de dados do PI AF abaixo ou selecione um banco de dados da lista.
c. Clique em Próximo.
7. Se o destino for um servidor do PI Vision, na guia PI Data Archive, guia, especifique uma
nova fonte de dados do PI Data Archive para os displays selecionados.
Para usar a mesma fonte de dados do PI Data Archive, deixe os campos vazios e clique em
Próximo para avançar para a guia Concluir.

a. No campo Source, insira o nome do PI Data Archive de origem.

b. No campo Destino, insira o nome do PI Data Archive de destino.
c. Clique em Próximo.
8. Na guia Finish, revise a lista dos displays que serao copiados e a lista de fontes de dados que
serao mapeadas e clique em Go para começar a copiar os displays e mapear as fontes de
dados. Se o destino for uma pasta do Windows, os displays selecionados serao exportados
para a pasta especificada do Windows como arquivos individuais com um nome de arquivo
do mesmo nome do display PI Visioncom uma extensao PDIX.
9. Para visualizar o arquivo de registro em log, clique no botao Mostrar Log. Para exibir um
relatorio HTML dos displays copiados, clique em Mostrar relatório.

Excluir displays, atribuir novos proprietários ou alterar

definições de função
Use o PI Vision Display Utility para gerenciar rapidamente seus displays em massa excluindo-
os, atribuindo-os a um novo proprietario ou compartilhando-os com outro grupo de usuarios
representado por uma identidade do PI AF.
Nota:
Para obter mais informaçoes sobre compartilhamento de displays baseados em
identidades do PI AF, consulte o topico Configuraçoes e permissoes do display (https://
docs.osisoft.com/bundle/pi-vision/page/display-settings-permissions.html) no guia do
usuario do PI Vision.

Procedimento
1. Execute o PI Vision Display Utility:
a. Navegue para Program Files\PIPC\PIVisionDisplayUtility.
b. Clique duas vezes em PIVisionDisplayUtility.exe.
2. Na pagina inicial, clique em Manage Displays.
3. No campo Connect to the PI Vision Server, insira a URL que se conecta ao servidor do
PI Vision que contem os displays e clique em Connect.
4. Encontre e selecione os displays inserindo o nome ou o proprietario ou encontrando-os na
lista.
5. Para excluir os displays selecionados, clique no botao Delete.

58 Guia de Instalação e Administração do PI Vision 2021

 Utilitário do display do PI Vision

6. Se desejar, reatribua os displays selecionados a um proprietario diferente:

a. Clique em Change Owner.
b. Quando for solicitado, selecione um proprietario de display existente na lista e clique em
Apply.
Nota:
Os proprietarios exibidos na lista sao aqueles que possuem pelo menos um display.
7. Para alterar as identidades que podem ver os displays selecionados, clique em Add or
Remove Identities.
a. Procure as identidades para as quais deseja modificar as permissoes.
b. Na lista de identidades, modifique permissoes para este display selecionando ou
desmarcando Read ou Write.
Nota:
Clicar em Write concede automaticamente acesso de Leitura ao display dessa
identidade.
c. Para remover o acesso de Leitura ou Gravação para identidades que ja tem acesso, clique
no X vermelho para cada tipo de acesso.

Nota:
Remover o acesso de Leitura ao display para essa identidade tambem remove
automaticamente o acesso de Gravação.
d. Clique em Apply para salvar suas alteraçoes.
e. Clique em Back para retornar a tela anterior.
8. Para exibir o PI Vision Display Utility Log, clique em Mostrar log.

Guia de Instalação e Administração do PI Vision 2021 59

Utilitário do display do PI Vision

60 Guia de Instalação e Administração do PI Vision 2021

Tarefas de administração do PI Vision
Esta seçao explica como executar tarefas típicas de administraçao do PI Vision.

Nesta seção
• Site de administraçao do PI Vision
• Grupos de acesso do PI Vision
• Gerenciar usuarios e recursos
• Atualizar a instancia do SQL Server e o banco de dados do PI Vision
• Éstrategia de backup para o banco de dados do PI Vision
• Alterar a conta do banco de dados do PI Vision
• Alterar o parametro UpdateRate do display do PI Vision
• Altere o comportamento de calculo padrao
• Alterar a configuraçao padrao do curinga de pesquisa
• Solucionar problemas de displays que nao sao migrados devido ao tamanho do arquivo de
imagem
• Displays de patches com PIVisionPatchDisplayAFids
• Configuraçoes de fuso horario e regiao
• Desinstalar o PI Vision

Site de administração do PI Vision

O site de administraçao do PI Vision fornece uma interface para as tarefas de administraçao do
PI Vision. A pagina Visão geral mostra um snapshot da sua instalaçao atual do PI Vision. Para
acessar o site, navegue para:
https://webServer/PIVision/Admin
em que webServer e o nome do seu servidor Web do PI Vision.

Guia de Instalação e Administração do PI Vision 2021 61

Tarefas de administração do PI Vision

Nota:
Se voce nao conseguir acessar o site de administraçao do PI Vision, consulte Nao e
possível acessar a pagina de administraçao do PI Vision (https://
customers.osisoft.com/s/knowledgearticle?knowledgeArticleUrl=Unable-to-access-PI-
Vision-admin-page-An-error-occurred-while-processing-your-request) no Portal de
Atendimento ao Cliente.
Para conceder aos usuarios acesso ao site de administraçao do PI Vision, adicione suas contas
de usuario ao grupo PI Vision Admins. Esse e um grupo de usuarios locais do Microsoft
Windows no servidor de aplicativo do PI Vision. Por padrao, somente o usuario que executa a
instalaçao e adicionado a este grupo.
Alem de ter acesso ao site de administraçao do PI Vision os usuarios no grupo PI Vision
Admins podem executar tarefas restritas no aplicativo principal do PI Vision, como reatribuir
displays individuais a outro usuario.
Nota:
Se voce estiver rodando um navegador localmente no servidor de aplicativo do PI Vision,
ele deve ser rodado por um administrador para que qualquer alteraçao tenha efeito. Para
configurar o seu navegador para rodas como administrador, clique com o botao direito no
ícone de atalho do navegador e clique em Executar como administrador.

Nesta seção
• Verificar o status do PI Vision
• Tipos de relatorio

62 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

Verificar o status do PI Vision

Use o site de administraçao do PI Vision para verificar o status da sua instalaçao do PI Vision e
atualizar configuraçoes. A pagina Visão geral exibe um snapshot atual das informaçoes a seguir:
• Banco de dados do PI Vision : mostra a instancia do SQL Server e o banco de dados do
PI Vision.
A coluna Status exibira uma marca de seleçao verde se o servidor de aplicativo do PI Vision
puder conectar-se ao banco de dados do PI Vision que esta rodando no SQL Server. Um
triangulo amarelo de aviso indica que o nome do certificado SSL nao e correspondente.
Verifique se o nome do servidor corresponde a um nome no campo Assunto ou Nome
alternativo do assunto do certificado.
• Servidores de dados permitidos: servidores do PI Data Archive usados pelo PI Vision para
pesquisar e recuperar dados. Alem disso, o usuario atual do site de administraçao do
PI Vision e a identidade do pool de aplicativos sao mostrados para cada servidor permitido
do PI Data Archive.
A coluna Status mostra uma marca de seleçao verde se a conta de pool de aplicativos puder
se conectar ao servidor PI Data Archive.
• Servidores de ativos/banco de dados permitidos: servidores AF e bancos de dados
correspondentes usados pelo PI Visionpara pesquisar e recuperar dados.
A coluna Status mostra uma marca de seleçao verde se a conta de conjunto de aplicativo
puder conectar-se ao banco de dados do PI AF.
• Status da versão do arquivo: indica se todas as versoes do arquivo cumprem os requisitos
mínimos.
Para fazer as atualizaçoes de configuraçao, clique em Gerenciar configuração, proxima a lista
apropriada. Alternativamente, e possível usar as guias de navegaçao a esquerda. Por exemplo,
para tornar o servidor PI Data Archive disponível para as procuras dos usuarios, e necessario
alterar seu status para Allowed. Portanto, clique em Gerenciar configuração ao lado de
Servidores PI permitidos. Na pagina Configuração aberta, voce pode adicionar ou remover o
acesso a qualquer servidor do PI Data Archive disponível no servidor de aplicativo do PI Vision.
O link Informações da versão na parte superior direita abre uma lista mostrando as versoes de
todos os componentes de software instalados para executar o PI Vision. A coluna Status da
conexão indica se um arquivo existe e atende aos requisitos da versao.

Tipos de relatório
Os administradores do PI Vision podem visualizar ou exportar relatorios sobre o uso do
PI Vision. Os relatorios estao disponíveis na guia Relatórios no site da Pi Vision Administration.
Os seguintes relatorios estao disponíveis:

• Informações detalhadas do conteúdo do display

Fornece um resumo do conteudo dos displays criados durante um intervalo de tempo
especificado. Isso pode incluir informaçoes sobre itens de dados, símbolos, visibilidade e
propriedade do display.

• Acesso ao Display
Fornece uma contagem total de visualizaçoes e usuarios exclusivos que acessaram um
display no intervalo de tempo especificado.

Guia de Instalação e Administração do PI Vision 2021 63

Tarefas de administração do PI Vision

• Usuários que acessaram o PI Vision em um intervalo de tempo específico

Fornece uma contagem de usuarios que abriram displays do PI Vision todos os meses
durante o intervalo de tempo especificado.

• Lista de todos os usuários do PI Vision

Fornece uma contagem de displays de propriedade de cada usuario do PI Vision.

• Obtenha a conta de publicadores e exploradores

Fornece uma contagem de usuarios licenciados Publisher e Explorer que acessaram o
PI Vision no intervalo de tempo especificado.

• Informações de uso de cálculo

Fornece informaçoes detalhadas sobre todos os calculos PI e AF usados nos displays do
PI Vision.
Para obter detalhes sobre como gerar cada um dos relatorios, consulte os topicos subsequentes
nesta seçao.

Gerar um relatório "Informações detalhadas do conteúdo do display"

O relatorio Informações detalhadas do conteúdo do display fornece um resumo do conteudo
dos displays criados durante um intervalo de tempo especificado. Isso pode incluir informaçoes
sobre itens de dados, símbolos, visibilidade e propriedade do display. Siga estas etapas para
gerar esse relatorio.

Procedimento
1. Navegue ate o site de administraçao do PI Vision.
2. No menu, clique em Reports.

3. Na seçao Informações detalhadas do conteúdo do display, defina o prazo para o relatorio.

4. Para exibir uma versao baseada no navegador do relatorio, clique em View.

64 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

5. Para gerar um arquivo .CSV que voce pode analisar localmente com software de planilha,
clique em Export.

Gerar um relatório "Acesso ao display"

O relatorio Acesso ao display fornece uma contagem de visualizaçoes totais e usuarios unicos
que acessaram um display no intervalo de tempo especificado. Siga estas etapas para gerar esse
relatorio.

Procedimento
1. Navegue ate o site de administraçao do PI Vision.
2. No menu, clique em Reports.

3. Na seçao Display Access, defina o intervalo de tempo para o relatorio.

4. Para exibir uma versao baseada no navegador do relatorio, clique em View.

Guia de Instalação e Administração do PI Vision 2021 65

Tarefas de administração do PI Vision

Nota:
Clique em qualquer item da coluna Display para abrir esse display no PI Vision.
5. Para gerar um arquivo .CSV que voce pode analisar localmente com software de planilha,
clique em Export.

6. Para gerar um arquivo .CSV com informaçoes adicionais sobre o acesso individual do
usuario a cada display que voce pode analisar localmente com software de planilha, clique
em Details.

Gerar um relatório "Usuários que acessaram o PI Vision dentro de um

intervalo de tempo específico"
O relatorio Usuários que acessaram o PI Vision dentro de um intervalo de tempo específico
fornece uma contagem de usuarios que abriram displays PI Vision todos os meses durante o
intervalo de tempo especificado. Siga estas etapas para gerar esse relatorio.

Procedimento
1. Navegue ate o site de administraçao do PI Vision.
2. No menu, clique em Reports.

66 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

3. De acordo com a seçao Usuários que acessaram o PI Vision dentro de um intervalo de tempo
específico, defina o intervalo de tempo para o relatorio.

4. Para exibir uma versao baseada no navegador do relatorio, clique em View.

5. Para gerar um arquivo .CSV que voce pode analisar localmente com software de planilha,
clique em Export.

6. Para gerar um arquivo .CSV com informaçoes adicionais sobre o acesso individual do
usuario que voce pode analisar localmente com software de planilha, clique em Details
(Detalhes).

Guia de Instalação e Administração do PI Vision 2021 67

Tarefas de administração do PI Vision

Gerar um relatório "Lista de todos os usuários do PI Vision"

O relatorio Lista de todos os usuários do PI Vision fornece uma contagem dos displays de
propriedade de cada usuario do PI Vision. Siga estas etapas para gerar esse relatorio.

Procedimento
1. Navegue ate o site de administraçao do PI Vision.
2. No menu, clique em Reports.

3. Na seçao Lista de todos os usuários do PI Vision, clique em View para ver uma versao
baseada no navegador do relatorio.

4. Para gerar um arquivo .CSV que voce pode analisar localmente com software de planilha,
clique em Export.

68 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

Gerar um relatório "Obter a contagem de editores e exploradores"

O relatorio Obter a contagem de editores e exploradores fornece uma contagem de editores e
exploradores que foram acessados pelos usuarios licenciados. Siga estas etapas para gerar esse
relatorio.

Procedimento
1. Navegue ate o site de administraçao do PI Vision.
2. No menu, clique em Reports.

3. De acordo com a seçao Obter a contagem de editores e exploradores, defina o prazo para o
relatorio.

4. Para exibir uma versao baseada no navegador do relatorio, clique em View.

Guia de Instalação e Administração do PI Vision 2021 69

Tarefas de administração do PI Vision

5. Para gerar um arquivo .CSV que voce pode analisar localmente com software de planilha,
clique em Export.

Gerar um relatório de "Informações de uso de cálculo"

O relatorio de Informações de uso do cálculo fornece informaçoes detalhadas sobre todos os
calculos de PI e AF usados em displays do PI Vision durante um intervalo de tempo
especificado. Use essas informaçoes para identificar e solucionar problemas de calculos que
consomem muitos recursos. Siga estas etapas para gerar esse relatorio.

Procedimento
1. Navegue ate o site de administraçao do PI Vision.
2. No menu, clique em Reports.

70 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

3. Na seçao Informações de uso do cálculo, defina o prazo para o relatorio.

4. Para gerar um arquivo .CSV que voce pode analisar localmente com software de planilha,
clique em Export.

Guia de Instalação e Administração do PI Vision 2021 71

Tarefas de administração do PI Vision

Grupos de acesso do PI Vision

O acesso ao site de administraçao do PI Vision e ao site do PI Vision sao controlados por grupos
do Microsoft Windows separados. O programa de instalaçao do PI Vision cria esses grupos de
usuarios locais no servidor de aplicativo do PI Vision:
• Administradores do PI Vision
• Usuarios do PI Vision
• Usuarios de utilitarios do PI Vision
Tenha em mente o seguinte ao atribuir indivíduos a grupos de usuarios locais:

• Voce deve adicionar todos os usuarios que administrarao o PI Vision no grupo de

Administradores do PI Vision.
• Voce deve adicionar todos os usuarios que verao os displays do PI Vision no grupo de
Usuarios do PI Vision.
• Voce deve configurar todos os usuarios que administrarao o banco de dados de displays do
PI Vision no grupo de Usuarios de utilitario do PI Vision
Por padrao, o grupo de Administradores do PI Vision contem apenas o usuario que executou a
instalaçao. Voce deve adicionar manualmente todos os usuarios que executarao tarefas
administrativas dentro do aplicativo PI Vision a este grupo. Por padrao, o grupo de Usuarios do
PI Vision inclui usuários autenticados. Isso concede acesso ao aplicativo PI Vision a todos os
usuarios de domínio e tambem usuarios de domínios confiaveis. Para limitar o acesso ao
PI Vision, remova Usuários autenticados do grupo de Usuarios do PI Vision e adicione apenas
os usuarios que devem ter acesso ao PI Vision. Voce pode adicionar grupos do Active Directory
ao grupo local de Usuarios do PI Vision para facilitar o gerenciamento de usuarios.
Para obter mais informaçoes, consulte Acesso do usuario ao aplicativo do PI Vision e Site de
administraçao do PI Vision.

Gerenciar usuários e recursos

Como administrador, voce pode executar as seguintes tarefas para gerenciar usuarios e
recursos do PI Vision. Essas opçoes para restringir e conceder acesso ao PI Vision e seus
recursos funcionam juntos. A OSIsoft recomenda que voce analise todas as opçoes antes de
implementa-las.

Nesta seção
• Acesso do usuario ao aplicativo do PI Vision
• Estabelecer pastas
• Redefinir as configuraçoes do usuario
• Alterar a política de segurança de conteudo
• Gerenciar nível de acesso de usuario com base na funçao
• Reatribuir a propriedade do display
• Alterar o PI AF Server usado para armazenar PI AF Identities
• Restringir o acesso de utilitario ao PI Vision
• Restringir o acesso do usuario a bancos de dados do PI AF
• Restringir a pesquisa definindo raízes de pesquisa do banco de dados do PI AF

72 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

• Configurar permissoes para que os usuarios possam anotar e reconhecer eventos

• Alterar os tipos de arquivo de anotaçoes do evento e os limites de tamanho
• Anular as configuraçoes de segurança referentes a links de navegaçao

Acesso do usuário ao aplicativo do PI Vision

O grupo PI Vision Users controla o acesso ao aplicativo do PI Vision. Ele e um grupo de
usuarios locais do Microsoft Windows no servidor de aplicativo do PI Vision. Para conceder um
acesso de usuario ao aplicativo do PI Vision, adicione a conta do usuario a esse grupo. Para
revogar o acesso, remova a conta de usuario deste grupo.
Por padrao, o grupo PI Vision Users inclui Authenticated Users como um membro. Com
essa configuraçao, qualquer pessoa com acesso ao servidor de aplicativo tambem pode acessar
o PI Vision. Para limitar o acesso ao PI Vision, primeiro remova Authenticated Users do
grupo e adicione usuarios autorizados.
Nota:
Se voce precisar de informaçoes adicionais sobre a adiçao e manutençao de usuarios e
grupos em um grupo de segurança local, entre em contato com seu Departamento de TI.

Configurar acesso de usuário sem grupos locais

Caso nao tenha permissao para criar o grupo PI Vision Admins devido a uma política de
segurança local, e possível alterar as regras de autorizaçao no IIS Manager para usar o domínio
desejado ou o grupo local integrado. Para fazer essa alteraçao funcionar para o site de
administraçao do PI Vision, duas definiçoes de aplicativo devem ser adicionadas ao Internet
Information Services (IIS) Manager.

Procedimento
1. Execute o Internet Information Services (IIS) Manager.
2. No painel Connections, expanda Sites > Default Web Site e clique em PIVision para
selecionar o aplicativo PI Vision.
3. No grupo ASP.NET, clique duas vezes em Application Settings.
4. Adicione a configuraçao do EnablePIVisionAuthorize:
a. Clique com o botao direito na pagina Application Settings e clique em Add para abrir a
janela Add Application Setting.
b. No campo Name, insira VisionAdmin.
c. No campo Value, insira seu domínio ou grupo de usuario.
d. Clique em OK.
5. Adicione a configuraçao do VisionUser:
a. Clique com o botao direito na pagina Application Settings e clique em Add para abrir a
janela Add Application Setting.
b. No campo Name, insira VisionUser.
c. No campo Value, insira seu domínio ou grupo de usuario.
d. Clique em OK.
6. Adicione a configuraçao UtilityUsers:

Guia de Instalação e Administração do PI Vision 2021 73

Tarefas de administração do PI Vision

a. Clique com o botao direito na pagina Application Settings e clique em Add para abrir a
janela Add Application Setting.
b. No campo Name, insira UtilityUsers.
c. No campo Value, insira seu domínio ou grupo de usuario.
d. Clique em OK.

O que Fazer Depois

Tambem e necessario alterar as regras de autorizaçao no Internet Information Services (IIS)
Manager:
1. Execute o Internet Information Services (IIS) Manager.
2. No painel Connections, expanda Sites > Default Web Site e clique em PIVision para
selecionar o aplicativo PI Vision.
3. No grupo IIS, clique duas vezes em Authorization Rules.
4. Altere as Funçoes permitidas para o domínio ou grupo de usuarios que voce deseja utilizar
para permitir acesso ao aplicativo de administraçao do PI Vision.
5. No painel Connections, clique em Admin (em PIVision) para selecionar o aplicativo PI Vision.
6. Altere as Funçoes permitidas para o domínio ou grupo de usuarios que voce deseja usar
para permitir acesso ao site de administraçao do PI Vision.
7. No painel Connections, clique em Utility (em PIVision) para selecionar o terminal do
endpoint PI Vision.
8. Altere as Funçoes permitidas para o domínio ou grupo de usuarios que voce deseja utilizar
para permitir acesso aos utilitarios do PI Vision (PI Vision Display Utility e PI ProcessBook
to PI Vision Migration Utility).

Estabelecer pastas
Por padrao, o PI Vision armazena displays na pasta inicial. Os administradores podem criar
outras pastas para organizar displays. Eles podem dar aos usuarios acesso de leitura e de
gravaçao a uma pasta.
Apos a instalaçao do PI Vision, um administrador deve criar as pastas necessarias para
organizar displays e conceder acesso apropriado a essas pastas. Por exemplo, e possível criar
pastas para armazenar, oficialmente, displays publicados e fornecer acesso de leitura a quem
precisa visualizar esses displays.

Procedimento
1. No painel esquerdo na pagina inicial, selecione a pasta pai:
◦ Clique em Home para criar uma pasta na pasta inicial.
◦ Clique em para detalhamento em outra pasta na pasta inicial.

2. Clique em Add New PI Vision Folder e digite o nome da nova pasta.

O PI Vision cria a subpasta.

3. Clique em Edit folder settings para abrir a janela Folder Settings.

A janela lista as identidades do PI AF que podem ler e gravar na pasta, bem como as
identidades atualmente nao atribuídas a nenhuma permissao.
4. Configure o acesso desejado para a pasta:

74 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

◦ Para dar acesso de leitura a uma identidade, selecione uma identidade na lista
Identidades AF não atribuídas e clique na seta para mover para a lista de identidades com
acesso. Uma marca de seleçao e exibida automaticamente na coluna Read.
◦ Para dar a uma identidade o acesso de gravaçao, marque a caixa de seleçao Write.
◦ Para remover o acesso de gravaçao de uma identidade, desmarque a caixa de seleçao
Write para essa identidade.
◦ Para remover todo o acesso a pasta de uma identidade, selecione a identidade e clique na
seta para move-la para a lista Identidades AF não atribuídas.
Para obter detalhes sobre as permissoes de leitura e gravaçao, consulte GUID-947EDD0E-
DC0B-40AC-A0C5-3E554E27E445#GUID-947EDD0E-DC0B-40AC-A0C5-3E554E27E445.
Nota:
Alterar o acesso a pasta pode afetar outras pastas:
◦ Se conceder acesso de leitura de uma identidade a uma subpasta, o PI Vision
tambem concedera esse acesso de leitura de identidade a qualquer pasta superior.
◦ Se remover o acesso de leitura de uma pasta, o PI Vision tambem removera o acesso
de leitura dessa identidade de quaisquer subpastas e displays na pasta e nas
subpastas.

Exemplos
Suponha que sua organizaçao tem analistas que criam displays para executivos nas unidades de
negocios de geraçao e distribuiçao. É possível criar duas pastas, Geraçao e Distribuiçao, que
armazenam os displays finais para os executivos, e voce pode criar outra pasta, Rascunhos, na
qual os analistas podem trabalhar nos displays antes de libera-los aos executivos. É possível
fornecer aos analistas acesso de leitura e gravaçao a todas as pastas, possibilitando que eles
criem displays na pasta Rascunhos e movam esses displays para a pasta Geraçao ou
Distribuiçao. É possível fornecer aos executivos acesso de leitura as pastas Geraçao e
Distribuiçao, possibilitando que eles visualizem os displays nessas pastas.
Pasta Acesso de leitura Acesso de gravação
Geraçao Executivos Analistas
Analistas

Distribuiçao Executivos Analistas

Analistas

Rascunhos Analistas Analistas

Como os analistas tem acesso de gravaçao a pasta Rascunhos, eles podem criar subpastas nessa
pasta para organizar os displays de rascunho.

Permissões da pasta
As pastas do PI Vision podem ter duas permissoes possíveis atribuídas a uma identidade do PI
AF. As permissoes afetam o que os usuarios podem fazer com uma pasta:

• Leitura
Consulte a pasta e as pastas pai. No entanto, os usuarios podem ver apenas os displays dos
quais sao proprietarios ou os displays compartilhados pelos proprietarios.

Guia de Instalação e Administração do PI Vision 2021 75

Tarefas de administração do PI Vision

• Gravação

◦ Salvar ou mover displays na pasta

◦ Criar subpastas
◦ Definir o acesso as subpastas
◦ Renomear as subpastas
◦ Excluir as subpastas as quais os usuarios tem acesso para gravaçao

Redefinir as configurações do usuário

Os usuarios do PI Vision podem salvar as preferencias em relaçao a determinadas maneiras de
visualizar e lidar com informaçoes, como por exemplo, a configuraçao das tabelas de
visualizaçao. Outras informaçoes sao registradas automaticamente, como a ultima pagina
visualizada.
Se necessario, o administrador pode limpar todas as configuraçoes para um usuario e
configura-las de volta com os valores padrao.

Procedimento
1. No site de administraçao do PI Vision, clique em Configurações do usuário na arvore de
navegaçao.
2. Escolha o usuario na caixa suspensa.
3. Clique em Limpar configurações.

Alterar a política de segurança de conteúdo

PI Vision usa cabeçalhos CSP (Content Security Policy, política de segurança de conteudo) para
fornecer segurança contra Scripting Cross Site (XSS) e outros ataques. Para obter mais
informaçoes sobre a CSP e as diretivas disponíveis, consulte CSP (Content Security Policy)
(https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) no MDN.
Por padrao, PI Vision usa uma política que atenua o risco de ataques XSS, mantendo a
funcionalidade em implantaçoes típicas. Esta política inclui:

• Uso da diretiva script-src para restringir a execuçao do script a arquivos que foram
baixados do site PI Vision e bloquear quaisquer scripts inline nao confiaveis.
• Uso da diretiva frame-src para restringir os elementos incorporados <frame> e <iframe>
apenas para carregar conteudo do site PI Vision.
Voce pode modificar essas políticas para adicionar fontes confiaveis adicionais ou desativar as
políticas completamente. Isso pode ser necessario se os símbolos personalizados construídos
com a estrutura de extensibilidade PI Vision exigirem scripts ou quadros para carregar a partir
de fontes remotas.
Voce pode especificar diretivas adicionais de CSP para uso por PI Vision. Use esta opçao para
especificar proteçoes adicionais de CSP ou para especificar um ponto final de relatorio para a
diretiva report-uri.

Procedimento
1. Abra o arquivo web.config na pasta de instalaçao raiz PI Vision em qualquer editor de
texto.
2. Para modificar a diretiva script-src para acrescentar fontes autorizadas adicionais para
scripts, adicione as seguintes configuraçoes a seçao <appSettings>:

76 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

<add key="ScriptSrcPolicy" value="*.company.com trustedsite.com" />

a. Para desativar completamente a diretiva script-src, use as seguintes configuraçoes em

vez disso:
<add key="ScriptSrcPolicy" value="Disable" />
Nota:
Se voce precisar especificar varias fontes, separe-as com um espaço.
3. Para modificar a diretiva frame-src para adicionar fontes autorizadas adicionais para
quadros, adicione as configuraçoes a seguir a seçao <appSettings>:
<add key="FrameSrcPolicy" value="*.company.com trustedsite.com" />

a. Para desativar completamente a diretiva frame-src, use as seguintes configuraçoes em

vez disso:
<add key="FrameSrcPolicy" value="Disable" />
Nota:
Se voce precisar especificar varias fontes, separe-as com um espaço.
4. Adicione diretivas adicionais de CSP com as seguintes configuraçoes:
<add key="CspCustomPolicy" value="frame-ancestors ‘self’; report-uri https://
company.com/csp-reports" />

Nota:
Se voce precisar especificar varias diretivas, separe-as com um ponto e vírgula.

Gerenciar nível de acesso de usuário com base na função

Os administradores controlam os níveis de acesso do usuario ao PI Vision atribuindo usuarios a
funçoes. O PI Vision tem duas funçoes:

• Publisher (Publicador)
Os usuarios tem acesso total ao aplicativo e podem salvar displays.

• Explorer (Explorador)
Os usuarios tem acesso ao aplicativo, mas nao podem salvar nem compartilhar displays. Um
explorador ainda pode exportar dados de um display.
Como administrador, voce pode conceder a funçao Publisher a todos os membros do grupo PI
Vision Users do Windows ou atribuir funçoes a identidades individuais do PI AF. Ao atribuir
uma funçao a uma identidade do PI AF, voce concede essa funçao a todos os usuarios com essa
identidade. Se um usuario tiver varias identidades do PI AF e pelo menos uma identidade tiver
a funçao Publisher atribuída, o usuario recebera a funçao Publisher.
Nota:
Os administradores tem direitos de acesso total como publicador.

Procedimento
1. No site de administraçao do PI Vision, clique em Níveis de acesso de usuário na arvore de
navegaçao.
2. Para conceder a funçao Publisher a todos no grupo local de usuarios PI Vision Users do
Microsoft Windows, clique em Provide members of local group 'PI Vision Users' with
Publisher access level (Fornecer aos membros do grupo local “PI Vision Users” o nível de
acesso Publicador).
3. Para atribuir funçoes a grupos de usuarios específicos, clique em Choose Publisher or
Explorer access levels for members of AF Identities (Escolher níveis de acesso Publicador ou
Explorador para membros do AF Identities) e atribua as identidades desejadas as funçoes:

Guia de Instalação e Administração do PI Vision 2021 77

Tarefas de administração do PI Vision

a. Selecione uma identidade do PI AF na lista de identidades disponíveis.

b. Para atribuir os membros da identidade a funçao Publisher, clique na seta para direita ao
lado da lista Publishers (Publicadores).
c. Para atribuir os membros da identidade a funçao Publisher, clique na seta para direita ao
lado da lista Explorers (Exploradores).
4. Clique em Salvar.

Reatribuir a propriedade do display

Como administrador, voce pode reatribuir a propriedade de um display unico na pagina inicial
do PI Vision ou todos os displays de um usuario usando a seçao Gerenciamento de dados do
site de administraçao clicando no ícone de configurações na miniatura de display e

selecionando outro nome de usuario no campo Display Owner. O site de administraçao do

PI Vision tambem fornece a opçao de reatribuir todos os displays de um usuario a outro.

Procedimento
1. No site de administraçao do PI Vision, clique em Gerenciamento dos displays na arvore de
navegaçao.
2. No campo De, selecione o nome de usuario para o qual deseja reatribuir a propriedade do
display.
3. No campo Para, selecione o nome de usuario do novo proprietario.
4. Marque a caixa de seleçao I understand this operation cannot be undone.
5. Clique em Reassign Displays.
Na pagina inicial do aplicativo PI Vision, clique no ícone de configurações e selecione

outro nome de usuario no campo Display Owner.

Nota:
Os nomes so aparecem na lista Display Owner se um usuario tiver aberto o PI Vision e
visualizado pelo menos um display.

Alterar o PI AF Server usado para armazenar PI AF Identities

O PI Vision permite que os usuarios compartilhem displays com grupos de usuarios específicos.
Grupos de usuarios sao configurados por um administrador do PI usando identidades do PI AF
no PI AF. Uma identidade do PI AF representa um conjunto de permissoes de acesso para um
grupo de usuarios.
Quando o PI Vision e executado pela primeira vez, o programa verifica o padrao atual do
servidor do PI AF no servidor de aplicativo do PI Vision e grava uma entrada na tabela de
configuraçoes do banco de dados do PI Vision. A entrada sera usada para verificar as
identidades do PI AF armazenadas no servidor do PI AF. Tipicamente, as identidades do PI AF
serao armazenadas no servidor do PI AF padrao. Para armazenar identidades do PI AF em um
servidor do PI AF separado, um administrador com privilegios para editar o banco de dados do
PI Vision precisara modificar DisplayGroupsServer na tabela dbo.Settings do banco de
dados.

Procedimento
1. No Microsoft SQL Server Management Studio, conecte-se ao Microsoft SQL Server que
contem o banco de dados do PI Vision.
2. Expanda Bancos de dados, selecione o banco de dados do PI Vision e expanda Tabelas.

78 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

3. Localize e clique com o botao direito na tabela dbo.Settings e clique em Editar 200 linhas
superiores.
4. Na linha para a linha DisplayGroupsServer, defina o campo Valor como o nome do PI AF
Server que sera usado como um provedor de identidade.

Restringir o acesso de utilitário ao PI Vision

Por padrao, o PI Vision esta configurado para permitir que o utilitario de display do PI Vision e
o utilitario de migraçao do PI ProcessBook para o PI Vision leia e grave displays. Voce pode
restringir esse acesso por:
• Permitindo que os utilitarios tenham apenas acesso de leitura.
• Desativar totalmente o acesso de utilitario.
Para restringir utilitarios para permitir o acesso de leitura:
1. Use um editor para abrir o arquivo web.config na pasta de instalaçao raiz do PI Vision
\<Utility>.
2. Para restringir o acesso a operaçoes de leitura somente, procure a seguinte entrada no
arquivo web.config: <add key="UtilityAccess" value=”ReadWrite" />
E atualize essa entrada para:
<add key="UtilityAccess" value=”Read" />

Guia de Instalação e Administração do PI Vision 2021 79

Tarefas de administração do PI Vision

Para desativar totalmente o acesso de utilitario:

1. Execute o Internet Information Services (IIS) Manager.
2. No painel Connections (Conexoes), selecione Application Pools (Pools de aplicativos).
3. Clique com o botao direito do mouse em PIVisionUtilityAppPool e escolha Stop
(Parar).

Restringir o acesso do usuário a bancos de dados do PI AF

Como administrador, voce pode restringir o acesso aos bancos de dados do PI AF a um ou mais
usuarios. Depois que o acesso ao banco de dados e restringido, o usuario nao sera capaz de
acessar ou pesquisar esse banco de dados no painel Assets do PI Vision. No entanto, os dados
de displays existentes ainda podem ser visualizados por esses usuarios.

Procedimento
1. No site de administraçao do PI Vision, clique em User Settings na arvore de navegaçao.
2. Clique na guia Restrict Database Access.
3. Na lista do banco de dados, selecione o banco de dados do PI AF ao qual voce deseja
restringir o acesso.
4. Na coluna User da tabela, marque a caixa de seleçao ao lado de cada usuario para o qual
deseja restringir o acesso ao banco de dados do PI AF.

5. Clique em Salvar.

Restringir a pesquisa definindo raízes de pesquisa do banco de dados do PI

AF
Como administrador, voce pode restringir os usuarios de pesquisar nos específicos de um
banco de dados do PI AF, definindo qualquer ativo em um banco de dados como a raiz de
pesquisa. Depois que o ativo estiver definido como a raiz de pesquisa, os usuarios somente
serao capazes de pesquisar esse ativo e seus filhos, e nao poderao pesquisar o resto da
hierarquia de dados acima da raiz de pesquisa. Definir a raiz de pesquisa nao evita que os
usuarios vejam dados acima da raiz de pesquisa se esses ativos fizerem parte de um display
existente.

80 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

Nota:
As versoes do banco de dados PI AF abaixo de 2.10.5 so suportam correspondencias de
nomes em pesquisas. As versoes do banco de dados PI AF 2.10.5 e acima suportam
correspondencias de nome e descriçao em pesquisas. Sites com versoes variadas do
banco de dados do PI AF sao compatíveis com correspondencias de descriçao se a versao
do servidor for 2.10.5 ou superior.

Procedimento
1. No site de administraçao do PI Vision, clique em Configurações do usuário na arvore de
navegaçao.
2. Clique na guia Set Database Search Root.
3. Na lista de banco de dados, selecione um banco de dados do PI AF. É exibida uma tabela com
a arvore do banco de dados ao lado de uma lista de usuarios.
4. Na coluna Database, expanda a hierarquia do banco de dados e encontre e selecione o ativo
que deseja definir como raiz de pesquisa.
5. Na coluna User, marque a caixa de seleçao ao lado de cada usuario para o qual deseja tornar
o ativo selecionado em uma raiz de pesquisa.

6. Clique em Salvar (Save).

Nota:
Voce pode definir a raiz de pesquisa diretamente no Microsoft SQL, criando um
arquivo delimitado por ponto-e-vírgula com o seguinte formato: AF server name;
database name; user name; element path, em que o caminho do elemento e af:\
\ServerName\DatabaseName\ElementName.
O codigo SQL para o procedimento armazenado e fornecido em [PIPC]\PI Vision\Admin
\SQL\SP_SetSearchRoot.sql. Por exemplo:
DECLARE @return_value int
EXEC @return_value = [dbo].[ImportUsersSearchRoots]
@path = [path to the semicolon delimited file]
SELECT 'Return Value' = @return_value
GO

Configurar permissões para que os usuários possam anotar e reconhecer

eventos
O administrador do PI deve configurar permissoes de segurança para que usuarios reconheçam
e anotem eventos na pagina de detalhes de eventos do PI Vision. As permissoes podem ser
configuradas no PI AF 2016 e posterior usando o PI System Explorer. As permissoes de

Guia de Instalação e Administração do PI Vision 2021 81

Tarefas de administração do PI Vision

reconhecimento e anotaçoes sao configuradas separadamente para cada template de event

frame. Para configurar permissoes de reconhecimento, voce deve tambem configurar
permissoes de anotaçao.
Nota:
Para reconhecer e anotar eventos, e preciso ter o PI AF 2016. A delegaçao restrita de
Kerberos ou a autenticaçao basica devem estar configuradas entre o servidor de
aplicativo do PI Vision e o servidor do PI AF. Consulte Habilitar a delegaçao de Kerberos.
Nota:
Para obter mais informaçoes sobre anotaçao, reconhecimento de evento e permissoes de
segurança do PI AF, consulte os topicos em PI Asset Framework e PI System Explorer
(https://docs.osisoft.com/bundle/pi-server/page/pi-asset-framework-and-pi-system-
explorer.html).

Procedimento
1. No PI System Explorer, conecte-se ao banco de dados que contem o template de event frame
para a qual voce deseja configurar as permissoes.
2. Acesse Library > Templates > Templates de event frame e encontre seu template de event
frame na lista e clique nele.
3. Se voce deseja que os usuarios possam reconhecer o evento, marque a caixa de seleçao Can
Be Acknowledged.

4. Clique em Security.
5. Na janela Security Configuration, escolha a identidade ou os usuarios individuais do PI AF
para os quais deseja conceder permissoes de reconhecimento e/ou anotaçao.

82 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

6. Para permitir que os usuarios reconheçam e/ou anotem o evento, marque a caixa de seleçao
Allow para a permissao Annotate.
Nota:
Certifique-se de que o pool de aplicativos do PI Vision tenha permissoes para Ler
dados (Read Data).
7. Clique em OK depois que todas as permissoes de segurança forem configuradas.

Alterar os tipos de arquivo de anotações do evento e os limites de tamanho

Os usuarios do PI Vision podem anexar um unico arquivo a uma anotaçao de evento. O tamanho
maximo do arquivo (aproximadamente 7 MB por padrao) e os tipos de arquivo podem ser
configurados no PI AF 2016 e posteriores. Os tipos de arquivo padrao sao:
Tipo de arquivo Extensão permitida
MS Office csv, docx, pdf, xlsx
Texto rtf, txt
Imagem gif, jpeg, jpg, png, svg, tiff
PI ProcessBook pdi

Os administradores podem usar o utilitario PI AF Diagnostics (afdiag localizado na pasta

\PIPC\AF) para alterar os tipos de arquivo padrao que podem ser anexados a anotaçoes (com
o parametro FileExtensions), bem como o tamanho maximo de arquivo (com o parametro
FileMaxLength).

Guia de Instalação e Administração do PI Vision 2021 83

Tarefas de administração do PI Vision

Procedimento
1. Como administrador, abra um command prompt elevado do Windows e altere o diretorio
para \PIPC\AF.
Nota:
Para obter mais informaçoes sobre como usar o utilitario PI AF Diagnostic, consulte o
PI System Explorer User Guide.
2. Para alterar os tipos de arquivo padrao, utilize um dos parametros FileExtensions:
◦ Para substituir uma lista existente, utilize afdiag\FileExtensions\<File types>,
onde cada extensao de tipo de arquivo estara separada por uma vírgula.
Exemplo de substituiçao de lista atual apenas com arquivos DOC e MP4: C:\Program
Files\PIPC\AF\FileExtensions:doc:mp4
◦
Para adicionar uma extensao de tipo de arquivo adicional a lista existente, utilize afdiag
\FileExtensionsAdd:<File type>
Exemplo de adiçao de uma extensao de arquivo DOC a lista permitida atual: C:\Program
Files\PIPC\AF\FileExtensionsAdd:doc
◦ Para remover uma extensao de arquivo da lista permitida existente, utilize afdiag
\FileExtensionsRemove:<File type>
Exemplo de remoçao de uma extensao de arquivo TIFF da lista permitida existente: C:
\Program Files\PIPC\AF\FileExtensionsRemove:tiff
3. Para alterar o tamanho maximo do arquivo, altere o parametro FileMaxLength inserindo
afdiag\FileMaxLength:<file size in MB>no command prompt. O valor inteiro e
especificado em megabytes. Exemplo de permissao de arquivos de ate 15 MB: C:\Program
Files\PIPC\AF\FileMaxLength:15
4. Se voce alterar o parametro FileMaxLength no PI AF, voce tambem precisara alterar os
parametros maxRequestLength e maxAllowedContentLength no PI Vision abrindo o
arquivo web.config na pasta de instalaçao raiz do PI Vision.
5. Faça com que os seguintes valores no arquivo web.config sejam 1,4 vezes o tamanho
especificado no PI AF:
maxRequestLength="max value in kilobytes"
maxAllowedContentLength="max value in bytes"

Nota:
Devido a um anexo de arquivo conter codificaçao adicional que aumenta o tamanho da
solicitaçao no navegador, deve-se aumentar os valores para maxRequestLength e
maxAllowedContentLength para aproximadamente 1,4 vezes o limite de tamanho
do arquivo, em que 1.024 bytes = 1 kilobyte (KB). Por exemplo, para permitir anexos
de arquivo de ate 15 MB, configure os seguintes valores para:
◦ maxRequestLength = 15360 (KB)
◦ maxAllowedContentLength = 15728640 (bytes)
6. Reinicie o IIS para que as alteraçoes entrem em vigor.

Anular as configurações de segurança referentes a links de navegação

Por padrao, em relaçao a links de navegaçao contextual, voce so pode inserir os protocolos
http: e https: para sites ou ./#, ./PB/# e # para displays. Voce pode anular essas
configuraçoes de segurança:

84 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

• Permitindo que usuarios usem outros protocolos, como ftp e mailto.

• Permitindo que usuarios ignorem todas as configuraçoes de segurança padrao referentes a
link de navegaçao.

Procedimento
1. Use um editor para abrir o arquivo web.config na pasta de instalaçao raiz do PI Vision.
2. Para permitir o uso de outros protocolos, adicione a seguinte entrada ao arquivo
web.config:
<add key=" NavigationLinkWhitelist" value="^\s*((https?:)|(protocol)|(./#)|
(./PB/#)|#)"/>

Por exemplo, para permitir o uso do protocolo ftp:, o valor deve ser:
value="^\s*((https?:)|(ftp:)|(./#)|(./PB/#)|#)"/>
3. Para ignorar todas as configuraçoes de segurança referentes a navegaçao, adicione a
seguinte entrada:
<add key="NavigationLinkSecurityOverride" value="true"/>

Atualizar a instância do SQL Server e o banco de dados do PI

Vision
Nota:
Se acessar o site de administraçao do PI Vision em um navegador que esta rodando
localmente no servidor de aplicativo do PI Vision, voce devera executar o navegador como
administrador. Para fazer isso, clique com o botao direito do mouse no ícone de atalho do
navegador e selecione Executar como administrador.

Antes de Iniciar
O usuario do Windows atualmente conectado deve ter acesso de administrador para o
Microsoft SQL Server para poder concluir este procedimento.
O metodo mostrado aqui e aplicavel somente nas situaçoes a seguir:
• O banco de dados do PI Vision esta localizado no servidor de aplicativo do PI Vision.
• O usuario do Windows atualmente conectado esta rodando a pagina de administraçao do
PI Vision em seu navegador enquanto esta conectado ao servidor Web.
Se a sua configuraçao nao for condizente a estas condiçoes, siga as instruçoes em Executar o
script go.bat para configurar o banco de dados do PI Vision.

Procedimento
1. Na pagina Visao geral, clique em Gerenciar configuração ao lado da tabela Banco de dados do
PI VIsion ou clique em Configuração na arvore de navegaçao a esquerda e escolha a guia
Banco de dados do PI Vision.
2. Para alterar a instancia do Microsoft SQL Server que hospeda o banco de dados do PI Vision,
clique no botao suspenso proximo ao campo SQL Server e selecione o servidor desejado ou
digite seu nome diretamente na caixa, por exemplo, .\sqlexpress.
3. Digite o nome do banco de dados do PI Vision que deseja usar no campo Banco de dados ou
clique no botao suspenso para selecionar um banco de dados existente.
Depois que voce seleciona um banco de dados, o PI Vision verifica se ele pode ser usado da
maneira em que se encontra ou se e necessaria uma atualizaçao.

Guia de Instalação e Administração do PI Vision 2021 85

Tarefas de administração do PI Vision

Se digitar um novo nome de banco de dados e o usuario que esta executando o site de
administraçao possuir permissoes suficientes para criar um banco de dados no Microsoft
SQL Server, um novo banco de dados com este nome sera criado.
Para criar um novo banco de dados do PI Vision, voce deve ter:
◦ A funçao de servidor db_creator.
◦ A permissao ALTER ANY LOGIN, que significa que foi concedida a permissao ao usar a
instruçao GRANT ALTER ANY LOGIN TO "domain\account" ou voce e um membro da
funçao de servidor securityadmin.
O PI Vision conecta-se ao banco de dados especificado.
4. Clique em Salvar (Save).

Estratégia de backup para o banco de dados do PI Vision

Para desenvolver sua estrategia, consulte o topico de documentos da Microsoft Fazer backup e
restaurar bancos de dados do SQL Server (https://docs.microsoft.com/en-us/sql/relational-
databases/backup-restore/back-up-and-restore-of-sql-server-databases).
A sua estrategia deve ser adequada ao seu ambiente, mas o ideal e fazer o backup do seu banco
de dados do PI Vision do SQL Server todos os dias. As melhores praticas de manutençao padrao
incluem:
• Backups de registros
• Backups de dados diarios
• Reindexaçao periodica e atualizaçao de estatísticas em todos os banco de dados e sempre
apos a importaçao de exibiçoes, exclusao de pastas importadas ou exclusao de muitas
exibiçoes
Use o Microsoft SQL Server Management Studio ou o utilitario de comando sqlcmd.
O OSIsoft recomenda a alteraçao do seu banco de dados a partir do modelo de recuperaçao
simples para o modelo de recuperaçao completo para permitir a recuperaçao momentanea. O
kit de instalaçao configura o banco de dados com um modelo de recuperaçao simples, por
padrao. Com este modelo de recuperaçao simples, os registros de transaçao nao poderao fazer
backup e nao sera possível fazer a recuperaçao do ponto de falha. Se configurar o banco de
dados para o modelo de recuperaçao completo, os registros de transaçao tambem farao backup.
Os registros de transaçao sao truncados para que eles nao cresçam sem limites e sem que a
recuperaçao momentanea ou de ponto de falha seja permitida.
Considere estes outros pontos enquanto projeta a sua estrategia de backup:
• Coloque o arquivo de backup em um disco físico diferente de onde os dados do SQL Server
estao localizados. Pode nao ser possível gravar na pasta raiz da unidade C:\. Use outra
unidade, como uma unidade de rede ou uma subpasta.
• A frequencia de backup depende do seu aplicativo; geralmente, os backups noturnos sao
melhores. É possível configurar o tempo e a frequencia dos backups e se os backups
completos ou diferenciais foram concluídos. É recomendado o backup completo
diariamente.
• É possível colocar conteudo semelhante ao exemplo abaixo em um arquivo chamado
BackupPIVision.sql e agendar como uma tarefa, conforme mostrado no comando abaixo.
Observe que voce precisara alterar o DestFile para o diretorio criado para armazenar
backups e alterar o nome do banco de dados de PIVisionDB para o nome do seu banco de
dados do PI Vision.
Conteudo do arquivo BackupPIVision.sql:

86 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

declare @DestFile varchar(128) = N'E:\Backups\PIVisionBackupDB.bak';

backup database PIVisionDB
to disk = @DestFile;
go

Comando para tarefa agendada:

sqlcmd -S .\SQLEXPRESS -i "E:\Backups\BackupPIVision.sql"

É necessaria a funçao sysadmin, db_owner ou db_backupoperator (o ultimo privilegio e a

melhor pratica de segurança).

Alterar a conta do banco de dados do PI Vision

Se voce alterar o ID do pool de aplicativos do PI Vision apos a criaçao do banco de dados do
PI Vision, sera necessario criar um logon do SQL Server para a conta e alterar a conta usada
para acessar o banco de dados do PI Vision.
Para criar um logon do SQL Server para a conta, utilize o SQL Server Management Studio ou
execute o comando SQL a seguir:
CREATE LOGIN "<domain>\<Application Pool ID>" FROM WINDOWS

Para alterar a conta utilizada para acessar o banco de dados do PI Vision, execute os comandos
SQL a seguir:
ALTER USER "DVService" with
LOGIN="<domain>\<Application Pool ID>"
ALTER USER "<domain>\<Application Pool ID>" with
NAME="DVService"

Alterar o parâmetro UpdateRate do display do PI Vision

O parametro UpdateRate tem as seguintes limitaçoes:

• Voce so pode especificar valores inteiros para esse parametro, e o valor e sempre em
segundos.

◦ Se voce fornecer um valor nao inteiro para o parametro UpdateRate, UpdateRate usara o
valor padrao de cinco segundos.
Para explorar se a alteraçao desse parametro e aplicavel para o seu aplicativo, entre em contato
com o Suporte Tecnico da OSIsoft.
Nota:
Para símbolos de tabela de eventos, a taxa de atualizaçao esta definida na configuraçao do
símbolo e nao adere ao parametro de configuraçao UpdateRate.

Procedimento
1. Navegue ate a tabela dbo.settings no banco de dados PI Vision no SQL Server.
2. Clique com o botao direito do mouse na tabela e selecione Edit top 200 rows.
3. Alterar o UpdateRate
◦ Se existir a coluna UpdateRate na tabela, altere o valor de 5 para um novo valor inteiro.
◦ Se a coluna UpdateRate nao existir na tabela, execute a consulta a seguir e substitua X
por um valor inteiro:
INSERT INTO dbo.Settings (Name, Value, TenantID)
VALUES ('UpdateRate', X, 0)

Guia de Instalação e Administração do PI Vision 2021 87

Tarefas de administração do PI Vision

Altere o comportamento de cálculo padrão

Por padrao, o PI Vision permite calculos em tags do PI e atributos do AF. Dependendo do
numero e da complexidade dos calculos definidos, a execuçao dos calculos pode afetar o
desempenho do servidor. Use a configuraçao do CalculationBehavior para controlar como
os calculos sao gerenciados e executados. As configuraçoes possíveis sao:
• Ativar
Esta configuraçao permite que os usuarios criem e editem calculos PI e AF e permite que
PI Vision avalie os calculos. Este e o comportamento padrao se a configuraçao do
CalculationBehavior nao for especificada.

• ExecuteOnly
Esta configuraçao permite que PI Vision avalie os calculos, mas os usuarios nao podem criar
ou editar calculos. Os usuarios podem visualizar os calculos existentes e excluí-los se nao
forem referenciados no display.

• Desativar
Esta configuraçao impede que PI Vision avalie calculos e os usuarios nao podem criar ou
editar calculos. Os símbolos que fazem referencia aos calculos PI ou AF mostram um valor
de No Data. Varios estados baseados em calculos mostram o estado de Bad Data. Os
usuarios podem visualizar os calculos existentes e excluí-los se nao forem referenciados no
display. Essa configuraçao tambem desabilita os conjuntos de dados da PI Expression
presentes nos displays de PI ProcessBook.

Procedimento
• Navegue ate o banco de dados PI Vision no SQL Server.
◦ Para criar uma entrada de tabela de configuraçao de comportamento de calculo:
INSERT INTO [dbo].[Settings] ([Name], [Value], [TenantID])
VALUES ('CalculationBehavior', 'ExecuteOnly', 0)
◦ Para modificar a configuraçao apos a aplicaçao de uma configuraçao anterior, use uma
instruçao UPDATE. Por exemplo, para desativar todos os calculos PI e AF no servidor:
UPDATE [dbo].[Settings]
SET [Value] = 'Disable'
WHERE [Name] = 'CalculationBehavior'

Alterar a configuração padrão do curinga de pesquisa

Por padrao, a pesquisa PI Vision anexa um curinga (*) ao final do termo de pesquisa. Use a
configuraçao SearchPatternUsesWildcards para desliga-lo e para dar aos usuarios a
capacidade de fazer correspondencia exata de termos de pesquisa.
Para explorar se a alteraçao desse parametro e aplicavel para o seu aplicativo, entre em contato
com o Suporte Tecnico da OSIsoft.

Procedimento
• Navegue ate o banco de dados PI Vision no SQL Server.
◦ Para criar uma entrada de tabela de configuraçao de curinga:
INSERT INTO [dbo].[UserSettings] (Name, Value,
Owner, TenantID) VALUES
('SearchPatternUsesWildcards', 'true', '', 0)
◦ Para desativar a configuraçao de curinga:

88 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

UPDATE [dbo].[UserSettings] SET [Value] = 'false'

WHERE [Name] = 'SearchPatternUsesWildcards'
◦ Para ativar a configuraçao de curinga:
UPDATE [dbo].[UserSettings] SET [Value] = 'true'
WHERE [Name] = 'SearchPatternUsesWildcards'

Solucionar problemas de displays que não são migrados

devido ao tamanho do arquivo de imagem
O tamanho maximo padrao do arquivo de imagem em displays do PI Vision e de 2145728 bytes
(2 MB). Quando voce migrar arquivos PDI com o Utilitario de migraçao de display do PI
ProcessBook, se o display resultante do PI Vision contiver alguma imagem maior do que isso, o
utilitario de display do PI Vision nao podera criar o display e retornara o seguinte erro:
"Display validation failed for user <domain\user running the utility> on display
with id:
0, name: <display name>. Reason: Display symbols or attachments too exceeded
maximum size."

Siga os passos abaixo para adicionar o parametro ImageFileSize ao dbo.Settings no banco de

dados SQL do PI Vision.

Procedimento
1. Em Databases, navegue ate PI Vision > Tables > dbo.Settings .
2. Clique com o botao direito do mouse na tabela e selecione Edit top 200 rows.
3. Em TenantID, escreva 0.
4. Em Name, escreva ImageFileSize.
5. Em Value, digite o tamanho maximo do arquivo de imagem desejado em bytes e pressione
enter. Por exemplo, 10485760 bytes (10 MB).
6. Recicle os pools do PI Vision App.
Nota:
Existem alguns outros parametros na tabela dbo.Settings que podem resultar no
mesmo erro. A tabela abaixo fornece informaçoes sobre cada um.
Parâmetro Description Limite de tamanho
padrão
ImageFileSize Limita o tamanho das imagens usadas 2145728 bytes (2 MB)
em displays do PI Vision
MaxAllowedContentLeng Limita o tamanho das solicitaçoes POST 10485760 bytes
th que sao usadas para salvar alteraçoes (10 MB)
e/ou salvar novamente o display quando
ele nao esta no cache
MaxSymbolConfigSize Limita o tamanho dos símbolos usados 2145728 bytes (2MB)
em displays do PI Vision
TextSize Limita o comprimento da string usada no 520 caracteres
símbolo Texto

Displays de patches com PIVisionPatchDisplayAFids

PIVisionPatchDisplayAFids patches existentes do PI Vision sao exibidos de modo que
elementos e atributos renomeados ou movidos em um PI AF Server sao atualizados

Guia de Instalação e Administração do PI Vision 2021 89

Tarefas de administração do PI Vision

automaticamente se o display estiver recem-aberto ou em execuçao ativa. O utilitario requer

um parametro para especificar o servidor do PI Vision. Um segundo parametro opcional
especifica o caminho para um arquivo CSV. Se voce nao especificar o caminho, a saída sera
registrada em PIVisionPatchDisplayAFidsOutput.csv no diretorio atual.

Procedimento
1. Execute PIVisionPatchDisplayAFids.exe do diretorio %PIHOME64%
\PIVisionUtilities com os parametros de localizaçao do servidor e do arquivo de
registro especificados no seguinte formato, em que <server> refere-se ao PI Vision dos
quais os displays sao solicitados e <logFile> refere-se a localizaçao do arquivo CSV em que
o PIVisionPatchDisplayAFids registra seus processos:
PIVisionPatchDisplayAFids <server> [<logFile>]

Nota:
Se voce abrir PIVisionPatchDisplayAFids.exe sem especificar um parametro, o
utilitario exibira texto de ajuda para ajuda-lo a formatar o comando.
A seguir estao exemplos de comandos que voce pode usar:
◦ PIVisionPatchDisplayAFids "https://server.int/PIVision"
◦ PIVisionPatchDisplayAFids "https://server.int/PIVision" "C:\custom path
\output.csv"
◦ PIVisionPatchDisplayAFids "https://server.int/PIVision" .\output.csv
◦ PIVisionPatchDisplayAFids /?
PIVisionPatchDisplayAFids solicita todos os displays no servidor fornecido, os le e
atualiza conforme necessario e relata quaisquer erros.
2. Se PIVisionPatchDisplayAFids relatar algum erro, abra o arquivo de registro
PIVisionPatchDisplayAFidsOutput.csv para obter mais informaçoes.
Nota:
Se voce nao especificou um local para o arquivo de registro
PIVisionPatchDisplayAFidsOutput.csv, o padrao sera o diretorio onde
PIVisionPatchDisplayAFids.exe esta localizado.

Configurações de fuso horário e região

É possível definir a configuraçao de fuso horario e a regiao para todos os usuarios do PI Vision.

90 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

Nesta seção
• Alterar as configuraçoes de fuso horario
• Alterar as configuraçoes regionais

Alterar as configurações de fuso horário

Por padrao, o PI Vision usa o fuso horario da maquina do cliente para exibir as informaçoes.
Para anular o fuso horario do cliente e fazer com que todos os usuarios que acessam sites do
PI Vision usem o mesmo fuso horario, siga este procedimento.
Nota:
Para usar um parametro de URL a fim de configurar o fuso horario para um display de
maneira que usuarios possam visualizar os dados no fuso horario especificado, consulte
Configurar fuso horario para o display.

Procedimento
1. No Microsoft SQL Server Management Studio, conecte-se ao Microsoft SQL Server que
contem o banco de dados do PI Vision.
2. Expanda Banco de dados, selecione o banco de dados do PI Vision e expanda Tabelas.

3. Localize e clique com o botao direito na tabela dbo.Settings e clique em Editar 200 linhas
superiores.
4. No campo Valor, configure OverrideTimeZone para um dos IDs de fuso horario listados em
IDs de fuso horario do sistema. Por exemplo, para fazer com que o fuso horario do PI Vision
seja o horario padrao do Pacífico para todos os usuarios, adicione Pacific Standard
Time a tabela dbo.Settings.

Guia de Instalação e Administração do PI Vision 2021 91

Tarefas de administração do PI Vision

IDs de fuso horário do sistema

ID de fuso horário do sistema Nome do display
Hora Padrao do Cabeçalho (GMT-12:00) Linha de Data Internacional Oeste
UTC-11 (GMT-11:00) Hora Universal Coordenada-11
Hora Padrao de Samoa (GMT-11:00) Samoa
Hora Padrao do Havaí (GMT-10:00) Havaí
Hora Padrao do Alaska (GMT-09:00) Alasca
Hora Padrao do Pacífico (Mexico) (GMT-08:00) Baja California
Hora Padrao do Pacífico (GMT-08:00) Hora do Pacífico (EUA e Canada)
Hora Padrao das Montanhas dos EUA (GMT-07:00) Arizona
Hora Padrao das Montanhas (Mexico) (GMT-07:00) Chihuahua, La Paz, Mazatlan
Hora Padrao das Montanhas (GMT-07:00) Hora das Montanhas (EUA e Canada)
Hora Padrao da America Central (GMT-06:00) America Central
Hora Padrao Central (GMT-06:00) Hora Central (EUA e Canada)
Hora Padrao Central (Mexico) (GMT-06:00) Guadalajara, Cidade do Mexico,
Monterrey
Hora Padrao Central do Canada (GMT-06:00) Saskatchewan
Hora Padrao do Pacífico da America do Sul (GMT-05:00) Bogota, Lima, Quito
Hora Padrao do Leste dos EUA (GMT-05:00) Hora do Leste (EUA e Canada)
Hora Padrao do Leste dos EUA (GMT-05:00) Indiana (Leste)
Hora Padrao da Venezuela (GMT-04:30) Caracas
Hora Padrao do Paraguai (GMT-04:00) Assunçao
Hora Padrao do Atlantico (GMT-04:00) Hora do Atlantico (Canada)
Hora Padrao do Brasil Central (GMT-04:00) Cuiaba
Hora Padrao do Oeste da America do Sul (GMT-04:00) Georgetown, La Paz, Manaus, San
Juan
Hora Padrao da America do Sul do Pacífico (GMT-04:00) Santiago
Hora Padrao da Terra Nova (GMT-03:30) Terra nova
Hora padrao do Leste da America do Sul (GMT-03:00) Brasília
Hora Padrao da Argentina (GMT-03:00) Buenos Aires
Hora Padrao do Leste da America do Sul (GMT-03:00) Caiena, Fortaleza

92 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

ID de fuso horário do sistema Nome do display

Hora Padrao da Groelandia (GMT-03:00) Groenlandia
Hora Padrao de Montevideu (GMT-03:00) Montevideu
UTC-02 (GMT-02:00) Hora Universal Coordenada-02
Mid-Atlantic Standard Time (GMT-02:00) Atlantico Central
Hora Padrao de Açores (GMT-01:00) Açores
Hora Padrao de Cabo Verde (GMT-01:00) Cabo Verde
Hora Padrao de Marrocos (GMT) Casablanca
UTC (GMT) Horario Coordenado Universal
Hora Padrao GMT (GMT) Hora de Greenwich: Dublin, Edinburgh,
Lisboa, Londres
Hora Padrao de Greenwich (GMT) Monrovia, Reykjavik
Hora padrao do Europa Ocidental (GMT+01:00) Amsterdam, Berlin, Bern, Rome,
Stockholm, Vienna
Hora Padrao da Europa Central (GMT+01:00) Belgrade, Bratislava, Budapest,
Ljubljana, Prague
Hora Padrao de Romance (GMT+01:00) Brussels, Copenhagen, Madrid, Paris
Hora Padrao da Europa Central (GMT+01:00) Sarajevo, Skoplie, Varsovia, Zagreb
Hora padrao do Oeste da Africa Central (GMT+01:00) Centro-oeste da Africa
Hora Padrao da Jordania (GMT+02:00) Ama
Hora Padrao GTB (GMT+02:00) Atenas, Bucarestehens, Istambul
Hora Padrao do Oriente Medio (GMT+02:00) Beirute
Hora Padrao do Egito (GMT+02:00) Cairo
Hora Padrao da Síria (GMT+02:00) Damasco
Hora Padrao da Africa do Sul (GMT+02:00) Harare, Pretoria
Hora Padrao FLE (GMT+02:00) Helsinque, Kiev, Riga, Sofia, Tallinn,
Vilnius
Hora Padrao de Israel (GMT+02:00) Jerusalem
Hora padrao do Europa Ocidental (GMT+02:00) Minsk
Hora Padrao da Namíbia (GMT+02:00) Windhoek
Hora Padrao da Arabia (GMT+03:00) Bagda
Hora Padrao Arabe (GMT+03:00) Kuwait, Riad
Hora Padrao da Russia (GMT+03:00) Moscou, Sao Petersburgo,
Volgogrado
Hora padrao do Africa Oriental (GMT+03:00) Nairobi
Hora Padrao do Ira (GMT+03:30) Teera
Hora Padrao da Arabia (GMT+04:00) Abu Dhabi, Mascate
Hora Padrao do Azerbaijao (GMT+04:00) Baku
Hora Padrao da Ilha Maurício (GMT+04:00) Porto Luís
Hora Padrao da Georgia (GMT+04:00) Tbilisi
Hora Padrao do Caucaso (GMT+04:00) Yerevan
Hora Padrao do Afeganistao (GMT+04:30) Cabul
Hora Padrao de Ekaterinburg (GMT+05:00) Ekaterimburgo
Hora Padrao do Paquistao (GMT+05:00) Islamabad, Karachi
Hora Padrao da Asia Ocidental (GMT+05:00) Tashkent
Hora Padrao da India (GMT+05:30) Calcuta, Madras, Bombaim, Delhi

Guia de Instalação e Administração do PI Vision 2021 93

Tarefas de administração do PI Vision

ID de fuso horário do sistema Nome do display

Hora Padrao do Sri Lanka (GMT+05:30) Sri Jayawardenepura
Hora Padrao do Nepal (GMT+05:45) Katmandu
Hora Padrao da Asia Central (GMT+06:00) Astana
Hora Padrao de Bangladesh (GMT+06:00) Dacca
Hora padrao da Hora Padrao da Asia Central (GMT+06:00) Novosibirsk
Hora Padrao de Mianmar (GMT+06:30) Yangon (Rangoon)
Hora Padrao do Sudeste da Asia (GMT+07:00) Bangcoc, Hanoi, Jacarta
Hora Padrao da Asia do Norte (GMT+07:00) Krasnoyarsk
Hora Padrao da China (GMT+08:00) Pequim, Chonquim, Hong Kong,
Urumqui
Hora Padrao do Leste da Asia do Norte (GMT+08:00) Irkutsk
Hora Padrao de Cingapura (GMT+08:00) Kuala Lumpur, Cingapura
Hora padrao do Australia Standard Time (GMT+08:00) Perth
Hora Padrao de Taipei (GMT+08:00) Taipe
Hora Padrao de Ulaanbaatar (GMT+08:00) Ulaanbaatar
Hora Padrao de Toquio (GMT+09:00) Osaka, Sapporo, Toquio
Hora Padrao da Coreia (GMT+09:00) Seul
Hora Padrao de Yakutsk (GMT+09:00) Yakutsk
Cen. Australia Standard Time (GMT+09:30) Adelaide
Hora Padrao do Centro da Australia (GMT+09:30) Darwin
Hora padrao do Australia Standard Time (GMT+10:00) Brisbane
Hora Padrao do Oriente da Australia (GMT+10:00) Camberra, Melbourne, Sydney
Hora Padrao do Pacífico Ocidental (GMT+10:00) Guam, Port Moresby
Hora Padrao da Tasmania (GMT+10:00) Hobart
Hora Padrao de Vladivostok (GMT+10:00) Vladivostok
Hora Padrao do Pacífico Central (GMT+11:00) Magada, Ilhas Salomao, Nova
Caledonia
Hora Padrao da Nova Zelandia (GMT+12:00) Auckland, Wellington
UTC+12 (GMT+12:00) Horario Coordenado Universal+12
Hora Padrao de Fiji (GMT+12:00) Fiji
Kamchatka Standard Time (GMT+12:00) Petropavlovsk-Kamchatsky - Antigo
Hora Padrao de Samoa (GMT+13:00) Nuku'alofa

Alterar as configurações regionais

Para dar suporte a um formato regional para todos os usuarios que acessam um site do
PI Vision, siga este procedimento.

Procedimento
1. Use um editor para abrir o arquivo web.config na pasta de instalaçao raiz do PI Vision.
2. Localize a linha do elemento globalization. O valor padrao se parece com isso:
<globalization culture="auto" uiCulture="auto" />
3. Modifique o valor culture para a opçao regional desejada que contempla todos os sites:
<globalization culture="siteWideRegion" uiCulture="auto" />

94 Guia de Instalação e Administração do PI Vision 2021

 Tarefas de administração do PI Vision

em que siteWideRegion e o codigo da regiao apropriada. Para obter uma lista de codigos,
consulte o artigo Supported Culture Codes (https://msdn.microsoft.com/en-us/library/
hh441729.aspx) da Rede de Desenvolvedores da Microsoft.
Por exemplo, para configurar o PI Vision para usar o formato regional franco-canadense
para todos os usuarios, digite:
<globalization culture="fr-CA" uiCulture="auto" />

Desinstalar o PI Vision
Para desinstalar o aplicativo do PI Vision, inicie o applet "Programs and Features Control Panel"
(painel de controle de programas e recursos), selecione PI Vision e Desinstalar.

Guia de Instalação e Administração do PI Vision 2021 95

Tarefas de administração do PI Vision

96 Guia de Instalação e Administração do PI Vision 2021

URLs para abrir displays
Voce pode usar uma URL para abrir, de maneira programada, os displays do PI Vision por
outros aplicativos.
É possível usar a URL para:
• Criar um display temporario que mostra uma unica tendencia preenchida com os itens de
dados especificados; a URL tambem pode especificar um intervalo de tempo para o display.
• Abra um display salvo existente e, opcionalmente, especifique o intervalo de tempo para o
display.
• Éspecifique o modo kiosk para abrir um display com a interatividade limitada.
• Configure um display existente para usar outros ativos que compartilham o mesmo template
do PI AF.
• Éspecifique o elemento de um display de elemento relativo do PI ProcessBook acessado por
dentro do PI Vision.
• Defina o fuso horario de um display para que os usuarios visualizem os dados no fuso
horario especificado, em vez do fuso de suas maquinas cliente.
• Oculte a barra de ferramenta ou a barra de tempo em uma exibiçao.
• Evite o redirecionamento automatico de usuarios do PI Vision em dispositivos moveis. Os
usuarios de dispositivos menores sao automaticamente redirecionados para a versao movel
do PI Vision. Entretanto, voce pode ignorar esse comportamento, por exemplo, nos casos em
voce integra um display do PI ProcessBook ou do PI Vision em seu proprio painel.
Nota:
Uma URL deve incluir caracteres codificados para URL, quando necessario. Por exemplo, o
sinal de mais (+) indica <Space> no HTML. Para inserir um sinal de mais real como parte
de uma URL, ele deve ser codificado como %2B. Isso significa que para usar a sintaxe de
URL do &EndTime=+8h, voce precisa inserir a sintaxe codificada como &EndTime=%2B8h.
Consulte o artigo do w3schools.com, Referencia de codificaçao URL para HTML (http://
www.w3schools.com/tags/ref_urlencode.asp) para mais informaçoes sobre a codificaçao
de URL.

Nesta seção
• Caminhos de URL base
• Referencia de parametros de URL
• Displays integrados
• Displays temporarios (ad hoc) com tag(s) ou atributo(s) especiais
• Displays temporarios (ad hoc) com calculos
• Referencia do parametro de calculo
• Displays existentes salvos
• Displays no modo kiosk
• Reutilizar as exibiçoes para construir ativos a partir do mesmo modelo AF
• Éspecificar o elemento para as exibiçoes de elemento relativas do PI ProcessBook
• Configurar o fuso horario para um display
• Esconder a barra de ferramentas, a barra de tempo ou a barra lateral

Guia de Instalação e Administração do PI Vision 2021 97

URLs para abrir displays

• Evitar o redirecionamento automatico ao Website para dispositivo movel do PI Vision

Caminhos de URL base

Estes sao os caminhos de URL base para os displays do PI Vision:
Display URL
Página inicial do https://webserver/website/
PI Vision
Novo display https://webserver/website/#/Displays/New/

Display https://webserver/website/#/Displays/DisplayId/
existente DisplayName

Display https://webserver/website/PB/#/PBDisplays/DisplayId/
existente do PI
ProcessBook

• Webserver: o nome do servidor do PI Vision.

• Website: o nome do site do PI Vision. Geralmente, o nome do site e PIVision.
• DisplayName: o nome do display.
• DisplayId: o numero de ID atribuído para o display salvo.
• PBDisplayId: o numero de ID atribuído para um display salvo do PI ProcessBook.

Referência de parâmetros de URL

Voce pode adicionar parametros de string de consulta listados na tabela abaixo aos caminhos
de URL base, seguindo essas regras basicas de sintaxe:
• Separe os parametros de string de consulta da URL base anterior com um ponto de
interrogaçao (?).
• Separe cada parametro de string de consulta com um "e" comercial (&).
Nota:
Uma URL deve incluir caracteres codificados para URL, quando necessario. Por exemplo, o
sinal de mais (+) indica <Space> no HTML. Para inserir um sinal de mais real como parte
de uma URL, ele deve ser codificado como %2B. Isso significa que para usar a sintaxe de
URL do &EndTime=+8h, voce precisa inserir a sintaxe codificada como &EndTime=%2B8h.
Para obter mais informaçoes sobre a codificaçao de URL, consulte o artigo do
w3schools.com, Referencia de codificaçao URL para HTML (http://www.w3schools.com/
tags/ref_urlencode.asp).

98 Guia de Instalação e Administração do PI Vision 2021

 URLs para abrir displays

Parâmetro Description
Asset=<path> Configura um display existente para trocar ativos relacionados que
compartilham o mesmo template do PI AF. Éspecifique os ativos anexando
Asset a URL, seguido pelo caminho do novo ativo.
Caminho para atributo ou tag em um servidor do PI AF:
\\ServerName\DatabaseName\ParentElement\ChildElement
Regras de sintaxe:
• Varios ativos sao delimitados por pontos e vírgulas. Um caminho completo
do servidor deve ser fornecido para cada ativo.
Exemplo:
https://webserver/pivision/#/Displays/AdHoc?
DataItems=calc:Temperature.Value;calc:Level.Maximum&Calculatio
ns=[{"Name":"Temperature","Server":"piserver","Expression":"'C
DT158'-100"},
{"Name":"Level","Server":"piserver","Expression":"'BA:Level.
1'-25"}]

Calculations= Éspecifica calculos para um display temporario (ad hoc) do PI Vision. Esses
<JSON string> calculos nao aparecem no símbolo de exibiçao, a menos que um item de dados
correspondente se refira ao calculo. Consulte Displays temporarios (ad hoc) com
calculos para obter detalhes adicionais.
Regras de sintaxe:
• Deve ser uma string JSON valida que define quaisquer calculos referenciados
por itens de dados.
• Consulte Referencia do parametro de calculo para obter detalhes sobre como
definir objetos de calculo na string JSON.
Exemplo:

https://webserver/pivision/#/Displays/AdHoc?
DataItems=calc:Temperature.Value;calc:Level.Maximum&Calculatio
ns=[{"Name":"Temperature","Server":"piserver","Expression":"'C
DT158'-100"},
{"Name":"Level","Server":"piserver","Expression":"'BA:Level.
1'-25"}]

CurrentElement= Éspecifica o elemento de displays de elementos relativos (ERD) do PI

<path> ProcessBook visualizados no PI Vision.
Exemplo:
https://webserver/pivision/#/PBDisplays/15914?CurrentElement=
\\AFServer1\DB1\CrackingProcess\Boiler202

Guia de Instalação e Administração do PI Vision 2021 99

URLs para abrir displays

Parâmetro Description
DataItems=<path> Éspecifica um ou multiplos dados para um display temporario (ad hoc) do
PI Vision.
Caminho em um servidor do PI AF:
\\ServerName\DatabaseName\ParentElement\ChildElement|
ChildAttribute
Caminho em um servidor do PI Data Archive:
\\ServerName\TagName
Regras de sintaxe:
• Os atributos sao delimitados pelo caractere de barra vertical (|).
• Varios itens de dados sao delimitados por pontos e vírgulas. Um caminho
completo do servidor deve ser fornecido para cada atributo ou tag.
• Se o parametro DataItems especificar um ativo, todos os seus atributos
representaveis em grafico aparecerao no símbolo.
Exemplo:
https://webserver/pivision/#/Displays/AdHoc?DataItems=
\\AFserver1\Houston\B-210|Temperature;\\AFserver\B-210|
Pressure;

HideSidebar Oculta a barra lateral de um display.

Exemplo:
https://webserver/pivision/#/Displays/AdHoc?DataItems=
\\AFserver1\Houston\B-210|Temperature&HideSidebar

Nota:
Os parametros do Hide tambem podem ser atribuídos a um valor true ou
false. Assim, por exemplo, se um display tiver o HideSidebar conjunto e
contiver um link para um display diferente, esse link pode incluir
HideSidebar=false para que a barra lateral seja mostrada.

HideTimebar Oculta a barra de tempo de um display.

Exemplo:
https://webserver/pivision/#/Displays/AdHoc?DataItems=
\\AFserver1\Houston\B-210|Temperature&HideTimebar
(Veja a nota para HideSidebar.)

HideToolbar Oculta a barra de ferramentas de um display.

Exemplo:
https://webserver/pivision/#/Displays/AdHoc?DataItems=
\\AFserver1\Houston\B-210|Temperature&HideToolbar
(Veja a nota para HideSidebar.)

Mode=kiosk Éspecifica como um display existente deve ser apresentado. No modo de

quiosque, o usuario nao pode pesquisar dados ou salvar o display.
https://webserver/pivision/#/Displays/3117/PowerAnalysis?
mode=kiosk

100 Guia de Instalação e Administração do PI Vision 2021

 URLs para abrir displays

Parâmetro Description
Redirect=false Anula o redirecionamento do PI Vision a um Website para dispositivo movel. Por
padrao, um usuario de dispositivo ou navegador menor e redirecionado ao site
para dispositivo movel do PI Vision. Use esse parametro para ignorar esse
comportamento, por exemplo, ao integrar um display do PI Vision ou do PI
ProcessBook em seu proprio painel.
Exemplo:
http://webserver/pivision/#/Displays/3117/PowerAnalysis?
redirect=false

Rootpath=<path> Configure um display existente para trocar um ativo pai (ou outro ancestral)
pelos ativos filho no display. Éspecifique as raízes anexando rootpath a URL,
seguido pelo caminho do novo ativo pai.
Exemplo:
https://webserver/pivision/#/Displays/39189/Wind-Farm-
Temperatures?rootpath=\\csaf\windpowergenfleet\Wind Power
Generation Fleet\Big Buffalo Wind Farm

StartTime=<PI Éspecifica a hora de início e termino de um display.

time>
Nota:
As horas de início e termino devem ser usadas em pares. A OSIsoft
EndTime=<PI time>
recomenda o uso de padroes ISO 8601 porque eles nao sao afetados por
fusos horarios.
Para obter mais informaçoes, consulte Configurar o fuso horario para um
display.
Exemplo:
https://webserver/pivision/#/Displays/202/AdHocDisplay1?
openadhocdisplay=all&starttime=2017-10-25T12:50:49.755Z&
endtime=2017-10-25T13:50:49.755Z

Symbol=<symbol Éspecifica qual tipo de símbolo aparecera em um display temporario (ad hoc).
type> Os tipos de símbolos validos incluem verticalgauge, horizontalgauge,
radialgauge, table, trend, value, xyplot e ACT (tabela de comparaçao de
ativos). O numero de dados de itens compatíveis varia de acordo com o símbolo.
As tabelas de comparaçao de ativos nao suportam pontos PI. Se nenhum
símbolo for especificado, uma tendencia e o tipo de símbolo padrao para um
display temporario (ad hoc).
Por exemplo, para alterar o tipo de símbolo para uma tabela, use o parametro
Symbol=table:
https://webserver/pivision/#/Displays/AdHoc?DataItems=
\\AFserver1\Houston\B-210|Temperature&Symbol=table
Para configurar uma tendencia temporaria (ad hoc) que mostre apenas uma
escala de valores quando houver tag(s) ou atributo(s) multiplos, inclua o
parametro Symbol=trend com a configuraçao MultipleScales=false:
https://webserver/pivision/#/Displays/AdHoc?DataItems=
\\afserver\B-210|Temperature;\\piserver
\aPIPoint&Symbol=trend;MultipleScales=false

Guia de Instalação e Administração do PI Vision 2021 101

URLs para abrir displays

Parâmetro Description
TZ=<time zone Éspecifica um deslocamento de tempo do horario UTC (Universal Coordinate
name> Time) para que os usuarios possam verificar os dados no fuso horario
especificado. O parametro TZ tambem pode especificar nomes de fuso horario
do Windows (por exemplo, Eastern Standard Time) ou IANA (por exemplo,
America/Denver).
Sintaxe:
• Nao podem haver espaços entre a especificaçao de deslocamento do fuso
horario.
• O deslocamento pode ser positivo ou negativo. Para aplicar um
deslocamento positivo, deve-se codificar o sinal de + (mais) como %2B.
• É possível inserir o deslocamento de tempo em qualquer um dos formatos a
seguir: H:MM ou HH:MM.
Exemplo:
https://webserver/pivision/#//Displays/3117/PowerAnalysis?
tz=UTC-5:00

Displays integrados
É possível integrar um display do PI Vision em uma pagina existente usando um elemento
<iframe> e configurando seu atributo src para a URL de uma pagina de display do PI Vision.
Se o site do PI Vision e o site de hospedagem tiverem origens diferentes, as configuraçoes de
segurança impedirao os navegadores de carregar o display do PI Vision. A origem de um site e
definida como a combinaçao do protocolo (por exemplo, HTTP ou HTTPS), nome do domínio
(por exemplo, 123.com) e numero da porta (por exemplo, :80).
Nota:
Se nenhuma porta for especificada, os valores padrao serao 80 para http e 443 para
https.
Para compartilhar os displays do PI Vision entre as origens, o servidor Web do PI Vision deve
identificar explicitamente as origens que podem renderizar os displays. Para configurar isso
para PI Vision, consulte Como voce pode incorporar um display do PI Vision em outro site?
(https://customers.osisoft.com/s/knowledgearticle?knowledgeArticleUrl=How-can-you-
embed-a-PI-Vision-display-into-another-website) no Portal de Atendimento ao Cliente.

Displays temporários (ad hoc) com tag(s) ou atributo(s)

especiais
Uma URL pode especificar os itens de dados para mostrar em uma tendencia unica em um
display temporario (ad hoc). Os dados podem ser qualquer combinaçao de tags do PI, atributos
e ativos (elementos do PI AF). Se a URL especificar um ativo, todos os seus atributos aparecerao
na tendencia.
Os usuarios podem salvar um display temporario para uso futuro ao fazer uma copia do display.
A URL pode incluir os parametros de horas de início e termino para o intervalo de tempo de
display usando qualquer expressao de tempo PI. Se nenhuma hora de início e termino for
especificada, o intervalo de tempo padrao de 8 horas atras ate o momento e aplicado e o
intervalo de tempo e atualizado continuamente.
Uma tendencia e o tipo de símbolo padrao para um display ad hoc. Para mostrar uma escala
para tendencia em vez de uma escala separada para cada atributo ou tag, inclua o parametro

102 Guia de Instalação e Administração do PI Vision 2021

 URLs para abrir displays

Symbol=trend com a configuraçao MultipleScales=false. Para alterar o símbolo para uma

tabela, inclua o parametro Symbol=table.

Exemplos
As seguintes URLs criam displays temporarios de tendencias:
• Atributo unico (Fuel) do ativo B-210
https://webserver/website/#/Displays/AdHoc?DataItems=\\EastCoast\HiEfficiency
\B-210|Fuel

O caractere de barra vertical (|) separa os atributos dos elementos e atributos pai. Nenhum
horario de início e termino foi especificado, entao o intervalo de tempo padrao aplica-se a
exibiçao.
• Ativo unico (B-210) em um intervalo especificado
https://webserver/website/#/Displays/AdHoc?DataItems=\\EastCoast\HiEfficiency
\B-210&StartTime=25-sep-19&EndTime=27-sep-19

Isso mostra os dados para todos os atributos de B-210 na tendencia em um display

temporario durante o intervalo de tempo entre a meia-noite do dia 25 de setembro de 2019
e meia-noite do dia 27 de setembro de 2019.
• Tag(s) ou atributo(s) multiplos
https://webserver/website/#/Displays/AdHoc?DataItems=\\afserver
\B-210|Temperature;\\piserver\aPIPoint

O ponto e vírgula separa itens de dados. Os atributos do mesmo ativo (Temperature e Fuel)
devem ser completamente especificados. Nenhum horario de início e termino foi
especificado, entao o intervalo de tempo padrao aplica-se a exibiçao. Por padrao, a tendencia
mostra uma escala separada para cada atributo ou tag.
• Multiplos dados com uma escala de valores unica
https://webserver/website/#/Displays/AdHoc?DataItems=\\afserver
\B-210|Temperature;\\piserver\aPIPoint&Symbol=trend;MultipleScales=false

Inclui o parametro Symbol=trend com a configuraçao MultipleScales=false.

Displays temporários (ad hoc) com cálculos

Voce pode incluir um calculo em uma URL para uma exibiçao temporaria (ad hoc). Para incluir
um item de dados de calculo, o calculo deve ser referenciado no parametro DataItems e
tambem definido no parametro de calculos. O parametro de calculos deve conter uma string
JSON valida com uma definiçao de calculo ou varias definiçoes de calculo em uma matriz. Cada
definiçao de calculo deve definir um Name, Server e Expression no mínimo. Para obter
propriedades de calculo disponíveis adicionais, consulte Referencia do parametro de calculo.
O parametro DataItems deve consultar um calculo por nome e escolher uma coluna. O formato
de um item de dados de calculo e: calc:<CalculationName>.<Column>. Por exemplo:
?DataItems=calc:Temperature.Value;calc:Level.Maximum

A URL final deve incluir tanto os itens de dados quanto as definiçoes de calculo. Por exemplo:
?
DataItems=calc:Temperature.Value;calc:Level.Maximum&Calculations=[{"Name":"Tempera
ture","Server":"piserver","Expression":"'CDT158' - 100"},
{"Name":"Level","Server":"piserver","Expression":"'BA:Level.1' - 25"}]

Exemplos

• Definiçao de calculo unica

Guia de Instalação e Administração do PI Vision 2021 103

URLs para abrir displays

{"Name":"Temperature","Server":"piserver","Expression":"'CDT158' - 100"}
• Varias definiçoes de calculo
[{"Name":"Temperature","Server":"piserver","Expression":"'CDT158' - 100"},
{"Name":"Level","Server":"piserver","Expression":"'BA:Level.1' - 25"}]

Referência do parâmetro de cálculo

Nome da propriedade Descrição da propriedade Valor Padrão
Name O nome de calculo. Isso e exibido (obrigatorio)
como parte do rotulo do item de
dados em símbolos e usado para
referenciar esse calculo em itens
de dados.
Nota:
A propriedade Name nao
deve conter o caractere de
ponto (".").

Server O servidor de arquivo de dados a (obrigatorio)

ser usado para avaliar a
Éxpressao.
Expression A expressao avaliada para o (obrigatorio)
calculo
IntervalMode A configuraçao intervalo de "Auto"
tempo para este calculo. Esta
propriedade deve ser definida
como "Custom" (Personalizado)
para que os parametros
CalcInterval e SyncTime
tenham efeito.
CalcInterval O Intervalo de cálculo para este "10m"
calculo CalcInterval deve
incluir um numero e uma
abreviaçao de intervalo como
"30s", "2h", "7d", etc.
Nota:
Se voce definir
IntervalMode como
"Auto" ou se voce nao
especificar um, esta
propriedade sera ignorada.

SyncTime Defina o Tempo de sincronização "00:00:00"

para este calculo. Deve estar em
formato de tempo de 24 horas de
##:##:## . Por exemplo:
05:00:00.
Nota:
Se voce definir
IntervalMode como
"Auto" ou se voce nao
especificar um, esta
propriedade sera ignorada.

104 Guia de Instalação e Administração do PI Vision 2021

 URLs para abrir displays

Nome da propriedade Descrição da propriedade Valor Padrão

Stepped Define se esse calculo deve ser true
plotado em formato Nivelado.
Deve consistir em um valor de
true ou false.
Nota:
Nao inclua o valor entre
aspas. Em JSON, os valores
booleanos sao
representados sem aspas.
Por exemplo:
"Stepped":true

ConversionFactor O Fator de conversão total para o "1d"

calculo ConversionFactor deve
incluir um numero e uma
abreviaçao de intervalo. Por
exemplo: 30s, 2h, 7d, etc.
Nota:
Esta propriedade afeta
apenas a recuperaçao da
coluna "Total" para o
calculo.

Description A descriçao do calculo N/D

Definição de cálculo de exemplo com todas as propriedades especificadas

{
"Name": "Temperature",
"Server": "piserver",
"Expression": "'CDT158' * 2",
"IntervalMode": "Custom",
"CalcInterval": "1h",
"SyncTime": "04:30:00",
"Stepped": true,
"ConversionFactor": "7d",
"Description": "A useful temperature calculation"
}

Nota:
Propriedades com valores padrao nao precisam ser especificadas. Por exemplo, para criar
um calculo com um CalcInterval nao padrao de "1h" e com valores padrao para todas
as outras propriedades, a amostra a seguir ilustra as informaçoes mínimas necessarias:
{
"Name": "Temperature",
"Server": "piserver",
"Expression": "'CDT158' * 2",
"IntervalMode": "Custom",
"CalcInterval": "1h"
}

Displays existentes salvos

Voce pode dar uma URL para outros usuarios abrirem um display salvo existente. Certifique-se
de que os usuarios tenham acesso ao display salvo marcando o display como publico.
É possível anexar os parametros de tempos de início e termino para o intervalo de tempo de
display usando qualquer expressao de tempo PI. Se nenhum tempo de início e termino for
especificado, o intervalo de tempo do display salvo sera aplicado.

Guia de Instalação e Administração do PI Vision 2021 105

URLs para abrir displays

Em relaçao a displays do PI Vision, especifique a ID do display na URL, anexada ao parametro

da URL, #/Displays, conforme mostrado nos exemplos a seguir. (A ID de display e mostrada
na URL quando voce abre o display).
Para displays do PI ProcessBook, voce pode especificar a ID de display ou o nome e o caminho
do arquivo PI ProcessBook importado na URL:
• Para abrir um display do PI ProcessBook por nome e caminho, especifique o parametro de
URL, #/PBDisplayName, e anexe-o ao caminho e nome do arquivo de display do PI
ProcessBook.
• Para abrir um display do PI ProcessBook por ID, especifique o parametro de URL, #/
PBDisplays, e anexe a ele a ID do display do PI ProcessBook.
Exemplos sao mostrados abaixo.

Exemplos do PI Vision
• A URL a seguir abre o display salvo do PI Vision 3117 (chamado PowerAnalysis). Nenhum
intervalo de tempo e especificado, portanto o display e aberta com o intervalo de tempo do
display salvo.
https://webserver/website/#/Displays/3117/PowerAnalysis
• Esta URL abre o display salvo do PI Vision 3117 (chamado PowerAnalysis) com o intervalo
de tempo especificado entre meia-noite do dia 25 de setembro de 2012 ate meia-noite do
dia 27 de setembro de 2012.
https://webserver/website/#/Displays/3117/PowerAnalysis?mode=kiosk
&StartTime=25-sep-12&EndTime=27-sep-12

Exemplos do PI ProcessBook
Nesses exemplos, a pasta de importaçao deve ser \\fileServer\Imports e o servidor do
PI Vision deve ser https://webServer/PIVision.
• Se o caminho do arquivo de display do PI ProcessBook for \\fileServer\Imports
\Kamyr.pdi, voce podera abri-lo usando a seguinte URL:
https://webServer/PIVision/#/PBDisplayName/Kamyr
• Se o caminho do arquivo de display do PI ProcessBook for \\fileServer\Imports
\Dealer\Customer2\ChemicalPlant\DistillationProcess.svg, voce podera abri-lo
usando a seguinte URL:
https://webServer/PIVision/#/PBDisplayName/Dealer
/Customer2/ChemicalPlant/DistillationProcess
Nota:
Nao inclua \\fileServer\Imports na URL para o display do PI ProcessBook.

• Se o nome de arquivo for unico e nao incluir um ponto final, entao voce nao precisa
especificar uma extensao. Se uma extensao nao for especificada, o PI Vision abrira um PDI
ou um display SVG. Se o nome do arquivo de display incluir um ponto final, entao voce deve
incluir a extensao do arquivo no URL. Por exemplo:
https://webServer/PIVision/#/PBDisplayName/Dealer
/Customer2/ChemicalPlant/DistillationProcess.svg
Voce tambem pode abrir um display do PI ProcessBook especificando a ID de display.
• Por exemplo, a seguinte URL abre o display do PI ProcessBook importada chamada
PressureVariation, que tem uma ID de 3649, com o intervalo de tempo especificado de meia-
noite de 1º de fevereiro de 2015 a meia-noite 28 de fevereiro de 2015:
https://webServer/PIVision/#/PBDisplays/3649/PressureVariation
?&StartTime=01-feb-15&EndTime=28-feb-15

106 Guia de Instalação e Administração do PI Vision 2021

 URLs para abrir displays

Displays no modo kiosk

Uma URL pode especificar um display com interatividade limitada usando o modo de quiosque.
É possível aplicar o modo de quiosque em um display temporario ou salvo.
Quando um display estiver no modo de quiosque:
• O display e de somente leitura.
• Somente a area de trabalho do display e visível. Os paineis a esquerda, como Search e Events,
sao omitidos. Para obter maior limite de interaçao, os links para ajuda e pagina inicial nao
estao disponíveis. Este parametro nao removera o botao Voltar de um display visualizado no
Website para dispositivo movel.
• Os usuarios podem interagir com a barra de tempo e os símbolos, mas nao podem salvar
quaisquer alteraçoes.
• Atualizar o navegador exibe a visualizaçao original do display.
Para colocar um display em modo de quiosque, anexe este parametro na URL:
?mode=kiosk

Nota:
O modo quiosque so existe dentro de um navegador que inclui o parametro de URL
anexado descrito acima. Omitir o parametro URL de um link remove efetivamente uma
tela do modo quiosque.

Exemplos
• A URL a seguir cria um display temporario no modo de quiosque.
O display mostrara uma tendencia contendo um unico atributo (Fuel) do ativo B-210
durante o intervalo de tempo da meia-noite do dia 25 de setembro de 2012 ate a meia-noite
do dia 27 de setembro de 2012.
https://webserver/website/#/Displays/AdHoc?DataItems=\\EastCoast\HiEfficiency\
B-210|Fuel&StartTime=25-sep-12&EndTime=27-sep-12&mode=kiosk
• A URL abre o display 3117 salvo (nomeado como PowerAnalysis) no modo de quiosque.
Nenhum intervalo de tempo e especificado para que o display possa abrir com o intervalo de
tempo do display salvo.
https://webserver/website/#/Displays/3117/PowerAnalysis?mode=kiosk

Reutilizar as exibições para construir ativos a partir do

mesmo modelo AF
É possível configurar uma exibiçao existente para usar outros ativos que compartilham o
mesmo modelo AF. Para fazer isso, especifique os ativos a serem apresentados em um display
anexando ?Asset a URL, seguido pelo caminho do novo ativo.

Procedimento
1. Obtenha os caminhos dos ativos que deseja usar para substituir os ativos existentes na
exibiçao.
Voce pode encontrar esses caminhos nos resultados da pesquisa do PI Vision ou no PI
System Explorer.
2. Éspecifique os ativos relacionados atualizando a URL de exibiçao existente. Anexe a string ?
Asset, seguido pelo caminho do novo ativo. Separe varios caminhos de ativo com um ponto
e vírgula (;)

Guia de Instalação e Administração do PI Vision 2021 107

URLs para abrir displays

Exemplo
No exemplo a seguir, o display do PI Vision chamado "BoilerFanInformation" contem dois
símbolos de tabela; um mostra as informaçoes sobre uma caldeira; e o outro, as informaçoes
sobre um ventilador.
O ativo da caldeira na exibiçao foi construído a partir de um modelo de elemento AF do tipo
Boiler e o ativo do ventilador foi construído a partir de um modelo de elemento AF do tipo
Fan.
Um engenheiro deseja usar esta exibiçao para mostras as informaçoes sobre uma caldeira e um
ventilador diferente, que foram construídos a partir do mesmo modelo. A exibiçao
"BoilerFanInformation" original possui a URL: https://PIVisionServ/Displays/15914/
BoilerFanInformation
Para visualizar as informaçoes sobre uma caldeira e uma caldeira diferente, execute as etapas a
seguir:
1. No PI System Explorer, identifique os caminhos para os ativos AF de interesse.
2. Anexe a sequencia a seguir para a URL de exibiçao "BoilerFanInformation":
?Asset=\\AFServer1\DB1\CrackingProcess\Equipment\Boiler309;\\AFServer1\DB1\
Cracking Process\Equipment\Fan486

Isso cria a URL:

https://PIVisionServ/Displays/15914/BoilerFanInformation?Asset=\\AFServer1\DB1\
CrackingProcess\Equipment\Boiler309;\\AFServer1\DB1\
Cracking Process\Equipment\Fan486

As tabelas na exibiçao agora mostram as informaçoes do ativo Caldeira para Boiler309 e as

informaçoes do ativo Ventilador para Fan486.
Nota:
Voce nao tem que especificar um ativo para cada modelo. Por exemplo, voce pode
especificar apenas um ventilador na URL e nao especificar uma caldeira. Nesse caso, a
caldeira padrao associada a exibiçao sera usada.

Especificar o elemento para as exibições de elemento

relativas do PI ProcessBook
Para um display de elemento relativa (ERD), ao visualiza-lo no PI ProcessBook, altere o
elemento que esta visualizando selecionando outro elemento no painel Elementos de interesse.
Ao visualizar um ERD do PI ProcessBook em um PI Vision, use um metodo diferente para
alternar elementos.

Procedimento
• Anexe ?CurrentElement a URL, seguido pelo caminho do elemento para o qual os dados
serao mostrados.
A sintaxe do caminho relativo dos elementos PI AF e suportada.
Por exemplo, cada uma das URLs mostra os dados de um elemento diferente na ERD
identificada como 15914:
https://PIVisionServ/PIVision/#/PBDisplays/15914?CurrentElement=
\\AFServer1\DB1\CrackingProcess\Boiler202
https://PIVisionServ/PIVision/#/PBDisplays/15914?CurrentElement=
\\AFServer1\DB1\CrackingProcess\Boiler209

108 Guia de Instalação e Administração do PI Vision 2021

 URLs para abrir displays

Configurar o fuso horário para um display

É possível usar o parametro da URL com o objetivo de configurar o fuso horario para um
display de modo que os usuarios possam visualizar os dados no fuso horario especificado, em
vez de no fuso horario da sua maquina cliente.
Voce pode fazer isso especificando a seguinte URL de um display:
• IDs do fuso horario do Windows (por exemplo, Hora Padrao do Leste dos EUA). Consulte IDs
de fuso horario do sistema.
• IANA TZID (para obter mais informaçoes, consulte a pagina unicode.org Zona – Tzid (http://
www.unicode.org/cldr/charts/26/supplemental/zone_tzid.html).)
• Um offset de horario UTC (Universal Coordinate Time). Este offset e usado somente para:
◦ Display especificado.
◦ Visualizaçoes de tendencias de símbolos dinamicos nesse display.
◦ Displays temporarios (ad hoc) do PI Vision acessados de um display do PI ProcessBook.
A barra de tempo mostra a sequencia de UTC. O horario de verao nao afeta os displays que
usam este parametro.
Como um exemplo, suponha que deseja especificar o fuso horario no qual os seus usuarios
visualizam os dados para o display a seguir:
https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis

Procedimento
• Anexe o parametro TZ a URL. Por exemplo:
https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?tz=Eastern
Standard Time
https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?tz=America/New_York
https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?tz=UTC-5:00

O nome do parametro TZ e a palavra-chave UTCnao sao sensíveis a maiusculas e minusculas.

O deslocamento pode ser positivo ou negativo. Para aplicar um deslocamento positivo, deve-
se codificar o sinal de + (mais) como %2B.

A sintaxe e os exemplos
Nao podem haver espaços entre a especificaçao de deslocamento do fuso horario, como por
exemplo: TZ=UTC-3:00.
É possível inserir o deslocamento de tempo em qualquer um dos formatos a seguir:
• H:MM ou HH:MM
Por exemplo:TZ=UTC-5:05
Se especificar os minutos, deve-se usar dois dígitos e precede-los com : (dois-pontos). Os
valores para minutos podem variar entre 00 a 59. Por exemplo:
tz=utc%2B8:05
• +n ou -n horas. Os valores para horas (n) podem variar de 1 a 13.
Por exemplo:tz=Utc-1
Nota:
Nos navegadores Mozilla Firefox, o formato UTC+H pode falhar, pois o sinal de + (mais)
nao e transmitido adequadamente (codificado como %2B ou nao).

Guia de Instalação e Administração do PI Vision 2021 109

URLs para abrir displays

Quaisquer especificaçoes invalidas causam a reversao do display para o fuso horario do cliente.

Esconder a barra de ferramentas, a barra de tempo ou a barra

lateral
Voce pode usar os parametros de URL HideToolbar, HideTimebar e HideSidebar para
esconder a barra de ferramentas, a barra de tempo e a barra lateral em um display.
A configuraçao aplica-se:
• A exibiçao especificada
• Displays temporarios (ad hoc) do PI Vision acessados de um display do PI ProcessBook
Para reverter a ocultaçao da barra de ferramentas, da barra de tempo e da barra lateral, voce
precisa remover os parametros HideToolbar, HideTimebar e HideSidebar e recarregar o
display.
Como um exemplo, suponha que deseje ocultar a barra de ferramentas ou a barra de tempo na
exibiçao a seguir:
https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis

Nota:
Os nomes do parametro nao fazem distinçao entre maiusculas e minusculas. Nao podem
haver espaços entre a especificaçao de parametro.

Procedimento
• Para ocultar a barra de ferramentas, anexe o parametro ?HideToolbar a URL. Por exemplo:
https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?HideToolbar
• Para ocultar a barra de tempo, anexe o parametro ?HideTimebar a URL. Por exemplo:
https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?HideTimebar
• Para esconder a lateral, anexe o parametro ?HideSidebar a URL. Por exemplo:
https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?HideSidebar
• Para esconder varias barras, anexe os parametros a URL usando um sinal tipografico & &
para separar cada parametro. As barras podem ser ocultadas em qualquer combinaçao. O
exemplo a seguir oculta todas as tres barras:
https://PIVisionServ/PIVision/#/Displays/3117/
PowerAnalysis?hideToolbar&HideTimebar&HideSidebar

Evitar o redirecionamento automático ao Website para

dispositivo móvel do PI Vision
Com base no tamanho da janela do dispositivo ou navegador, um usuario de um dispositivo ou
navegador menor e redirecionado, por padrao, ao Website para dispositivo movel do PI Vision.
Talvez seja necessario ignorar esse comportamento, por exemplo, ao integrar um display do PI
ProcessBook ou do PI Vision em seu proprio painel.

Procedimento
• Para anular esse comportamento padrao, adicione redirect=false a sua URL do PI Vision.

110 Guia de Instalação e Administração do PI Vision 2021

 URLs para abrir displays

Esse parametro faz com que o usuario visualize o aplicativo Web completo do PI Vision,
independentemente do tamanho da janela.

Exemplos
A URL a seguir abre o display salvo 3117 (chamado PowerAnalysis) no aplicativo Web
completo do PI Vision, mesmo quando for acessado em dispositivos ou janelas de navegadores
menores.
http://webserver/website/#/Displays/3117/PowerAnalysis?redirect=false

Guia de Instalação e Administração do PI Vision 2021 111

URLs para abrir displays

112 Guia de Instalação e Administração do PI Vision 2021

Opções de alta disponibilidade para o PI Vision
As soluçoes de alta disponibilidade (HA) descritas neste documento sao independentes do
PI Vision. Essas estrategias sao recomendaçoes, mas todos os sistemas possuem requisitos
exclusivos, portanto, deve-se discutir tais estrategias com o seu administrador do banco de
dados e o administrador de Internet Information Services (IIS) enquanto sua arquitetura e
planejada.
As opçoes de HA estao disponíveis para o PI Vision nos níveis de servidor de banco de dados e
de aplicativo. Cada uma dessas opçoes possui seus proprios benefícios.
As opçoes de banco de dados incluem:
• Armazenamento em cluster
• Espelhamento
• Grupos de disponibilidade AlwaysOn
• Replica transacional
As opçoes de servidor de aplicativo do PI Vision incluem:
• Équilíbrio de carga de rede (NLB)
• Roteamento de solicitaçao de aplicativo (ARR)
• NLB e ARR em uma configuraçao de failover ativa/passiva
• NLB e ARR em uma configuraçao de failover ativa/ativa

Opções de nível de banco de dados

A implementaçao de HA no nível de banco de dados evita que o banco de dados do PI Vision no
Microsoft SQL Server torne-se um unico ponto de falha.
Voce deve implementar a HA no banco de dados do PI Vision da mesma maneira que ela seria
aplicada em qualquer outro banco de dados do SQL Server. A Microsoft fornece uma descriçao
geral de suas opçoes de implementaçao HA para MS SQL Server no artigo Continuidade de
negocios e recuperaçao de banco de dados - SQL Server (https://docs.microsoft.com/en-
us/sql/sql-server/failover-clusters/high-availability-solutions-sql-server).
Apos a conexao, um banco de dados replicado age da mesma maneira que o banco de dados
substituído; portanto, a unica alteraçao de configuraçao necessaria e fazer com que o aplicativo
do PI Vision reconheça o banco de dados replicado. Faça isso ao especificar a string de conexao
para o aplicativo. Por exemplo:
connectionString = "Data Source=myPrimaryServer;Failover
Partner=mySecondaryServer;
Initial Catalog=myDataBase;Integrated Security=True;
Application Name=&quotPIVision Web Service&quot"

A string de conexao pode ser editada no web.config diretamente pelo aplicativo Web do
PI Vision ou por meio do modulo de strings de conexao no IIS Manager quando o aplicativo
Web do PI Vision estiver selecionado. O arquivo web.config esta localizado em um desses
diretorios a seguir:
%pihome64%\PIVision\Services for versions 1.x
%pihome64%\PIVision for versions 2.x

A tabela a seguir resume os benefícios e as desvantagens de cada opçao de HA do SQL Server.

Guia de Instalação e Administração do PI Vision 2021 113

Opções de alta disponibilidade para o PI Vision

Opção de HA do SQL Server Vantagens Desvantagens

Armazenamento em cluster • Permite acesso integral de • Exige um investimento inicial
leitura e gravaçao ao banco de significante no hardware do
dados do PI Vision. cluster.
• Ressincronizaçao nao • Pode ser lento ao executar o
necessaria. Os membros de failover entre os membros do
cluster sempre usam a ultima cluster (comparado ao
copia compartilhada do banco espelhamento).
de dados. • Somente uma copia do banco
de dados.
• A distancia entre os nos e
limitada em alguns metros,
pois compartilham uma
unidade física.
Espelhamento • Permite acesso integral de • Exige um terceiro "servidor
leitura e gravaçao ao banco de testemunha" para o failover
dados do PI Vision. automatico.
• Tempo de failover rapido • Se executar em um modo
(comparado ao assíncrono, o banco de dados
armazenamento em cluster de espelho pode nao estar
do SQL). sempre atualizado.
• Duas copias do banco de
dados no hardware
independente.
• Os membros podem ser
separados fisicamente por
uma longa distancia.
Grupos de disponibilidade • Permite acesso integral de • O SQL Enterprise e necessario
AlwaysOn leitura e gravaçao ao banco de para utilizar os grupos de
dados do PI Vision. disponibilidade.
• Tempo de failover rapido
(comparado ao
armazenamento em cluster
do SQL).
• Duas copias do banco de
dados no hardware
independente.
• Nenhum servidor testemunha
e necessario.
Replica transacional • Duas copias dos dados no • O failover nao e suportado.
hardware independente. • O equilíbrio de carga nao e
suportado.
• Nenhuma proteçao de dados
replicados foi alterada.

Opções de HA do servidor de aplicativo do PI Vision

A HA no nível do servidor de aplicativo pode fornecer equilíbrio de carga e tolerancia a falhas.
A tabela a seguir esboça alguns pros e contras para as implementaçoes de equilíbrios de carga
de rede diferentes (NLB) e o roteamento de solicitaçao de aplicativo (ARR).
A tabela a seguir resume os benefícios e as desvantagens de cada opçao de HA do servidor de
aplicativo do PI Vision.

114 Guia de Instalação e Administração do PI Vision 2021

 Opções de alta disponibilidade para o PI Vision

Opções de HA do servidor de Vantagens Desvantagens

aplicativo do PI Vision
Roteamento de solicitaçao de • Divide a carga de acesso de • Nao fornece uma HA
aplicativo (ARR) dados no servidor de verdadeira, pois o no de ARR
aplicativo. permanece um unico ponto
• Outros recursos estao de falha.
disponíveis para permitir que • A escalabilidade e limitada,
o ARR atue como um proxy pois o trafego e canalizado
reverso, se necessario. atraves de um unico no.
Équilíbrio de carga de rede (NLB) • Divide a carga de acesso de
dados no servidor de
aplicativo.
NLB e ARR (ativo/passivo) • Fornece o HA verdadeiro, ja • O investimento maior exigido,
que nao ha um unico ponto de em termos de configuraçao e
falha. numero de maquinas
• Outros recursos estao disponíveis necessarias.
disponíveis para permitir que
o ARR atue como um proxy
reverso, se necessario.
NLB e ARR (ativo/ativo) • Fornece o HA verdadeiro, ja
que nao ha um unico ponto de
falha.
• Fornece a escalabilidade
verdadeira, pois o trafego nao
e canalizado atraves de um
unico no.
• Outros recursos estao
disponíveis para permitir que
o ARR atue como um proxy
reverso, se necessario.

Para obter mais informaçoes, consulte o topico Administraçao de alta disponibilidade do PI

System (https://docs.osisoft.com/bundle/pi-server/page/pi-system-high-availability-
administration.html) do PI Server.

Guia de Instalação e Administração do PI Vision 2021 115

Opções de alta disponibilidade para o PI Vision

116 Guia de Instalação e Administração do PI Vision 2021

Apêndice A Visualizar e configurar o registro de
mensagens do PI Vision
Este apendice explica como visualizar as mensagens do PI Vision e como configurar o registro
em log de mensagens. Por padrao, as mensagens do PI Vision aparecem na ferramenta
Visualizador de Eventos do Windows no servidor de aplicativo do PI Vision.

Exibir os logs de mensagens

Procedimento
1. No computador do servidor de aplicativo do PI Vision, abra a ferramenta Visualizador de
eventos do Windows. Por padrao, a ferramenta e diretamente acessível no menu Iniciar do
Windows.
2. Clique no botao + para expandir Applications and Services Logs (registros em log de
aplicativos e serviços). As mensagens do aplicativo do PI Vision sao exibidas nas seguintes
categorias:
◦ OSIsoft-PIDataServices
Contem mensagens relacionadas ao acesso de dados dos servidores PI Data Archive e
servidores PI AF.

▪ Admin
▪ Operacional
◦ OSIsoft-PISymbols
Inclui as mensagens de procura e recuperaçao de dados (inclusive todas as mensagens do
site de administraçao e dos serviços de monitoramento de arquivo).

▪ Admin
▪ Operacional
◦ OSIsoft-Search
Inclui mensagens relacionadas a pesquisas executadas pelo PI Vision.

▪ Admin
3. Opcional: crie uma exibiçao personalizada para ver todos esses eventos em um so lugar:
a. No painel a esquerda do Visualizador de eventos do Windows, clique com o botao direito
do mouse na linha Personalizar visualizações e selecione Criar visualização
personalizada.
b. De um nome a vista. Por exemplo, Eventos do PI Vision.
c. Selecione a guia XML.
d. Marque Editar consulta manualmente e adicione o texto a seguir:
<QueryList>
<Query Id="0" Path="OSIsoft-PIDataServices/Admin">
<Select Path="OSIsoft-PIDataServices/Admin">*</Select>
<Select Path="OSIsoft-PIDataServices/Operational">*</Select>
<Select Path="OSIsoft-PIVisualization/Admin">*</Select>
<Select Path="OSIsoft-PIVisualization/Operational">*</Select>

Guia de Instalação e Administração do PI Vision 2021 117

Apêndice A Visualizar e configurar o registro de mensagens do PI Vision

<Select Path="OSIsoft-PISystemSearch/Admin">*</Select>
<Select Path="OSIsoft-PISystemSearch/Operational">*</Select>
<Select Path="OSIsoft-Search/Admin">*</Select>
<Select Path="PIWebAPI/Admin">*</Select>
</Query>
</QueryList>
4. Use o log do Visualizador de eventos de análise para rastrear chamadas de pesquisa:
a. Inicie o Visualizador de Eventos do Windows.
b. Clique em View (Exibir).

c. Selecione Mostrar Logs Analíticos e de Depuração.

118 Guia de Instalação e Administração do PI Vision 2021

 Apêndice A Visualizar e configurar o registro de mensagens do PI Vision

Coleção de eventos de depuração e análise do Monitor de

Desempenho do Windows
Para fins de depuraçao, e possível habilitar os logs de rastreamento para coleta de dados de
diagnostico a fim de fornece-los ao Suporte Tecnico da OSIsoft. Templates para este tipo de
coleta de dados estao disponíveis no Suporte Tecnico. É possível configurar logs de
rastreamento de evento para coleta por um período dinamico usando as sessoes de
rastreamento de eventos.
Para obter mais informaçoes sobre coletores de dados, consulte o artigo Configurar
monitoramento de desempenho (https://docs.microsoft.com/en-us/windows-server/
identity/ad-fs/deployment/configure-performance-monitoring) do Microsoft TechNet.

Suprimir mensagens duplicadas (supressão de mensagem)

Voce pode impedir que aplicativos cliente encham os logs com mensagens duplicadas, quando
houver um problema recorrente. O valor padrao e de 5 minutos, significando que se a mesma
mensagem se repetir dentro de 5 minutos, os aplicativos do registro em log nao farao o log
daquela mensagem.
Para modificar essa configuraçao, edite o arquivo web.config localizado na sua maquina
cliente. Edite a seguinte entrada em <appSettings> para ajustar as configuraçoes de
otimizaçao:
<add key="ErrorSuppressionTime" value="" />

O valor e um tempo em minutos; portanto, a seguinte linha definiria a otimizaçao de

mensagens para dez minutos:
<add key="ErrorSuppressionTime" value="10" />

Se o valor for zero, a supressao da mensagem estara desativada. A OSIsoft recomenda que voce
nao desative a supressao da mensagem.

Guia de Instalação e Administração do PI Vision 2021 119

Apêndice A Visualizar e configurar o registro de mensagens do PI Vision

120 Guia de Instalação e Administração do PI Vision 2021

Vídeos de tutoriais
Para assistir a vídeos sobre como instalar e configurar o PI Vision, confira a lista de reproduçao
no YouTube com o passo a passo da instalaçao do PI System.
https://www.youtube.com/watch?
v=DS93Tf9jpSU&list=PLMcG1Hs2Jbct0EHchLIiJTegzXSv3XVWF

Guia de Instalação e Administração do PI Vision 2021 121

Vídeos de tutoriais

122 Guia de Instalação e Administração do PI Vision 2021

Suporte técnico e outros recursos
Para obter assistencia tecnica, contate o Suporte Tecnico da OSIsoft pelo telefone +55 11 3053
5040 ou por Pagina Fale conosco no portal do cliente da OSIsoft (https://
customers.osisoft.com/s/contactus). A pagina Fale conosco fornece opçoes de contato
adicionais para clientes fora dos Estados Unidos.
Ao contatar o Suporte Tecnico da OSIsoft, tenha estas informaçoes em maos:
• Nome do produto, versao e numeros de compilaçao
• Detalhes sobre a plataforma do computador (tipo da CPU, sistema operacional e numero da
versao)
• Horario em que o problema começou
• Arquivos de log nesse horario
• Detalhes de todas as alteraçoes no ambiente anteriores ao início do problema
• Resumo do problema, inclusive os arquivos de log relevantes durante o horario em que o
problema ocorreu
Para fazer perguntas a outros usuarios do software OSIsoft, entre na comunidade de usuarios
do OSIsoft, PI Square (https://pisquare.osisoft.com). Os membros da comunidade podem
solicitar conselhos e compartilhar ideias sobre o PI System. O espaço PI Developers Clube
dentro do PI Square oferece recursos para ajuda-lo na programaçao e integraçao dos produtos
OSIsoft.

Guia de Instalação e Administração do PI Vision 2021 123

Suporte técnico e outros recursos

124 Guia de Instalação e Administração do PI Vision 2021