PI Vision Guía de Instalación y Administración
PI Vision Guía de Instalación y Administración
PI Vision Guía de Instalación y Administración
Actualizaciones de PI Vision...................................................................................9
Actualizar una instalación de PI Vision...................................................................................................... 9
Copias de seguridad automáticas de actualización de PI Vision............................................................... 11
Instalación de PI Vision........................................................................................ 13
Entender el proceso de instalación.......................................................................................................... 13
Fase 1: preparar el servidor de aplicación.................................................................................................14
Verificar requisitos de hardware y de software.................................................................................... 14
Preparar el equipo del servidor de aplicaciones de PI Vision.................................................................14
Agregar roles y características del servidor.......................................................................................... 15
Configurar el acceso a la capa de sockets seguros................................................................................ 17
Fase 2: crear una cuenta de servicios y configurar permisos.....................................................................18
Crear una cuenta de servicios para PI Vision........................................................................................ 19
Otorgar permisos de acceso a las cuentas de servicios de PI Vision......................................................20
Fase 3: Ejecutar el proceso de instalación................................................................................................ 29
Recomendaciones de instalación........................................................................................................ 29
Lista de verificación anterior a la instalación........................................................................................30
Instalar PI Vision.................................................................................................................................. 32
Interfaz de usuario multilingüe no disponible para instalar...................................................................35
Realizar una instalación silenciosa....................................................................................................... 35
Fase 4: Configurar PI Vision después de su instalación.............................................................................36
Añadir un servidor de PI Data Archive o un servidor de PI AF a la lista de servidores registrados.......... 37
Configurar agrupaciones de aplicaciones de PI Vision para que utilicen la cuenta de servicios de PI
Vision.................................................................................................................................................. 37
Creación de la base de datos de PI Vision.............................................................................................39
Permitir acceso a cada servidor de PI Data Archive desde PI Vision......................................................43
Permitir acceso a cada servidor de PI AF desde PI Vision..................................................................... 44
Configurar carpetas de importación de PI ProcessBook.......................................................................44
Fase 5: Configurar la delegación de Kerberos.......................................................................................... 46
Crear PI mappings............................................................................................................................... 47
Habilitar la delegación de Kerberos..................................................................................................... 48
Configurar navegadores web para clientes PI Vision............................................................................ 54
Autenticación del servidor de PI Data Archive en dispositivos móviles.................................................56
Configurar delegación restringida basada en recursos......................................................................... 56
Autenticación básica............................................................................................................................57
En esta sección
• Arquitectura de PI Vision
• Requisitos de hardware y software
Arquitectura de PI Vision
PI Vision es una aplicación basada en un navegador web que le permite recuperar, monitorear
y analizar fácilmente información de ingeniería de procesos.
Los principales componentes de una instalación de PI Vision son:
• (1) Clientes
Los clientes son usuarios de PI Vision individuales que obtienen acceso a los datos de PI.
PI Vision es compatible con la mayoría de los navegadores en una gran variedad de equipos,
incluidos tabletas y teléfonos que ejecutan los sistemas operativos iOS o Android.
• (6) Servidor de PI AF
PI Asset Framework (PI AF) es un único repositorio para los modelos, las jerarquías, los
objetos y los equipos centrados en recursos. Integra, contextualiza, refina, refiere y analiza
posteriormente los datos de múltiples fuentes, incluido uno o más servidores de PI Data
Archive. Juntos, estos metadatos y los datos de serie temporal proporcionan una
descripción detallada de equipos o recursos.
En esta sección
• Flujo de datos
• Acerca del servidor web de PI Vision
• Grupos de aplicaciones y cuentas de servicios de PI Vision
• Grupos de acceso de PI Vision
Flujo de datos
Este es un ejemplo de un flujo de datos típico que tiene lugar a medida que interactúan
diferentes elementos de la arquitectura para proporcionar al cliente datos del PI System.
Cuando se buscan datos en una nueva pantalla de :
1. Cuando un usuario realiza una búsqueda de un elemento de datos (recurso, atributo o PI
point), el cliente envía una solicitud de ese elemento de datos al servidor de aplicaciones de
PI Vision. La solicitud se retransmite a PI Web API, que rellena los resultados de la búsqueda
obtenidos del índice local creado por PI Web API Crawler.
2. En función de los resultados de la búsqueda, el usuario puede crear un símbolo para el
elemento de datos si lo arrastra a la visualización. El símbolo en la visualización no contiene
aún ningún valor de datos de PI.
3. La creación del símbolo activa una solicitud de datos de PI, que el servidor de aplicaciones
de PI Vision retransmite al servidor de PI Data Archive o al servidor de PI AF. Cuando los
datos de PI vuelven al cliente, los símbolos en la visualización se rellenan con valores de
datos.
4. Cuando un usuario guarda la pantalla, la definición de pantalla (ajustes de pantalla) se
envían al servidor SQL de Microsoft y se almacenan en la base de datos de PI Vision.
Cuando se abre una visualización de existente:
1. Cuando un usuario abre una visualización existente, el cliente envía una solicitud de
definición de una visualización al servidor de aplicaciones de PI Vision, que se retransmite
al servidor SQL de Microsoft. El servidor SQL devuelve la definición de la visualización a
partir de la cual el cliente genera una visualización con símbolos. Los símbolos aún no
contienen ningún valor de datos.
2. La creación del símbolo activa una solicitud de datos de PI, que el servidor de aplicaciones
de PI Vision retransmite al servidor de PI Data Archive o al servidor de PI AF. Cuando los
datos de PI vuelven al cliente, los símbolos se rellenan con valores de datos.
Nota:
El PI Web API Crawler requiere acceso de lectura a las tablas PIUSER, PIDBSEC,
PIMAPPING y PIPOINT. Puede establecer el acceso a esas tablas en el complemento de
seguridad de base de datos en PI System Management Tools (SMT). Tenga en cuenta
que, de manera predeterminada, la identidad de PIWorld tiene acceso de lectura a
PIUSER, PIPOINT y PIDBSEC. Por lo tanto, solo se requiere acceso explícito para
PIMAPPING, a menos que haya deshabilitado PIWorld. Si se desactiva PIWorld, debe
otorgar acceso explícito a PI Web API Crawler en cada una de las cuatro tablas
mencionadas anteriormente.
Los grupos de aplicaciones y cuentas de servicios de PI Vision se ejecutan en la cuenta de
servicios de PI Vision. Esta es la cuenta que PI Vision utiliza para conectarse a los servidores de
PI Data Archive y PI AF. Para que los usuarios cliente puedan ver datos de PI, la cuenta de
servicios de PI Vision necesita permisos de acceso adecuados a estos servidores.
Cuando instala PI Vision, en forma predeterminada, el kit de instalación configura la cuenta de
servicios en la cuenta del equipo del propio servidor de aplicaciones y configura las cuentas
para cada servidor de la siguiente manera:
Servicio Cuenta
PIVisionAdminAppPool NT Authority\Network Service
PIVisionServiceAppPool NT Authority\Network Service
PI Web API NT Service\piwebapi
PI Web API Crawler NT Service\picrawler
• Microsoft Windows Server 2008 R2 SP1 de 64 bits o una versión superior, incluidas las
versiones de Server Core.
• Microsoft Internet Information Services (IIS) 7.5 o superior
• Microsoft .NET Framework 4
• Roles y funciones de Administración del servidor. Consulte Añadir roles y funciones del
servidor para obtener detalles de los roles y de las funciones requeridos para PI Vision.
Nota:
No se admite la instalación de PI Vision en el controlador de dominio.
Nota:
Para las cargas más pesadas (más de 500 usuarios) se requiere una versión completa de
Microsoft SQL Server en ejecución en un servidor dedicado.
Antes de empezar
PRECAUCIÓN:
• Debe tener un certificado digital para completar la instalación (el programa de
instalación le permite crear y usar un certificado autofirmado, si se requiere).
• Debe especificar su servidor de PI AF durante la instalación. Las versiones mínimas del
servidor de PI AF y del servidor PI Data Archive han cambiado; consulte Requisitos de
PI System para PI Vision.
• Debe conocer el nombre de la cuenta de servicios de PI Vision actualmente en uso para
PI Vision. Para obtener más información sobre cómo recuperar esta cuenta, consulte
Grupos de aplicaciones y cuentas de servicios de PI Vision.
• Si tiene previsto importar las pantallas de PI ProcessBook, considere contar con
espacio de disco extra (aproximadamente 500 KB por pantalla).
• Se requieren PI mappings para que todos los usuarios cliente puedan buscar los
servidores de PI Data Archive y los servidores AF (un PI trust no es suficiente para
realizar búsquedas, pero puede usarse para la visualización de datos). Una PI mapping
asocia un grupo o usuario de Windows Active Directory con una PI identity.
• Los administradores de PI Vision deben ser miembros del grupo de administradores
de PI Web API para permitir los servidores de PI Data Archive y las bases de datos de
PI AF.
Consulte Lista de verificación anterior a la instalación para obtener más información sobre los
requisitos de instalación.
Nota:
Para actualizar la base de datos de PI Vision, el usuario que realice la actualización
(mediante el programa de instalación, el sitio web de administración o la secuencia de
go.bat) debe pertenecer a los siguientes roles mínimos de base de datos o debe ser
miembro del rol de base de datos db_owner.
• db_datareader
• db_datawriter
• db_ddladmin
Procedimiento
1. Inicie sesión en el servidor de aplicaciones como administrador del sistema utilizando una
cuenta de usuario de dominio que pertenezca al grupo local Administradores.
2. Verifique que todos los roles y las características necesarios estén instalados. Las
características y los roles necesarios se enumeran en la sección Preparar el equipo del
servidor de aplicaciones de PI Vision.
3. Descargue el nuevo kit de instalación de PI Vision desde el sitio web del Soporte Técnico
OSIsoft.
4. Haga clic con el botón derecho en el archivo ejecutable de instalación PI Vision y haga clic en
Ejecutar como administrador para iniciar el asistente de instalación.
5. Una vez que se complete el asistente de instalación de PI Web API, siga estos pasos para que
la utilidad de administrador de PI Web API configure PI Web API.
6. Cuando se le solicite una cuenta durante la instalación de PI Web API, elija la cuenta de
Active Directory que usa actualmente la versión anterior de los grupos de aplicaciones del
sitio web de PI Vision. Si PI Vision anteriormente usaba la cuenta del servicio de red, una
excepción es elegir la opción para ejecutar PI Web API como el usuario virtual NT Service
\piwebapi.
7. Cuando se le solicite un certificado seguro durante la utilidad de administración de PI Web
API, seleccione un certificado SSL existente, o haga clic en Siguiente para crear un
certificado autofirmado y selecciónelo. Para obtener más información, consulte Configurar
el acceso a la capa de sockets seguros.
8. Después de finalizar la actualización, reinicie el equipo y siga las instrucciones detalladas en
Configurar agrupaciones de aplicaciones de PI Vision para que utilicen la cuenta de servicios
de PI Vision para garantizar que todos los servicios se ejecuten con las cuentas correctas.
9. Si tiene activada la autenticación básica, es posible que se desactive al actualizar PI Vision. Si
está usando dispositivos móviles a través de SSL, deberá volver a activar la autenticación
básica. Para obtener más información, consulte Autenticación del servidor de PI Data
Archive en dispositivos móviles.
Si ya existe una base de datos de copia de seguridad en esta ubicación procedente de una
actualización anterior de PI Vision, el kit de instalación sobrescribirá el archivo de copia de
seguridad antiguo.
El programa de instalación crea también copias de archivos web.config actualizados, que se
encuentran ubicados en:
Program Data\OSIsoft\Coresight\PIDSTemp
Antes de instalar PI Vision, primero deberá abrir los puertos requeridos, descargar el kit de
instalación y otro software requerido, y habilitar los roles y funciones del servidor para
preparar el servidor de aplicaciones.
Video de capacitación
Para obtener más información sobre este tema, vea el siguiente video:
https://www.youtube.com/watch?
v=DS93Tf9jpSU&list=PLMcG1Hs2Jbct0EHchLIiJTegzXSv3XVWF
En esta sección
• Verificar requisitos de hardware y de software
• Preparar el equipo del servidor de aplicaciones de PI Vision
• Agregar roles y características del servidor
• Configurar el acceso a la capa de sockets seguros
• Sistema operativo: Windows Server 2008 R2 SP1 de 64 bits o más reciente, incluidas las
versiones de Server Core
• Microsoft Internet Information Services (IIS) 7.5 o superior
• Microsoft .NET Framework 4
• Microsoft SQL Server 2008 R2 (Express, Standard o Enterprise) o posterior para alojar la
base de datos de PI Vision SQL
• El servidor de PI Asset Framework (AF) para incluir la configuración de PI Web API
• Hardware (consulte Requisitos de hardware para el servidor de aplicaciones de PI Vision)
Procedimiento
1. Abra los puertos necesarios para el sitio web de PI Vision configurado. Todos los puertos
necesarios deben estar abiertos para que PI Vision funcione correctamente.
Puertos necesarios típicos
Puerto Utilizado por
80 o 443 servidor web de PI Vision
Si va a realizar la instalación en un servidor web que aloja varios sitios en el mismo puerto,
necesitará modificar de forma temporal el número de puerto antes de realizar la instalación:
a. En Internet Information Server (IIS) Manager, seleccione el sitio web donde desea
instalar PI Vision, haga clic con el botón derecho y seleccione Modificar enlaces.
b. En Enlaces de sitios, seleccione la primera fila y haga clic en Editar.
c. Cambie el número de puerto por un número exclusivo y haga clic en OK.
d. Una vez realizada la instalación, podrá restablecer el número original del puerto.
Nota:
Si va a realizar la instalación en un servidor de aplicaciones de PI WebParts o de PI
Web Services, debe crear un sitio web independiente con un número de puerto único.
No podrá instalar PI Vision en una aplicación web existente. Tome nota de este sitio
web. Durante el proceso de instalación, introdúzcalo cuando se le solicite el sitio web.
2. Descargue el software necesario:
◦ El kit de instalación de PI Vision. Puede descargar estos kits desde el sitio web del
Soporte Técnico OSIsoft (http://techsupport.osisoft.com/).
◦ Kit de instalación de Microsoft SQL Server (si tiene previsto utilizar una instalación de
SQL Server existente, omita este paso). El kit de instalación de SQL Server Express se
encuentra disponible para descargar en el sitio web de la asistencia técnica de OSIsoft.
Consulte Requisitos de Microsoft SQL Server para obtener una lista de versiones
compatibles.
3. Instale Microsoft SQL Server (si tiene previsto utilizar una instalación de SQL Server
existente, omita este paso).
Procedimiento
1. En Microsoft Server Manager, haga clic en Agregar roles y características para abrir el
asistente y elija Instalación basada en características o en roles como tipo de instalación.
2. En la página Roles del servidor del asistente, seleccione los roles Servidor de aplicaciones y
Servidor web (IIS).
4. En la página Servicios de rol para el rol del Servidor web (IIS), seleccione al menos los
servicios de rol mínimos detallados a continuación:
requieren esto. Para obtener más información, consulte Autenticación del servidor de PI Data
Archive en dispositivos móviles.
Para asegurar por completo el acceso a PI Vision, use un certificado digital provisto por un
registrador externo seguro o por la entidad de certificación privada de su empresa. Si bien el
programa de instalación puede crear un certificado autofirmado, solo debe usar esa opción en
caso de que el sitio web de PI Vision no esté asegurado mediante SSL.
De manera predeterminada, durante una instalación nueva, PI Vision configurará el sitio web
de IIS designado para PI Vision para que sea HTTPS. PI Vision utiliza el mismo certificado
digital que se especifica durante la configuración de PI Web API en la utilidad administrativa PI
Web API.
Si una versión anterior de PI Vision se actualiza a PI Vision 2017, el sitio no se configurará
automáticamente para HTTPS. Para configurar el sitio IIS que aloja PI Vision de forma manual
para usar SSL, consulte los siguientes artículos: Cómo implementar SSL en IIS (http://
support.microsoft.com/kb/299875) e Instalación de certificado SSL en Microsoft IIS 8 e IIS 8.5
(http://www.digicert.com/ssl-certificate-installation-microsoft-iis-8.htm).
Nota:
Este producto usa cookies que podrían tener implicancias legales según la ubicación
geográfica del licenciatario. Consulte con su departamento de asuntos legales para
asegurarse de que cumpla con las leyes, reglas y reglamentaciones relevantes, que
incluyen, entre otras, las directivas sobre protección de datos y cookies.
Si configura SSL para el sitio web de PI Vision, OSIsoft le recomienda que proteja las
cookies de PI Vision mediante la adición de atributos “seguros” al archivo de PI Vision
web.config. Añada el siguiente indicador a web.config:
<configuration>
<system.web>
<httpCookies httpOnlyCookies = "true" requireSSL ="true"/>
</system.web>
</configuration>
Una vez que esté preparado el servidor de aplicaciones, creará una cuenta de servicios (cuenta
de dominio) para PI Vision. Después de crear una cuenta de servicios, otorgará los permisos de
acceso de la cuenta de servicios al servidor SQL de Microsoft, los servidores de PI Data Archive
y los servidores de PI AF. Para obtener más información, consulte el artículo de Microsoft
MSDN Cuentas de usuarios de dominio (https://msdn.microsoft.com/en-us/library/
ms675915).
Nota:
OSIsoft le recomienda enfáticamente que cree una cuenta de servicios personalizada para
el PI Vision. Si opta por no tener en cuenta esta recomendación y utilizar las cuentas de
equipos predeterminadas, debe revisar el resto de las aplicaciones que se estén
ejecutando en el equipo servidor de aplicación. Todas las aplicaciones que se ejecuten en
este equipo tendrán permisos de acceso a PI Vision en los servidores de SQL, PI Data
Archive y PI AF. Por motivos de seguridad, plantéese eliminar algunas o todas las demás
aplicaciones que se ejecuten en este equipo.
Video de capacitación
Para obtener más información sobre este tema, vea el siguiente video:
https://www.youtube.com/watch?v=DS93Tf9jpSU&start=592
En esta sección
• Crear una cuenta de servicios para PI Vision
• Otorgar permisos de acceso a las cuentas de servicios de PI Vision
Nota:
En la mayoría de las organizaciones, un profesional de TI realiza los procedimientos en
este paso. Para obtener más información, consulte el artículo de Microsoft Crear nueva
cuenta de usuario (https://technet.microsoft.com/en-us/library/Cc732336.aspx).
Procedimiento
1. En el controlador de dominio, cree una nueva cuenta de usuario en Usuarios y equipos de
Active Directory.
2. Haga clic con el botón secundario en la carpeta Usuarios y seleccione Nuevo > Usuario.
3. Ingrese el nombre de su cuenta y haga clic en Siguiente. OSIsoft recomienda asignar a esta
cuenta de servicios el nombre PIVisionService. Puede ingresar Vision como nombre,
Service como apellido y PIVisionService como nombre de inicio de sesión del usuario.
• Para cada servidor de PI Data Archive permitido: la cuenta de servicios de PI Vision necesita
acceso de lectura a todos los PI Points a los que acceden los usuarios cliente. Consulte
Configurar permisos de acceso al servidor PI Data Archive.
• Para cada servidor de PI AF permitido: la cuenta de servicios de PI Vision necesita acceso de
lectura a los servidores de PI AF y a todas las bases de datos de PI AF permitidas en cada
servidor de PI AF. Además, la cuenta de servicios de PI Vision necesita acceso de lectura a
todos los elementos y tablas de PI AF a los que los usuarios pueden obtener acceso. Consulte
Configurar permisos del servidor de PI AF.
Procedimiento
1. Identifique una PI identity existente que tenga los permisos de acceso necesarios. (Dado que
se requiere acceso de lectura a cada PI point, resulta más sencillo utilizar una PI identity
existente que ya tenga acceso). Si no tiene una PI identity existente, consulte Crear una
identidad de PI.
2. Si ha creado una identidad de PI para PI Vision, necesita otorgar a esa identidad el acceso de
lectura a los PI points. Consulte Otorgar a la PI identity los permisos de acceso necesarios.
3. Asigne la identidad de PI nueva o existente a la cuenta de servicios de PI Vision. Consulte
Asignar la PI identity.
Procedimiento
1. Ejecute la aplicación PI System Management Tools (SMT).
2. En Servidores, seleccione un servidor.
3. En System Management Tools, seleccione Security > Identities, Users, & Groups.
4. Seleccione la pestaña PI Identities y haga clic en el botón Nueva identidad para abrir el
cuadro de diálogo Nueva identidad.
5. En el cuadro de diálogo Nueva identidad, escriba un nombre para la nueva identidad. Este es
el único campo que es necesario para crear una entidad. Tenga en cuenta las siguientes
limitaciones respecto a los nombres de identidades:
◦ El nombre debe ser exclusivo.
◦ El nombre no puede incluir el carácter de barra vertical (|) o el de los dos puntos (:).
◦ El nombre no puede ser un entero positivo, aunque puede incluir números. Por ejemplo,
el nombre "407" no es válido, pero el nombre "Admins407" sí lo es.
◦ El nombre no distingue entre mayúsculas y minúsculas.
Si intenta crear una entidad con un nombre no válido, aparecerá un mensaje de error y no
se creará la identidad. Tenga en cuenta que puede cambiar el nombre de una identidad en
cualquier momento después de crearla.
6. Seleccione el servidor adecuado de la lista desplegable Server. La lista se rellena con los
servidores seleccionados en Servidores. Solo los servidores PI Data Archive versión 3.4.380
y versiones posteriores aparecerán en la lista. Las versiones anteriores del servidor PI Data
Archive no admiten PI identities.
Procedimiento
1. Ejecute la aplicación PI System Management Tools (SMT).
2. En System Management Tools, seleccione Security > Database Security.
3. Haga doble clic en la tabla de la base de datos PIPOINT.
4. En el cuadro de diálogo Seguridad para PIPOINT, haga clic en Añadir para seleccionar su PI
identity.
7. Una vez que haya otorgado acceso de lectura a la tabla de la base de datos PIPOINT, realice
los mismos pasos para la tabla de la base de datos PIMAPPING. Si ejecuta PI Web API
Crawler en la misma cuenta, la PI identity también necesita permisos para las tablas de las
bases de datos DBSEC y PIUSER. Si ejecuta PI Web API Crawler en una cuenta diferente
desde una agrupación de aplicaciones de PI Vision, la identidad de PI para esa cuenta
necesita acceso de lectura a las tablas de la base de datos PIPOINT, PIMAPPING, DBSEC y
PIUSER.
8. Otorgue acceso de lectura a los datos de punto para cada PI point. El método más simple es
usar el complemento PI Builder para editar los puntos en forma masiva. De manera
alternativa, puede utilizar la herramienta Point Builder en PI SMT para editar la seguridad
de punto en cada punto.
a. Vaya a Puntos > Point Builder.
b. En el cuadro de diálogo Búsqueda de tags, busque los PI points a los que debe acceder la
nueva PI identity y añádalos a Point Builder.
c. Haga clic en el ícono de búsqueda.
d. Seleccione la pestaña Seguridad, luego seleccione los PI points y añada la PI identity
deseada en los menús Seguridad de datos y Seguridad de punto.
e. Seleccione la casilla de verificación Lectura en ambos menús.
Para obtener más información, consulte el tema del servidor de PI "Administrar identidades
de PI" in Live Library (https://livelibrary.osisoft.com).
Procedimiento
1. Abra PI System Management Tools (PI SMT).
2. En Servidores, seleccione el servidor.
3. En System Management Tools, seleccione Security > Identities, Users, & Groups.
4. Seleccione la PI identity que desee asignar.
7. Haga clic en el botón Add, que está situado en la sección de asignaciones del cuadro de
diálogo. Se abrirá el cuadro de diálogo Add New Mapping.
Nota:
El botón Add se encuentra desactivado si la PI identity seleccionada está marcada
como desactivada o no se puede utilizar en una asignación.
Procedimiento
1. Abra PI System Explorer.
2. Seleccione Archivo > Conexiones. Se abre el cuadro de diálogo Servidores y en él se
enumeran todos los servidores de PI AF.
3. Haga clic con el botón secundario en un servidor de PI AF conectado y seleccione
Propiedades.
4. En la ventana Propiedades del servidor de PI AF, navegue hasta la pestaña Identidades. Haga
clic con el botón secundario y seleccione Nueva identidad.
Procedimiento
1. Haga clic con el botón secundario en un servidor de PI AF conectado y seleccione Seguridad.
2. Haga clic en Añadir para añadir la identidad que ha creado.
3. En la ventana Seleccionar identidad, seleccione la PI AF identity y habilite los permisos de
lectura seleccionando Permitir.
4. Haga clic en Aplicar y en Aceptar.
Procedimiento
1. Abra PI System Explorer.
2. Haga clic en el botón Base de datos. Se abre el cuadro de diálogo Seleccionar base de datos y
en él se detallan todas las bases de datos de PI AF en el servidor de PI AF conectado
actualmente.
3. Si el servidor de PI AF actualmente conectado es el servidor para el que desea configurar
acceso, omita este paso. De lo contrario, haga clic con el botón derecho del ratón en el
nombre del servidor que desee configurar en la lista y seleccione Establecer conexión.
4. Haga clic con el botón secundario en la base de datos de PI AF y seleccione Seguridad. Se
abrirá el cuadro de diálogo Permisos para esa base de datos.
5. Haga clic en Agregar. Se abrirá el cuadro de diálogo Identidades.
6. Seleccione la identidad a la que se ha asignado la cuenta de servicios de PI Vision.
7. En el campo Permissions, seleccione la casilla de verificación Read en la columna Allow.
8. Haga clic en Aceptar.
En esta fase, ejecutará el kit de instalación para instalar PI Vision. Al ejecutar el kit de
instalación, instalará todos los componentes de software requeridos de PI Vision. El kit de
instalación emitirá una serie de indicaciones que le solicitarán que especifique la información
de configuración para el servidor PI AF y PI Web API.
Video de capacitación
Para obtener más información sobre este tema, vea el siguiente video:
https://www.youtube.com/watch?v=DS93Tf9jpSU&start=635
En esta sección
• Recomendaciones de instalación
• Lista de verificación anterior a la instalación
• Instalar PI Vision
• Interfaz de usuario multilingüe no disponible para instalar
• Realizar una instalación silenciosa
Recomendaciones de instalación
OSIsoft recomienda la siguiente configuración:
• Para la base de datos de PI Vision, use el mismo Microsoft SQL Server que usa PI AF.
• Los servidores de PI Data Archive y de PI AF están en el dominio donde:
◦ Reside el servidor de aplicaciones de PI Vision
◦ Microsoft SQL Server aloja la base de datos de PI Vision
PRECAUCIÓN:
• Debe tener un certificado digital SSL para completar la instalación (el programa de
instalación le permite crear y usar un certificado autofirmado, si es necesario).
• Debe especificar su servidor de AF durante la instalación. Las versiones mínimas del
servidor AF y el servidor PI Data Archive se han modificado; consulte Requisitos de PI
System para PI Vision.
• Debe conocer el nombre de la cuenta de servicios de PI Vision actualmente en uso para
PI Vision. Para obtener más información sobre cómo recuperar esta cuenta, consulte
Grupos de aplicaciones y cuentas de servicios de PI Vision.
• Si tiene previsto importar las pantallas de PI ProcessBook, considere contar con
espacio de disco extra (aproximadamente 500 KB por pantalla).
• Se requieren PI mappings para que todos los usuarios cliente puedan buscar los
servidores de PI Data Archive y los servidores AF (un PI trust no es suficiente para
realizar búsquedas, pero puede usarse para la visualización de datos). Una PI mapping
asocia un usuario o un grupo con una PI identity.
• Los administradores de PI Vision deben ser miembros del grupo de administradores
de PI Web API, para permitir los servidores de PI Data Archive y las bases de datos de
PI AF.
Cuenta de servicios de PI Vision Para mantener los datos seguros, Crear una cuenta de servicios para
OSIsoft le recomienda que cree una PI Vision
cuenta de servicios (cuenta de
Configurar agrupaciones de
dominio) para el servicio de
aplicaciones de PI Vision para que
PI Vision.
utilicen la cuenta de servicios de PI
Nota: Vision
Después de la instalación,
debe configurar los grupos de
aplicaciones para que utilicen
esta identidad.
Instalar PI Vision
Siga los pasos de este procedimiento para instalar PI Vision por primera vez.
Antes de empezar
Cuando instale PI Vision por primera vez, debe crearse la base de datos de PI Vision. Por lo
tanto, el usuario que realice la instalación (mediante el programa de instalación, el sitio web de
administración o la secuencia de comandos go.bat) debe tener los siguientes privilegios, que
puede obtener generalmente del administrador de la base de datos de su organización:
• El rol de servidor db_creator.
• El permiso ALTER ANY LOGIN. Los usuarios pueden obtener este permiso mediante el uso
de la declaración GRANT ALTER ANY LOGIN TO "domain\account". Si un usuario
pertenece al rol de servidor securityadmin, ya dispone del permiso ALTER ANY LOGIN.
El usuario que realice la instalación también debe tener acceso de escritura a la base de datos
de Configuración en el servidor de PI AF predeterminado. Para obtener acceso a la base datos
Configuración, use PI System Explorer.
Asegúrese de haber cumplido con los requisitos previos detallados en Lista de verificación
anterior a la instalación.
Nota:
Durante la instalación, verá las pantallas de configuración para lo siguiente:
1. PI Web API
2. PI Vision
Si el equipo en el que instaló PI Vision se agrega posteriormente a un dominio, debe
desinstalar y reinstalar PI Web API. Si usó un certificado autofirmado, deberá generar un
nuevo certificado para la reinstalación.
Procedimiento
1. Inicie sesión en el servidor de aplicaciones como administrador del sistema utilizando una
cuenta de usuario de dominio que pertenezca al grupo local Administradores.
2. Haga clic con el botón derecho en el archivo ejecutable de instalación PI Vision y haga clic en
Ejecutar como administrador para iniciar el asistente de instalación. El instalador muestra
una lista de componentes de software requeridos por PI Vision. Algunos componentes
pueden estar ya presentes en su equipo.
3. Revise la lista de componentes de software y haga clic en OK para continuar con la
instalación. Haga clic en Siguiente a medida que avance a través de las indicaciones.
5. Después de completar la configuración de PI Web API, configure PI Web API mediante el uso
de la utilidad administrativa PI Web API. El asistente le solicitará que especifique:
Procedimiento
1. Haga doble clic en el archivo .EXE para extraer el ejecutable de PI Vision. Tome nota de la
carpeta en la que se extrae la configuración en la máquina de destino.
2. Abra esa carpeta en Windows Explorer.
3. Abra el archivo SilentConfig.json en Notepad.
Este archivo contiene una configuración predeterminada para PI Web API:
{
"ConfigAssetServer": "MyAFServer",
"ConfigInstance": "MachineName",
"IsFirewallExceptionEnabled": true,
"IsTelemetryEnabled": false,
"ListenPort": 443,
"ApiServiceAccountType": "Default",
"ApiServiceAccountUsername": "NT Service\\piwebapi",
"CrawlerServiceAccountType": "Default",
"CrawlerServiceAccountUsername": "NT Service\\picrawler",
"CrawlBuiltInGroups": true,
"CrawlerSubmitTimeout": 1200.0,
"CrawlerSubmitUrl": "https://MachineName/piwebapi/",
"MaxConcurrentCrawlers": 2,
"AutoCrawlRebuild": true,
"CrawlerMaxPathCount": 1000000
4. Modifique los siguientes campos:
◦ ConfigAssetServer: reemplace “MyAFServer” con el servidor AF predeterminado que
quisiera usar para PI Vision.
◦ ConfigInstance: reemplace “MachineName” con el nombre de la máquina en la que se
está instalando PI Vision.
◦ CrawlerSubmitUrl: reemplace "MachineName" con el nombre de la máquina en la que
se está instalando PI Vision.
Si desea especificar cuentas de usuario diferentes para PI Web API o PI Web API Crawler, o
si desea especificar un puerto diferente para PI Web API, modifique estos campos también.
5. Guarde y cierre el archivo SilentConfig.json.
6. Abra el archivo silent.ini en Notepad. El archivo contiene una configuración
predeterminada para todos los demás componentes instalados durante la instalación de
PI Vision.
7. Encuentre la sección [COMMANDLINE] de este archivo. En la fila 17, reemplace
"MyPIServer" con su PI Data Archive predeterminado y reemplace "MyAFServer" con su
servidor de AF predeterminado.
17 = /qn REBOOT=Suppress ALLUSERS=1 PI_SERVER=MyPIServer PI_USER=pidemo
AF_SERVER=MyAFServer ADDLOCAL=FD_AFSDK,FD_AFExplorer,FD_AFBuilder,FD_AFDocs
8. En la fila 18, modifique el parámetro CONFIG_FILE para que sea la ruta completa a la
carpeta en la que extrajo el ejecutable de configuración autoextraíble de PI Vision. Por
ejemplo, si extrajo el archivo setup .exe en la carpeta C:\Temp, modificaría CONFIG_FILE.
18 = /qn REBOOT=Suppress ADMINS_GROUP_TYPE=Default CONFIG_FILE=C:\Temp
\SilentConfig.json
9. Guarde y cierre el archivo silent.ini.
10. Ejecute un símbolo del sistema como Administrador y navegue hasta la carpeta extraída.
11. Para invocar una instalación silenciosa, ejecute el siguiente comando:
18 = /qn REBOOT=Suppress ADMINS_GROUP_TYPE=Default CONFIG_FILE=C:\Temp
\SilentConfig.json
Video de capacitación
Para obtener más información sobre este tema, vea el siguiente video:
https://www.youtube.com/watch?
v=sRmP2qNJvLQ&list=PLMcG1Hs2Jbct0EHchLIiJTegzXSv3XVWF
En esta sección
• Añadir un servidor de PI Data Archive o un servidor de PI AF a la lista de servidores
registrados
• Configurar agrupaciones de aplicaciones de PI Vision para que utilicen la cuenta de servicios
de PI Vision
• Creación de la base de datos de PI Vision
• Permitir acceso a cada servidor de PI Data Archive desde PI Vision
• Permitir acceso a cada servidor de PI AF desde PI Vision
• Configurar carpetas de importación de PI ProcessBook
Procedimiento
1. Ejecute PI System Explorer de forma local en el servidor de aplicaciones PI Vision. PI System
Explorer se instala como parte de la instalación de PI Vision.
2. Seleccione Archivo > Conexiones. Se abrirá la ventana Servidores. En esta ventana se
enumeran todos los servidores PI Data Archive y los servidores de PI AF para los que se ha
configurado una conexión. Los servidores PI Data Archive y los servidores de PI AF
conectados actualmente se indican con unos círculos de color verde.
3. Haga clic en Añadir servidor de recursos para el servidor de PI AF o en Añadir servidor de
datos para PI Data Archive.
4. En la ventana Propiedades del servidor, escriba el nombre de su servidor de PI AF o del
servidor PI Data Archive en el campo Host.
5. Haga clic en Conectar.
Nota:
Como se describe en estos pasos, debe asegurarse de que la configuración Permitir
aplicaciones de 32 bits se establezca en Falso. PI Vision es una aplicación de 64 bits y no
funcionará correctamente en un grupo de aplicaciones de 32 bits.
Procedimiento
1. Ejecute Administrador de Internet Information Services (IIS).
2. En Conexiones, haga clic en Agrupación de aplicaciones para mostrar la lista de grupos de
aplicaciones. La lista incluye los dos grupos de aplicaciones de PI Vision:
◦ PIVisionAdminAppPool ejecuta el sitio web de administración de PI Vision, que se
encuentra en https://webServer/PIVision/Admin.
◦ PIVisionServiceAppPool ejecuta los servicios de aplicaciones de PI Vision, que se
encuentran en https://webServer/PIVision.
3. Haga clic con el botón derecho en PIVisionAdminAppPool y seleccione Configuración
avanzada. Se abrirá el cuadro de diálogo Advanced Settings.
◦ Servicio API: si creó una cuenta de servicios de PI Vision personalizada, elija Personalizar
del menú desplegable y escriba el nombre de la cuenta (domain name\account name) y la
contraseña. Haga clic en el botón Probar y luego haga clic en Aceptar.
◦ Servicio Crawer: si creó una cuenta de servicios de PI Vision personalizada, elija
Personalizar del menú desplegable y escriba el nombre de la cuenta (domain name
\account name) y la contraseña. Haga clic en el botón Probar y luego haga clic en Aceptar.
Procedimiento
1. Configurar la conexión de Microsoft SQL Server.
2. Utilice uno de los siguientes métodos para crear la base de datos de PI Vision:
◦ Método 1: Crear automáticamente la base de datos de PI Vision uso del sitio web de
administración de PI Vision. Esta es la forma más fácil de crear la base de datos, pero solo
se puede realizar si se cumple, al menos, una o más de las siguientes condiciones:
i. La delegación de Kerberos está configurada entre el servidor de aplicaciones de
PI Vision y el equipo SQL Server.
ii. La base de datos de PI Vision se encuentra en el mismo equipo que el servidor de
aplicaciones de PI Vision.
iii. Usted está ejecutando su navegador localmente en el mismo equipo que el servidor de
aplicaciones de PI Vision.
◦ Método 2: Creación manual de la base de datos de PI Vision en el Microsoft SQL Server.
Generalmente, se requiere este método, excepto que su situación cumpla con las
condiciones antes mencionadas.
Procedimiento
1. Use su navegador web para ir al sitio web de administración de PI Vision. De forma
predeterminada, este sitio está ubicado en https://webServer/PIVision/Admin, donde
webServer es el nombre del servidor web de PI Vision.
Nota:
Si obtiene acceso al sitio web de administración de PI Vision desde un navegador que
se ejecuta localmente en el servidor de aplicaciones de PI Vision, debe ejecutar el
navegador como administrador. Para hacerlo, haga clic con el botón secundario en el
icono de acceso directo al navegador y seleccione Ejecutar como administrador.
2. Haga clic en Configuración en la navegación que está a la izquierda y elija la pestaña Base de
datos de PI Vision.
3. Para especificar la instancia de Microsoft SQL Server que debe alojar la base de datos de
PI Vision, haga clic en el botón desplegable que está junto al campo de SQL Server y
seleccione el servidor que desea, o escriba directamente el nombre en el cuadro, por
ejemplo, .\sqlexpress.
4. Haga clic en el botón de menú desplegable que está junto al campo Base de datos y
seleccione la base de datos que desea, o escriba el nombre directamente en la casilla.
5. Haga clic en Guardar.
Antes de empezar
Nota:
Para crear la base de datos de PI Vision, debe tener lo siguiente:
• El rol de servidor db_creator
• El permiso ALTER ANY LOGIN (que significa que ha obtenido este permiso mediante el
uso de la declaración GRANT ALTER ANY LOGIN TO "domain\account" o que
pertenece al rol de servidor securityadmin).
Procedimiento
1. Use su navegador web para ir al sitio web de administración de PI Vision. De forma
predeterminada, este sitio está ubicado en https://webServer/PIVision/Admin, donde
webServer es el nombre del servidor web de PI Vision.
Nota:
Si obtiene acceso al sitio web de administración de PI Vision desde un navegador que
se ejecuta localmente en el servidor de aplicaciones de PI Vision, debe ejecutar el
navegador como administrador. Para hacerlo, haga clic con el botón secundario en el
icono de acceso directo al navegador y seleccione Ejecutar como administrador.
2. Haga clic en Configuración en la navegación que está a la izquierda y elija la pestaña Base de
datos de PI Vision.
3. Haga clic en el botón de menú desplegable que está junto al campo Base de datos y
seleccione la base de datos que desea, o escriba el nombre directamente en la casilla.
4. Haga clic en Guardar.
Aparece una marca de verificación verde junto a los nombres del Microsoft SQL Server y de
la base de datos para verificar la configuración correcta.
Nota:
Para actualizar la base de datos de PI Vision, debe pertenecer a los siguientes roles
mínimos de base de datos o ser miembro del rol de base de datos db_owner.
• db_datareader
• db_datawriter
• db_ddladmin
Puede seguir estos pasos para crear, actualizar y configurar una base de datos de PI Vision en
Microsoft SQL Server.
Procedimiento
1. En el servidor de aplicación busque el directorio SQL y cópielo. Este directorio suele estar
situado aquí:
Program Files/PIPC/PIVision/Admin/SQL
2. En el equipo que ejecuta SQL Server, pegue la carpeta y todo su contenido en un directorio
local.
3. En el equipo que ejecuta SQL Server, abra un símbolo del sistema como administrador, vaya
al directorio local usado en el paso 2 e introduzca la secuencia de comandos Go.bat:
Go.bat DBServer DBName PIVisionService
Nota:
Si PIVisionService contiene algún espacio, incluya la cadena entre comillas dobles.
◦ La base de datos SQL de PI Vision es una base de datos SQL Express que se denomina
PIVision y es local.
◦ Los servicios web de PI Vision se ejecutan en el grupo de aplicaciones predeterminado.
◦ La palabra clave output.log hace que los resultados sean capturados y almacenados en el
archivo TEMP\ pivisualizationdbupgrade.log (por ejemplo, C:\Users\username
\AppData\Local\Temp\ pivisualizationdbupgrade.log).
Procedimiento
1. Use su navegador web para ir al sitio web de administración de PI Vision. De forma
predeterminada, este sitio está ubicado en https://webServer/PIVision/Admin, donde
webServer es el nombre del servidor web de PI Vision.
2. En la página Descripción general, haga clic en Administrar configuración que se encuentra
junto a la lista Servidores de datos permitidos. O bien, haga clic en Configuración en el árbol
de navegación y elija la pestaña Servidores de datos.
3. Para añadir un servidor PI Data Archive, seleccione la casilla de verificación Permitido junto
a ese servidor.
Nota:
El botón Probar conexión comprueba si se puede conectar al servidor de PI Data
Archive adecuado utilizando la cuenta PIVisionService. Esta es la identidad usada
por los grupos de aplicaciones de PI Vision.
4. Una vez que termine de realizar los cambios, haga clic en Guardar para actualizar el servidor
de aplicaciones de PI Vision con sus selecciones.
Procedimiento
1. Use su navegador web para ir al sitio web de administración de PI Vision. De forma
predeterminada, este sitio está ubicado en https://webServer/PIVision/Admin, donde
webServer es el nombre del servidor web de PI Vision.
2. En la página Descripción general, haga clic en Administrar configuración junto a la lista
Servidores de recursos/Bases de datos permitidas. O bien, haga clic en Configuración en el
árbol de navegación y elija la pestaña Servidores de recursos.
Aparecerá la página de Servidores y bases de datos de PI AF. Esta página presenta los
servidores de AF reconocidos por PI Vision. Para agregar un servidor de PI AF a la lista,
consulte Añadir un servidor de PI Data Archive o un servidor de PI AF a la lista de
servidores registrados.
3. Si un servidor de PI AF tiene un símbolo de triángulo a su lado, puede expandirlo para ver
una lista de las bases de datos de PI AF en ese servidor en la columna Databases:
a. Para verificar la conexión con un servidor de PI AF, haga clic en Test Connection en la
columna Connection Status.
b. Para permitir el acceso a todas las bases de datos, seleccione All. De manera alternativa,
para permitir el acceso a un subconjunto de las bases de datos, seleccione solamente las
casillas de verificación de aquellas bases de datos que desea tenga permiso de acceso.
carpetas, automáticamente lo añade, actualiza o elimina de PI Vision. Todos los archivos PDI y
SVG de las carpetas especificadas y de cualquier subcarpeta son automáticamente importados
al servidor de aplicaciones de PI Vision. Puede importar los archivos PIW de PI ProcessBook en
PI Vision. El archivo PIW se presenta como una carpeta en la carpeta Importar que contiene
subcarpetas para cada pestaña.
Las visualizaciones importadas de PI ProcessBook se comparten con la identidad de PI AF
World de manera predeterminada. Puede ajustar la configuración de intercambio de las
visualizaciones de PI ProcessBook después de que estas se importen para compartirlas con una
identidad de PI AF específica. Sin embargo, si se elimina la visualización de PI ProcessBook y
luego se vuelve a agregar a la carpeta de importación, se compartirá nuevamente con la
identidad de PI AF World.
PRECAUCIÓN:
Para mantener los datos seguros, OSIsoft le recomienda que implemente las siguientes
medidas:
• Restrinja el acceso de red a las carpetas de importación solo para aquellos usuarios y
grupos que lo requieran para agregar pantallas. Puede autorizar los usuarios y los
grupos usando la configuración de seguridad del sistema operativo de Windows para
las carpetas y los volúmenes compartidos. Tenga en cuenta que las visualizaciones
importadas estarán disponibles para que las vean los usuarios de clientes en PI Vision.
Los permisos de los archivos de pantalla en las carpetas de importación no se aplican a
las pantallas importadas.
• Habilite la Auditoría de seguridad de Windows para realizar un seguimiento de quién
añade, elimina o modifica los archivos en las carpetas de importación. Para obtener
más información, consulte: Aplicar o modificar la configuración de la política de
auditoría para una carpeta o un archivo local (http://technet.microsoft.com/en-US/
library/cc771070.aspx).
Nota:
PI Vision nunca modifica el contenido de una carpeta importada.
Procedimiento
1. Use su navegador web para ir al sitio web de administración de PI Vision. De forma
predeterminada, este sitio está ubicado en https://webServer/PIVision/Admin, donde
webServer es el nombre del servidor web de PI Vision.
2. Haga clic en Administración de importación de carpeta en el árbol de navegación que está a
la izquierda.
3. Para añadir una carpeta nueva, introduzca la ruta en la columna Carpeta. Opcionalmente,
también puede introducir un alias para la carpeta en el campo Nombre informal. A
continuación, haga clic en Añadir.
El campo Carpeta a la que se puede acceder indica si el servicio de monitoreo tiene acceso a
la carpeta. Después de añadir una carpeta, el estado Carpeta accesible muestra un signo de
pregunta hasta que usted actualiza la página de administración de PI Vision. Si la ruta de
acceso a la nueva carpeta es accesible y no ocurren errores, muestra una marca de
verificación verde.
Una X de color rojo indica que hay un problema con el proceso de monitoreo de archivos
para obtener acceso a la carpeta especificada. Para determinar la causa, investigue los
errores en el registro de eventos PISymbols Admin. En general, la causa de los errores de
monitoreo de archivos es una ruta no válida o que la cuenta de grupo de aplicaciones
PIVisionServiceAppPool no tenga suficientes privilegios para obtener acceso para importar
la jerarquía de carpetas.
Nota:
El proceso de monitoreo de archivo puede demorar algunos minutos en comenzar a
importar los archivos, porque busca todos los archivos para importar antes de
comenzar el proceso de importación en sí.
El acceso a la carpeta se obtiene usando la identidad del grupo de aplicaciones
PIVisionServiceAppPool.
4. (Opcional) Haga clic en Mostrar estado para ver información sobre los errores ocurridos
durante una importación.
5. (Opcional) Para modificar un nombre descriptivo, introduzca los cambios en el campo
Nombre informal y haga clic en Aplicar.
6. (Opcional) Si ya no desea importar pantallas de PI ProcessBook desde una carpeta, haga clic
en el botón Quitar.
Todos los archivos de esa carpeta se quitarán del servidor de aplicaciones de PI Vision; los
archivos de PI ProcessBook reales no se tocan.
Nota:
Después de eliminar las carpetas de importación, vuelva a indexar la base de datos de
PI Vision SQL Server y actualice las estadísticas. Para obtener más información sobre
cómo realizar reindexaciones de Microsoft SQL Server, vaya al sitio web de Microsoft
TechNet (https://technet.microsoft.com/library) y busque “Cómo: Reconstruir un
índice (SQL Server Management Studio)”. También puede obtener más información
sobre la actualización de las estadísticas de consultas en Microsoft SQL Server; para
ello, vaya a Microsoft Developer Network (https://msdn.microsoft.com) y busque
“Actualizar estadísticas (Transact-SQL)”.
obtienen tickets del Centro de distribución de claves de Kerberos y presentan estos tickets a los
servidores donde se establecen las conexiones.
WIS requiere que utilice PI mappings para autenticar usuarios en el servidor PI Data Archive. Si
todavía no utiliza PI mappings para autenticar usuarios del servidor PI Data Archive, deberá
configurar las PI mappings de requisitos primero. Consulte Crear PI mappings.
PRECAUCIÓN:
OSIsoft le recomienda que no use un PI Trust para configurar la autenticación. Si utiliza
un PI trust, no podrá buscar PI points, a menos que el usuario del cliente también tenga
una PI Mapping para asociar su usuario de Active Directory a una PI Identity.
Si admite usuarios de PI Vision en dispositivos móviles y utiliza WIS para autenticar usuarios
del servidor PI Data Archive, deberá configurar también la capa de sockets seguros (SSL) (si no
lo ha hecho) y realizar la autenticación Básica. Una vez que active la delegación de Kerberos,
siga las instrucciones en Autenticación del servidor de PI Data Archive en dispositivos móviles.
Para la siguiente funcionalidad, se debe configurar la delegación restringida de Kerberos entre
el servidor de aplicaciones de PI Vision y el servidor de PI AF, o debe configurarse la
autenticación Básica para la aplicación web de PI Vision:
• Acusar recibo y anotar eventos
• Criterios de búsqueda de eventos
• Criterios de búsqueda de colecciones
• Criterio de búsqueda de tablas de comparación de activos
Video de capacitación
Para obtener más información sobre este tema, vea el siguiente video:
https://www.youtube.com/watch?v=sRmP2qNJvLQ&start=1046
En esta sección
• Crear PI mappings
• Habilitar la delegación de Kerberos
• Configurar navegadores web para clientes PI Vision
• Autenticación del servidor de PI Data Archive en dispositivos móviles
• Configurar delegación restringida basada en recursos
• Autenticación básica
Crear PI mappings
Junto con las PI identities, las PI mappings son los componentes centrales del modelo de
seguridad de PI Data Archive. Determinan los usuarios de Windows que se autentican en el
servidor de PI Data Archive y los permisos de acceso que tienen. Para obtener más información
sobre las asignaciones de PI, consulte el tema del servidor de PI, "Administración de
asignaciones" in Live Library (https://livelibrary.osisoft.com).
Para crear una PI mapping:
Procedimiento
1. Abra PI System Management Tools (PI SMT).
2. En Collectives and Servers, seleccione el servidor.
3. En System Management Tools, seleccione Security > Identities, Users, & Groups.
8. Ingrese la cuenta de Windows para grupos o usuarios individuales. Esta puede ser una
cuenta principal de AD o un grupo o usuario local de Windows. Para seleccionar la cuenta,
realice una de las siguientes operaciones:
◦ Haga clic en el botón de exploración para buscar la cuenta.
Procedimiento
1. Siga el procedimiento correspondiente, según el tipo de cuenta de servicio.
Cuando se utiliza esta configuración, deben existir los siguientes nombres principales de
servicio (SPN) de HOST para la cuenta de equipo del servidor de aplicaciones de PI Vision.
Estos SPN ya deberían existir de forma predeterminada, pero usted puede verificar su
existencia mediante el uso de setspn -l netbios-server-name.
HOST/netbios-server-name
HOST/fully-qualified-DNS-name
La autenticación del modo Kernel está activada en Internet Information Services (IIS) de forma
predeterminada y debe permanecer activada para esta configuración.
Para obtener más información acerca de SPN, consulte el siguiente artículo en Microsoft
TechNet Library (https://technet.microsoft.com/en-us/library/cc961723.aspx).
Procedimiento
1. En su controlador de dominio, abra Usuarios y equipos de Active Directory.
2. Seleccione Equipos en el dominio del servidor de aplicaciones de PI Vision.
3. Haga clic con el botón derecho en el servidor de aplicaciones de PI Vision y luego haga clic
en Propiedades.
5. Ahora deberá agregar servicios para cada servidor de PI Data Archive y el servidor AF al
cual se accederá a través de PI Vision. Para esto, haga clic en Añadir y luego haga clic en
Usuarios o equipos en la ventana Añadir servicios.
7. En la ventana Añadir servicios, elija PIServer como tipo de servicio y haga clic en Aceptar
para añadir el SPN para el servidor PI Data Archive.
Procedimiento
1. En el Administrador de Internet Information Services (IIS), seleccione la aplicación web
PI Vision y haga doble clic en el icono de Autenticación.
Por ejemplo:
setspn -S http/myserver mydomain\PIVisionService
setspn -S http/myserver.mydomain.int mydomain\PIvisionService
5. En su controlador de dominio, abra Usuarios y equipos de Active Directory.
6. Seleccione Usuarios en el dominio del servidor de aplicaciones de PI Vision.
7. Haga clic con el botón secundario en el nombre de la cuenta de dominio que ha creado y
haga clic en Propiedades.
8. En la ventana Propiedades, seleccione la pestaña Delegación y especifique un ajuste de
confianza para la computadora. Seleccione las siguientes opciones:
◦ Confiar en este usuario para la delegación solo a los servicios especificados
◦ Usar cualquier protocolo de autenticación
La selección de Usar cualquier protocolo de autenticación le permite realizar una transición
de protocolo. Esto permite que PI Vision autentique a los usuarios con NTLM y aún puedan
utilizar la delegación de Kerberos para los servicios especificados en el paso siguiente.
9. Ahora deberá agregar servicios para cada servidor de PI Data Archive y el servidor AF al
cual se accederá a través de PI Vision. Para esto, haga clic en Añadir y luego haga clic en
Usuarios o equipos en la ventana Añadir servicios.
10. Escriba el nombre de su servidor PI Data Archive, haga clic en Verificar nombres y en
Aceptar para regresar a la ventana Añadir servicios que ahora contiene una lista de todos los
tipos de servicios.
11. En la ventana Añadir servicios, elija PIServer como tipo de servicio y haga clic en Aceptar
para añadir el SPN para el servidor PI Data Archive.
12. Realice los mismos pasos para su servidor AF y escriba el nombre de su servidor en la
ventana Seleccionar usuarios o equipos. Haga clic en Verificar nombres y elija AFServer como
tipo de servicio en la ventana Añadir servicios.
Nota:
Si el servidor AF se ejecuta como una cuenta de servicios personalizada, busque el SPN
del servidor AF por esa cuenta de servicios en lugar de buscarlo por nombre de
equipo.
Los servicios añadidos se mostrarán en la ventana Propiedades.
13. Haga clic en Aplicar.
Procedimiento
1. En Internet Explorer, vaya a Ajustes > Opciones de internet.
2. Haga clic en la pestaña Opciones avanzadas.
3. Seleccione la casilla de verificación para Habilitar autenticación integrada de Windows.
8. En la ventana Ingresar valor de cadena, escriba su nombre de dominio y haga clic en Aceptar.
Autenticación básica
Con la autenticación básica, las credenciales de usuario se transfieren al PI System. Debe
utilizar el método de autenticación básica si usa asignaciones en el servidor PI Data Archive
para proporcionar seguridad específica de usuario. Sin embargo, la autenticación Básica envía
las credenciales de usuario al servidor web en texto sin formato, por lo que también debe
configurar el sitio web de PI Vision para que use el acceso de capa de sockets seguros (SSL).
Para configurar la autenticación Básica, consulte Habilitar la autenticación básica.
• Los permisos para una delegación a un recurso de back-end están asociados a la identidad
de back-end, en lugar de la identidad de front-end.
• No se requieren privilegios de administrador de dominio.
• Funciona en límites de dominio y bosques.
La delegación restringida basada en recursos es una excelente opción para los administradores
que no son de TI. Permite que los administradores de PI controlen si los recursos como el PI
Data Archive y el servidor de PI AF reciben o no credenciales delegadas. Sin embargo, para que
la delegación restringida basada en recursos funcione, se deben implementar los siguientes
requisitos:
Nota:
Al configurar la delegación restringida basada en recursos, se establece un atributo en la
identidad del servicio de back-end que especifica qué identidades del servicio de front-
end tienen permiso de enviar credenciales delegadas. Para establecer este atributo,
utilice cmdlets de Active Directory en PowerShell. Estos cmdlets se pueden ejecutar en
cualquier equipo con la característica Remote Server Administration Tools (RSAT-AD-
PowerShell) instalada. El usuario que ejecuta los comandos necesita acceso de escritura a
los atributos del objeto de Active Directory de back-end.
Procedimiento
1. Obtenga las identidades de front-end y de back-end.
◦ Si el servicio se ejecuta en una cuenta de dominio, utilice Get-ADUser.
◦ Si se ejecuta en una cuenta del equipo, como el servicio de red o una cuenta virtual,
utilice Get-ADComputer.
El ejemplo que figura a continuación se aplica al servidor web de PI Vision que se ejecuta en
una cuenta de dominio pivision y al servidor PIAF01 de PI AF que se ejecuta en la cuenta
virtual predeterminada NT Service\AFService.
$frontendidentity = Get-ADUser -Identity PIVisionService
$backendidentity = Get-ADComputer -Identity PIAF01
2. Asigne la identidad de front-end a la propiedad
PrincipalsAllowedToDelegateToAccount de la identidad de back-end.
Set-ADComputer $backendidentity -PrincipalsAllowedToDelegateToAccount
$frontendidentity
3. Una vez que se complete la configuración, revise la propiedad
PrincipalsAllowedToDelegateToAccount actualizada de la identidad de back-end
para corroborar que se haya establecido correctamente.
Get-ADComputer $backendidentity -Properties
PrincipalsAllowedToDelegateToAccount
4. Puede activar varios principios para realizar delegaciones a la misma back-end al configurar
PrincipalsAllowedToDelegateToAccount con todas las identidades deseadas.
Set-ADComputer $backendidentity -PrincipalsAllowedToDelegateToAccount
$frontendidentity1, $frontendidentity2
El ejemplo que sigue a continuación incluye el parámetro del servidor para especificar un
controlador de dominio (DC) del dominio donde reside la identidad.
$frontendidentity = Get-ADUser -Identity pivision -Server DC01.picorp.int
Autenticación básica
OSIsoft le recomienda que habilite la delegación de Kerberos. Si su dominio no es compatible
con la delegación de Kerberos (por ejemplo, varios dominios en diferentes bosques), deberá
habilitar la autenticación Básica.
Con la autenticación Básica, PI Vision puede respetar la seguridad específica del usuario. Sin
embargo, la autenticación Básica envía las credenciales de usuario al servidor web en texto sin
formato, por lo que también debe configurar el sitio web de PI Vision para que use el acceso de
capa de sockets seguros (SSL).
Procedimiento
1. En el Administrador de Internet Information Services (IIS), seleccione la aplicación web
PI Vision y haga doble clic en el icono de Autenticación en la vista de las funciones.
2. Seleccione Basic Authentication y haga clic en el enlace Enable, situado en el panel derecho.
3. Para configurar dispositivos móviles para usar autenticación Básica:
a. Seleccione Windows Authentication.
b. Haga clic en el enlace Providers del panel derecho.
c. Elimine NTLM en la ventana que se abre.
4. Para configurar navegadores de escritorio para usar autenticación Básica:
a. Seleccione Autenticación de Windows y haga clic en el vínculo Desactivar, situado en el
panel derecho.
Nota:
Esto evitará que los navegadores de escritorio usen la autenticación de Windows.
Desinstalar
• Desinstale PI Vision
Para otorgar a un usuario acceso al sitio web de administración de PI Vision, añada la cuenta de
usuario al grupo PI Vision Admins y al grupo PI Web API Admins. Estos son grupos de
usuarios locales de Microsoft Windows en el servidor de aplicaciones de PI Vision. De forma
predeterminada, solo el usuario que está ejecutando la instalación es añadido a estos grupos.
Además de tener acceso al sitio web de administración de PI Vision, los usuarios del grupo PI
Vision Admins pueden llevar a cabo tareas restringidas en la aplicación principal de
PI Vision, como reasignar visualizaciones individuales a otro usuario.
Nota:
Si ejecuta el navegador de forma local en el servidor de aplicaciones de PI Vision, debe
ejecutarlo como administrador para que los cambios surtan efecto. Para configurar su
navegador como administrador, haga clic con el botón derecho del ratón sobre el icono de
acceso directo al navegador y seleccione Ejecutar como administrador.
Generar informes
PI Vision Los administradores pueden ver o exportar informes sobre el uso de PI Vision, como
los informes que incluyen información detallada sobre el contenido de las visualizaciones de su
base de datos.
Procedimiento
1. El sitio web de administración de PI Vision, haga clic en Informes en el árbol de navegación.
2. Si corresponde, seleccione un intervalo de tiempo para su informe.
3. Haga clic en Ver o en Exportar:
◦ Ver le muestra el informe en su navegador.
◦ Exportar guarda la información del informe en un archivo .csv.
En esta sección
• Permitir las características de la Vista preliminar técnica de comunidad (CTP)
• Configurar el acceso de usuario a la aplicación PI Vision
• Restablecer la configuración de usuario
• Administrar el nivel de acceso de usuario basado en roles
• Reasignar propiedad de visualización
• Cambiar servidor AF utilizado para almacenar identidades de AF
• Restringir el acceso de usuarios a las bases de datos de AF
• Establecer raíces de búsqueda de la base de datos de AF para restringir la búsqueda
• Configurar permisos para permitir que los usuarios anoten y acusen recibo de eventos
• Cambiar tipos y límites de tamaño de archivos de anotación de eventos
• Anulación de los ajustes de seguridad para los enlaces de navegación
Nota:
Si se conecta a PI Vision usando un alias o cualquier otro nombre que no sea el FQDN o el
nombre del equipo, deberán agregarse nombres adicionales al atributo CorsOrigins. El
protocolo (HTTP o HTTPS) debe coincidir con el enlace utilizado para obtener acceso a
PI Vision. OSIsoft recomienda enfáticamente los enlaces de HTTPS para PI Vision.
Antes de empezar
Se deben cumplir los siguientes requisitos previos para activar las características de XY Plot y
de Tabla de eventos:
• Debe activarse la delegación restringida entre el servidor de aplicación de PI Vision, PI Data
Archive y los servidores de PI AF.
• PI Vision y PI Web API deben tener un certificado de terceros o un certificado de dominio.
Nota:
Si PI Vision y PI Web API se configuran para ejecutarse en el mismo puerto, se puede
utilizar el mismo certificado.
• Para los navegadores del cliente, la configuración de seguridad de Internet debe realizarse
de la siguiente manera:
◦ Para Internet Explorer, es probable que deba configurar la opción “Acceder a las fuentes
de datos entre dominios” en “Activar”. Esta configuración es necesaria cuando se accede a
PI Vision mediante un nombre diferente de PI Web API, el cual generalmente utiliza el
nombre de dominio calificado completo (FQDN) del servidor web.
Nota:
Para cambiar las opciones de Internet, abra Internet Explorer y vaya a Opciones de
Internet >Seguridad>Intranet local>Personalizar nivel.... El cambio de las opciones de
Internet afecta a múltiples navegadores.
Procedimiento
1. Determine qué servidor de PI AF es el servidor predeterminado para el servidor de
aplicaciones de PI Vision.
a. Inicie PI System Explorer desde el servidor de aplicaciones de PI Vision.
b. En PI System Explorer, pulse el botón Base de datos para abrir la ventana Seleccionar
base de datos.
c. En la lista Servidor de activos, encuentre el servidor de PI AF predeterminado que tiene
un icono de marca de verificación negra y blanca junto al nombre.
2. Ejecute AFDiag.exe desde el servidor de PI AF para activar el indicador de características.
Procedimiento
1. Ejecute Administrador de Internet Information Services (IIS).
2. En Sitios, expanda el nodo del sitio web de PI Vision y seleccione PI Vision en la aplicación
web.
3. Haga doble clic en Ajustes de aplicaciones.
4. Haga clic con el botón secundario en el nombre de cualquier grupo y haga clic en Añadir.
5. En la ventana Añadir ajustes de aplicaciones, ingrese EnablePIVisionAuthorize en el
campo Nombre y true en el campo Valor.
Haga clic en Aceptar.
6. Haga clic con el botón secundario en el nombre de cualquier grupo y haga clic en Añadir.
7. En la ventana Añadir ajustes de aplicaciones, ingrese PIVisionAdmin en el campo Nombre y
su grupo de usuarios de dominio en el campo Valor.
Haga clic en Aceptar.
Procedimiento
1. En el sitio web de administración de PI Vision, haga clic en Ajustes del usuario en el árbol de
navegación.
2. Elija el usuario en el cuadro desplegable.
3. Haga clic en Borrar ajustes.
Procedimiento
1. En el sitio web de administración de PI Vision, haga clic en Niveles de acceso de usuario en
el árbol de navegación.
2. Si desea que todos los usuarios del grupo local de usuarios “PI Vision” de Microsoft
Windows tengan roles de Explorador, seleccione Miembros de grupo local “Usuarios de PI
Vision” tienen nivel de acceso de Editor.
3. Para asignar roles a grupos específicos de usuarios, seleccione Use AF Identity membership
to assign Publisher, Explorer access level (Utilizar membresía de identidad de AF para
asignar nivel de acceso de Editor y Explorador).
4. Elija una identidad de PI AF de la lista de identidades disponibles. Para asignar los
miembros de la identidad a un rol de Editor, haga clic en la flecha derecha junto al campo
Editores. Para asignar los miembros de la identidad a un rol de Explorador, haga clic en la
flecha derecha junto al campo Exploradores.
Después de que asigne la identidad seleccionada a un rol, puede seleccionar otra identidad y
asignarla a un rol.
5. Haga clic en Save.
Procedimiento
1. En el sitio web de administración de PI Vision, haga clic en Administración de
visualizaciones en el árbol de navegación.
2. En el campo De, seleccione el nombre del usuario del que desea reasignar la propiedad de
pantalla.
3. En el campo A, seleccione el nombre de usuario del nuevo propietario.
4. Marque la casilla Entiendo que esta operación no puede deshacerse.
5. Haga clic en Reasignar visualizaciones.
Nota:
En la página de inicio de la aplicación PI Vision, haga clic en el ícono de Ajustes y
Procedimiento
1. En Microsoft SQL Server Management Studio, conéctese a Microsoft SQL Server que
contiene su base de datos de PI Vision.
2. Expanda Bases de datos, seleccione su base de datos de PI Vision y expanda Tablas.
3. Busque la tabla dbo.Settings y haga clic con el botón secundario en ella; luego, haga clic en
Editar las primeras 200 filas.
4. En el campo Valor, configure DisplayGroupsServer con el nombre del servidor de PI AF
que se utilizará como proveedor de identidades.
Procedimiento
1. En el sitio web de administración de PI Vision, haga clic en Ajustes del usuario en el árbol de
navegación.
2. Seleccione la pestaña Restringir acceso a la base de datos.
3. En el menú desplegable, seleccione la base de datos de AF a la que desea restringir el acceso.
4. En la columna Usuario de la tabla Ruta de acceso raíz, seleccione la casilla de verificación
junto a cada usuario cuyo acceso a la base de datos de AF desea restringir.
Procedimiento
1. En el sitio web de administración de PI Vision, haga clic en Ajustes del usuario en el árbol de
navegación.
2. Seleccione la pestaña Establecer la raíz de búsqueda de la base de datos.
3. Use el menú desplegable para seleccionar una base de datos de AF. Se abre una tabla con el
árbol de la base de datos junto a una lista de usuarios.
4. En la columna Base de datos, haga clic en el triángulo junto a la base de datos para
desglosar la jerarquía de datos. Encuentre y seleccione el recurso que desee para
configurarlo como raíz de búsqueda.
5. En la columna Usuario de la tabla Ruta de acceso raíz, seleccione la casilla de verificación
junto a cada usuario para el que desee que el recurso seleccionado sea una raíz de
búsqueda.
Configurar permisos para permitir que los usuarios anoten y acusen recibo
de eventos
El administrador de PI debe definir permisos de seguridad para que los usuarios puedan
acusar recibo y anotar eventos en la pantalla Detalles del evento de PI Vision. Los permisos
pueden definirse en PI AF 2016 y versiones posteriores usando PI System Explorer. Los
permisos de acuse de recibo y anotaciones se definen por separado para cada plantilla de Event
Frame. Para definir los permisos de acuse de recibo, también debe definir permisos de
anotación.
Nota:
Para confirmar y anotar eventos, se requiere PI AF 2016. Se deben configurar la
delegación restringida de Kerberos o la autenticación básica entre el servidor de
aplicación de PI Vision y el servidor de PI AF. Consulte Habilitar delegación de Kerberos.
Nota:
Para obtener más información acerca de los permisos de seguridad de PI AF, y el acuse de
recibo y anotación de eventos, consulte PI System Explorer User Guide.
Procedimiento
1. En PI System Explorer, conéctese a la base de datos que contiene la plantilla de Event Frame
para la que desea definir permisos.
2. Diríjase a Biblioteca > Plantillas > Plantillas de Event Frame , busque su plantilla de event
frame en la lista y haga clic en ella.
3. Si quiere que los usuarios puedan acusar recibo del evento, seleccione la casilla de
verificación Permite acuse de recibo.
6. Para permitir que los usuarios acusen recibo o anoten el evento, seleccione la casilla de
verificación Anotar en la columna Permitir.
Nota:
Asegúrese de que la identidad World y la agrupación de aplicaciones de PI Vision
tengan permisos de Lectura de datos.
7. Haga clic en Aceptar una vez que se hayan definido todos los permisos de seguridad.
Procedimiento
1. Como administrador, abra un símbolo del sistema elevado de Windows y cambie el
directorio por \PIPC\AF.
Nota:
Para obtener más información acerca del uso de la utilidad de diagnóstico de PI AF,
consulte PI System Explorer User Guide.
2. Para cambiar los tipos de archivo predeterminados, use uno de los parámetros
FileExtensions:
◦ Para reemplazar la lista existente, use afdiag\FileExtensions\<File types>, donde
cada extensión de tipo de archivo está separada por dos puntos.
Ejemplo de reemplazo de la lista actual solo con archivos DOC y MP4: C:\Program
Files\PIPC\AF\FileExtensions:doc:mp4
◦
Para añadir una extensión de tipo de archivo adicional a la lista permitida existente, use
afdiag\FileExtensionsAdd:<File type>.
Ejemplo de adición de la extensión de archivo DOC a la lista permitida existente: C:
\Program Files\PIPC\AF\FileExtensionsAdd:doc
◦ Para eliminar una extensión de archivo de la lista permitida existente, use afdiag
\FileExtensionsRemove:<File type>.
Ejemplo de eliminación de la extensión de archivo TIFF de la lista permitida existente:C:
\Program Files\PIPC\AF\FileExtensionsRemove:tiff
3. Para cambiar el tamaño máximo de archivo, cambie el parámetro FileMaxLength
ingresando afdiag\FileMaxLength:<file size in MB> en el símbolo del sistema. El
valor entero se especifica en megabytes. Ejemplo de permiso de archivos de hasta 15 MB: C:
\Program Files\PIPC\AF\FileMaxLength:15
Nota:
Dado que un adjunto de archivo contiene codificación adicional que aumenta el
tamaño de la solicitud en el navegador, deberá incrementar los valores para
maxRequestLength y maxAllowedContentLength en aproximadamente 1.4 veces el
límite del tamaño de archivo, donde 1024 bytes = 1 kilobyte (KB). Por ejemplo, para
permitir adjuntos de archivo de hasta 15 MB, configure estos valores de la siguiente
manera:
◦ maxRequestLength = 15 360 (KB)
◦ maxAllowedContentLength = 15 728 640 (bytes)
6. Reinicie IIS para aplicar los cambios.
Procedimiento
1. Utilice un editor para abrir el archivo web.config en la carpeta de instalación raíz de
PI Vision.
2. Para activar el uso de otros protocolos, agregue la siguiente entrada al archivo web.config:
Por ejemplo, para permitir el uso del protocolo ftp:, el valor debería ser:
value="^\s*((https?:)|(ftp:)|(./#)|(./PB/#)|#)"/>
3. Para omitir todos los ajustes de seguridad del enlace de navegación, agregue la siguiente
entrada:
<add key="NavigationLinkSecurityOverride" value="true"/>
Antes de empezar
El usuario de Windows con una sesión actualmente iniciada debe tener acceso de
administrador a Microsoft SQL Server para poder completar este procedimiento.
El método que se muestra aquí solo es aplicable en las siguientes situaciones:
• La base de datos de PI Vision se encuentra en el servidor de aplicaciones de PI Vision.
• El usuario de Windows con una sesión actualmente iniciada está ejecutando la página de
administración de PI Vision en su navegador mientras está conectado al servidor web.
Si su configuración no cumple con estas condiciones, siga las instrucciones detalladas en
Creación manual de la base de datos de PI Vision.
Procedimiento
1. En la página Descripción general, haga clic en Administrar configuración junto a la tabla
Bases de datos de PI Vision. O bien, haga clic en Configuración en el árbol de navegación que
está a la izquierda y luego elija la pestaña Bases de datos de PI Vision.
2. Para cambiar la instancia de Microsoft SQL Server que aloja la base de datos de PI Vision,
haga clic en el botón desplegable que está junto al campo de SQL Server y seleccione el
servidor que desea, o escriba directamente el nombre en el cuadro, por ejemplo, .
\sqlexpress.
3. Escriba el nombre de la base de datos de PI Vision que desea usar en el campo Base de
datos o haga clic en el botón desplegable para elegir una base de datos existente.
Después de seleccionar una base de datos, PI Vision verifica si se puede utilizar como está o
si es necesario realizar una actualización.
Si introduce un nombre de base de datos nuevo y el usuario que ejecuta el sitio web de
administración tiene suficientes permisos para crear una base de datos en el Microsoft SQL
Server, se creará una nueva base de datos con dicho nombre.
Para crear una base de datos de PI Vision nueva, debe tener lo siguiente:
◦ El rol de servidor db_creator
◦ El permiso ALTER ANY LOGIN (lo que significa que ha obtenido este permiso mediante el
uso de la declaración GRANT ALTER ANY LOGIN TO "domain\account" o que
pertenece al rol de servidor securityadmin )
PI Vision se conecta a la base de datos especificada.
4. Haga clic en Guardar.
Contenido de BackupPIVision.sql
declare @DestFile varchar(128) = E:\Backups\PIVisionBackupDB.bak;
backup database PIVisionDB
to disk = @DestFile;
go
Debe tener el rol sysadmin, db_owner o db_backupoperator (el menor privilegio es la mejor
práctica de seguridad).
Procedimiento
1. En Microsoft SQL Server Management Studio, conéctese a Microsoft SQL Server que
contiene su base de datos de PI Vision.
2. Expanda Bases de datos, seleccione su base de datos de PI Vision y expanda Tablas.
3. Busque la tabla dbo.Settings y haga clic con el botón secundario en ella; luego, haga clic
en Editar las primeras 200 filas.
4. En el campo Valor, configure OverrideTimeZone a una de las ID de la zona horaria
indicadas en ID de zona horaria del sistema. Por ejemplo, para configurar la zona horaria de
PI Vision en hora estándar del Pacífico para todos los usuarios, agregaría Pacific
Standard Time a la tabla dbo.Settings.
Procedimiento
1. Utilice un editor para abrir el archivo web.config en la carpeta de instalación raíz de
PI Vision.
2. Localice la línea del elemento globalization. El valor predeterminado tiene la siguiente
apariencia:
<globalization culture="auto" uiCulture="auto" />
3. Modifique el valor culture según la opción de región en todo el sitio deseada:
<globalization culture="siteWideRegion" uiCulture="auto" />
donde siteWideRegion es el código de la región que corresponda. Para obtener una lista de
códigos, visite el sitio web de Microsoft Developer Network:http://msdn.microsoft.com/.
Por ejemplo, para ajustar PI Vision para que utilice el formato de regionalización de francés
(Canadá) para todos los usuarios, escriba lo siguiente:
<globalization culture="fr-CA" uiCulture="auto" />
Procedimiento
1. Navegue hasta %pihome64%\WebAPI para iniciar la utilidad administrativa PI Web API y
ejecute OSIsoft.REST.Admin.exe.
2. Siga las instrucciones del asistente utilizando las opciones existentes hasta llegar al módulo
Puerto de escucha. Especifique un puerto para PI Web API (como 8443) y haga clic en
Siguiente.
Nota:
Seleccione un puerto diferente del utilizado por el sitio web de PI Vision.
3. Si PI Web API es utilizado por PI Vision únicamente, haga clic en Siguiente sin seleccionar
un certificado en el módulo Certificado. Se creará y se utilizará un certificado autofirmado.
Si otras aplicaciones necesitan acceder a la PI Web API, puede seleccionar un certificado
para PI Web API haciendo clic en Seleccionar y, luego, en uno de los certificados que se
muestran.
Nota:
Si un certificado está seleccionado explícitamente en el módulo de certificados, no
seleccione el certificado utilizado por PI Vision o el certificado WMSVC.
4. Continúe con el resto de los módulos haciendo clic en Siguiente para conservar la
configuración actual.
Nota:
Si PI Web API o PI Web API Crawler se ejecutan como una cuenta de servicio de
dominio, será necesario volver a introducir las credenciales en los módulos
correspondientes.
5. En el módulo Revisar cambios, puede revisar la configuración para corroborar que se haya
especificado el nuevo puerto. Seleccione la casilla de verificación Aceptar y haga clic en
Siguiente para aplicar la configuración.
6. El módulo Confirmación indicará el estado de todas las acciones. Haga clic en Finalizar para
cerrar la utilidad.
Desinstalar PI Vision
Para desinstalar la aplicación PI Vision, inicie el applet Programas y características del Panel de
control, seleccione PI Coresight y luego seleccione Desinstalar. Si desea eliminar el PI Web API,
debe desinstalarse por separado.
En esta sección
• Requisitos de seguridad
• Copiar las visualizaciones de PI Vision y cambiar las fuentes de datos
• Eliminar las visualizaciones, reasignar los propietarios y cambiar la configuración de roles
Requisitos de seguridad
Estos son los ajustes mínimos de seguridad recomendados para la utilidad de visualización de
PI Vision:
Procedimiento
1. Ejecute la utilidad de pantalla de PI Vision ubicada en esta carpeta: Program Files\PIPC
\PI Vision\DisplayUtility.
2. En la pantalla de inicio, haga clic en Copy and Map Displays (Copiar y asignar pantallas).
3. En la pestaña de SQL Server, realice la siguiente tarea:
a. Ingrese el nombre de la conexión de origen (ruta de SQL Server) de la base de datos de
PI Vision desde la cual desea copiar las pantallas. Haga clic en Conectar. Seleccione el
nombre de su base de datos de la lista.
b. Ingrese el nombre de la conexión de destino (ruta de SQL Server) de la base de datos de
PI Vision desde la cual desea copiar o modificar las pantallas. Haga clic en Conectar.
Seleccione el nombre de su base de datos de la lista.
Nota:
La base de datos de destino debe existir antes de que ejecute la utilidad.
c. Si solo desea cambiar las fuentes de datos de las pantallas sin copiar las pantallas entre
los servidores, seleccione Edit displays without copying them to a different location
(Editar pantallas sin copiarlas a una ubicación diferente) e ingrese la conexión de origen
(ruta de SQL Server) y base de datos.
d. Haga clic en Siguiente.
Nota:
El nombre de servidor y la ruta deben escribirse de la siguiente manera:
[SQL Server]\[Instance name]
Ejemplo: MyServer\sqlexpress
Si se instala una instancia predeterminada de SQL Server, en lugar de la instancia
nombrada, el nombre y la ruta del servidor deberán escribirse de la siguiente
manera:
[SQL Server]
Ejemplo: MyServer
Nota:
Para obtener más información sobre cómo compartir visualizaciones en función de
identidades de PI AF, consulte el tema de la PI Vision Guía de usuario "Compartir una
visualización" in Live Library (https://livelibrary.osisoft.com).
Procedimiento
1. En la pantalla de inicio, haga clic en Manage Displays (Administrar pantallas).
2. En la pantalla Manage Displays (Administrar pantallas), ingrese el nombre de SQL Server de
origen de la base de datos de PI Vision que contiene las pantallas. Haga clic en Conectar.
3. Seleccione el nombre de su base de datos de la lista.
4. Encuentre y seleccione sus pantallas al ingresar el nombre o propietario, o al buscarlas en la
lista.
5. Para eliminar las pantallas seleccionadas, haga clic en el botón Eliminar.
6. Para reasignar las pantallas seleccionadas a un propietario diferente, haga clic en el botón
Change Owner (Cambiar propietario).
Cuando se le solicite, seleccione en la lista un propietario de la pantalla existente y haga clic
en Aplicar.
Nota:
Los propietarios que aparecen en la lista son aquellos que poseen, al menos, una
pantalla.
7. Para cambiar las identidades de PI AF relacionadas con las pantallas seleccionadas, haga clic
en Add or remove Identities (Agregar o eliminar identidades).
a. Encuentre y seleccione las identidades de PI AF deseadas al ingresar el nombre o
encontrarlas en la lista. Haga clic en Aplicar.
Las identidades de PI AF aparecen en la columna Display Identities (Mostrar identidades)
dentro de la tabla.
b. Para eliminar una identidad de PI AF de una pantalla seleccionada, haga clic en junto a
la identidad de PI AF en la columna Display Identities (Mostrar identidades).
c. Para eliminar una identidad de PI AF de todas las pantallas seleccionadas, haga clic con el
botón derecho en la identidad de PI AF, en la columna Display Identities (Mostrar
identidades) y, luego, haga clic en Delete from all display (Eliminar de todas las
visualizaciones).
En esta sección
• Rutas de URL básicas
• Referencia de parámetros URL
• Crear una nueva visualización (ad hoc) temporal con elementos de datos específicos
• Abrir una visualización guardada existente
• Aplicar el modo kiosko a una pantalla
• Reutilizar pantallas para activos creados a partir de la misma plantilla AF
• Especificar el elemento para las pantallas relativas a elementos de PI ProcessBook
• Cambiar la zona horaria para una visualización
• Ocultar la barra de herramientas o la barra de tiempo
• Evitar la redirección automática al sitio web móvil de PI Vision
Visualización de https://webserver/website/PB/#/PBDisplays/DisplayId/
PI ProcessBook
existente
Parámetro Descripción
Asset=<path> Configura una visualización existente para cambiar los recursos relacionados
que comparten la misma plantilla AF. Especifique los recursos añadiendo Asset
a la URL, seguido de la ruta del nuevo recurso.
Ruta para un elemento de datos en un servidor de PI AF:
\\ServerName\DatabaseName\ParentElement\ChildElement
Reglas de sintaxis:
• Varios recursos son delimitados por punto y coma. Se debe proporcionar
una ruta de servidor completa para cada recurso.
Ejemplo:
https://webserver/website/#/Displays/15914/BoilerInformation?
Asset=\\AFServer1\Houston\CrackingProcess\Equipment\Boiler309
Parámetro Descripción
CurrentElement=<p Especifica el elemento para las pantallas relativas a elementos de PI
ath> ProcessBook (ERD) vistas en PI Vision.
Ejemplo:
https://webserver/website/#/PBDisplays/15914?CurrentElement=\
\AFServer1\DB1\CrackingProcess\Boiler202
Mode=kiosk Crea una visualización de solo lectura con interactividad limitada. En el modo
kiosko, el usuario no puede buscar datos ni guardar la visualización.
https://webserver/website/#/Displays/3117/PowerAnalysis?
mode=kiosk
Parámetro Descripción
StartTime=<PI Especifica la hora de inicio de una visualización.
time>
Ejemplo:
https://webserver/website/#/Displays/AdHoc?DataItems=\
\AFserver1\Houston\B-210&StartTime=25-sep-12&EndTime=27-sep-12
Symbol=<symbol Especifica qué tipo de símbolo aparecerá en una visualización "ad hoc". Una
type> tendencia es el tipo de símbolo predeterminado para una visualización
temporal (ad hoc). Para cambiar el tipo de símbolo a una tabla, use el parámetro
Symbol=table.
Ejemplo:
https://webserver/website/#/Displays/AdHoc?DataItems=\
\AFserver1\Houston\B-210|Temperature&Symbol=table
TZ=<UTC +/- Especifica la compensación horaria de Hora UTC (Hora universal coordinada)
hours> para que los usuarios vean los datos en la zona horaria que especificaron. El
parámetro TZ también puede especificar los nombres de zonas horarias de
Windows o IANA.
Sintaxis:
• No puede haber espacios en la especificación de la compensación de la zona
horaria.
• La compensación puede ser positiva o negativa. Para aplicar una
compensación positiva, debe codificar el signo + (más) como %2B.
• Puede introducir la compensación horaria en cualquiera de los siguientes
formatos: H:MM o HH:MM.
Ejemplo:
https://webserver/website/#//Displays/3117/PowerAnalysis?
tz=UTC-5:00
Ejemplos
• La siguiente URL crea una pantalla temporal con una tendencia que contiene un solo
atributo (Fuel) a partir del activo B-210.
Los atributos se delimitan mediante el carácter de barra vertical (|). No se especifica una
hora de inicio ni tampoco de finalización, por lo que a la pantalla se aplica el intervalo de
tiempo predeterminado.
https://webserver/website/#/Displays/AdHoc?DataItems=\\EastCoast\HiEfficiency
\B-210|Fuel
• La siguiente URL crea una visualización temporal con un único activo (B-210) en un
intervalo de tiempo especificado.
De esta forma, se mostrarán los datos de todos los atributos del activo B-210 en la tendencia
de la se aplica temporal durante el intervalo de tiempo que va desde la medianoche del 25
de septiembre de 2012 a la medianoche del 27 de septiembre de 2012.
https://webserver/website/#/Displays/AdHoc?DataItems=\\EastCoast\HiEfficiency
\B-210&StartTime=25-sep-12&EndTime=27-sep-12
• Varios elementos de datos, delimitados por punto y coma.
Tenga en cuenta que es necesario especificar todos los atributos del mismo activo
(Temperature y Fuel). No se especifica una hora de inicio ni tampoco de finalización, por lo
que a la pantalla se aplica el intervalo de tiempo predeterminado.
https://webserver/website/#/Displays/AdHoc?DataItems=\\afserver
\B-210|Temperature;\\piserver\aPIPoint
Ejemplos de PI Vision
• La siguiente URL abre la visualización PI Vision 3117 guardada (denominada
PowerAnalysis). Dado que no se ha especificado ningún intervalo de tiempo, la pantalla se
abrirá con el de la pantalla guardada.
https://webserver/website/#/Displays/3117/PowerAnalysis
• Esta URL abre la visualización de PI Vision guardada 3117 (denominada PowerAnalysis)
con el intervalo de tiempo desde la medianoche del 25 de septiembre de 2012 hasta la
medianoche del 27 de septiembre de 2012.
https://webserver/website/#/Displays/3117/PowerAnalysis?mode=kiosk
&StartTime=25-sep-12&EndTime=27-sep-12
Ejemplos de PI ProcessBook
En estos ejemplos, se supone que la carpeta de importación está en \\fileServer\Imports y
que el servidor de PI Vision está en https://webServer/PIVision.
• Si la ruta al archivo de la pantalla de PI ProcessBook es \\fileServer\Imports
\Kamyr.pdi, lo puede abrir mediante el uso de la siguiente URL:
https://webServer/PIVision/#/PBDisplayName/Kamyr
• Si la ruta al archivo de la pantalla de PI ProcessBook es \\fileServer\Imports\Dealer
\Customer2\ChemicalPlant\DistillationProcess.svg, lo puede abrir mediante el
uso de la siguiente URL:
https://webServer/PIVision/#/PBDisplayName/Dealer
/Customer2/ChemicalPlant/DistillationProcess
Nota:
No incluya \\fileServer\Imports en la URL para la pantalla de PI ProcessBook.
Ejemplos
• La siguiente URL crea una pantalla temporal en modo kiosko.
La pantalla mostrará una tendencia que contiene un solo atributo (Fuel) del activo B-210
durante el intervalo de tiempo que va desde la medianoche del 25 de septiembre de 2012 a
la medianoche del 27 de septiembre de 2012.
https://webserver/website/#/Displays/AdHoc?DataItems=\\EastCoast\HiEfficiency\
B-210|Fuel&StartTime=25-sep-12&EndTime=27-sep-12&mode=kiosk
• Esta URL abre la pantalla guardada 3117 (denominada PowerAnalysis) en modo kiosko.
Dado que no se ha especificado ningún intervalo de tiempo, la pantalla se abrirá con el de la
pantalla guardada.
https://webserver/website/#/Displays/3117/PowerAnalysis?mode=kiosk
Procedimiento
1. Obtenga las rutas de los activos que desee utilizar para sustituir los activos existentes en la
pantalla.
Podrá encontrar estas rutas en los resultados de búsqueda de PI Vision o en PI System
Explorer.
2. Especifique los activos relacionados actualizando la URL de pantalla existente. Añada la
cadena ?Asset seguida de la ruta al nuevo activo. Separe distintas rutas de activo con un
punto y coma (;).
Ejemplo
En el siguiente ejemplo, una visualización de PI Vision denominada “BoilerFanInformation”
contiene dos símbolos de tabla: uno muestra información sobre una caldera y el otro, sobre un
ventilador.
El activo de caldera de la pantalla se creó a partir de una plantilla de elementos AF de tipo
Boiler y el activo de ventilador se creó a partir de una plantilla de elementos AF de tipo Fan.
Un ingeniero desea utilizar esta pantalla para mostrar información sobre otra caldera y otro
ventilador, que se crearon a partir de las mismas plantillas. La pantalla "BoilerFanInformation"
original tiene la URL: https://PIVisionServ/Displays/15914/BoilerFanInformation
Para ver información sobre otra caldera y otro ventilador en esta pantalla, siga estos pasos:
1. En PI System Explorer, identifique las rutas a los activos de interés de AF.
2. Añada la siguiente cadena a la URL de pantalla "BoilerFanInformation":
?Asset=\\AFServer1\DB1\CrackingProcess\Equipment\Boiler309;\\AFServer1\DB1\
Cracking Process\Equipment\Fan486
Ahora, las tablas de la pantalla mostrarán información del activo de caldera para
Boiler309 e información del activo de ventilador para Fan486.
Nota:
No tiene que especificar un activo para cada plantilla. Por ejemplo, puede especificar
solo un ventilador en la URL y no especificar una caldera. En ese caso, se utilizará la
caldera predeterminada que está asociada con la pantalla.
Procedimiento
• Añada ?CurrentElement a la URL, seguido de la ruta al elemento del que quiere mostrar
datos.
La sintaxis de ruta de acceso relativa de elementos de PI AF es compatible.
Por ejemplo, cada una de las siguientes URL muestra datos de un elemento diferente en la ERD
identificada como 15914:
https://PIVisionServ/PIVision/#/PBDisplays/15914?CurrentElement=
\\AFServer1\DB1\CrackingProcess\Boiler202
https://PIVisionServ/PIVision/#/PBDisplays/15914?CurrentElement=
\\AFServer1\DB1\CrackingProcess\Boiler209
Procedimiento
• Añada el parámetro TZ a la URL. Por ejemplo:
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
Sintaxis y ejemplos
No puede haber espacios en la especificación de la compensación de la zona horaria, por
ejemplo: TZ=UTC-3:00.
Puede introducir la compensación horaria en cualquiera de los siguientes formatos:
• H:MM o HH:MM
Por ejemplo: TZ=UTC-5:05
Si especifica minutos, debe usar dos dígitos precedidos por : (dos puntos). Los valores para
los minutos pueden variar entre 00 y 59. Por ejemplo:
tz=utc%2B8:05
• +n o -n horas. Los valores para las horas (n) pueden variar entre 1 y 13.
Por ejemplo: tz=Utc-1
Nota:
En los navegadores Mozilla Firefox, el formato UTC+H puede fallar, porque el signo +
(más) no se transmite adecuadamente (ya sea que se codifique o no como %2B).
Las especificaciones no válidas hacen que la pantalla vuelva a la zona horaria del cliente.
Procedimiento
• Para ocultar la barra de herramientas, añada el parámetro ?HideToolbar a la URL. Por
ejemplo:
https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?HideToolbar
Procedimiento
• Para anular este comportamiento predeterminado, añada redirect=false a la URL de
PI Vision.
Este parámetro hace que el usuario vea la aplicación web PI Vision completa,
independientemente del tamaño de la ventana.
Ejemplo
La siguiente URL abre la visualización guardada 3117 (denominada PowerAnalysis) en la
aplicación web PI Vision completa, incluso cuando se obtiene acceso a esta desde ventanas de
navegadores o dispositivos más pequeños.
http://webserver/website/#/Displays/3117/PowerAnalysis?redirect=false
En la siguiente tabla se resumen las ventajas y las desventajas de cada opción de HA de SQL
Server.
las desventajas para estos escenarios, consulte el artículo de Microsoft IIS Achieving High
Availability and Scalability - ARR and NLB (https://www.iis.net/learn/extensions/configuring-
application-request-routing-arr/achieving-high-availability-and-scalability-arr-and-nlb)
(Cómo lograr alta disponibilidad y escalabilidad: ARR y NLB).
En la siguiente tabla, se resumen las ventajas y las desventajas de cada opción de HA del
servidor de aplicaciones de PI Vision.
Opciones de HA del servidor de Ventajas Desventajas
aplicaciones de PI Vision
Enrutamiento de solicitud de • Divide la carga de acceso a los • No proporciona HA
aplicaciones (ARR) datos en el servidor de verdadera, porque el nodo
aplicaciones. ARR permanece como un
• Hay otras funciones único punto de error.
disponibles que permiten que • La escalabilidad es limitada,
ARR actúe como un proxy porque el tráfico está
inverso, si se desea. canalizado a través de un solo
nodo.
Equilibrio de carga de red (NLB) • Divide la carga de acceso a los
datos en el servidor de
aplicaciones.
NLB y ARR (activo/pasivo) • Proporciona HA verdadera, • Se requiere una inversión
dado que no hay un único más grande, en términos de
punto de error. configuración y cantidad de
• Hay otras funciones equipos disponibles
disponibles que permiten que requerida.
ARR actúe como un proxy
inverso, si se desea.
NLB y ARR (activo/activo) • Proporciona HA verdadera,
dado que no hay un único
punto de error.
• Proporciona escalabilidad
verdadera, dado que el tráfico
no está canalizado a través de
un solo nodo.
• Hay otras funciones
disponibles que permiten que
ARR actúe como un proxy
inverso, si se desea.
Para obtener más información, consulte el tema del servidor de PI en "Administración de la alta
disponibilidad del sistema PI" in Live Library (https://livelibrary.osisoft.com).
▪ Admin
▪ Operativo
◦ OSIsoft-PISymbols
Incluye mensajes de búsqueda y recuperación de datos (incluidos todos los mensajes del
sitio web de administración y de los servicios de monitoreo de archivos).
▪ Admin
▪ Operativo
◦ OSIsoft-PISystemSearch
Incluye mensajes relacionados con el rastreador de PI Web API y las consultas de
búsqueda de PI Web API.
▪ Admin
▪ Operativo
◦ OSIsoft-Search
Incluye mensajes relacionados con las búsquedas realizadas por PI Vision.
▪ Admin
3. También puede crear una vista personalizada para ver todos estos eventos en un único
lugar:
a. Haga clic con el botón derecho del ratón en la fila Custom Views en el panel izquierdo del
Visualizador de eventos de Windows y seleccione Create Custom View.
b. Asigne un nombre a la vista; por ejemplo, Eventos de PI Vision.
c. Seleccione la pestaña XML.
d. Seleccione Editar consulta manualmente y añada el siguiente texto:
<QueryList>
<Query Id="0" Path="OSIsoft-PIDataServices/Admin">
<Select Path="OSIsoft-PIDataServices/Admin">*</Select>
<Select Path="OSIsoft-PIDataServices/Operational">*</Select>
<Select Path="OSIsoft-PISymbols/Admin">*</Select>
<Select Path="OSIsoft-PISymbols/Operational">*</Select>
<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>
El valor es una vez en minutos. Por lo tanto, la siguiente línea establecerá el límite de mensajes
en diez minutos:
<add key="ErrorSuppressionTime" value="10" />