PI Data Archive 2018 System Management Guide ES

PI Data Archive 2018
Guía de administración del sistema

OSIsoft, LLC
1600 Alvarado Street
San Leandro, CA 94577 EE. UU.
Tel.: (01) 510-297-5800
Fax: (01) 510-357-8136
Web: http://www.osisoft.com
Guía de administrador del sistema PI Data Archive 2018

© 2009-2018 by OSIsoft, LLC. Todos los derechos reservados.
Ninguna parte de esta publicación puede ser reproducida, almacenada en un sistema de recuperación o
transmitida, de ninguna forma ni por ningun medio, mecanicó, fotocopiado, grabado o de cualquier otro
modo, sin el consentimiento previo por escrito de OSIsoft, LLC.
OSIsoft, el logotipo de OSIsoft, Managed PI, OSIsoft Advanced Services, OSIsoft Cloud Services, OSIsoft
Connected Services, PI ACE, PI Advanced Computing Engine, PI AF SDK, PI API, PI Asset Framework, PI
Audit Viewer, PI Builder, PI Cloud Connect, PI Connectors, PI Data Archive, PI DataLink, PI DataLink Server,
PI Developers Club, PI Integrator for Business Analytics, PI Interfaces, PI JDBC Driver, PI Manual Logger, PI
Nótificatións, PI ODBC Driver, PI OLEDB Enterprise, PI OLEDB Provider, PI OPC DA Server, PI OPC HDA
Server, PI ProcessBook, PI SDK, PI Server, PI Square, PI System, PI System Access, PI Vision, PI
Visualization Suite, PI Web API, PI WebParts, PI Web Services, RLINK y RtReports son marcas comerciales
de OSIsoft, LLC. Todas las demas marcas y nombres comerciales aquí utilizados son propiedad de sus
respectivos propietarios.
DERECHOS DEL GOBIERNO DE LOS EE. UU.
Su uso, replica o difusión por parte del Gobierno de EE.UU. esta sujeto a las restricciones estipuladas en el
contrato de licencia de OSIsoft, LLC, de acuerdo con lo que establecen las regulaciones DFARS 227.7202,
DFARS 252.227-7013, FAR 12.212, FAR 52.227, segun proceda. OSIsoft, LLC.
Versión: 3.4.420
Publicación: 30 de mayo de 2018
Contenido
Introducción a la administración del sistema PI Data Archive.................................... 1

Descripción general de PI System..............................................................................................................1
Estructura del directorio de PI Data Archive.............................................................................................. 2
Prácticas recomendadas del sistema de archivos de PI Data Archive......................................................... 3
Subsistemas de PI Data Archive................................................................................................................ 3
Herramientas para la administración de PI Server.................................................... 7
Descarga de PI SDK............................................................................................... 9
Flujo de datos de PI Data Archive..........................................................................11

Informe de excepciones.......................................................................................................................... 12
Desactivar el informe de excepciones.................................................................................................. 13
Snapshot................................................................................................................................................. 13
Prueba de compresión............................................................................................................................ 14
Directrices relativas a la compresión.................................................................................................... 15
Cola de eventos.......................................................................................................................................16
Iniciar y detener PI Data Archive........................................................................... 17

Iniciar PI Data Archive ............................................................................................................................. 17
Iniciar PI Data Archive como un servicio de Windows........................................................................... 17
Configurar el inicio automático de los servicios.................................................................................... 17
Verificación del inicio...........................................................................................................................18
Iniciar PI Data Archive en modo interactivo (de resolución de problemas)............................................18
Detener PI Data Archive.......................................................................................................................... 18
Detener servicios de Windows.............................................................................................................19
Cambiar la hora de espera para el cierre.............................................................................................. 19
Detener modo interactivo................................................................................................................... 19
Eventos de cierre.................................................................................................................................... 20
Configurar eventos de cierre para puntos específicos.......................................................................... 20
Especificaciones y consideraciones de hora............................................................23

Tiempo PI................................................................................................................................................23
Abreviaturas de tiempo PI................................................................................................................... 23
Expresiones de tiempo PI.................................................................................................................... 24
Especificación de intervalos de tiempo................................................................................................ 24
Especificación de intervalos de tiempo................................................................................................ 25
Mostrar información sobre la zona horaria.............................................................................................. 26
Información sobre zona horaria y reglas de transición al horario de verano......................................... 26
Opciones de visualización de la zona horaria para pidiag -tz................................................................ 27
Mostrar la hora local y la hora UTC.......................................................................................................27
Mostrar una zona horaria diferente..................................................................................................... 28
Personalizar los cambios del horario estándar y el horario de verano...................................................28
Determinar si una cadena de hora es ambigua.................................................................................... 28
Especificar zonas horarias................................................................................................................... 29
Traducir formatos de hora.......................................................................................................................29
Salida de ejemplo de cadena para formato de entero.......................................................................... 29
Salida de ejemplo de cadena para formato de entero.......................................................................... 30
Copias de seguridad de PI Data Archive................................................................. 31

Configuración de la copia de seguridad programada de PI Data Archive.................................................. 31
Guía de administrador del sistema PI Data Archive 2018 iii

Contenido
Configuración del disco recomendada para las copias de seguridad de PI Data Archive....................... 32
Configurar la copia de seguridad programada de PI Data Archive........................................................ 33
Colectivos y copias de seguridad de PI Data Archive............................................................................ 38
Ver el historial de copias de seguridad de un servidor de PI Data Archive.................................................39
Tipos de copia de seguridad de PI Data Archive...................................................................................40
Cambio de la cantidad de copias de seguridad que se muestran en la tabla Backup History.................40
Ver resumen de la información sobre la copia de seguridad................................................................. 41
Ver detalles de las copias de seguridad................................................................................................ 41
Resolución de problemas de las copias de seguridad de PI Data Archive..................................................43
Ver mensajes y registros de copias de seguridad de PI Data Archive.................................................... 44
Problemas comunes con las copias de seguridad.................................................................................44
Error en la copia de seguridad de PI Data Archive debido a subsistema desconectado.........................45
Realizar una copia de seguridad de PI Data Archive a pedido...............................................................45
Exportar el historial de copias de seguridad de PI Data Archive........................................................... 46
Scripts de copia de seguridad de PI Data Archive.................................................................................... 46
pibackuptask.bat.................................................................................................................................47
pibackup.bat....................................................................................................................................... 47
pisitebackup.bat................................................................................................................................. 48
pintbackup_3.4.370.bat....................................................................................................................... 48
afbackup.bat....................................................................................................................................... 48
Cómo funciona la verificación de copia de seguridad de PI Data Archive................................................. 49
Restaurar PI Data Archive a partir de una copia de seguridad.................................................................. 50
Restaurar una copia de seguridad en un servidor de PI Data Archive existente.....................................50
Restaurar una copia de seguridad de PI Data Archive en un equipo nuevo........................................... 52
PI points............................................................................................................. 55
Distinción entre mayúsculas y minúsculas............................................................................................... 55
Clases y atributos de punto..................................................................................................................... 55
Clases de punto predefinidas...............................................................................................................56
Conjuntos de atributos predefinidos.................................................................................................... 57
Atributos del punto de clase Base........................................................................................................60
Atributos de clases de puntos clásicos................................................................................................. 70
Atributos de punto de conectores COM............................................................................................... 72
Atributos integrados............................................................................................................................73
Atributos asignados por el sistema...................................................................................................... 73
Búsqueda de puntos defectuosos............................................................................................................ 74
Creación de puntos..................................................................................................................................75
Eliminar y retirar puntos.......................................................................................................................... 75
Retirada de un punto con Point Builder................................................................................................ 75
Retirada de varios puntos con PI Builder.............................................................................................. 75
Cambiar tipo de PI point..........................................................................................................................76
Conversiones de tipos de puntos permitidas........................................................................................76
Cambios en el tipo de punto y archivos históricos................................................................................ 77
Configurar el control de errores........................................................................................................... 77
Modificación de clases de PI point........................................................................................................... 78
Permisos de acceso requeridos y otras restricciones............................................................................ 78
Edición de la base de datos de las clases de puntos..............................................................................79
Editar la clase de punto de un punto.................................................................................................... 82
Auditoría de la base de datos de puntos.............................................................................................. 83
Conjuntos de estados digitales................................................................................................................ 83
Convenciones de nombres de estados digitales...................................................................................84
Conjunto predeterminado: conjunto de estados del sistema............................................................... 84
Definir un conjunto de estados digitales.............................................................................................. 84
Archivos históricos.............................................................................................. 87
Ficheros de archivado..............................................................................................................................87
Ficheros de archivado primarios.......................................................................................................... 87
iv Guía de administrador del sistema PI Data Archive 2018

Contenido
Registros de archivos históricos...........................................................................................................88

Registros de índice.............................................................................................................................. 88
Archivos históricos fijos y dinámicos................................................................................................... 88
Administración de archivos históricos..................................................................................................... 89
Herramientas de administración de archivos históricos....................................................................... 90
Ubicación de los ficheros de archivado................................................................................................ 90
Prevención de pérdida de datos de archivo histórico........................................................................... 91
Restablecimiento automático de la cola de eventos............................................................................ 91
Creación de archivos históricos con PI SMT......................................................................................... 92
Tamaño del archivo histórico...............................................................................................................94
Registro de archivos históricos............................................................................................................ 95
Intercambios de archivos históricos..................................................................................................... 97
Arranque y detención de interfaces................................................................................................... 102
Annotations.......................................................................................................................................103
Administración de vacíos de archivos históricos.................................................................................105
Reprocesamiento de archivos históricos............................................................................................ 106
Configurar el número de archivos históricos supervisados en busca de errores de lectura y escritura. 109
Evitar cambios en los archivos históricos........................................................................................... 109
Exportar una lista de archivos históricos a un archivo......................................................................... 110
Crear un archivo de registro .bat ........................................................................................................111
Mover ficheros de archivado.............................................................................................................. 111
Eliminar un evento de archivo histórico..............................................................................................112
Eliminar un archivo histórico.............................................................................................................. 113
Verificar archivos dañados..................................................................................................................113
Administración de la reposición............................................................................................................. 114
Prácticas recomendadas para la reposición........................................................................................114
Preparar PI Data Archive para la reposición de datos......................................................................... 114
Reponer un archivo histórico nuevo................................................................................................... 115
Reponer archivos históricos existentes con datos de PI points nuevos................................................116
Borrar el snapshot Pt Created............................................................................................................ 117
Reponer datos con un script de piconfig............................................................................................. 117
Administración de ficheros de archivado desconectados con piarchss................................................... 118
Consejos para utilizar la herramienta de archivo desconectado..........................................................119
Mostrar información de archivo histórico no registrado..................................................................... 120
Opciones de línea de comandos de la utilidad de archivo desconectado............................................ 120
Ejecutar la herramienta de archivo desconectado.............................................................................. 122
Intervalos de tiempo.......................................................................................................................... 123
Compensaciones para marcas de tiempo de eventos (-tfix -tfixend)...................................................125
Fusionar o dividir archivos históricos................................................................................................. 126
Seguridad de PI Data Archive............................................................................. 129

Descripción general de la seguridad...................................................................................................... 129
Administración de la autenticación....................................................................................................... 129
Administración de la autenticación con la seguridad de Windows...................................................... 130
Administración de la autenticación de interfaces con PI trusts........................................................... 133
Administrar cuentas de usuario y grupos de PI Data Archive.............................................................. 136
Administración de la autorización.......................................................................................................... 137
Descripción de los permisos de acceso antiguos y nuevos.................................................................. 137
Dónde establecer permisos de acceso................................................................................................139
Establecimiento de permisos de acceso.............................................................................................142
Aumento de la seguridad...................................................................................................................... 144
Protección de la cuenta piadmin........................................................................................................144
Contraseñas obligatorias en todas las cuentas de usuario.................................................................. 145
Descativar todos los inicios de sesión explícitos en PI Data Archive....................................................145
Desactivar inicios de sesión explícitos para cuentas de usuario individuales....................................... 145
Datos futuros.................................................................................................... 147
Guía de administrador del sistema PI Data Archive 2018 v

Contenido
Productos que admiten datos futuros....................................................................................................148

PI points futuros.................................................................................................................................... 148
Restricciones con PI points futuros.....................................................................................................150
Archivos futuros.................................................................................................................................... 150
Análisis con datos futuros...................................................................................................................... 151
Casos de uso y ejemplos........................................................................................................................ 152
Ejemplo del tiempo: procedimiento de alto nivel................................................................................... 152
Ejemplo del tiempo: verificare la instalación de PI Server................................................................... 153
Ejemplo del tiempo: crear y rellenar PI points con datos sobre el tiempo........................................... 153
Ejemplo del tiempo: crear elementos y atributos de PI AF................................................................. 154
Ejemplo del tiempo: crear tendencias y analizar datos....................................................................... 155
PI interfaces...................................................................................................... 157
Utilidades de PI interface.......................................................................................................................158
Estructura de la interfaz UniInt.......................................................................................................... 158
PI API.................................................................................................................................................158
PI SDK............................................................................................................................................... 158
Interfaces incluidas con PI Data Archive................................................................................................ 159
Configuración de puntos en la interfaz Ramp Soak............................................................................ 160
Configuración de puntos en interfaz Random.................................................................................... 161
Instalación de la interfaz........................................................................................................................164
Instalación de una interfaz: pasos generales...................................................................................... 164
Características de interfaz avanzadas (opcional)................................................................................ 165
Diagnóstico de interfaz (opcional)..................................................................................................... 166
Mantenimiento de la interfaz................................................................................................................ 166
Arranque y detención de interfaces....................................................................................................167
Configuración de interfaces............................................................................................................... 167
Monitorización del rendimiento de la PI interface.............................................................................. 170
Administración de equipos de fuentes de datos................................................................................. 171
Documentación adicional sobre las interfaces........................................................................................172
Supervisión de PI Data Archive............................................................................175

Supervisión de los contadores de rendimiento de Windows................................................................... 175
Qué contadores de rendimiento supervisar........................................................................................ 175
Configuración de la interfaz PIPerfmon.............................................................................................. 178
Creación de puntos de monitorización de rendimiento...................................................................... 178
Utilizar una tendencia para supervisar los puntos de rendimiento...................................................... 179
Mensajes de PI System..........................................................................................................................180
Ver mensajes de PI Data Archive con PI SMT..................................................................................... 180
Ver mensajes en el registro de eventos de Windows.......................................................................... 181
Estructura de mensaje....................................................................................................................... 181
Niveles de gravedad.......................................................................................................................... 182
Archivo de definición de mensajes de PI............................................................................................ 182
Interpretar códigos de error............................................................................................................... 182
Verificaciones de estado del subsistema (mensajes de error de RPC resolver).................................... 183
Convención de nomenclatura de archivos de registro........................................................................ 183
Verificación de estado diaria de PI Data Archive ....................................................................................183
Historial de conexión............................................................................................................................. 185
Administre la fragmentación de los archivos de PI Data Archive............................................................186
Parámetros de ajuste de PI Data Archive............................................................. 187

Parámetros de ajuste que pueden configurarse..................................................................................... 187
Editar parámetros de ajuste...................................................................................................................187
Agregar un parámetro de ajuste a la lista...............................................................................................188
PI SQL Subsystem............................................................................................. 189

Arquitectura de PI SQL Subsystem........................................................................................................189
vi Guía de administrador del sistema PI Data Archive 2018

Contenido
Configuración de PI SQL Subsystem..................................................................................................... 190

Jerarquía de la configuración de PI SQL Subsystem........................................................................... 190
Configuración del archivo de inicialización.........................................................................................190
pisqlss................................................................................................................................................191
Resolución de problemas de PI SQL Subsystem.................................................................................... 192
Archivos de seguimiento de PI SQL................................................................................................... 193
Borrar problemas de consulta costosos............................................................................................. 194
Contadores de rendimiento............................................................................................................... 195
Plan de recuperación por cierre o corte de energía inesperado de PI System..................................... 195
Informes de problemas y soporte técnico.......................................................................................... 195
Recuperación de datos con fuentes de datos externas.......................................... 197

Configuración de punto......................................................................................................................... 198
Recuperación de datos de snapshot...................................................................................................... 198
Recuperación de datos de archivos históricos........................................................................................199
Ficheros de archivado........................................................................................................................... 200
Actualizaciones de Snapshot.................................................................................................................200
Compresión.......................................................................................................................................... 200
Seguridad de punto............................................................................................................................... 201
Resolución de problemas.................................................................................... 203

Lista de verificación para la resolución de problemas.............................................................................203
Tareas generales de resolución de problemas........................................................................................206
Verificación de que los procesos de PI Data Archive se estén ejecutando........................................... 206
Verificación de conexión....................................................................................................................208
Problemas específicos...........................................................................................................................209
Tendencias con líneas delgadas en PI ProcessBook............................................................................209
Problemas con los conectores COM...................................................................................................210
Límite de actualización pendiente..................................................................................................... 216
Reparaciones..................................................................................................... 217
Reparación del archivo de datos de Archive Manager............................................................................ 217
Daños en los ficheros de archivado........................................................................................................ 218
Recuperación de un archivo que no es primario................................................................................. 218
Recuperar un archivo primario........................................................................................................... 218
Corrección de marcas de tiempo de eventos de archivo.........................................................................219
Formato de archivos de conversión de hora....................................................................................... 220
Recuperación de snapshots................................................................................................................... 220
Recuperarse de horas futuras en la snapshot..................................................................................... 221
Reconstruir el archivo de snapshot.....................................................................................................221
Eliminación de snapshots del futuro...................................................................................................223
Reparación de bases de datos................................................................................................................223
Reparar la PI Module Database..........................................................................................................224
Diagnosticar y reparar archivos de bases de datos de PI Data Archive................................................... 224
Haga una lista del encabezado y del índice........................................................................................ 224
Comprimir archivo de base de un archivo...........................................................................................225
Recuperar un fichero basado en archivo.............................................................................................225
Recuperarse de un cambio accidental de la hora del sistema................................................................. 226
Recuperarse del cambio de hora accidental en el nodo interfaz que utiliza PI Buffer Subsystem........ 228
Soporte técnico y otros recursos......................................................................... 229
Guía de administrador del sistema PI Data Archive 2018 vii

Contenido
viii Guía de administrador del sistema PI Data Archive 2018

Introducción a la administración del sistema PI
Data Archive
En esta sección
• Descripción general de PI System
• Estructura del directorio de PI Data Archive
• Practicas recomendadas del sistema de archivos de PI Data Archive
• Subsistemas de PI Data Archive
Descripción general de PI System

PI System recopila, almacena y administra los datos de su planta o proceso. PI System incluye
los siguientes tipos de productos.
Nota:
Hay disponibles muchos videos introductorios y de capacitación en el canal de YouTube
de OSIsoftLearning (https://www.youtube.com/user/OSIsoftLearning).
• Fuentes de datos
Las fuentes de datos son los instrumentos que generan datos. Pueden conectarse a los nodos
de interfaz de diversas maneras. PI Performance Equations, PI ACE y Totalizer tambien se
consideran fuentes de datos, aunque pueden estar alojados en PI Server.
• Interfaces y conectores
Las PI interfaces obtienen datos de las fuentes de datos externas y los envían a PI Server.
Cada fuente de datos precisa una PI interface que pueda interpretarla. OSIsoft ofrece mas de
400 interfaces.
De manera similar a PI interfaces, PI connectors recopilan datos de sensores y sistemas de
control. PI connectors requieren una cónfiguración mínima y simplifican la óbtención de
datos al escanear un protocolo de dispositivo específicó, obtener PI points y crear
autómaticamente un modelo de PI Asset Framework para su activo.
• PI Server
PI Server es el córazón del PI System. PI Server incluye:
◦ PI Data Archive
PI Data Archive recibe o recupera datos y los suministra en tiempo real a traves de PI
System y toda su infraestructura de infórmación. Con PI Data Archive, todos trabajan a
partir de un conjunto cómun de datos en tiempo real. Operadores, ingenieros,
administradores y otro personal de planta utilizan aplicaciones cliente para conectarse al
PI Server y consultar los datos de fabricación en los archivos históricós de datos de PI o
en sistemas de almacenamiento de datos externos.
Recomendamos ejecutar PI Data Archive en un equipo separado de los que ejecutan PI
interfaces y aplicaciones cliente. Esta arquitectura de cólección de datos distribuidos es
ampliable, robusta y flexible. Cuando se utiliza la arquitectura de alta disponibilidad
(HA), PI Data Archive se ejecuta en dos o mas equipos sincronizados y se comportan
como un unicó colectivo PI Data Archive lógicó. Para obtener mas infórmación, busque
“alta disponibilidad” en PI Live Library (https://livelibrary.osisoft.com/).
Guía de administrador del sistema PI Data Archive 2018 1

Introducción a la administración del sistema PI Data Archive
◦ PI Asset Framework (PI AF)

PI AF le permite definir representaciones coherentes de activos o equipos organizativos.
PI AF utiliza estas representaciones en analisis simples o complejos que generan
infórmación esencial.
• Herramientas de desarrollador
Las herramientas de desarrollador admiten el desarrollo de aplicaciones personalizadas
basadas en PI System, así como la integración de los datos de PI System con otros sistemas
de aplicaciones y sistemas empresariales, como Microsoft Office o SQL Server, sistemas de
planificación de recursos empresariales, plataformas de analisis e informes, portales web y
sistemas de mantenimiento y geoespaciales.
◦ PI API
PI Application Programming Interface (PI API) ofrece una interfaz prógramatica a la
infórmación de PI de PI Data Archive. PI API tambien proporciona utilidades para las
interfaces de recópilación de datos y desarrollo de aplicaciones del usuario. El códigó
escrito con PI API puede transportarse a multiples entornos de hardware y software.
◦ PI SDK
PI Software Development Kit (PI SDK) es una biblioteca de prógramación que utiliza un
enfoque jerarquicó, orientado a objetos, para proporcionar acceso de lectura y escritura a
las funciones de PI Server. El software de PI SDK consta de un servidor COM en proceso,
varios controles y dialógós comunes, y bibliotecas de códigó de soporte. El kit incluye
dócumentación, códigós de ejemplo, archivos de soporte y herramientas.
• PI AF SDK
PI AF Software Development Kit (PI AF SDK o AFSDK) ofrece acceso prógramaticó a los
datos de PI Server (PI Data Archive y PI AF).
• Aplicaciones cliente
Operadores, ingenieros, administradores y demas personal de planta utilizan diversas
aplicaciones cliente para conectarse a PI Data Archive, PI AF, y servidores de aplicaciones de
PI para consultar los datos de la planta. PI Vision, PI ProcessBook, PI DataLink y PI WebParts
son aplicaciones cliente.
Estructura del directorio de PI Data Archive

Cuando instala PI Data Archive, el programa de instalación le solicita una ubicación para
almacenar los archivos. De manera predeterminada, PI Data Archive instala sus archivos en una
carpeta denominada PI en el disco con el espacio mas disponible. La variable de entorno
PISERVER apunta a este directorio.
El directorio PI incluye los siguientes subdirectorios:
Subdirectorio Contenido
Program Files\PI\adm Herramientas administrativas.
Program Files\PI\bin Ejecutables de subsistemas o servicios de PI.
Program Files\PI\dat Bases de datos y tablas, como Point Database y la tabla de estados
digitales. Ademas, este es el directorio predeterminado para los
ficherós de archivado y la cola de eventos.
Program Files\PI\interfaces Interfaces que se instalaron con versiones anteriores de PI Data
Archive. Este directorio no esta presente en las instalaciones
nuevas de PI Data Archive.
2 Guía de administrador del sistema PI Data Archive 2018

Subdirectorio Contenido
Program Files\PI\log Archivos de registro.
Program Files\PI\setup Archivos para instalar y desinstalar.
Ademas del directorio de PI, la instalación de PI Data Archive crea el directorio pipc durante la
instalación de PI SDK. El directorio pipc contiene archivos para PI SDK, PI interfaces en
paquete y otras herramientas y utilidades, incluidas PI SMT, Collective Manager y PI ICU. La
variable de entorno PIHOME apunta a este directorio.
Prácticas recomendadas del sistema de archivos de PI Data

Archive
• Deshabilite el analisis de virus en PI\dat y en las carpetas de archivos históricós. El analisis
de virus puede afectar la integridad de los archivos históricós u otros archivos de la base de
datos. El problema con el analisis de virus es que, debido a que los datos son aleatorios,
pueden tener un patrón de bits que coincide con una firma de virus conocida. El software de
analisis de virus bloquea el archivo de datos y lo coloca en cuarentena.
• Utilice la cómpresión del sistema de archivos de Windows con precaución. La cómpresión de
archivos puede disminuir la velocidad de acceso de PI Data Archive a los ficherós de
archivado. La cómpresión puede reducir de manera significativa el tamanó del archivo
históricó, pero se necesitan mas recursos de la CPU para acceder a un archivo comprimido.
No utilice cómpresión en archivos a los que se acceda con frecuencia, como archivos
históricós recientes.
Subsistemas de PI Data Archive

Algunos subsistemas de PI Data Archive dependen de otros subsistemas para comportarse
correctamente. Todos los subsistemas esperan en el inicio a otros subsistemas dependientes. El
ejecutable de cada subsistema se instala en el directorio PI\bin. Los subsistemas de PI Data
Archive se ejecutan como servicios de Windows. Puede comprobar el estado de estos servicios
en la herramienta Windows Services o en System Management Tools (Operation > PI Services).
PI Data Archive requiere los siguientes subsistemas principales.
Subsistemas principales de PI Data Archive
Subsistema Ejecutable Finalidad Dependencias
Archivo históricó piarchss.exe Almacena y proporciona los datos una Snapshot
vez que salen del subsistema de
Update Manager
snapshots. Los datos se componen de
varias mediciones con marcas de tiempo License Manager
para cada punto de datos.
Base pibasess.exe Conserva la Base de datos de puntos, la Update Manager
Tabla de estados digitales y las bases de
License Manager
datos de cónfiguración para la
autenticación; aloja PI Module Database;
valida los inicios de sesión de usuarios.
License Manager pilicmgr.exe Conserva la infórmación sobre licencia
para PI Data Archive y todas las
aplicaciones conectadas.

Subsistema Ejecutable Finalidad Dependencias

Mensaje pimsgss.exe Registra los mensajes de estado y error Si este subsistema
de PI Data Archive en un archivo de no esta disponible,
registro. los mensajes se
redirigiran al
registro de eventos
de Windows.
Network Manager pinetmgr.exe Administra la cómunicación entre los
subsistemas, las interfaces y las
aplicaciones cliente de PI Data Archive.
Ademas, valida clientes en el momento
de la cónexión. Los clientes son
productos estandares, como PI
ProcessBook, y personalizados, como
programas de PI API o PI SDK.
Snapshot pisnapss.exe Almacena el evento mas reciente de Update Manager
cada punto, aplica la cómpresión, envía
License Manager
datos a la cola del evento, proporciona
eventos de Snapshot y envía
actualizaciones de aplicaciones cliente a
PI Update Manager.
Update Manager piupdmgr.exe Pone en cola las nótificaciónes de Esencial para el
cambios en los valores de datos, los funcionamiento
atributos de puntos, los módulós, correcto de PI Data
etcetera, en cualquier interfaz o Archive; la mayóría
aplicación cliente en la que se haya de los subsistemas
registrado para recibir nótificaciónes. y de las
aplicaciones
cliente lo
requieren.
AF Link piaflink.exe Sincroniza PI MDB y PI AF. Network Manager
Los subsistemas que no son principales no son esenciales para ejecutar PI Data Archive.
Subsistemas que no son principales de PI Data Archive
Subsistema Ejecutable Descripción
Alarm pialarm.exe Proporciona capacidades de alarma para PI points.
Backup pibackup.exe Administra las copias de seguridad de PI Data
Archive.
Batch pibatch.exe Detecta y registra la actividad de los batches.
La licencia de este subsistema se otorga por
separado y es posible que no este instalado en el
servidor de PI Data Archive.
Performace Equations pipeschd.exe Realiza calculós de ecuaciones de rendimiento (PE)

para los puntos de PE.
Recalculator pirecalc.exe Recalcula los valores de los puntos de PE despues
de los cambios históricós.
Redirector piudsrdr.exe Obtiene datos de sistemas externos y los envía a
los subsistemas Base, Archive y Snapshot. Se
utilizaba en cónexión con los conectores COM*.
Cierre pishutev.exe Determina cuandó se detuvo PI Data Archive y
escribe los eventos de cierre en los puntos
cónfiguradós para recibir estos eventos. Se ejecuta
unicamente en el inicio y, luego, se detiene.

Subsistema Ejecutable Descripción

SQL pisqlss.exe Prepara y ejecuta sentencias SQL dirigidas a PI
Data Archive. Los usuarios primarios de este
subsistema son PI ODBC Driver y PI SDK.
Totalizer pitotal.exe Realiza calculós posteriores al procesamiento en
un punto de snapshot y almacena los resultados en
un punto de PI Totalizer.


Herramientas para la administración de PI Server
OSIsoft proporciona varias herramientas y utilidades para administrar un Servidor PI.
Ademas de las siguientes herramientas de interfaz de usuario grafica, Servidor PI tambien
incluye utilidades de línea de comandos poderosas. Para obtener infórmación sobre las
utilidades de PI Data Archive, consulte el tema de referencia de PI Data Archive sobre las
utilidades de línea de comandos de "PI Data Archive" in Live Library (https://
livelibrary.osisoft.com). Para obtener infórmación sobre las utilidades de PI AF, consulte los
temas en PI System Explorer, dentro de utilidades y complementos de "PI AF" in Live Library
(https://livelibrary.osisoft.com).
PI System Management Tools (SMT)

PI System Management Tools (SMT) es una interfaz de usuario grafica que puede utilizar para
realizar muchas tareas de administración de PI Data Archive, como cónfigurar los ajustes de
seguridad, administrar archivos históricós, crear y cónfigurar puntos, y visualizar registros de
mensajes.
PI SMT se incluye con la instalación de PI Data Archive, pero usted puede obtener su versión
mas actualizada en la pagina de descargas de Soporte Tecnicó de OSIsoft (https://
techsupport.osisoft.com/Downloads/All-Downloads/PI-Server-Tools-and-Utilities/PI-System-
Management-Tools/All-Installation-Kits).
Para ejecutar PI SMT, seleccione Start > All Programs > PI System > PI System Management
Tools.
PI System Tray
PI System Tray permite supervisar los servidores PI Data Archive y PI AF.
PI System Tray se muestra como un icono en la barra de tareas de Windows. El icono muestra
el estado de los servidores PI Data Archive y PI AF que supervisa, y muestra alertas cuando se
producen problemas. PI System Tray proporciona tambien accesos directos para ver mensajes
del sistema, iniciar y detener PI Data Archive y PI AF, e iniciar PI System Management Tools
(SMT) y PI System Explorer.
De manera predeterminada, PI System Tray supervisa el servidor PI Data Archive
predeterminado o el colectivo, y el servicio de aplicación de PI AF asociado con el servidor PI
AF predeterminado. Puede supervisar servidores adicionales o cambiar los servidores
supervisados segun sea necesario.
PI System Tray se inicia autómaticamente al instalar PI SMT. Para iniciarlo manualmente,
seleccione Start > All Programs > PI System > PI System Tray.
PI Builder
PI Builder es un complemento de Microsoft Excel que permite trabajar con objetos de PI Asset
Framework y PI Data Archive de forma masiva. Use PI Builder para crear, eliminar y editar
objetos de PI, como puntos, elementos y atributos.
En Servidor PI 2014 y posterior, PI Builder sustituye a PI Tag Cónfiguratór.
Para obtener mas infórmación sobre PI Builder, consulte los temas Servidor PI dentro de "PI
Builder" in Live Library (https://livelibrary.osisoft.com).
PI Interface Configuration Utility (ICU)

PI Interface Cónfiguratión Utility (ICU) es una herramienta interactiva para cónfigurar
interfaces de PI. Para cónfigurar una interfaz de PI con ICU, debe ejecutarlo directamente en el
nodo interfaz. Esto significa que debe instalar ICU en cada uno de los nodos de interfaz.

Herramientas para la administración de PI Server
ICU se incluye con la instalación de PI SMT, pero usted puede obtener su versión mas
actualizada en la pagina de descargas de Soporte Tecnicó de OSIsoft (https://
techsuppórt.ósisóft.cóm/Dównlóads/All-Dównlóads/PI-Interface-Tóóls-and-Utilities/PI-
Interface-Cónfiguratión-Utility/Install-Kits).
Para ejecutar ICU, seleccione Start > All Programs > PI System > PI Interface Configuration
Utility.
PI Collective Manager
Use PI Collective Manager para administrar colectivos de alta disponibilidad (HA) en PI Data
Archive. Puede crear colectivos de PI Server, cónfigurar colectivos existentes y sus servidores, y
visualizar el estado de los colectivos.
PI Collective Manager se incluye en la instalación de PI SMT.
Para ejecutar Collective Manager, seleccione Start > All Programs > PI System > PI Collective
Manager.
PI SDK Utility
Muchos clientes (y algunas interfaces) se comunican con el servidor PI Data Archive mediante
PI SDK. PI SDK Utility proporciona funciones de resólución de problemas, como cómpróbación
de la conectividad, ejecución de busquedas de puntos, consultas de registros de mensajes y
activación del seguimiento. PI SDK Utility reemplaza a About PI-SDK.
Para ejecutar PI SDK Utility, seleccione Start > All Programs > PI System > PI SDK Utility.
PI System Explorer
PI System Explorer proporciona una interfaz de usuario grafica para crear, editar y administrar
objetos y activos de PI AF, lo que incluye analisis y marcos de eventos, en el servidor PI AF.
Utilice PI System Explorer para crear y administrar su estructura de activos, lo que incluye
bases de datos de PI AF, elementos y plantillas. Si es la primera vez que utiliza PI Asset
Framework, empiece con PI System Explorer.
Para ejecutar PI System Explorer, seleccione Inicio > Todos los programas > PI System > PI
System Explorer.
Administrador de almacenamiento en búfer

El Administrador de almacenamiento en bufer lo ayuda a cónfigurar el almacenamiento en
bufer con PI Buffer Subsystem. Cuando actualice de una versión anterior de PI Buffer
Subsystem o de API Buffer Server, el Administrador de almacenamiento en bufer lo ayuda a
garantizar que el almacenamiento en bufer este cónfiguradó correctamente para las interfaces
existentes. Luego de realizar la actualización, puede usar el Administrador de almacenamiento
en bufer para anadir servidores o colectivos de PI Data Archive que recibiran datos
almacenados en bufer.
Con el Administrador de almacenamiento en bufer, tambien puede hacer lo siguiente:
• Módificar la cónfiguración de almacenamiento en bufer para la computadora en la que se
esta ejecutando el Administrador de almacenamiento en bufer, los servidores específicós y
los colectivos que reciben los datos almacenados en bufer.
• Ver el estado de almacenamiento en bufer, la capacidad de bufer estimada, la cantidad de
eventos enviados y en cola, y senalar errores para los servidores y los colectivos.
• Exportar archivos que contengan infórmación detallada acerca del estado de
almacenamiento en bufer en una computadora.
• Ver mensajes con infórmación adicional para la sólución de problemas.

Descarga de PI SDK
Para descargar PI SDK, visite Pagina de descargas de soporte tecnicó de OSIsoft (https://
techsupport.osisoft.com/Downloads/All-Downloads/).

Descarga de PI SDK

Flujo de datos de PI Data Archive
En esta sección se proporciona una descripción general de los flujós de datos de PI Data
Archive.
1. La interfaz envía datos a PI Data Archive. Las PI interfaces obtienen datos de las fuentes de
datos y los envían al servidor en forma de eventos. Un evento consta de una marca de
tiempo, un valor y un estado. Antes de enviar un evento a PI Data Archive, la interfaz evalua
el evento; a cóntinuación, envía los eventos significativós a PI Data Archive y descarta los
demas. Esto se denomina informe de excepciones. Las interfaces realizan los siguientes
pasos:
a. Obtener datos y crear un evento.
b. Realizar una prueba de excepciones para determinar si el evento es significativó.
c. Enviar eventos significativós a PI Data Archive y descarta el resto.
d. Si se ha cónfiguradó el almacenamiento en bufer, guardar los eventos en el disco, en caso
de que PI Data Archive no este disponible.
Nota:
El servicio de almacenamiento en bufer tambien puede realizar pruebas de
cómpresión y enviar datos a todos los miembros de un PI collective. Esto se denomina
almacenamiento en búfer de n vías.
2. PI Snapshot Subsystem recibe todos los datos. En PI Data Archive, todos los eventos nuevos
se gestionan primero mediante PI Snapshot Subsystem. PI Snapshot Subsystem guarda un
unicó valor por cada PI point. Si llegan datos en orden temporal, los eventos entrantes se
convierten en los nuevos valores snapshot.
Cuando llega un nuevo valor, PI Snapshot Subsystem evalua el antiguo valor realizando una
prueba de compresión. Segun los resultados de la prueba de cómpresión, PI Snapshot
Subsystem descarta el antiguo valor o lo envía a la cola de eventos. PI Snapshot Subsystem
realiza los siguientes pasos:
a. Obtiene el nuevo evento y lo convierte en el nuevo valor snapshot.
b. Si el nuevo evento es incorrecto, lo envía directamente a la cola de eventos sin realizar
una prueba de cómpresión. En caso contrario, realiza una prueba de cómpresión entre el
evento nuevo y el anterior.
c. Envía eventos significativós a la cola de eventos y descarta el resto.
3. PI Archive Subsystem lee datos de la cola de eventos. .PI Archive Subsystem lee
continuamente datos de la cola de eventos, los almacena en una memoria cache y,
finalmente, los almacena en ficherós de archivado. Sin embargo, cuando PI Archive
Subsystem esta apagado o no puede recibir datos, la cola de eventos guarda los datos y sirve
como un bufer de alta velocidad. PI Archive Subsystem reanuda el procesamiento de datos
cuando vuelve a estar disponible. PI Archive Subsystem realiza los siguientes pasos:
a. Lee eventos provenientes de la cola de eventos.
b. Valida y almacena eventos en la cache de escritura.
c. Traslada periódicamente los datos de la cache de escritura a archivos históricós.
4. Los usuarios acceden a los datos a traves de aplicaciones cliente. El objetivo ultimó de un PI
System es distribuir infórmación a toda la empresa u órganización para aquellos que la
necesitan para tomar decisiones clave. Para lograr este fin, OSIsoft produce un numeró de
herramientas cliente que muestran datos de PI Data Archive en diversos formatos.

En esta sección
• Informe de excepciones
• Snapshot
• Prueba de cómpresión
• Cola de eventos
Informe de excepciones
Los informes de excepciones garantizan que PI interface solo envíe datos significativós, en lugar
de enviar datos innecesarios que cargan el sistema.
El informe de excepciones emplea un sencillo algoritmo de banda muerta para determinar si
envía eventos a PI Data Archive. Es posible establecer para cada punto las especificaciónes de
los informes de excepciones que crean la banda muerta. La interfaz ignórara los valores dentro
de la banda muerta.
En la ilustración precedente, la interfaz informa a PI Data Archive de los valores A, D y C. El

valor A es el ultimó valor del que se informa. Los valores B y C se ubican en la banda muerta de
la excepción, pero el valor D se ubica fuera de la banda muerta. La interfaz informa un valor D
junto con el valor anterior: en este caso, el valor C. La prueba de cómpresión determinara si es
necesario preservar C, o si A y D bastan para recrear la senal original con la fidelidad requerida.
La interfaz utiliza los atributos ExcDev, ExcMin y ExcMax del punto para determinar si informa
el nuevo valor a PI Data Archive. Para obtener detalles sobre la cónfiguración de los atributos
del informe de excepciones, consulte ExcDev, ExcDevPercent, ExcMax y ExcMin.
Nota:
Algunas interfaces no son compatibles con el informe de excepciones. Consulte la
dócumentación de su interfaz para determinar si es compatible con esta funcionalidad.

Desactivar el informe de excepciones

A fin de generar una excepción para cada evento, desactive el informe de excepciones.
Procedimiento
1. Cónfigure el atributo de punto ExcMax en 0.
2. Cónfigure el atributo del punto en ExcDev o ExcDevPerc 0.
Snapshot
PI Snapshot Subsystem obtiene nuevos datos del nodo de interfaz y guarda el valor mas
reciente de cada punto. El valor de un punto adquirido mas recientemente se denomina
snapshot.
PI Data Archive evalua el snapshot anterior en cuanto a las especificaciónes de cómpresión y

envía el valor antiguo a la cola de eventos o lo descarta.
Nota:
En ocasiones, un evento ingresa a PI Snapshot Subsystem con una marca de tiempo mas
antigua que el valor de snapshot actual. Es lo que se considera un evento incorrecto. PI
Data Archive envía los eventos incorrectos directamente a la cola de eventos para su
archivado, sin realizar ninguna prueba de cómpresión.
Estos valores en PI Snapshot Subsystem se denominan eventos de snapshot o simplemente

snapshots. El conjunto de todos los valores snapshot de todos los puntos es la Tabla Snapshot.

Prueba de compresión
La prueba de cómpresión asegura que se almacene la infórmación mínima necesaria para
reproducir con precisión la senal original.
PI Snapshot Subsystem utiliza la prueba de cómpresión para determinar que eventos hay que
guardar en el archivo históricó. Por ejemplo, en la siguiente ilustración todos los eventos
quedan dentro de la misma recta. En un caso sencillo como este, no es necesario almacenar
todos los puntos de la línea. Con guardar solo dos puntos, es posible recrear el valor del punto
en cualquier otro momento.
El mismo principio se aplica a la cómpresión de datos reales. PI Data Archive utiliza un

algoritmo de cómpresión para determinar que eventos se deben almacenar. La prueba de
cómpresión puede recrear otros eventos a traves de la extrapólación de eventos circundantes.
Este metódó de cómpresión se denomina compresión “swinging door”.
Cuan PI Snapshot Subsystem recibe un valor nuevo, la marca de tiempo del valor es el ultimó
valor de snapshot que se recibió antes del ultimó valor de snapshot. Este valor se registra solo
si ninguno de los valores desde el ultimó valor registrado se ubica en la capa de desviación de
cómpresión. La capa de desviación es un paralelogramo que se extiende entre el ultimó valor
registrado y el nuevo valor, con un ancho equivalente al doble del parametró de desviación de
cómpresión.

Cada punto posee tres atributos que incluyen las especificaciónes de cómpresión: CompDev o
CompDevPercent (desviación de cómpresión), CompMin (tiempo mínimó de cómpresión) y
CompMax (tiempo maximó de cómpresión). CompDev constituye la mitad del ancho de la capa
de desviación (como se muestra en la ilustración). Para obtener mas infórmación, consulte
CompDev, CompDevPercent, CompMax y CompMin.
Un evento omite el proceso de cómpresión y se coloca en la cola de eventos en las siguientes
instancias:
• El atributo Compressing del punto se cónfigura en Off.
• La marca de tiempo del evento es mas antigua que la marca de tiempo del snapshot actual.
Un evento de ese tipo se considera out of order.
• El atributo Status del punto ha cambiado.
• El evento esta anotado.
La cómpresión “swinging door” no se utiliza cuando el atributo Step se cónfigura en On. En su
lugar, se aplica un calculó de excepción utilizando el valor CompDev. Si la diferencia absoluta
entre el snapshot actual y el ultimó valor archivado es superior a CompDev, el snapshot se envía
al archivo históricó. Para obtener mas infórmación, consulte Paso.
Directrices relativas a la compresión

La cómpresión le brinda la flexibilidad para realizar una cónfiguración punto por punto, con la
ópción de archivar la infórmación relevante. La cómpresión afecta al rendimiento, al ancho de
banda y al acceso a los datos. La cómpresión no solo ahorra espacio de almacenamiento, sino
que tambien le permite almacenar solo datos significativós. PI Data Archive almacena los
valores reales que se reciben de la fuente, no interpolaciones, promedios o aproximaciones.
Esto mejora de forma significativa el rendimiento para los usuarios finales y no origina la
perdida de datos importantes.
Usted tendra un control absoluto sobre el nivel de cómpresión utilizado, desde la cómpresión
maxima (con perdida) hasta la cómpresión mínima (sin perdida). Por ejemplo:

• Activar la cómpresión para las senales con ruido.

• Activar la cómpresión y cónfigurar el atributo de desviación de cómpresión (CompDev) en
cero. Con esta cónfiguración, no se archivan los valores identicós sucesivos (o los valores
perfectamente alineados). Esto resulta mas eficaz que desactivar la cómpresión.
• Desactive la cómpresión para los datos totalizados y los ingresados manualmente, y para los
puntos en los que cada evento es significativó en sí mismo y no solamente representativo de
un flujó subyacente (como las mediciones de laboratorio). Cuando se desactiva la
cómpresión, se registran todas las excepciones.
En la mayóría de los casos, es conveniente instalar PI Data Archive con los valores de
cómpresión predeterminados.
La cónfiguración de la cómpresión requiere aplicar sus conocimientos del proceso para conocer
la naturaleza de la senal. Las especificaciónes de desviación de cómpresión no funcionan para
todas las mediciones. Tenga en cuenta el tipo de sensor, la precisión de los instrumentos, etc.
Afortunadamente, en una planta de proceso hay categórías generales de mediciones. Los
medidores de flujó, manómetrós y termopares similares tienen el mismo grado de repetibilidad
y reproducibilidad en sus mediciones.
Cola de eventos
La cola de eventos sirve como un bufer de memoria y disco entre los subsistemas de snapshot y
de archivos históricós. PI Snapshot Subsystem anade datos a la cola y PI Archive Subsystem los
elimina.
Normalmente, la cola de eventos pasa los eventos al archivo históricó tan pronto le llegan, pero
en algunas circunstancias PI Archive Subsystem pódría estar ocupado o no disponible. Cuando
esto sucede, la cola de eventos almacena los datos y se va llenando hasta que el archivo
históricó vuelve a estar disponible. Es lo que se denomina una cola de archivado.
La cola de archivado se produce en los siguientes casos:

• Los nodos interfaz u otras fuentes de datos producen una gran descarga de eventos. Puede
suceder cuando una interfaz recupera datos tras una caída de la red.
• PI Archive Subsystem esta ocupado almacenando eventos out-of-order o procesando
consultas de usuario costosas.
• El sistema operativo o el hardware asociado al PI Data Archive disponen de una capacidad
reducida de E/S o de CPU. Otras aplicaciones que se ejecutan en el equipo de PI Data Archive
o que comparten el mismo hardware anfitrión pódrían provocar esta situación.

Iniciar y detener PI Data Archive
PI Data Archive se ejecuta como un conjunto de servicios de Windows. Generalmente, estos
servicios se cónfiguran para iniciarse de manera autómatica cuando se inicia el equipo. Si
necesita cerrar o reiniciar el sistema operativo de Windows, siempre detenga PI Data Archive
primero. De lo contrario, pódría perder datos debido a tiempos de espera del servicio. Tambien
pódría perder datos que aun se encuentran en la memoria y no se transfirierón al disco.
En esta sección
• Iniciar PI Data Archive
• Detener PI Data Archive
• Eventos de cierre
Iniciar PI Data Archive

En esta sección
• Iniciar PI Data Archive como un servicio de Windows
• Cónfigurar el inicio autómaticó de los servicios
• Verificación del inicio
• Iniciar PI Data Archive en modo interactivo (de resólución de problemas)
Iniciar PI Data Archive como un servicio de Windows
Procedimiento
1. Inicie sesión en una cuenta de Windows que tenga acceso completo a los archivos de PI Data
Archive y permiso para iniciar los servicios de PI.
2. En el símbóló del sistema, vaya al directorio PI\adm.
3. Utilice el script pisrvstart.bat para iniciar PI Data Archive como servicio de Windows:
pisrvstart.bat [-nosite] [-base]
El parametró nosite opcional ejecuta PI Data Archive sin iniciar las interfaces y otros
programas específicós del sitio.
El parametró base opcional inicia los subsistemas principales solamente. Cuando utilice
este parametró, estos subsistemas se iniciaran en el siguiente orden: Network Manager,
Base, Message, License Manager, Snapshot, Archive, Backup y Update Manager. Esto puede
ser util para resolver problemas.
Configurar el inicio automático de los servicios

PI Data Archive en Windows normalmente se ejecuta como un conjunto de servicios. Puede
cónfigurar el comportamiento de inicio de PI Data Archive con la herramienta Windows
Services.
Para controlar los servicios, debe haber iniciado sesión con una cuenta que tenga privilegios
suficientes. Si no lo hizo, recibira un mensaje como este:
Error 5: Access Denied
Por cuestiones de diagnósticó, tambien puede iniciar PI Data Archive en modo interactivo.

Verificación del inicio

Los subsistemas PI Data Archive pueden tardar varios minutos en iniciarse. Los subsistemas
que deben iniciarse antes que las interfaces y otras aplicaciones puedan conectarse a PI Data
Archive son Archive, Base, License Manager, Network Manager, Snapshot y Update Manager.
Cuando estos subsistemas estan listos para responder solicitudes, se abre el oyente TCP/IP.
Para verificar que PI Data Archive se haya iniciado, puede hacer lo siguiente:
• Determinar que el puerto PI Data Archive este abierto:

netstat -an
• O revisar que el registro de PI Data Archive tenga el siguiente mensaje:
>> TCP/IP connection listener opened on port: 5450
Se producen errores en los intentos de cónexión si el puerto no esta abierto. La mayóría de

las interfaces y las aplicaciones cliente reintentan la cónexión de manera autómatica hasta
que se establece.
Iniciar PI Data Archive en modo interactivo (de resolución de problemas)

Si necesita supervisar, probar o resolver problemas de PI Data Archive, puede iniciarlo en modo
interactivo.
Procedimiento
1. Inicie sesión en una cuenta de Windows que tenga acceso completo a los archivos PI Data
Archive y permiso para iniciar los servicios de PI Data Archive.
2. En el símbóló del sistema, vaya al directorio PI\adm y escriba:
pistart.bat [-nosite] [–stdout] [–base]
El parametró nosite opcional ejecuta PI Data Archive sin iniciar las interfaces y otros
programas específicós del sitio.
El parametró stdout opcional impide que se inicie PI Message Subsystem. Envía todos los
mensajes a la salida estandar en lugar de enviarlos al registro de mensajes de PI Data
Archive.
El parametró base opcional inicia los subsistemas PI Data Archive principales solamente.
Este parametró inicia los siguientes subsistemas en el orden que se muestra: Network
Manager, Base, Message, License Manager, Snapshot, Archive, Backup y Update Manager.
Nota:
Algunas interfaces de Windows no pueden ejecutarse como servicios. Consulte la
dócumentación de la interfaz para obtener detalles.
Detener PI Data Archive

En esta sección
• Detener servicios de Windows
• Cambiar la hora de espera para el cierre
• Detener modo interactivo

Detener servicios de Windows

Utilice el archivo pisrvstop.bat para detener PI Data Archive si los procesos de este se
ejecutan como servicios de Windows.
Procedimiento
1. Inicie sesión en una cuenta de Windows que tenga acceso completo a los archivos de PI Data
Archive y permiso para iniciar los servicios de PI.
2. En el símbóló del sistema, vaya al directorio PI\adm:
3. Escriba el siguiente comando:
pisrvstop.bat
Todas las interfaces y los programas que figuran en pisrvsitestop.bat y luego los
procesos de PI se detienen. Para detener PI Data Archive sin cerrar las interfaces y otros
programas específicós del sitio, ingrese el parametró opcional nosite.
Nota:
Si planea iniciar o detener PI Data Archive por completo, utilice los scripts de inicio y
cierre; estos archivos inician o detienen servicios en el orden que requieren las
dependencias del sistema.
Cambiar la hora de espera para el cierre

Windows cuenta con una entrada de registro que define el tiempo de espera maximó para que
un servicio se cierre. De manera predeterminada, el tiempo de espera es de
300 000 milisegundos o de 5 minutos. Generalmente esto es tiempo suficiente para que el
cierre se realice en forma correcta en sistemas con menos de 50 000 puntos. En cualquier
servidor PI Data Archive con mas puntos, puede aumentar el tiempo de espera maximó para
dar a los servicios el tiempo suficiente para que se cierren correctamente.
Si no permite el tiempo necesario para el cierre, es posible que se pierdan datos o que se danen
los archivos de datos.
Procedimiento
1. Utilicee el archivo pisrvstop.bat para detener PI Data Archive.
2. Registre el tiempo que tarda PI Data Archive en cerrarse.
3. Si el servidor tarda mas de 5 minutos en cerrarse, revise la entrada de registro:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\WaitToKillServiceTimeout
4. Para aumentar el tiempo de espera:
a. Edite el parametró WaitToKillServiceTimeout.
b. Reinicie para aplicar los cambios.
Detener modo interactivo

Si PI Data Archive se inició en modo interactivo, cierreló escribiendo Ctrl + C en cada una de las
ventanas de símbóló del sistema que corresponden a los procesos PI Data Archive. Cierre los
procesos en el siguiente orden.

Procedimiento
1. Cierre las utilidades (como piconfig).
2. Cierre las interfaces (como RampSoak y Aleatorio).
3. Cierre el servicio Network Manager.
Cuando detenga el servicio Network Manager, los procesos restantes se cerraran antes de
que se detenga el servicio Network Manager.
Eventos de cierre
Los PI points tienen un atributo que puede cónfigurarse, el atributo Shutdown, para determinar
si se escriben los eventos de cierre. La estampa de tiempo del evento de cierre representa
normalmente la hora real del cierrre de PI Data Archive, como esta registrado por PI Snapshot
Subsystem. Si PI Data Archive se cierra de repente, esta marca de tiempo se precisara, de
manera predeterminada, en un plazo de 15 minutos.
Los valores validós para el atributo Shutdown son 1 (On) y 0 (Off). Si el atributo Shutdown de
un punto es 1, PI Shutdown Subsystem escribira un evento de cierre cada vez que PI Data
Archive se cierre. A menos que cónfigure puntos para recibir eventos de cierre, solo los puntos
de prueba, como sinusoid y sinusoidu, recibiran eventos de cierre.
OSIsoft le recomienda utilizar la cónfiguración predeterminada de 0 (Off) para los puntos
obtenidos por interfaces remotas que estan cónfiguradas para almacenamiento en bufer o alta
disponibilidad (HA). El motivo es que si ejecuta interfaces remotas con colectivos de PI Server o
almacenamiento en bufer, los eventos de cierre no son un indicador preciso de la perdida de
datos cuando PI Data Archive se cierra. Con el almacenamiento en bufer cónfiguradó
correctamente, los datos se póndran en la cola de PI Data Archive mientras este se cierra,
siempre y cuando las interfaces remotas sigan ejecutandóse. Tambien, si PI Data Archive es
parte de un colectivo, apagar un miembro no tiene efecto en la capacidad de otros miembros de
continuar recibiendo y sirviendo datos.
Muchos sitios cónfiguran puntos que almacenan valores de prueba de laboratorio de manera
que los puntos de prueba de laboratorio no reciban eventos de cierre. Se supone que los valores
de laboratorio son constantes entre pruebas. Puede ser confuso insertar eventos de cierre para
estos puntos.
Nota:
OSIsoft recomienda no ejecutar interfaces en el mismo equipo que PI Data Archive. Sin
embargo, si efectivamente utiliza dicha cónfiguración, cónfigure estas interfaces locales
para eventos de cierre. A diferencia de la mayóría de subsistemas de PI Data Archive, PI
Shutdown Subsystem se cierra una vez finalizadó el proceso.
Configurar eventos de cierre para puntos específicos

Los puntos que reciben eventos de cierre se especifican en el archivo PI\dat\shutdown.dat.
Puede editar el archivo shutdown.dat para restringir eventos de cierre en determinados
grupos de puntos. Para especificar mas de un nombre de tag, use una mascara de tag. Utilice los
comodines * y ?. El asterisco (*) busca todas las posibilidades con cualquier numeró de
caracteres. El signo de interrógación (?) coincide con un unicó caracter y se puede utilizar un
numeró ilimitado de veces.

Nota:
No especifique tags adicionales al anadir mascaras de tag separadas por comas o utilizar
líneas adicionales. Puede especificar solo una mascara de tag. Debe especificar al menos
una mascara de tag para permitir que el sistema de cierre funcione sin errores. Para
evitar todos los eventos de cierre, especifique una mascara de tag que no coincida con
ningun tag.
Puede usar otros atributos y valores de punto ademas del flag de cierre o en lugar de el. Todas
las condiciones se combinan de manera lógica con AND. Si no se especifican atributos de punto,
se selecciónaran todos los tags especificadós por la mascara de tag para que reciban eventos de
cierre.
Por ejemplo, esta entrada de archivo de cónfiguración selecciona solo tags que comienzan con
s, tienen el atributo location1 cónfiguradó en 0 y el origen de punto cónfiguradó en H. Ningun
otro tag recibe eventos de cierre:
! tag mask
s*
! point attributes
location1,0
pointsource,H


Especificaciones y consideraciones de hora
PI Data Archive realiza un seguimiento de la hora de acuerdo con el reloj de Windows, incluida
la cónfiguración de zona horaria y de horario de verano (DST). Si el reloj del sistema no
funciona correctamente, los datos de PI Data Archive seran incorrectos.
OSIsoft recomienda controlar el reloj del sistema regularmente. Si necesita realizar un cambio,
ajuste el reloj solo en pequenós incrementos (por ejemplo, un segundo por minuto). Mantenga
un registro de todos los ajustes que realiza.
Las estampas de tiempo de archivo históricó de PI Data Archive se almacenan como el numeró
de segundos despues del 1 de enero de 1970. Los anós de dos dígitós de 00 a 69 se interpretan
como anós del siglo 21 (2000). Los anós de dos dígitós de 70 a 99 se interpretan como anós del
siglo 20 (1900). Por ejemplo, 70 se traduce en 1970; 00 se traduce en 2000; y 37 se traduce en
2037.
Nota:
Las estampas de tiempo posteriores a enero de 2038 no se admiten por el momento.
En esta sección
• Tiempo PI
• Mostrar infórmación sobre la zona horaria
• Traducir formatos de hora
Tiempo PI
Puede utilizar una sintaxis especial, denominada PI time, para especificar entradas de marcas
de tiempo e intervalos de tiempo. PI time utiliza abreviaturas específicas, que puede combinar
para crear expresiones temporales.
En esta sección
• Abreviaturas de tiempo PI
• Expresiones de tiempo PI
• Especificación de intervalos de tiempo
• Especificación de intervalos de tiempo
Abreviaturas de tiempo PI
Al especificar un tiempo PI, puede utilizar abreviaturas concretas que representen unidades de
tiempo y referencias temporales.
Abreviaturas de unidades temporales
Abreviatura Versión completa Versión plural Unidad de tiempo correspondiente
s second seconds Segundo
m minute minutes Minuto
h hour hours Hora
d day days Día
mo month months Mes
y year years Anó

Abreviatura Versión completa Versión plural Unidad de tiempo correspondiente

w week weeks Semana
Para especificar unidades de tiempo, puede indicar la abreviatura, el nombre completo o la

versión plural de la unidad de tiempo; por ejemplo, s, second o seconds. Debe incluir un valor
validó con cualquier unidad de tiempo. Al especificar segundos, minutos y horas, puede utilizar
un valor fraccionario; por ejemplo, 1.25h. No se pueden utilizar valores fraccionarios con otras
unidades de tiempo.
Abreviaturas de referencia temporal
Abreviatura Versión completa Referencia temporal correspondiente
* Hora actual
t today 00:00:00 (medianoche) del día en curso
y yesterday 00:00:00 (medianoche) del día anterior
sun1 sunday 00:00:00 (medianoche) del domingo mas reciente
jun2 june 00:00:00 (medianoche) del día en curso del mes de junio del
anó actual
dec DD december DD 00:00:00 (medianoche) del día DD de diciembre del anó
actual
YYYY 00:00:00 (medianoche) del día y el mes actual del anó YYYY
M-D o M/D 00:00:00 (medianoche) del día D del mes de M del anó actual
DD 00:00:00 (medianoche) del día DD del mes actual
1: Utilice las tres primeras letras como abreviatura de cualquier día de la semana: sun, mon, tue, wed,
thu, fri o sat.

2: Utilice las tres primeras letras como abreviatura de cualquier mes del anó: jan, feb, mar, apr, may,
jun, jul, aug, sep, oct, nov o dec.
Expresiones de tiempo PI
Las expresiones de tiempo PI pueden incluir horas fijas, abreviaturas de hora de referencia o
compensaciones de tiempo. Una cómpensación de tiempo indica la dirección de
desplazamiento (+ o -) y la cantidad de desplazamiento (una abreviatura de unidad de tiempo
con un valor).
Por ejemplo, las expresiones de tiempo PI pueden tener la estructura siguiente:
Estructura Ejemplo
Solo hora fija 24-aug-2012 09:50:00
Solo abreviatura de hora de referencia t
Solo cómpensación de tiempo +3h
Abreviatura de hora de referencia con t+3h
cómpensación de tiempo
Incluya como maximó una cómpensación de tiempo en una expresión. Incluir varias
compensaciones de tiempo puede llevar a resultados imprevisibles.
Especificación de intervalos de tiempo

Para especificar las entradas de las marcas de tiempo, puede introducir expresiones de tiempo
que contengan:

• Tiempos fijós
Una hora fija representa siempre la misma hora, independientemente de la hora actual.
Entrada Significado
23-aug-12 15:00:00 3:00 p. m. del 23 de agosto de 2012
25-sep-12 00:00:00 (medianoche) del 25 de septiembre de 2012
• Abreviaturas de referencia temporal

Una abreviatura de referencia temporal representa una hora relativa a la hora actual.
Entrada Significado
* Hora actual (ahora)
3-1 o 3/1 00:00:00 (medianoche) del 1 de marzo del anó actual
2011 00:00:00 (medianoche) del mes y día en curso de 2011
25 00:00:00 (medianoche) del día 25 del mes actual
t 00:00:00 (medianoche) del día en curso (hoy)
y 00:00:00 (medianoche) de la fecha anterior al día en curso (ayer)
tue 00:00:00 (medianoche) del martes mas reciente
• Abreviaturas de referencia temporal con cómpensación horaria

Cuando se incluye con una abreviatura de referencia temporal, se anade una cómpensación
horaria a la hora especificada o se resta de ella.
Entrada Significado
*-1h Hace una hora
t+8h 08:00:00 (8:00 a. m.) de hoy
y-8h 16:00:00 (4:00 p. m.) de antes de ayer
mon+14.5h 14:30:00 (2:30 p.m.) del ultimó lunes
sat-1m 23:59:00 (11:59 p. m.) del ultimó viernes
• Desplazamientos temporales
Cuando se introducen solos, estos desplazamientos temporales especifican una hora relativa
a una hora de referencia implícita. La hora de referencia implícita puede ser la hora de reloj
actual u otra, en función de dónde introduzca la expresión.
Entrada Significado
-1d Un día antes de la hora actual
+6h Seis horas despues de la hora actual
Especificación de intervalos de tiempo

Las entradas de intervalos temporales definen intervalos para recopilar o calcular valores
durante un períódó de tiempo. Por ejemplo, puede especificar un intervalo de 60 minutos para
calcular el promedio por hora para un períódó de 12 horas. Para especificar entradas de
intervalo de tiempo, introduzca un valor y una unidad de tiempo validós:
• Los valores positivos definen intervalos que comienzan en un momento anterior dentro del
períódó y finalizan en o antes de un momento posterior dentro del períódó.
Hora de inicio 2:00:00
Hora de finalización 3:15:00

Intervalo de tiempo 30m

Intervalos devueltos 2:00:00 a 2:30:00
2:30:00 a 3:00:00
• Los valores negativos definen intervalos que finalizan en un momento posterior dentro del
períódó y comienzan en o despues de un momento anterior dentro del períódó.
Hora de inicio 2:00:00
Hora de finalización 3:15:00
Intervalo de tiempo -30m
Intervalos devueltos 02:15:00 a 02:45:00
02:45:00 a 03:15:00
Mostrar información sobre la zona horaria

Procedimiento
1. Abra una ventana de comandos y vaya al directorio PI\adm.
2. Escriba:
pidiag -tz
La utilidad pidiag devólvera varias líneas de resultado, incluidos los nombres de su zona
horaria. Para obtener resultados mas detallados, utilice las opciones de presentación
pidiag -tz .
En esta sección
• Infórmación sobre zona horaria y reglas de transición al horario de verano
• Opciones de visualización de la zona horaria para pidiag -tz
• Mostrar la hora local y la hora UTC
• Mostrar una zona horaria diferente
• Personalizar los cambios del horario estandar y el horario de verano
• Determinar si una cadena de hora es ambigua
• Especificar zonas horarias
Información sobre zona horaria y reglas de transición al horario de verano

Si no especifica una zona horaria, pidiag -tz muestra la infórmación sobre la zona horaria y
las reglas de transición al horario de verano (DST) que utiliza PI Data Archive. Si el archivo PI
\dat\localhost.tz esta presente y es validó, la infórmación sobre la zona horaria es del
archivo. De lo contrario, la infórmación es del sistema operativo.
StartYear, EndYear, Month, Week, Day, Time y Offset definen las reglas de transición al
horario de verano y al horario estandar.
Las reglas de transición son las siguientes:
• StartYear es el primer anó en que la regla entra en vigor.

• EndYear es el ultimó anó en que la regla esta en vigor.
• Month es el mes (1 a 12) en que se aplica la regla.

• Week es la semana (1 a 5) en que se aplica la regla. Si Week es 5 y existen solo cuatro

semanas en el mes, entonces 5 designa la ultima semana del mes. Si el valor de Week es -1,
Week se ignora y el día se convierte en absoluto.
• Si Week es superior a 0, Day es el día relativo (1 a 7) en que se aplica la regla. Un Day de 1
representa el domingo, un Day de 2 representa el lunes, etc. Por ejemplo, una Week de 1 y un
Day de 1 significa el primer domingo de abril. Si Week es -1, Day es un día absoluto (1-31).
• Time es la hora en segundos despues de la medianoche en que se aplica la regla.
• Offset es la hora en segundos para restar del horario estandar para obtener la hora local.
Por ejemplo, cuando el horario de verano esta en vigor, se resta -3600 del horario estandar.
Si su zona horaria no contempla el horario de verano, el resultado indica esto.
C:\PI\adm> pidiag -tz
TZ environment variable: <not set>

Standard Time Name: US Mountain Standard Time (UMST)
Daylight Saving Time: <not observed>
Consulte Personalizar los cambios del horario estandar y el horario de verano para cambiar
esta cónfiguración.
Opciones de visualización de la zona horaria para pidiag -tz

Al utilizar pidiag -tz para mostrar la infórmación correspondiente a la zona horaria, puede
incluir las siguientes opciones adicionales. La sintaxis es la siguiente:
pidiag -tz [time_string [time_zone]] [-check | -dump [-brief] | -full]
• time_string [time_zone]
Muestre la hora local y la hora universal (en segundos) para la cadena de hora especificada:
Si utiliza el parametró opcional time_zone, pódra mostrar la infórmación sobre la zona
horaria y convertir la hora como si la zona horaria especificada estuviera vigente.
• -check
Indica si la cónfiguración de zona horaria de su sistema no es valida. Si la cónfiguración de
zona horaria de su sistema es valida, el comando no generara ningun resultado.
• -dump [-brief]
Vuelca toda la tabla de zonas horarias, lo que incluye los cambios de ótónó y primavera de
cada anó. El volcado se encuentra en formato variable separado por comas (CSV), que puede
cargarse en una hoja de calculó con toda la infórmación sobre cambio de hora para la zona
horaria local.
Con el parametró opcional -brief, el resultado incluira el anó y los cambios de hora de
primavera y ótónó; cada uno de estos se marcara con S o D para indicar horario estandar u
horario de verano, respectivamente.
• -full
Muestra infórmación adicional sobre el archivo localhost.tz, como el UID, el creador y la
fecha de creación del archivo. La infórmación sera valida solo si PI Data Archive cargó
correctamente localhost.tz.
Mostrar la hora local y la hora UTC

Para mostrar la hora local y la hora universal (en segundos) para una hora especificada:

Procedimiento
2. Escriba:
pidiag -tz "timeString"
donde timeString es su cadena de hora. Por ejemplo:

pidiag -tz "25-oct-98 1:30:00"
La utilidad pidiag devuelve varias líneas de resultado, incluidas las siguientes:

Passed Time: 25-Oct-98 01:30:00* PST Local: 909279000 UTC:909304200
Mostrar una zona horaria diferente

Para mostrar la infórmación sobre la zona horaria y convertir la hora como si estuviera vigente
alguna en particular, especifique una cadena de hora y una zona horaria con pidiag -tz, tal
como se indica a cóntinuación:
pidiag -tz timeString timezone
Por ejemplo:
C:\Program Files\PI\adm>pidiag -tz * GMT0BST
# Time Zone name:

# TZ environment variable: GMT0BST
# Bias (offset) from UTC (TAI) time:
0
# January is standard / Northern hemisphere:
1
# Standard Time Name:
GMT
GMT
# Daylight Time Name:
BST
BST
# StartYear, EndYear, Month, Week, Day, Time, Offset
1970, 2006, 4, 1, 1, 7200, -3600
2007, 2038, 3, 2, 1, 7200, -3600
1970, 2006, 10, 5, 1, 7200, 0
2007, 2038, 11, 1, 1, 7200, 0
Passed Time: 22-Feb-17 22:42:27 GMT Local: 1487803347 UTC: 1487803347
Personalizar los cambios del horario estándar y el horario de verano

PI utiliza una tabla construida internamente para determinar cuandó se realizan los cambios
entre el horario estandar y el horario de verano (DST). De manera predeterminada, PI crea la
tabla mediante el uso de la regla de cambio de hora unica disponible en Windows. Sin embargo,
cuando el archivo PI\dat\localhost.tz esta presente y es validó, PI crea la tabla mediante
el uso de las reglas de cambio especificadas en el archivo.
Determinar si una cadena de hora es ambigua

Use pidiag -tz para determinar si una cadena de hora específica se considera ambigua:
Procedimiento
2. Escriba:
pidiag -tz "timeString"

donde timeString es su cadena de hora. Por ejemplo:

pidiag -tz "25-oct-98 1:30:00"
La utilidad pidiag devuelve varias líneas de resultado.

Passed Time: 25-Oct-98 01:30:00* PST Local: 909279000 UTC:909307800
El asterisco en la línea superior indica que esta es una cadena de hora ambigua, a menos que
usted incluya el nombre de la zona horaria.
Especificar zonas horarias

En general, PI System puede determinar si el horario de verano esta vigente. Si desea ser
específicó, utilice el formato de tiempo fijó DD-MMM-YY hh:mm:ss.ssss y agregue la zona
horaria.
PI admite nombres de zonas horarias largos (como Hora estandar del Pacíficó) y nombres de
zonas horarias cortos (como PST). Puede especificar cualquiera de los nombres. Las
comparaciones no distinguen entre mayusculas y minusculas. La siguientes cadenas de hora
son equivalentes:
25-Oct-98 01:30 Pacific Daylight Time
25-Oct-98 01:30 pdt
25-Oct-98 01:30 D
Otros códigós de zonas horarias utilizados cómunmente incluyen S para horario estandar, D
para horario de verano y MET para Horario de Europa Central.
Traducir formatos de hora

Procedimiento
2. Escriba:
pidiag -t time_stamp [U]
Esto proporciona una traducción entre los formatos de cadena de hora y los formatos
internos: si time_stamp comienza con 0 (cero), un formato de numeró entero (segundos
desde el 1.º de enero de 1970), se traduce a una representación en cadena. pidiag adopta
la hora local, a menos que use el argumento U o UTC, en cuyo caso el argumento se tómara
como hora universal (UTC). Si el primer caracter no es 0, el argumento de hora se
cónsiderara cadena de hora, absoluta o relativa, y se traducira en un valor entero. Se
muestran los valores enteros de hora UTC y hora local.
En esta sección
• Salida de ejemplo de cadena para formato de entero
• Salida de ejemplo de cadena para formato de entero
Salida de ejemplo de cadena para formato de entero

Si escribe el siguiente comando:
C:\PI\adm>pidiag -t 1-sep
Obtendra un resultado similar al siguiente:

1-Sep-98 00:00:00 PDT - Local: 904608000 UTC: 904633200

C:\PI\adm>pidiag -t t+1h

21-Oct-98 01:00:00 PDT - Local: 908931600 UTC: 908956800

C:\PI\adm>pidiag -t "*"

21-Oct-98 20:00:10 PDT - Local: 909000010 UTC: 909025210
Salida de ejemplo de cadena para formato de entero

Si escribe el comando:
C:\PI\adm>pidiag -t 0909000010

21-Oct-98 20:00:10 PDT - Local: 909000010 UTC: 909025210

Copias de seguridad de PI Data Archive
Una copia de seguridad es una copia de datos que puede utilizar en caso de que sus datos
originales se danen o pierdan. Las copias de seguridad proporcionan un medio de recuperación
despues de cambios de cónfiguración imprevistos (como una eliminación accidental de puntos)
y danó de la base de datos. En general, la mejor manera de recuperar datos es restaurando una
copia de seguridad que se realizó antes de que se produjera el problema.
En PI Data Archive, las copias de seguridad incluyen ficherós de archivado e infórmación sobre
la cónfiguración.
En esta sección
• Cónfiguración de la copia de seguridad programada de PI Data Archive
• Ver el historial de copias de seguridad de un servidor de PI Data Archive
• Resólución de problemas de las copias de seguridad de PI Data Archive
• Scripts de copia de seguridad de PI Data Archive
• Cómó funciona la verificación de copia de seguridad de PI Data Archive
• Restaurar PI Data Archive a partir de una copia de seguridad
Configuración de la copia de seguridad programada de PI

Data Archive
OSIsoft le recomienda cónfigurar una copia de seguridad diaria autómatica de PI Data Archive.
La instalación de PI Data Archive incluye un script que puede utilizar para cónfigurar una copia
de seguridad diaria como servicio de Windows, que se conoce como la tarea de copia de
seguridad programada. La tarea de copia de seguridad programada realiza una copia de
seguridad incremental verificada todos los días.
Mientras se ejecuta la tarea de copia de seguridad programada, puede acceder a PI Data
Archive como de costumbre. Por ejemplo, puede crear puntos y enviar datos a los archivos
históricós. Para minimizar el impacto del rendimiento durante las copias de seguridad, utilice
la cónfiguración de disco recomendada. Consulte Cónfiguración del disco recomendada para las
copias de seguridad de PI Data Archive.
La tarea de copia de seguridad programada coloca los archivos de la copia de seguridad en un
directorio especificadó por la tarea de Windows, a la que denominamos directorio de la copia
de seguridad programada. El directorio de la copia de seguridad programada guarda
unicamente la copia de seguridad verificada mas reciente.
Ademas de la tarea de la copia de seguridad programada, OSIsoft le recomienda utilizar una
aplicación de copias de seguridad de terceros para realizar una copia de seguridad del
directorio de la copia de seguridad programada en una ubicación segura.

En esta sección
• Cónfiguración del disco recomendada para las copias de seguridad de PI Data Archive
• Cónfigurar la copia de seguridad programada de PI Data Archive
• Colectivos y copias de seguridad de PI Data Archive
Configuración del disco recomendada para las copias de seguridad de PI

Data Archive
Las copias de seguridad requieren al menos una partición NTFS en el equipo donde PI Data
Archive esta instalado. Para lograr un rendimiento óptimó durante las copias de seguridad,
conserve los siguientes archivos en unidades separadas:
• Ficheros de archivado de datos y cola de eventos.
• El archivo de paginación del sistema operativo.
• El directorio de la copia de seguridad programada (esta unidad puede ser una unidad de red
remota o NAS).
Por ejemplo, PI Data Archive puede estar instalado en la unidad C: donde normalmente esta
ubicado el archivo de paginación, mientras que los archivos históricós y la cola de eventos se
cónfiguran para estar en la unidad D: y el directorio de la copia de seguridad intermedia esta
en la unidad E: o en una unidad de red remota.
Todos los archivos históricós a los que se les realizara una copia de seguridad deben estar en el
equipo de PI Data Archive. La copia de seguridad fallara si el archivo históricó al que se le
realizara una copia de seguridad se encuentra en una unidad remota, como por ejemplo, una
unidad de red asignada.
Rendimiento durante las copias de seguridad de PI Data Archive

Cualquier copia de seguridad en el ordenador de PI Data Archive tiene el potencial de tener un
impacto en el rendimiento. Puede evitar, en gran medida, este impacto mediante el uso de la
cónfiguración de disco recomendada. Sin embargo, es inevitable que haya algun tipo de
impacto debido a que se consumen los recursos de la CPU y los recursos del cache del sistema
de archivos.
Supervise PI Data Archive durante una copia de seguridad para determinar de que manera la
copia de seguridad afecta la velocidad de archivado, las lecturas de los archivos históricós y el
uso de la CPU de PI Data Archive. Ademas, controle los contadores de rendimiento de Windows

Avg Disk Write Queue Length y Avg Disk Read Queue Length para el objeto de
rendimiento del disco físicó. Si la longitud de cola del disco es mayor que uno, el disco esta
quedando retrasado.
Configurar la copia de seguridad programada de PI Data Archive

Procedimiento
1. Determine si debe excluir algun archivo históricó de la copia de seguridad.
2. Cree la tarea de copia de seguridad programada.
3. Utilice una herramienta de copia de seguridad de terceros para automatizar una copia de
seguridad regular de los archivos en el directorio de copias de seguridad.
Si una herramienta de terceros no es una ópción viable, puede usar un script para hacer una
copia de seguridad del directorio de la copia de seguridad intermedia.
4. Para garantizar que la tarea de copia de seguridad programada funcione correctamente,
ejecute una copia de seguridad de prueba.
¿Desea excluir los archivos históricos antiguos de la copia de seguridad?

Para los siguientes escenarios, omita esta sección:
• Recientemente ha instalado PI Data Archive.
• Esta realizando la actualización y ya esta haciendo copias de seguridad incrementales.
Si esta realizando la actualización y planea cambiar las copias de seguridad realizadas durante
la noche por copias de seguridad incrementales, siga los pasos de esta sección.
Antes de realizar la cónversión a copias de seguridad incrementales, asegurese de que su
primera copia de seguridad incremental no sea extremadamente larga. Si realizó copia de
seguridad de los archivos históricós fuera de las copias de seguridad programadas normales, la
ópción Backup Time (como lo muestra el comando piartool -al ) puede aparecer en la lista
como Never. Estos archivos históricós se incluyen en la primera copia de seguridad incremental
(o bien, si los archivos estan marcados como de solo lectura, se incluyen en cada copia de
seguridad incremental subsiguiente). Si realizó copia de seguridad de estos archivos históricós
antiguos por otros medios (por ejemplo, al cerrar el servidor PI Data Archive y realizar una
copia de los ficherós de archivado), considere excluir los archivos históricós antiguos de la
copia de seguridad.
Procedimiento
1. Para determinar los archivos históricós que se pódrían incluir con la primera copia de
seguridad incremental, ejecute el comando:
piartool.exe -backup -identify -type incremental -verbose
2. Examine la lista. Si desea excluir archivos históricós de la copia de seguridad incremental o
si algun archivo históricó se marca como de solo lectura, identifique el archivo históricó mas
reciente de la lista que desea excluir. El archivo históricó mas reciente posee la Hora de
finalización mas reciente (como lo muestra el comando piartool -al ). Utilice esta hora
de finalización en el siguiente comando -identify .
piartool.exe -backup -identify -type incremental -verbose
-excludeArchivesWithEndTimesOlderThan EndTime
3. Examine la lista. Esta no debe incluir los archivos históricós que excluyó. Use la misma hora
de finalización para módificar la línea de comandos de la tarea programada que usted creara
en Personalizar la copia de seguridad predeterminada.

Crear la tarea de copia de seguridad programada

PI Data Archive incluye scripts para crear la tarea y realizar las copias de seguridad. La tarea
realiza una copia de seguridad de los archivos y los copia al directorio de la copia de seguridad
programada. Puede cónfigurar el nombre y la ubicación del directorio de la copia de seguridad
y la hora de dicha copia.
Procedimiento
1. En el ordenador de PI Data Archive, inicie sesión con una cuenta de Windows que disponga
de privilegios de administrador.
2. Abra una ventana del símbóló del sistema.
3. Cambie al directorio PI\adm.
Por ejemplo, si PI Data Archive esta instalado en la unidad D, escriba lo siguiente:
cd /d "%piserver%adm"
4. Seleccione un directorio de destino para sus copias de seguridad, por ejemplo, e:
\pibackup. Idealmente, la unidad de la copia de seguridad es una unidad diferente de la
unidad del sistema o la unidad en la que se almacenan sus archivos históricós.
pibackup e:\pibackup -install
Este comando crea una tarea programada de Windows denominada PI Server Backup.
Qué hacer a continuación

Utilice la herramienta de la copia de seguridad de su elección para realizar una copia de
seguridad del directorio pipc, que no esta incluido en la tarea de copia de seguridad
programada de PI Data Archive. Consulte Cónfigurar una copia de seguridad autómatica del
directorio de copia de seguridad programada de PI Data Archive. Si no hay herramientas de
copia de seguridad disponibles, puede cónfigurar la tarea de copia de seguridad programada de
PI Data Archive para que realice una copia de seguridad de este directorio. Consulte Anadir el
directorio PIPC a la tarea de copia de seguridad diaria de PI Data Archive.
En esta sección
• Directorio de destino para la copia de seguridad
• Personalizar la copia de seguridad predeterminada
• Cambiar la hora programada de las copias de seguridad autómaticas de PI Data Archive
Directorio de destino para la copia de seguridad

Cuando emite un comando de copia de seguridad de referencia, especifica la ruta al directorio
de la copia de seguridad programada. A cóntinuación se indican algunos ejemplos de rutas
validas:
C:\pibackup\
\\myserver\c$\pibackup\
\\myserver\share\pibackup\
No recomendamos rutas UNC porque PI Backup Subsystem no intenta reiniciarse si se produce

un error de red. Si utiliza una ruta UNC, puede especificar una ruta a un directorio compartido
en un equipo remoto, pero no puede utilizar unidades de red asignadas.
Personalizar la copia de seguridad predeterminada

Puede personalizar la tarea despues de instalar la copia de seguridad de PI Data Archive como
una tarea programada.

Antes de empezar
Para realizar cualquiera de estos cambios, abra el Programador de tareas de Windows y haga
doble clic en la entrada PI Server Backup.
Procedimiento
• Cambie la hora de la copia de seguridad.
La hora predeterminada es 3:15 a. m.
• Cambie el usuario de Windows con el que se ejecuta la tarea.
De manera predeterminada, la tarea se ejecuta con la cuenta Sistema. Si esta utilizando el
script pisitebackup.bat para realizar una copia de seguridad de sus archivos en un
equipo remoto, ejecute la tarea programada como un usuario que tenga los privilegios
suficientes para escribir en el directorio objetivo del equipo remoto.
• Cambie la ruta al directorio de la copia de seguridad programada.
• Si necesita excluir copias de seguridad anteriores, segun se determina en ¿Desea excluir los
archivos históricós antiguos de la copia de seguridad?, anexe la línea de comandos de la
tarea programada con lo siguiente:
-excludeArchivesWithEndTimesOlderThan EndTime
Cambiar la hora programada de las copias de seguridad automáticas de PI Data

Archive
Para cambiar la hora programada de la copia de seguridad autómatica , edite la tarea de
Windows.
Nota:
El siguiente procedimiento se aplica a Microsoft® Windows® 7 y versiones posteriores.
Si planea usar una versión anterior de Windows, consulte la dócumentación de Microsoft
correspondiente al Programador de tareas de Windows.
Procedimiento
2. En Panel de control, abra Tareas programadas.
3. Haga doble clic en la tarea PI Server Backup.
4. En el cuadro de dialógó Properties, haga clic en la pestana Triggers y, luego, haga clic en Edit.
5. Establezca la cónfiguración deseada.
6. Haga clic en OK.
Configurar una copia de seguridad automática del directorio de copia de

seguridad programada de PI Data Archive
Procedimiento
• Utilice una herramienta de copia de seguridad de terceros para cónfigurar copias de
seguridad programadas con regularidad del directorio de copia de seguridad programada.
La copia de seguridad debe almacenar los archivos en un equipo diferente de PI Data
Archive.
Puede utilizar cualquier estrategia de copia de seguridad disponible en el programa de copia
de seguridad de terceros. Por ejemplo, puede elegir una cómbinación de copias de seguridad

completas e incrementales, copias de seguridad completas y diferenciales, o una

cómbinación de copias de seguridad completas, incrementales y diferenciales.
El software de terceros reducira las tareas administrativas de su copia de seguridad. Por
ejemplo, un software típicó de copia de seguridad de terceros puede cónfigurarse para
descartar copias de seguridad anteriores despues de un períódó especificadó. Ademas, TI
puede administrar normalmente el software de copia de seguridad de terceros para que el
gestor de PI System pueda llevar a cabo otras tareas.
¿Por qué debe realizar una copia de seguridad del directorio de la copia de seguridad
programada?
Realizar una copia de seguridad de los archivos del directorio de su copia de seguridad es un
paso fundamental para proteger PI Data Archive. El directorio de la copia de seguridad
contiene unicamente la copia de seguridad mas reciente. A medida que se copian los archivos
de la nueva copia de seguridad en el directorio de la copia de seguridad, se sobrescriben los
archivos de la copia de seguridad anterior. Esto significa que el directorio de la copia de
seguridad contiene unicamente la copia de seguridad verificada mas reciente. Esto no es de
ayuda si necesita restablecer una copia de seguridad anterior.
Por ejemplo, supongamos que descubre que hace dos días eliminó un punto por accidente. No
puede recuperar el punto eliminado de los archivos del directorio de la copia de seguridad
debido a que la ultima copia de seguridad ócurrió despues de que se eliminó el punto. Necesita
recuperar el punto de una copia de seguridad anterior. Sus copias de seguridad del directorio
de la copia de seguridad de PI Data Archive própórciónaran el historial de las copias de
seguridad que le permitira restablecer el punto.
Añadir el directorio PIPC a la tarea de copia de seguridad diaria de PI

Data Archive
Si elige no utilizar software de terceros para realizar una copia de seguridad de los archivos en
el directorio pipc, puede cónfigurar la tarea de copia de seguridad programada para que los
incluya.

Procedimiento
2. Abra una ventana de comandos de Windows.
3. Cambie al directorio PI\adm: cd %piserver%adm
4. Localice el archivo denominado pisitebackup.bat.example.
5. Cambie el nombre del archivo a pisitebackup.bat eliminando la extensión .example.
Esto cónfigura la copia de seguridad de un conjunto predeterminado de archivos en el
directorio pipc. Esta copia de seguridad se ejecuta inmediatamente despues de la tarea de
copia de seguridad automatizada de PI Data Archive. Los archivos de copia de seguridad se
colocan en un subdirectorio llamado sitebackup dentro del directorio de copia de
seguridad de PI Data Archive.
6. Por defecto, pisitebackup.bat copia los archivos .bat, .log, .ini, .txt y .sql del
directorio pipc. Para cambiar los archivos que se cópiaran, edite el archivo
pisitebackup.bat.

Nota:
Puede editar pisitebackup.bat para incluir cualquier secuencia de comandos que
quiera ejecutar inmediatamente despues de la ejecución de la tarea de copia de seguridad
programada de PI Data Archive. Para obtener mas infórmación, lea las instrucciones
incluidas en el archivo pisitebackup.bat.example.
Ejecutar una copia de seguridad de prueba

En este ejemplo, se asume que el directorio de copias de seguridad es E:\pibackup\ y que el
directorio de PI Data Archive es C:\pi\.
Procedimiento
1. Para supervisar los mensajes que se escriben en el registro de mensajes de PI durante la
copia de seguridad, inicie PI SMT y seleccione Operation > Message Logs.
2. En el Programador de tareas de Windows, haga clic con el bótón derecho en la tarea
programada PI Server Backup y seleccione Ejecutar. Los archivos se cópiaran en los
siguientes directorios.
◦ Los archivos históricós se cópiaran en E:\pibackup\arc.
◦ Los archivos de C:\pi\dat, C:\pi\adm, C:\pi\log y C:\pi\bin se copian en E:
\pibackup\dat, E:\pibackup\adm, E:\pibackup\log y E:\pibackup\bin,
respectivamente.
3. Supervise los mensajes del registro de mensajes de PI de SMT. Al principio de la copia de
seguridad, debe ver el mensaje Backup operation started. Cuando se complete la
copia de seguridad, vera el mensaje: Backup operation completed
successfully . De manera alternativa, para determinar si se cómpletó la copia de
seguridad, verifique el estado de la tarea en el Programador de tareas de Windows.
4. Despues de que se complete la copia de seguridad, examine el registro de la copia de
seguridad en E:\pibackup. El formato del nombre de registro es pibackup_dd-MMM-
yy_hh.mm.ss.txt. El archivo de registro incluye la siguiente infórmación:
◦ Casi al comienzo del registro, se detallan los archivos históricós registrados actualmente.
Esta lista de archivos puede ser util durante las operaciones de restauración. Por ejemplo,

cuando restaure PI Data Archive, es util saber en el momento de la copia de seguridad

que archivo fue el primario y en que directorios estaban los archivos.
◦ Si la copia de seguridad se realiza correctamente, al final del registro vera el mensaje
pibackup.bat script completed successfully.
◦ Un Informe de la copia de seguridad del archivo detallado en el que
se indican los archivos que fueron copiados en el directorio de la copia de seguridad.
◦ La lista de subsistemas que se registraron para la copia de seguridad y los numerós de
versión del subsistema.
◦ Un resumen de la copia de seguridad que es similar al siguiente.
Backup in Progress: FALSE
Files Copied: 24
Files Skipped: 36
File Copy Failures: 0
Total File Count: 60
Last Backup Start Pending: 1-Nov-09 03:15:05
Last Backup Start: 1-Nov-09 03:15:26
End: 1-Nov-09 03:15:42
Status: [0] Success
Last Backup Type: INCREMENTAL, VSS, Component Mode
Last Backup Event: BACKUPSHUTDOWN
Last Backup Event Time: 1-Nov-09 03:15:43
Verification Start Time: 1-Nov-09 03:15:42
VSS Supported: TRUE
El tipo de copia de seguridad debe ser INCREMENTAL. La primera copia de seguridad

incremental de un PI Data Archive recientemente instalado debe ser equivalente a una
copia de seguridad completa. El tipo de copia de seguridad NUMARCH/CUTOFF es
posible unicamente si la tarea de copia de seguridad queda de una actualización.
5. Restaure el servidor PI Data Archive a partir de la copia de seguridad, como se describe en
Restaurar una copia de seguridad en un servidor de PI Data Archive existente, luego
verifique el servidor restaurado para asegurarse de que la copia de seguridad y la
restauración se hayan realizado correctamente.
Colectivos y copias de seguridad de PI Data Archive

Como mínimó, cónfigure copias de seguridad para el servidor primario en un colectivo de PI
Data Archive. Un colectivo no es un reemplazo de una copia de seguridad.
Considere cónfigurar copias de seguridad para los servidores secundarios y para el primario.
Existen diversas buenas razones para realizar una copia de seguridad de los servidores
secundarios.
• No toda la infórmación de la cónfiguración se replica. Los datos no replicados incluyen
parametrós de ajuste y registros de mensajes de PI Data Archive. En parte, estos archivos se
pueden enumerar por el comando piartool -backup -identify -verbose ; los
componentes no replicados en los cuales pueden diferir los datos entre los nodos primario y
secundario incluyen los parametrós de tiempo de espera, y los componentes pimsgss y
pibatch. Sin embargo, los datos no replicados tambien incluyen scripts de batches
personalizados, archivos .ini y registros que se pueden copiar con el script
pisitebackup.bat.
• La córrupción de la base de datos puede ocurrir en los nodos primario y secundario. El paso
de validación en el final de la copia de seguridad, por ejemplo, puede detectar la córrupción
en un nodo secundario que no ócurrió en el nodo primario.
• Si el nodo secundario y el primario estan separados geógraficamente en una red lenta, es
posible que sea mas conveniente restaurar el nodo secundario a partir de una copia de
seguridad, en lugar de reiniciar desde el nodo primario.

Las horas de inicio y de finalización de los archivos no son las mismas en los nodos primario y
secundario. Reiniciar un nodo secundario normalmente requiere pasos manuales para eliminar
brechas de datos. Si se restaura un nodo secundario a partir de una copia de seguridad, no
habra vacíós de datos.
Si restaura un servidor de PI Data Archive primario de una copia de seguridad, debe reiniciar
todos los servidores secundarios del servidor de PI Data Archive primario. Si restaura un
servidor de PI Data Archive primario desde una copia de seguridad del servidor de PI Data
Archive secundario, debe reiniciar los otros servidores secundarios.
Ver el historial de copias de seguridad de un servidor de PI

Data Archive
Procedimiento
1. Abra PI SMT.
2. En el panel Servidores, seleccione el servidor que desea comprobar.
3. En el panel System Management Tools, seleccione Operación > Backups.
4. En la lista desplegable PI Server, seleccione el servidor que desea examinar. En la lista, se
incluyen todos los servidores seleccionados en el panel Servidores.
En la tabla Backup History. se muestra el historial de las copias de seguridad para el
servidor seleccionado en la lista PI Server. Por defecto, la tabla enumera las ultimas
100 copias de seguridad y muestra un subconjunto de estos datos disponibles:
Columna Data
Index Numeró que representa el orden en que ocurrieron las copias de
seguridad.
Hora de inicio Hora de inicio de la copia de seguridad.
Status Códigó del estado y la descripción del códigó del estado para cada
copia de seguridad.
Archivos copiados Cantidad de archivos copiados durante la copia de seguridad.
Tamanó Tamanó total de la copia de seguridad.
Duración Tiempo transcurrido para completar la copia de seguridad.
Errores en la copia de archivos Cantidad de archivos en los que falló la copia de seguridad.
Archivos totales Cantidad de archivos seleccionados para la copia de seguridad.
Type Copy, Incremental, Differential, Full y Numarch/Cutoff. Consulte
Tipos de copia de seguridad de PI Data Archive.
VSS Verdadero para las copias de seguridad VSS; falso para las copias
de seguridad que no son de VSS.
Nota:
PI Server 2015 y versiones posteriores son compatibles
unicamente con las copias de seguridad VSS.
Modo del componente Verdadero para las copias de seguridad del modo de componente;
falso si no es el caso.
Tercero Verdadero si se utilizó una aplicación de copia de seguridad de
terceros para realizar la copia de seguridad de PI Data Archive;
falso si se utilizó PI Backup Subsystem.
Duración de la inicialización Tiempo transcurrido antes de que comience la copia de seguridad
despues de la solicitud de la copia de seguridad.

Nota:
Haga clic con el bótón derecho en un encabezado de columna para ver una lista
completa de las columnas que puede mostrar.
En esta sección
• Tipos de copia de seguridad de PI Data Archive
• Cambio de la cantidad de copias de seguridad que se muestran en la tabla Backup History
• Ver resumen de la infórmación sobre la copia de seguridad
• Ver detalles de las copias de seguridad
Tipos de copia de seguridad de PI Data Archive

La tabla Backup History puede mostrar los siguientes tipos de copias de seguridad:
• Copiar
El tipo de copia de seguridad para copias de seguridad no programadas, es decir, aquellas
que se ejecutan con la herramienta Backups.
• Incremental
El tipo de copia de seguridad para las copias de seguridad de PI Data Archive programadas
de forma periódica.
• Differential
Un tipo de copia de seguridad si utiliza software de copia de seguridad de terceros para
realizar una copia de seguridad de PI Data Archive.
• Completo
Un tipo de copia de seguridad si utiliza software de copia de seguridad de terceros para
realizar una copia de seguridad de PI Data Archive.
• Numarch/Cutoff
El tipo de copia de seguridad para copias de seguridad programadas de forma periódica que
fueron cónfiguradas en las versiones de PI Server 3.4.370 o 3.4.375.
Cambio de la cantidad de copias de seguridad que se muestran en la tabla

Backup History
Para cambiar la cantidad de copias de seguridad que se muestran en la tabla Backup History,
cónfigure el parametró de ajuste Backup_MaxHistory.
Procedimiento
1. Abra PI SMT.
2. En Collectives and Servers, seleccione el servidor que quiere comprobar.
3. En System Management Tools, seleccione Operation > Tuning Parameters.
4. En la herramienta Tuning Parameters, haga clic en la pestana Backup.
5. Haga doble clic en Backup_MaxHistory y cónfigure el valor del parametró.

Ver resumen de la información sobre la copia de seguridad

La pestana Summary debajo de la tabla Backup Details contiene infórmación acerca de la copia
de seguridad seleccionada.
Procedimiento
• Seleccione una copia de seguridad de la tabla Backup History para ver infórmación acerca
de la copia de seguridad de los campos Summary debajo de la tabla:
◦ Estado
El códigó del estado de la copia de seguridad: ya sea Success o un códigó de error por un
error que ócurrió.
◦ Método
Infórmación acerca del metódó de la copia de seguridad:
▪ Tipo
Los tipos de copia de seguridad incluyen incremental, copy, full, differential o
Numarch/Cutoff (consulte Tipos de copia de seguridad de PI Data Archive).
▪ VSS/no VSS
Verdadero para las copias de seguridad VSS; falso para las copias de seguridad que no
son de VSS.
Nota:
PI Server 2015 y versiones posteriores son compatibles unicamente con las copias de
seguridad VSS.
▪ Modo del componente

Significativó solo para copias de seguridad de terceros. Algunas aplicaciones de copia
de seguridad de terceros no pueden realizar copias de seguridad del modo de
componente y no proporcionan infórmación a PI Data Archive sobre el exitó o fracaso
de la copia de seguridad.
▪ Tercero
Aparece si PI Backup Subsystem no es la aplicación que se utilizó para realizar la copia
de seguridad.
◦ Hora de inicio
La hora de inicio de la copia de seguridad.
◦ Duración
El tiempo transcurrido para completar la copia de seguridad.
Ver detalles de las copias de seguridad

La herramienta Backups proporciona acceso a detalles acerca de las copias de seguridad de PI
Data Archive.

Procedimiento
• Haga doble clic en una copia de seguridad de la tabla Backup History para abrir la ventana
Backup Details. En la ventana Backup Details, se muestra un resumen de los detalles de las
copias de seguridad y una lista de archivos copiados.
En esta sección
• Resumen de los detalles de la copia de seguridad
• Lista de archivos con copia de seguridad
Resumen de los detalles de la copia de seguridad

Use la pestana Summary en la ventana Backup Details para ver los detalles de la copia de
seguridad seleccionada. En la parte superior izquierda de la pestana, el campo Index muestra el
numeró de índice de la copia de seguridad que esta viendo actualmente.
El numeró de índice representa el orden en que ócurrió la copia de seguridad, en relación con
las otras copias de seguridad de la lista. Utilice estas opciones para ver los detalles de una copia
de seguridad diferente:
• Haga clic en las flechas junto al campo Index.

• Introduzca un numeró de índice directamente en el campo Index.
• Use las flechas Previous y Next que se encuentran en la parte superior de la ventana.
La pestana Summary muestra toda la infórmación que se incluye en el area Summary debajo de
la tabla principal Backup History. Consulte Ver resumen de la infórmación sobre la copia de
seguridad si desea obtener mas infórmación sobre estos campos. La pestana Summary tambien
proporciona lo siguiente:
• Las siguientes estadísticas de la copia de seguridad de cada subsistema y archivo históricó

incluido en la copia de seguridad:
◦ Hora de inicio de la inmovilización

La hora a la que todos los subsistemas ingresaron en un estado inmovilizado; si la copia
de seguridad es correcta, se actualizara la hora de la ultima copia de seguridad de los
ficherós de archivado con esta estampa de tiempo.
◦ Duración de la inmovilización
Cantidad maxima de tiempo que las bases de datos pudieron haber estado inmovilizadas
(para escrituras) para un subsistema que se le realizó la copia de seguridad.
◦ Transición de inmovilización
Tiempo que tardan todos los subsistemas para cambiar de un estado no inmovilizado a
un estado inmovilizado.
◦ Duración de la inicialización
Tiempo transcurrido entre la emisión de la solicitud de la copia de seguridad y el inicio
de la copia de seguridad.
• Una lista de subsistemas que estaban disponibles en el momento que se ejecutó la copia de
seguridad.

Lista de archivos con copia de seguridad

La pestana Backed Up File List en la ventana Backup Details muestra un resumen de
infórmación y una lista de los archivos a los que se realizó una copia de seguridad. En el caso de
copias de seguridad abortadas o incorrectas, los archivos a los que no se les realizó copia de
seguridad aparecen en rojo.
El resumen de infórmación se compone de lo siguiente:
• Archivos totales
Cantidad de archivos seleccionados para la copia de seguridad.
• Errores en la copia de archivos

Cantidad de archivos para los que se debería haber hecho una copia de seguridad, pero no se
hizo.
• Archivos con copia de seguridad

Cantidad de archivos a los que se les realizó copia de seguridad.
• Archivos sin cambios para la copia de seguridad incremental

Numeró de archivos a los que no se realizó una copia de seguridad porque no se módificarón
desde la ultima copia de seguridad. Este campo aparece solo si la copia de seguridad
seleccionada fue una copia de seguridad incremental. Consulte Tipos de copia de seguridad
de PI Data Archive.
La tabla en la parte inferior de la pestana muestra listas de archivos copiados:
Columna Descripción
Nombre del archivo El nombre del archivo de copia de seguridad
Directorio de fuentes El nombre de ruta completo del directorio donde se ubica el archivo
de copia de seguridad
Informe La acción llevada a cabo o el motivo por el que falló la copia de
seguridad
Destino El nombre del directorio donde se realizó la copia de seguridad de
este archivo
Estado Un códigó de estado: success para una copia de seguridad correcta
o un error para una copia de seguridad incorrecta
Tamanó El tamanó del archivo en KB
Descripción del componente El nombre del componente al que pertenece el archivo
Puede:
• Haga clic en un encabezado de columna para ordenar la lista por esa columna.
• Haga clic con el bótón derecho en un encabezado de columna para seleccionar las columnas
que quiere mostrar.
Resolución de problemas de las copias de seguridad de PI

Data Archive
En esta sección
• Ver mensajes y registros de copias de seguridad de PI Data Archive

• Problemas comunes con las copias de seguridad

• Error en la copia de seguridad de PI Data Archive debido a subsistema desconectado
• Realizar una copia de seguridad de PI Data Archive a pedido
• Exportar el historial de copias de seguridad de PI Data Archive
Ver mensajes y registros de copias de seguridad de PI Data Archive

Compruebe que los siguientes archivos de registros no contengan mensajes de error:
• Registro de script de copia de seguridad

El registro de script de copia de seguridad se escribe en el directorio de destino de la copia
de seguridad con el nombre de tipo pibackup_dd-mmm-yy_hh.mm.ss.txt. Por ejemplo:
pibackup_5-Aug-05_14.16.22.txt.
• registro de mensajes de PI
Para visualizar todos los mensajes de error entre la hora de inicio y la hora de finalización
de una copia de seguridad, utilice un comando del tipo:
pigetmsg -sl E –st starttime –et endtime
Si se produce algun error durante una copia de seguridad, el resultado de este comando se
vuelca autómaticamente en el registro de script de la copia de seguridad.
Para visualizar todos los mensajes relacionados con una copia de seguridad, utilice un
comando del siguiente tipo:
pigetmsg -src pibackup –st starttime –et endtime
Para visualizar solo aquellos mensajes de PI Backup Subsystem, utilice un comando del
siguiente tipo:
pigetmsg -pr pibackup –st starttime –et endtime
• Registro de eventos de aplicación de Windows
Busque mensajes de fuentes de eventos VSS y COM+.
• Registro de eventos del sistema Windows
Busque mensajes de fuentes de eventos VOLSNAP y NTFS.
Problemas comunes con las copias de seguridad

Las copias de seguridad pueden fallar debido a los siguientes motivos:
• En ocasiones, el sistema puede ingresar en un estado en el que ole32.dll queda sin

registrarse. Si ole32.dll no esta registrado, las copias de seguridad no funcionan. Para
resolver este problema, vuelva a registrar ole32.dll con el siguiente comando:
regsvr32 ole32.dll
• Las copias de seguridad pueden fallar si se deshabilita alguno de los siguientes servicios:
◦ Microsoft Software Shadow Copy Provider
◦ Volume Shadow Copy
• Generalmente, el servicio Volume Shadow Copy no debería ejecutarse. Se inicia a pedido
cuando es necesario. Si el servicio se esta ejecutando, puede atascarse en un estado
incorrecto. Para detener el servicio, ingrese el siguiente comando:
net stop "Volume Shadow Copy"
Si este comando no funciona, use Windows Task Manager para finalizar el proceso de
VSSVC.exe.

• Se sabe que las copias de seguridad de PI Data Archive fallan cuando se instala OfmProvider
del software St. en el equipo PI Data Archive. Para determinar si este software esta instalado,
ejecute el comando de proveedores de lista vssadmin y busque OfmProvider en el
resultado.
• Todos los archivos históricós a los que se les realizara una copia de seguridad deben estar en
el equipo de PI Data Archive. La copia de seguridad fallara si el archivo históricó al que se le
realizara una copia de seguridad se encuentra en una unidad remota, como por ejemplo, una
unidad de red asignada.
• Las copias de seguridad requieren al menos una partición NTFS en el equipo donde PI Data
Archive esta instalado.
Error en la copia de seguridad de PI Data Archive debido a subsistema

desconectado
Cuando un subsistema se registra para una copia de seguridad, este debe permanecer
conectado durante la próxima copia de seguridad o, de lo contrario, se próducira el siguiente
error:
Backup start failed, Status: [16896] RPC Resolver offline for a subsystem to
which the backup subsystem is communicating. Find -10733 error in message log to
identify problematic RPC
Apareceran dos mensajes en el registro de mensajes de PI Data Archive con el error -10733
similar al siguiente:
E 19-Oct-09 13:54:57 pibackup (5059)
>> Callback failed for <pibatch> for the IDENTIFY event. Error [10733]
PINET: RPC Resolver is Off-Line.
E 19-Oct-09 13:54:57 pibackup (5061)
>> Error [10733] PINET: RPC Resolver is Off-Line., failed to send the IDENTIFY
backup event to pibatch
Para resolver el problema, puede iniciar el subsistema que no esta en ejecución o puede hacer
lo siguiente, si el subsistema se detuvo deliberadamente:
1. Ejecute el comando piartool -backup -query y tome nota de los subsistemas que
actualmente estan registrados para la copia de seguridad.
2. Reinicie PI Backup Subsystem.
3. Espere a que los subsistemas registrados previamente se vuelvan a registrar para realizar la
copia de seguridad, excepto el subsistema que presenta problemas. Los subsistemas pueden
tardar hasta 5 minutos en volver a registrarse para realizar la copia de seguridad despues de
haber reiniciado el subsistema de copia de seguridad.
Realizar una copia de seguridad de PI Data Archive a pedido

Utilice la herramienta Backups en SMT para realizar copias de seguridad a pedido de PI Data
Archive para realizar pruebas y resolver problemas. Las copias de seguridad a pedido se
ejecutan en el modo de componente.
Nota:
No utilice la herramienta Backups como reemplazo de las copias de seguridad
programadas. Sus copias de seguridad diarias deben cónfigurarse como una tarea
programada de Microsoft Windows.

Antes de empezar
Para realizar una copia de seguridad de PI Data Archive, los usuarios deben contar con
permisos de acceso de lectura y escritura en la tabla PIBACKUP. Utilice la herramienta PI SMT
Database Security para otorgar este acceso a los usuarios.
Procedimiento
1. En la ventana Backups, seleccione el servidor de datos de la lista de PI Server.
2. Haga clic en Backup Now .
3. En la ventana del servidor Backup, seleccione los componentes de PI Data Archive para los
que desea realizar la copia de seguridad.
A medida que realiza una selección, en el lado derecho de la ventana se muestra la lista de
archivos para los que se hara copia de seguridad.
4. En el campo Backup Location, ingrese o vaya a la ruta del directorio de destino.
Puede especificar una ruta UNC o ruta local en el servidor en el que esta realizando la copia
de seguridad.
Nota:
Si no ejecuta PI SMT en el mismo servidor PI Data Archive en el que esta haciendo la
copia de seguridad, no pódra utilizar el bótón de explóración a menos que tenga
acceso de administrador de Windows a ese servidor.
5. Haga clic en Backup.
Resultados
En la ventana Backup History se móstraran los detalles de la copia de seguridad, incluido el
progreso de dicha copia y si se realizó correctamente o se abórtó.
Exportar el historial de copias de seguridad de PI Data Archive

Puede usar la herramienta Backups para exportar un informe de historial de copias de
seguridad a un archivo XML.
Procedimiento
1. Haga clic en el bótón Export Backup Reports para abrir la ventana Save Backup History As.
2. Busque la ubicación donde lo guardara.
3. Ingrese el nombre del archivo.
4. Haga clic en Save.
Scripts de copia de seguridad de PI Data Archive

Los scripts de copia de seguridad de PI Data Archive se ubican en el directorio PI\adm.
• pibackup.bat
Utilice este script para realizar o instalar una copia de seguridad como tarea programada.
• pibackuptask.bat
Este script inicia pibackup.bat y redirige la salida estandar a un archivo de registro.

• pisitebackup.bat
Este script de copia de seguridad personalizado no existe de manera predeterminada.
• pintbackup.bat
Este script de copia de seguridad personalizado no existe de manera predeterminada y
generalmente no debe implementarse a menos que haya actualizado PI Data Archive.
• pibackup_3.4.370.bat
La instalación de PI Data Archive crea este script solo al realizar la actualización de 3.4.370 a
3.4.375 o versión posterior.
Con la excepción de instalar una tarea de copia de seguridad con pibackup.bat, no necesita
ejecutar ninguno de estos scripts de copia de seguridad directamente.
Nota:
Si el servidor de PI AF se instala en el mismo equipo que el servidor de PI Data Archive,
entonces, un script adicional llamado afbackup.bat se instalara en el directorio pipc
(pipc\AF\sql).
En esta sección
• pibackuptask.bat
• pibackup.bat
• pisitebackup.bat
• pintbackup_3.4.370.bat
• afbackup.bat
pibackuptask.bat
La tarea de copia de seguridad programada inicia el script pibackuptask.bat para poner en
marcha la copia de seguridad. El script inicia pibackup.bat y redirige la salida estandar a un
registro de copia de seguridad. El registro de copia de seguridad se escribe en el directorio de
destino de la copia de seguridad y el archivo de registro tiene el nombre de la siguiente forma:
pibackup_dd-mmm-yy_hh.mm.ss.txt
Por ejemplo:
pibackup_5-Aug-05_14.16.22.txt
pibackup.bat
Este script se utiliza para instalar una copia de seguridad como se describe en Crear la tarea de
copia de seguridad programada. El script pibackup.bat realiza la copia de seguridad real de
PI Data Archive e inicia el script pisitebackup.bat despues de realizar dicha copia. Cuando
se ejecuta la tarea de copia de seguridad, el script pibackuptask.bat se inicia directamente,
el cual a su vez inicia pibackup.bat.
El script pibackup.bat inicia la copia de seguridad de PI Data Archive al ejecutar un solo
comando piartool -backup .
Despues de ejecutar pibackup.bat para cónfigurar el servicio de copia de seguridad, no es
necesario que lo ejecute nuevamente en forma directa. Para lanzar una copia de seguridad
antes de su hora programada, abra el panel de control de Tareas programadas de Windows y
ejecute la tarea programada PI Server Backup desde allí. Para ejecutar una copia de seguridad
manual (una que no cambie la hora de la ultima copia de seguridad de sus copias de seguridad

programadas), utilice la herramienta Backups de PI SMT. Para obtener mas infórmación,

consulte Realizar una copia de seguridad de PI Data Archive a pedido.
Nota:
No personalice directamente el script pibackup.bat. Este script se sobrescribe en
actualizaciones de PI Data Archive.
pisitebackup.bat
Despues de finalizar la copia de seguridad de PI Data Archive, pibackup.bat
iniciapisitebackup.bat, siempre que pisitebackup.bat exista.
El script pisitebackup.bat puede utilizarse para:
• Realizar la copia de seguridad de archivos específicós del sitio.

• Copiar archivos del directorio de copia de seguridad en una ubicación segura. Esto debe
realizarse solo si no esta disponible un programa de copia de seguridad de terceros.
• Activar una copia de seguridad del directorio de copia de seguridad con un programa de
copia de seguridad de terceros.
La pisitebackup.bat no existe de manera predeterminada. Sin embargo, PI Data Archive
instala el archivo pisitebackup.bat.example en la carpeta PI\adm\. Al eliminar
simplemente la extensión .example, el script realiza una copia de seguridad de todos los
archivos que terminan en .bat, .log, .ini, .txt y .sql en directorios principales PIPC de
32 bits y 64 bits. Si desea realizar una copia de seguridad de otros archivos o llevar a cabo otras
tareas, debe personalizar el script. Las instrucciones sobre persónalización se encuentran en el
propio archivo pisitebackup.bat.example.
Nota:
El script pisitebackup.bat no se sobrescribe cuando se actualiza PI Data Archive.
pintbackup_3.4.370.bat
El script pibackup_3.4.370.bat se crea mediante la instalación de PI Data Archive
solamente al actualizar a partir de la versión 3.4.370. El script pibackup_3.4.370.bat
mantiene el comportamiento de las copias de seguridad de la versión 3.4.370 de manera que la
copia de seguridad específica de un sitio del usuario no se dane a causa de la actualización.
afbackup.bat
El script pibackup.bat inicia afbackup.bat, si este existe. Debido a que afbackup.bat es
parte de la instalación del servidor AF, existe en el equipo PI Data Archive solo si el servidor AF
esta instalado en el mismo equipo como PI Data Archive. El script afbackup.bat esta
instalado en el directorio pipc en pipc\AF\sql.
De manera predeterminada, el script afbackup.bat realiza una copia de seguridad de una
instancia de SQL Server denominada ./sqlexpress. Si la base de datos de PI AF se denomina
sqlexpress y se encuentra en el equipo PI Data Archive, la tarea de copia de seguridad
programada realiza una copia de seguridad de esa base de datos. La copia de seguridad de la
base de datos de PI AF se escribe en:
pibackupdir\AF\
donde pibackupdir es el directorio de la copia de seguridad transferido al script

pibackup.bat.

Puede editar el archivo afbackup.bat para realizar una copia de seguridad de una instancia
de SQL Server diferente, como sqlserver. El script afbackup.bat es un archivo específicó del
sitio. Si actualiza PI Data Archive, este archivo no se sobrescribe.
Cómo funciona la verificación de copia de seguridad de PI

Data Archive
De manera predeterminada, la tarea de copia de seguridad de PI Data Archive realiza una copia
de seguridad incremental de los archivos PI Data Archive.
PI Backup Subsystem intenta mantener una copia de seguridad coherente sin archivos
corruptos o copiados parcialmente en el directorio de copia de seguridad de PI Data Archive.
Para ello, copia archivos temporalmente en un directorio precommit antes de moverlos a su
destino final. Este directorio precommit es un subdirectorio que se encuentra en el directorio
de copia de seguridad de PI Data Archive. Si se aborta la copia de seguridad, si PI Backup
Subsystem genera una falla o si los archivos del directorio precommit no superan la
verificación, los archivos del directorio precommit no se móveran a su destino final. Por lo
tanto, siempre debe estar disponible la ultima copia de seguridad realizada correctamente.
El proceso de copia de seguridad funciona de esta manera:
1. Los archivos que corresponden a los componentes seleccionados para la copia de seguridad
se copian en el directorio precommit.
2. El archivo primario y los archivos que corresponden a los subsistemas base y Snapshot se
verifican en el directorio precommit.
3. Si los archivos superan la verificación, se mueven al directorio de la copia de seguridad. Los
archivos con el mismo nombre que ya existan en el directorio de la copia de seguridad
cambiaran de nombre antes de moverse.
4. Si todas las operaciones de movimiento se realizan correctamente, los archivos con nombre
cambiado se eliminaran.
Si la copia de seguridad no supera la verificación, los archivos se dejaran en el directorio

precommit y el motivo por el que se produjo un error en la copia de seguridad se escribira en
un archivo pibackupverify_*.log en el directorio de copia de seguridad PI Data Archive. Si
sucesivas copias de seguridad no superan la verificación, los archivos cómenzaran a
acumularse en el directorio precommit. Luego de la siguiente copia de seguridad realizada
correctamente, todos los archivos se cópiaran en su destino final.

La siguiente tabla muestra los comandos que PI Backup Subsystem genera para realizar la
verificación.
Componente Comando de verificación
Componentes del archivo históricó pidiag -archk
pibasess pibasess -verifydb
pibasess pidiag -fb
Aunque solo el archivo primario se verifica de manera predeterminada, el numeró de archivos

históricós que se deben verificar puede cónfigurarse con el parametró de ajuste
BackupVerification_NumArch. De manera alternativa, la verificación puede suprimirse al
cónfigurar el parametró de ajuste de BackupVerification en 0.
Aunque la ultima copia de seguridad realizada correctamente no debería estar corrupta, sigue
siendo imprescindible que realice una copia de seguridad del directorio de copia de seguridad
PI Data Archive, preferentemente con software de copia de seguridad de terceros. Por ejemplo,
si elimina por accidente un PI point y luego realiza una copia de seguridad, el PI point tambien
se eliminara en la ultima copia de seguridad realizada correctamente. Para recuperar el PI
point eliminado, es posible que deba restaurar una copia de seguridad anterior. Si no conserva
varias copias de seguridad de su directorio de copia de seguridad de PI Data Archive, no tendra
medios para realizar esta restauración.
Restaurar PI Data Archive a partir de una copia de seguridad

Puede restaurar un servidor PI Data Archive en el mismo equipo en que se estaba ejecutando o
en un equipo nuevo.
En esta sección
• Restaurar una copia de seguridad en un servidor de PI Data Archive existente
• Restaurar una copia de seguridad de PI Data Archive en un equipo nuevo
Restaurar una copia de seguridad en un servidor de PI Data Archive

existente
En esta sección se explica cómó restaurar un servidor PI Data Archive a partir de una copia de
seguridad. Siga estas instrucciones para restaurar el servidor PI Data Archive en el mismo
equipo en que se estaba ejecutando.
Procedimiento
1. Aísle el servidor PI Data Archive de la red.
Para obtener mas infórmación, consulte Aislar un servidor PI Data Archive de los datos de
proceso entrantes.
2. Detenga PI Data Archive.
\%PISERVER%\adm\pisrvstop.bat
3. Elimine el siguiente archivo:
\%PISERVER%\dat\PIModuleUnitDb.dat
Este archivo se regenerara autómaticamente al restaurar desde la copia de seguridad.
4. Restaure la copia de seguridad en un directorio temporal, como C:\TempRestoreDir.

Por ejemplo, si realiza una copia de su directorio de copias de seguridad con una aplicación
de terceros, restaure la copia de seguridad que desee en C:\TempRestoreDir. De manera
alternativa, si va a restaurar la copia de seguridad mas reciente, tambien puede restaurar el
servidor PI Data Archive directamente desde el ultimó directorio de copias de seguridad.
Este procedimiento asume que ha restaurado la copia de seguridad deseada a una carpeta
con el nombre C:\TempRestoreDir.
5. Copie los archivos de C:\TempRestoreDir\dat a %PISERVER%\dat.
6. Copie los archivos de C:\TempRestoreDir\adm a %PISERVER%\adm.
7. Copie los archivos de C:\TempRestoreDir\bin a %PISERVER%\bin.
Nota:
No copie los archivos ejecutables con extensión .exe.
8. Copie los archivos de C:\TempRestoreDir\log a %PISERVER%\log.
9. Copie los ficherós de archivado del directorio C:\TempRestoreDir\arc de su carpeta de
copias de seguridad y pegueló en su ubicación original en PI Data Archive.
Si no esta seguro de dónde se encuentran sus ficherós de archivado en PI Data Archive,
consulte el archivo de registro de copias de seguridad en C:\TempRestoreDir\. El registro
contiene la lista de archivos a la hora de la copia de seguridad.
Debido a que esta realizando una restauración en un servidor existente, no es necesario que
restaure todos los archivos históricós. Como mínimó, debera restaurar el archivo primario.
Restaure otros archivos históricós que necesite.
10. Si se realizó una copia de seguridad de un sitio (si, por ejemplo, existe C:\TempRestoreDir
\sitebackup), copie los archivos desde los directorios de copia de seguridad del sitio y
peguelós en el directorio %PIHOME%.
11. Reinicie PI Data Archive.
12. Restaure la cónexión de PI Data Archive a la red.
13. Utilice la herramienta MDB to AF Synchronization de PI SMT para comprobar el estado de
sincrónización entre MDB y AF.
14. Si MDB y AF no estan sincronizados, utilice la herramienta MDB to AF Synchronization para
restablecer MDB.
Aislar un servidor PI Data Archive de los datos de proceso entrantes

Aísle el servidor PI Data Archive primario de todos los datos de proceso entrantes, de
aplicaciones cliente (como PI ProcessBook) y de otros miembros del colectivo.
Durante la actualización, los usuarios y las aplicaciones realizan la cónmutación por error a
otro miembro del colectivo. (Estos metódós de aislamiento no afectan la cómunicación entre PI
Data Archive y el servidor PI AF).
Para aislar un servidor PI Data Archive:
• Utilice un cortafuegos de Windows u otro cortafuegos comercial para bloquear el puerto

5450.
• Cónfigure un cortafuegos de PI Data Archive con la herramienta Firewall en PI System
Management Tools (PI SMT).

Restaurar una copia de seguridad de PI Data Archive en un equipo nuevo

Este procedimiento lo guía a traves de la restauración de un servidor PI Data Archive completo
a partir de la copia de seguridad y el disco de instalación original. Esto es ideal para los casos
de fallas en el disco o problemas de magnitud similar.
Antes de empezar
Este procedimiento asume que esta restaurando PI Data Archive en un equipo en el que PI Data
Archive nunca antes se había instalado. Debe conocer la siguiente infórmación sobre la
instalación de PI Data Archive que esta restaurando:
• La versión del servidor PI Data Archive que esta restaurando (como PI Server 2012).
• La ruta completa del directorio, incluida la letra de la unidad, para la instalación de PI Data
Archive que esta restaurando (como C:\%PISERVER%).
Procedimiento
1. Cambie el nombre de equipo del nuevo equipo por el nombre del equipo PI Data Archive
antiguo. Reinicie el equipo.
2. Restaure la copia de seguridad en un directorio temporal, como C:\TempRestoreDir.
Por ejemplo, si realiza una copia de su directorio de copias de seguridad con una aplicación
de copias de seguridad de terceros, restaure la copia de seguridad que desee en C:
\TempRestoreDir. De manera alternativa, si va a restaurar la copia de seguridad mas
reciente, tambien puede restaurar el servidor PI Data Archive directamente desde el ultimó
directorio de copias de seguridad. Este procedimiento asume que ha restaurado una copia
de seguridad anterior en una carpeta con el nombre de C:\TempRestoreDir.
3. Copie el kit de instalación en el equipo nuevo.
El kit de instalación debe ser para la misma versión del servidor PI Data Archive que la
versión que esta restaurando. No intente actualizar PI Data Archive como parte de una
restauración.
Nota:
Si esta restaurando una copia de seguridad antigua, use la versión del servidor PI Data
Archive que se instaló al momento en que se realizó la copia de seguridad. La versión
se encuentra generalmente en el registro de copias de seguridad, que debería haberse
restaurado en C:\TempRestoreDir.
4. Desconecte el equipo de la red.
Este paso garantiza que no se pierdan los datos de las interfaces almacenadas en bufer en
los pasos subsiguientes.
5. Ejecute el kit de instalación de PI Data Archive. Realice la instalación en la misma letra de la
unidad y ruta de directorio que el equipo PI Data Archive antiguo.
6. Verifique que el equipo PI Data Archive este desconectado de la red.
7. Inicie PI Data Archive.
8. Cónfirme que PI Data Archive se haya iniciado correctamente y luego detenga PI Data
Archive.
Esto posibilita las funciones de "ejecutar una vez" realizadas despues de la instalación.
Debido a que en este punto el equipo PI Data Archive se desconecta de la red, no se pierden
los datos de los nodos de servidor almacenados en bufer.
9. Mediante el uso de Windows Explorer o el comando de copia, restaure todos los archivos del
directorio C:\TempRestoreDir\dat\ en el nuevo directorio %PISERVER%\dat\.

10. Restaure todos los archivos del registro de mensajes (pimsg_xxxxxxx.dat) de C:

\TempRestoreDir\log\ al directorio %PISERVER%\log.
11. Restaure todos los archivos del directorio C:\TempRestoreDir\adm\ al nuevo directorio
%PISERVER%\adm\.
12. Restaure todos los archivos del directorio C:\TempRestoreDir\bin\ al nuevo directorio
%PISERVER%\bin\.
13. Restaure los archivos históricós del directorio C:\TempRestoreDir\arc\ al mismo
directorio en el que se instalaron en el equipo PI Data Archive antiguo. Puede determinar los
directorios de la lista de archivos históricós en el registro de copias de seguridad
restauradas.
Si restaura los archivos en un directorio diferente, tambien debe usar PI SMT para registrar
el archivo primario en la nueva ubicación (Operation > Archives). Si no esta seguro respecto
a cual de los archivos históricós con copia de seguridad es el archivo primario, examine las
fechas de los archivos históricós. El archivo primario debe tener la ultima hora de inicio y
una hora de finalización correspondiente a la hora actual.
14. Inicie PI Data Archive.
15. Registre archivos históricós adicionales en PI SMT segun sea necesario.
16. Use piartool -al y las herramientas cliente (como PI DataLink) para verificar que se
hayan recuperado todos los datos. Ejecute los clientes a nivel local, ya que el equipo PI Data
Archive se aísla de la red. Si los datos estan intactos, la restauración esta completa.
PRECAUCIÓN:
Si no realiza este paso antes de exponer el servidor restaurado a los datos
almacenados en bufer, puede provocar la perdida de datos.
17. Conecte PI Data Archive a la red. Verifique que sea de facil acceso para los clientes de la red.
Supervise todos los nodos de interfaz almacenados en bufer.
18. Utilice la herramienta MDB to AF Synchronization de PI SMT para comprobar el estado de
sincrónización entre MDB y AF.
19. Si MDB y AF no estan sincronizados, utilice la herramienta MDB to AF Synchronization para
restablecer MDB.


PI points
Los puntos, a veces denominados tags, son los elementos basicós de un PI System porque se
utilizan para realizar un seguimiento de los eventos que constituyen el historial de datos.
Cuando un administrador de sistemas o un ingeniero de servicios de campo de OSIsoft instalan
PI Data Archive, crean un PI point para cada fuente de datos que PI System debe rastrear. PI
Base Subsystem almacena los puntos y sus atributos en la base de datos de puntos.
En esta sección
• Distinción entre mayusculas y minusculas
• Clases y atributos de punto
• Busqueda de puntos defectuosos
• Creación de puntos
• Eliminar y retirar puntos
• Cambiar tipo de PI point
• Módificación de clases de PI point
• Conjuntos de estados digitales
Distinción entre mayúsculas y minúsculas

PI System preserva la distinción entre mayusculas y minusculas de todas las cadenas, como
nombres de puntos y de estados digitales, pero las busquedas no distinguen mayusculas de
minusculas. Por ejemplo, una cadena ingresada como BatchStart se almacena exactamente
como se ingresó. La busqueda de “batchstart” devólvera “BatchStart”.
Clases y atributos de punto

Los atributos de punto especifican cómó y cuandó PI System obtiene datos de una determinada
fuente de datos. Por ejemplo, los atributos determinan con que frecuencia un punto obtiene
valores nuevos, el tipo de datos de un punto (como valor entero o cadena) y quien puede ver o
editar un punto.
Una clase de punto representa el esquema o plantilla de un punto. Determina que atributos
puede definir para un punto de ese tipo. Una clase de punto es esencialmente un grupo de
conjuntos de atributos de punto. Cada conjunto de atributos consta de un grupo de atributos
individuales. La clase de punto se asigna cuando se crea el punto. La clase de punto
predeterminada es la clase de punto Base.
Ningun conjunto de atributos de una clase de punto puede contener el mismo atributo que otro
conjunto. Point Database posee varias clases de puntos diferentes, como Base y Clasicó. La
estructura de la clase de punto Clasicó se describe en la siguiente figura.

PI points
Puede crear, editar y eliminar clases de punto y conjuntos de atributos. La edición y eliminación
de clases de puntos y conjuntos de atributos es raramente necesaria y puede implicar riesgos.
En esta sección
• Clases de punto predefinidas
• Conjuntos de atributos predefinidós
• Atributos del punto de clase Base
• Atributos de clases de puntos clasicós
• Atributos de punto de conectores COM
• Atributos integrados
• Atributos asignados por el sistema
Clases de punto predefinidas

En la siguiente tabla se enumeran las clases de puntos predefinidas.
Clase de punto Conjuntos de atributos que conforman la clase de
punto
Alarm base
alarmparam
Base base
Clasicó base
clasicó

PI points
Clase de punto Conjuntos de atributos que conforman la clase de

punto
SQC_Alarm base
sqcalm_parameters
Totalizer base
totales
Conjuntos de atributos predefinidos

Cuando cree un punto, debe, como mínimó, asignarle un nombre. Si no asigna valores a todos
los demas atributos, PI Data Archive utilizara los valores predeterminados.
Nota:
El acceso prógramaticó a algunos atributos puede ser limitado o no estar disponible
desde PI API.
En esta sección
• alarmparam
• base
• clasicó
• sqcalm_parameters
• totales
alarmparam
Atributo Tipo Valor predeterminado
action1 String
action2 String
action3 String
action4 String
action5 String
AutoAck String yes
ControlAlg String
ControlTag String
Deadband Float32 0
Options String
ReferenceTag String
Srcptid Int32 0
test1 String
test2 String
test3 String
test4 String
test5 String
txt1 String
txt2 String

PI points

txt3 String
txt4 String
txt5 String
base
Atributo Tipo Valor predeterminado Límites
Archiving BYTE 1 ON, OFF, 1 o 0
Changedate Timestamp 31-Dec-69 Asignado por el sistema
16:00:00
Changer String piadmin Asignado por el sistema
Compdev Float32 0.2
Compmax Uint32 28800
Compmin Uint16 0 0 ≤ x ≤ 65535
Compressing BYTE 1 ON, OFF, 1 o 0
Creationdate Timestamp 31-Dec-69 Asignado por el sistema
16:00:00
Creator String piadmin Asignado por el sistema
Descriptor String
DisplayDigits BYTE -5 -20 ≤ x ≤ 10
EngUnits String
Excdev Float32 0.1
ExcMax Uint32 600
ExcMin Uint16 0 0 ≤ x ≤ 65535
ExDesc String
Future UBYTE 0
PointSource String Lab
PointType String Float32
Scan BYTE 1 ON, OFF, 1 o 0
Shutdown BYTE 1
Span Float32 100. x³0
Step BYTE 0
TypicalValue Float32 50. Cero ≤ x ≤ (Zero + Span)
Zero Float32 0.
clásico
Convers Float32 1.
Filtercode Int16 0
InstrumentTag String
location1 Int32 0
location2 Int32 0

PI points

location3 Int32 0
location4 Int32 0
location5 Int32 0
Squareroot Int16 0 On, Off o 0 ≤ x ≤ 10
Srcptid Int32 0
Totalcode Int16 0
userint1 Int32 0
userint2 Int32 0
userreal1 Float32 0.
userreal2 Float32 0.
sqcalm_parameters
AutoAck String yes
ChartType Int32 0
ClearOnLimitChange String true
ClearOnStart String false
CLTag String
CommentTag String
LCLTag String
LSLTag String
Mixture String
OneSideofCL String
Options String
OutsideControl String
OutsideOneSigma String
OutsideTwoSigma String
PIProductLimits String no
ProductTag String
ReferenceTag String
ResetTag String
SQCAlarmPriority Int32 0
Srcptid Int32 0
Stratification String
TestStatusTag String
Trend String
UCLTag String
USLTag String
WaitOnLimitChange String false

PI points
totales
CalcMode String timeweighted
CompValue String ON
Conversion Float32 1
EventExpr String
FilterExpr String
Function String Total
MovingCount Int16 2
Offset String +0m
Offset2 String +0m
Options String
PctGood Float32 85
Period String +1h
Period2 String +2m
RateSampleMode String natural
ReportMode String Running
Srcptid Int32 0
TotalCloseMode String clock
Zerobias Float32 0
Atributos del punto de clase Base

La clase Base es un conjunto cómun de atributos que todas las demas clases de puntos incluyen.
Algunos de estos atributos puede cambiarlos solamente el sistema. Estos atributos se describen
en Atributos asignados por el sistema.
En esta sección
• Archiving
• Cómpresión
• CompDev, CompDevPercent, CompMax y CompMin
• Descriptor
• DigitalSet
• DisplayDigits
• EngUnits
• ExDesc
• ExcDev, ExcDevPercent, ExcMax y ExcMin
• Futuro
• Nombre
• NewTag
• Seguridad de punto
• PointSource

PI points
• PointType
• PtClassName
• Flag de scan
• Flag Shutdown
• SourceTag
• Span
• Paso
• Tag
• Valor típicó
• Zero
Archiving
El atributo de archivado debe establecerse en ENCENDIDO (1) para poder archivar un punto.
Este flag se puede establecer en OFF (0) para detener el archivado de un punto.
Compresión
Activa la cómpresión (cuando el valor es 1) o la desactiva (cuando el valor es 0). Establezca la
cómpresión en On para la mayóría de los puntos. Establezca la cómpresión en Off para los tags
de laboratorio y los ingresados manualmente, de manera que los valores enviados al snapshot
se guarden en el archivo históricó.
La cómpresión afecta a los puntos digitales, ya que se registra un valor nuevo solo cuando
cambia el valor actual. Los puntos de los tipos Blob y string tienen un comportamiento similar;
los nuevos eventos omiten la cómpresión solo cuando cambia el valor. Para los eventos Blob,
cualquier cambio es importante.
CompDev, CompDevPercent, CompMax y CompMin

PI Data Archive utiliza las especificaciónes de cómpresión para filtrar los datos que se
transfieren del snapshot al archivo históricó. Al filtrar los datos que no son necesarios, usted
obtiene un almacenamiento de archivos históricós mas eficiente.
Mientras que el informe de excepciones filtra datos mediante un sencillo metódó de banda
muerta, la prueba de cómpresión lo hace de un modo mas complejo que sigue la pendiente de
los datos (conocido como el algoritmo de compresión “swinging-door”). Cada vez que llega un
snapshot nuevo, el snapshot anterior se evalua de acuerdo con las especificaciónes de
cómpresión para determinar si es un evento importante. Los eventos importantes se envían a la
cola de eventos mientras que los eventos que no son importantes se descartan. Para obtener
mas infórmación, consulte Prueba de cómpresión.
Puede especificar los siguientes atributos de prueba de cómpresión.

PI points
Especificación Atributo Descripción

Desviación de CompDev Especifica la desviación de cómpresión en las unidades de
cómpresión ingeniería del punto. Normalmente, CompDev se ajusta a la
precisión del instrumento.
CompDevPercent Especifica la desviación de cómpresión como un porcentaje
del atributo Span del punto.
Un punto de inicio razonable es 1 o 2 % de Span para los
transmisores y 0,5 a 1 grado para los termopares. Observe las
visualizaciones de tendencias para encontrar puntos para los
que no sea aceptable la repróducción de datos. El objetivo es
filtrar el ruido de instrumento y de proceso, y aun así
registrar cambios de proceso importantes. El efecto de
cambiar la desviación de cómpresión no es predecible.
Cuando cambia CompDev o CompDevPercent, el otro se
actualiza autómaticamente para ser compatible. Si cambia los
dos al mismo tiempo, CompDevPercent anula CompDev.
Para los tags no numericós, CompDev y CompDevPercent se
establecen en cero y se ignoran.
Maximó de CompMax Especifica el tiempo maximó entre eventos en el archivo

cómpresión históricó. Si el tiempo desde el evento de snapshot mas
reciente es mayor o igual al valor de CompMax del punto, se
registra el valor actual de snapshot en el archivo históricó.
Este atributo generalmente se cónfigura en un valor para
todos los puntos del sistema. La especificación de tiempo
maximó recomendada es de 8 horas. Los valores duplicados
se archivan si el tiempo transcurrido excede CompMax.
Nota:
La especificación CompMax no garantiza que un valor se
escriba en el archivo históricó en un determinado
tiempo. El archivo históricó espera que los eventos se
envíen a el. No verifica si se alcanzó el tiempo de
expiración de un punto. No crea valores nuevos.
Tiempo mínimó de CompMin Especifica el tiempo mínimó entre eventos en el archivo

cómpresión históricó. Si el tiempo desde el ultimó evento registrado es
mayor o igual al valor de CompMin del punto, se registra el
valor actual de snapshot en el archivo históricó. Para los
puntos procedentes de interfaces que realizan informes de
excepciones, cónfigure CompMin en cero. Normalmente,
utiliza CompMin para evitar que un punto extremadamente
ruidoso emplee una gran cantidad de espacio de archivo
históricó. Para un sistema de adquisición de datos con un
tiempo de scan lento, este parametró no es importante.
Descriptor
Descriptor es un campo de texto que aparece en la pantalla de diversas aplicaciones cliente y
que se puede utilizar en los informes. Puede tener una longitud de hasta 65 535 caracteres.
Cuando este valor se lee a traves PI API, se trunca en 26 caracteres.
Algunas interfaces utilizan el descriptor para la cónfiguración de tag en un sistema externo. Las
comillas o los caracteres comodines pueden generar cónfusión cuando estos atributos se
transfieren a otras aplicaciones.

PI points
DigitalSet
El atributo DigitalSet especifica el nombre del conjunto de estados digitales relacionado con el
tag (consulte Conjuntos de estados digitales). Este atributo se aplica a los tags de tipo digital
unicamente. Se ignora para todos los demas tipos de tags.
Existe un conjunto de estados digitales especial denominado conjunto de estados digitales del
sistema (consulte Conjunto predeterminado: conjunto de estados del sistema). Todos los tags,
independientemente del tipo, se relacionan con el conjunto de estados digitales del sistema.
DisplayDigits
El atributo DisplayDigits controla el formato de los valores numericós de las pantallas y de los
informes. El cero o un numeró positivo indica la cantidad de dígitós que se móstrara a la
derecha del separador decimal. Un numeró negativo indica la cantidad de dígitós significativós
que se móstrara. En este caso, el valor absoluto de DisplayDigits es el numeró de dígitós
significativós.
La siguiente tabla muestra cómó aparecería el valor 23,45 en la pantalla, dependiendo de los
diferentes valores de DisplayDigits:
DisplayDigits Format
3 23450
2 23,45
1 23,5
0 23
-1 2E+001
-2 23
-4 23,45
EngUnits
La cadena de unidad de ingeniería describe las unidades de medida. Tenga en cuenta que PI
Data Archive no interpreta las unidades de ingeniería; esta cadena es solamente una etiqueta.
La cadena puede ser de cualquier longitud, pero PI API recuperara solamente los primeros
12 caracteres. PI SDK no trunca la cadena.
Los ejemplos incluyen:
DEGF
Degrees Centigrade
Gal/Min
Gallons Per Minute
' " Hg
Las cadenas de unidad de ingeniería distinguen entre mayusculas y minusculas, pero no lo

hacen en la busqueda. El sistema recorta los espacios a la izquierda y a la derecha durante la
entrada.
ExDesc
El descriptor ampliado es un campo de texto de cualquier longitud. Generalmente, se utiliza
para proporcionar infórmación adicional para la dócumentación. Varias interfaces utilizan el
atributo ExDesc para códificar infórmación de cónfiguración adicional.

PI points
ExcDev, ExcDevPercent, ExcMax y ExcMin

La mayóría de los programas de la interfaz utilizan el informe de excepciones para especificar
que eventos se deben enviar a PI Server y que eventos se deben descartar. Para obtener mas
infórmación, consulte Informe de excepciones.
Puede especificar los siguientes atributos de informe de excepciones.
Especificación Atributo Descripción
Desviación de ExcDev Especifica (en las unidades de ingeniería del punto) el grado
excepción de diferencia entre el valor de un punto y el valor anterior
antes de que la interfaz informe el nuevo valor a PI Data
Archive. Normalmente, cónfigura ExcDev en un valor algo
inferior a la precisión del sistema del instrumento.
ExcDevPercent Especifica la desviación de excepción en el porcentaje de
Span en lugar de utilizar unidades de ingeniería. Un valor
típicó es 1 % de Span. Sin embargo, si no se establece el
atributo Span de forma correcta, el informe de excepciones
tambien sera incorrecto.
Cuando cambia ExcDev o ExcDevPercent, el otro se
actualiza autómaticamente para ser compatible. Si cambia los
dos atributos al mismo tiempo, ExcDevPercent anula
ExcDev.
Para los tags digitales, de cadena y Blob, ExcDev y
ExcDevPercent se cónfiguran en cero y se ignoran.
Maximó de ExcMax Especifica el tiempo maximó (en segundos) entre eventos que
excepción la interfaz informa a PI Data Archive. Una vez concluido el
periodo ExcMax especificadó, la interfaz envía el valor nuevo
a PI Data Archive, independientemente de si este valor es
diferente del ultimó valor informado. Por ejemplo, es posible
que los datos entrantes tengan un solo valor durante varios
días. Si ExcMax se cónfigura en 600 segundos (10 minutos), el
valor no se descartara debido a la excepción si la marca de
tiempo del evento anterior era mas de 10 minutos antes de
eso.
Mínimó de ExcMin Especifica el tiempo mínimó (en segundos) entre eventos que
excepción la interfaz informa a PI Data Archive. Si, por ejemplo, ExcMin
cónfigura en 5, la interfaz descartara cualquier valor obtenido
antes de que transcurran 5 segundos desde el ultimó valor
informado. Normalmente, usted cónfigura ExcMin en cero.
Nota:
• Solamente las interfaces utilizan los parametrós de informes de excepciones; no los
utilizan los subsistemas de PI Server.
• Algunas interfaces no son compatibles con el informe de excepciones.
Futuro
Cuando el atributo se cónfigura en Permitido (1), especifica que el punto pretende almacenar
datos futuros.
Cuando este atributo se cónfigura en No permitido (0), el punto se considera “históricó”. Los
puntos históricós rechazan datos con marcas de tiempo que superan la hora actual por mas de
10 minutos.

PI points
Una vez que se crea un punto, no puede cambiar este atributo.

Para obtener mas infórmación, consulte PI points futuros.
Nombre
El atributo Tag, que especifica el nombre unicó de un punto, aparece como “Name” en algunas
aplicaciones, como PI SMT y PI Builder. Para obtener mas infórmación, consulte Tag.
NewTag
El atributo NewTag se utiliza para cambiar el nombre de los tags.
Seguridad de punto
Para cónfigurar la seguridad para los atributos y datos del punto, use los atributos Point
Security y Data Security.
Puede cónfigurar permisos de acceso a la seguridad de punto para PI Identities, usuarios y
grupos de PI.
Para obtener mas infórmación, consulte Establecimiento de permisos de acceso.
PointSource
El atributo PointSource es una cadena que asocia un tag con una interfaz o aplicación de PI. Una
interfaz utiliza el origen de punto para recuperar todos sus puntos.
El origen de punto predeterminado es L o Lab. Utilice L o Lab para los puntos que no esten
relacionados con ninguna interfaz para especificar puntos de entrada de lab.
La herramienta SMT Point Source Table lista los órígenes de punto empleados en este
momento.
Evite usar estos caracteres como órígenes de puntos:
• % (porcentaje)
• ? (signo de interrógación)
• * (asterisco)
• _ (guión bajo)
PointType
El valor PointType se asigna cuando se crea el punto. Para obtener detalles sobre cómó editar
este valor, consulte Módificación de clases de PI point.
Point Type Se utiliza para puntos con
Digital Valores limitados a uno de varios estados discretos diferentes, como ON/OFF y
Red/Green/Yellow.
Int16 Valores enteros entre 0 y 32 767 (enteros sin firma de 15 bits).
Int32 Valores enteros entre -2147450880 y 2147483647 (enteros con firma de 32 bits).
PI System reserva los 32 767 valores mas bajos del intervalo de 32 bits para
estados digitales.

PI points
Point Type Se utiliza para puntos con

Float16 Valores de punto flótante, ajustados. La precisión es de 1/32.767.
Float32 Valores de punto flótante y precisión simple, sin estar ajustados.
Float64 Valores de punto flótante y precisión doble, sin estar ajustados.
String Datos en cadena de hasta 972 caracteres, si tienen anotaciones, o 976 en caso
contrario.
Blob Cualquier tipo de datos binarios de hasta 972 bytes, si tienen anotaciones, o 976 en
caso contrario.
Timestamp Cualquier hora/fecha desde el 1 de enero de 1970 hasta el 1 de enero de 2038,
Universal Time (UTC).
En esta sección
• Tipos de puntos
• Atributos que dependen del tipo de punto
Tipos de puntos
Para los puntos obtenidos por las interfaces, utilice el tipo de punto que coincida mas
estrechamente con el tipo de punto del sistema de origen.
Para los acumuladores y otros valores de alta precisión, utilice los tipos de punto de mayor
precisión: Float32 o Float64.
Los tipos de punto de mayor precisión requieren mas espacio en disco para cada valor
almacenado. Los puntos Float16 utilizan 16 bits o 2 bytes por valor. Float32 y Float64 utilizan 4
y 8 bytes por valor respectivamente. Los valores Int16 e Int32 utilizan 2 y 4 bytes
respectivamente. Int16 admite numerós de 0 a 32 000.
Para almacenar valores enteros negativos, seleccione el tipo de punto Int32.

Recomendamos usar Float32 como el tipo predeterminado para los datos de punto flótante.
Float16 puede reducir la cantidad de E/S, pero esto es importante solo en recuperaciones muy
grandes de datos, como los calculós promedio anuales o las tendencias a largo plazo.
Para obtener mas infórmación, consulte PointType.
Atributos que dependen del tipo de punto

Algunos atributos de puntos no son relevantes para algunos tipos de puntos.
• Solo los puntos de tipo digital utilizan el atributo DigitalSet. Este es relevante para otros
tipos de puntos.
• Para los puntos de tipo no numericó, los valores CompDev, CompDevPercent, ExcDev y
ExcDevPercent no se aplican. Estos valores de atributo se devuelven como 0.
• Para los puntos de tipo no numericó, los atributos Span y Zero no se aplican. Para los puntos
digitales, Zero se establece autómaticamente como el numeró del conjunto digital.
• Para los puntos de tipo no numericó, el flag del paso se establece en On (o 1)
PtClassName
PtClassName especifica la clase de punto. La clase de punto se debe definir antes de que se cree
el punto.
Las clases de PI points por defecto son:

PI points
• Alarm
utilizada para alarmas. Consulte la PI Data Archive Applications Guide para obtener mas
infórmación sobre los puntos Alarm.
• Base
Un conjunto cómun de atributos incluido en todas las clases de punto. La clase Base incluye
atributos asignados por el sistema y por el usuario.
• Clásico
Incluye atributos utilizados por interfaces. Los puntos que representan datos de una interfaz
PI siempre pertenecen a la clase de punto clasicó.
• SQC_Alarm
Utilizado con los puntos de alarma SQC. Consulte la PI Data Archive Applications Guide para
obtener mas infórmación sobre los puntos de alarma SQC.
• Totalizador
Utilizado para puntos que representan una cantidad total de datos en ejecución. Para
obtener mas infórmación sobre los puntos de totalizador, consulte la PI Data Archive
Applications Guide y el tema de ayuda de PI SMT sobre la herramienta Totalizers.
En algunos casos, puede editar las clases de puntos. Para obtener mas infórmación, consulte
Módificación de clases de PI point.
Flag de scan
Algunos programas de la interfaz utilizan un flag de Scan . Las interfaces que respetan este
atributo no actualizan puntos cuyo flag de scan se cónfigura en OFF. Consulte la dócumentación
de la interfaz para conocer si el programa de su interfaz lo utiliza.
Flag Shutdown
El flag Shutdown especifica si se escriben los eventos de cierre. Los valores validós para el
atributo Shutdown son 1 (On) y 0 (Off). Para obtener mas infórmación, consulte Eventos de
cierre.
El flag Shutdown se utiliza junto con el archivo de cónfiguración dat\shutdown.dat.
SourceTag
Para la salida de datos a otros sistemas, SourceTag es el tag de PI de la fuente de datos. Por
ejemplo, puede definir un tag ABC para recibir datos usando el origen de punto A y luego
definir otro tag DEF para enviar esta infórmación a otro sistema de instrumento mediante el
uso del origen de punto B. El tag de origen para el tag DEF sería ABC. Algunas interfaces
utilizan este atributo, aunque otras interfaces utilizan el descriptor ampliado (ExDesc) para
esta infórmación.
La interfaz realiza la lectura y escritura de datos cuando se define este atributo.
El atributo SourceTag no se almacena en Point Database. Solo es una representación mas
legible del atributo srcptid que conserva la ID de punto de origen. El atributo srcptid no existe
en todas las clases de puntos. Por ejemplo, es parte de la clase de punto clasicó, pero no de la
clase de punto base.

PI points
Span
El span es la diferencia entre los valores maximó y mínimó del intervalo. Se requiere para todos
los puntos de tipos de datos numericós.
Para los tipos de punto flóat16, Span se utiliza con Zero para escalar valores en el archivo
históricó. El valor de Span debe ser positivo. Si el valor de un tipo de punto flóat16 es superior
al valor maximó del intervalo, se registra en el archivo históricó como Over Range. Para otros
tipos de puntos, los valores Zero y Span no afectan a los valores registrados en el archivo
históricó.
Span tambien se utiliza al definir tendencias en herramientas cliente (como PI ProcessBook)
con una escala vertical de base de datos.
Para los puntos digitales, el servidor PI Data Archive asigna el valor para este atributo y no
tiene en cuenta los cambios que se le hayan hecho, como por ejemplo, con PI Builder.
Este atributo no se utiliza para puntos que no son numericós.
El valor Span de un punto se puede cambiar sin afectar los datos que ya se encuentran en el
archivo históricó. Para los puntos de tipo flóat16, el valor de Span antiguo se utiliza para
recuperar los datos del archivo históricó obtenidos antes de la edición. El nuevo valor Span se
utiliza para los datos obtenidos despues de la edición. Si cambia el valor de Span, los
porcentajes de desviación de excepción y cómpresión se preservan, pero los campos ExcDev y
CompDev, que se expresan en unidades de ingeniería, se módifican de manera interna. Si
especifica cualquiera de los campos de desviación en la óperación de edición, estos tendran
prioridad.
Nota:
Algunas interfaces utilizan la infórmación de Span para filtrar datos entrantes. Estas
interfaces a menudo convierten los datos que estan fuera del intervalo en estados
digitales por encima y por debajo del intervalo. Sin embargo, las interfaces pueden
utilizar la cónfiguración de Span de otra manera. El propio equipo Servidor PI no cambia
los datos fuera de intervalo, excepto en el caso de los puntos de tipo flóat16.
Paso
El atributo de paso afecta solo a los puntos numericós. Define de que manera se interpolan los
valores numericós archivados. El comportamiento predeterminado, paso OFF (0), trata los
valores archivados como una senal continua. Los valores archivados adyacentes se interpolan
de manera lineal. Por ejemplo, a la hora 12:00:00, se archiva el valor 101.0 y a la hora 12:01:00,
se archiva el valor 102.0. Una solicitud del valor de archivo históricó a la hora 12:00:30
arrójaría 101.5.
El flag de paso ON (1) trata los valores archivados de manera discreta. Los valores archivados
adyacentes no se interpolan; un valor archivado se considera constante hasta el próximó valor
archivado.
Por ejemplo:
• A la hora 12:00:00, se archiva el valor 101.0.

• A la hora 12:01:00, se archiva el valor 102.0.
• Una solicitud de valor a la hora 12:00:30 arrójaría 101.0.
Nota:
Para los puntos de tipo no numericó (digital, cadena y marca de tiempo) el atributo de
paso es siempre ON (1).

PI points
En general, los datos que provienen de senales continuas deberían archivarse en puntos con el
flag de paso OFF. Los ejemplos pueden incluir senales de termopares y medidores de flujó. Los
datos que provienen de mediciones discretas deben archivarse en puntos con el flag de paso
On. Los ejemplos son los datos de laboratorio de muestra y el peso de carga de batch.
La cónfiguración del atributo de paso afecta a la visualización y a la cómpresión.
Se supone que los datos de puntos con este atributo cónfiguradó en 1 permanecen fijós entre
eventos, mientras que los puntos con datos de paso=0 cambian de manera lineal entre eventos
numericós validós.
La prueba de cómpresión no se utiliza cuando el flag de paso se cónfigura en 1. En cambio, se
aplica un calculó de excepción mediante el uso del valor CompDev. Si la diferencia absoluta
entre el snapshot actual y el valor del ultimó archivo históricó es superior a CompDev, el
snapshot se envía al archivo históricó.
Los límites mínimó y maximó de cómpresión funcionan de la misma manera que para los
puntos con el flag de paso no cónfiguradó.
Tag
El atributo de tag es el nombre unicó de un punto. El atributo de tag aparece como “Name” en
algunas aplicaciones, como PI SMT y PI Builder.
Cuando asigne nombres a puntos, utilice una cónvención significativa y coherente.
El atributo de tag puede ser de cualquier longitud e incluir letras, numerós y espacios. Ademas,
posee las siguientes restricciones:
• El primer caracter puede ser alfanumericó, el guion bajo (_) o el símbóló de porcentaje (%).
PRECAUCIÓN:
Evite utilizar el guion bajo (_) y el símbóló de porcentaje (%) en el atributo de tag, ya
que algunas aplicaciones los utilizan de manera especial. Por ejemplo, SQL utiliza estos
caracteres como comodines.
• No estan permitidos los caracteres de control, como los cambios de línea o las tabulaciones.
• No estan permitidos los siguientes caracteres:
* ' ? ; { } [ ] | \ ` ' " ,
Estas restricciones no se aplican a otros atributos de tag, como el descriptor.
Algunas funciones y algunos componentes restringen la longitud del tag:
• PI SQL Subsystem puede procesar tags con hasta 1016 caracteres. Las uniones que implican
tags mas largos no devuelven filas. Las consultas sin uniones devuelven filas, pero truncan
tags en 1016 caracteres.
Cambiar nombres de puntos

Para cambiar el nombre de un punto, utilice la herramienta Point Builder de System
Management Tools (Points > Point Builder), PI Builder o la utilidad piconfig . Con PI Builder y
piconfig, utilice el atributo NewTag de la tabla PIPoint.
Nota:
Muchas aplicaciones cliente, como PI ProcessBook, actualizan autómaticamente los
nombres de puntos. Sin embargo, es posible que deba actualizar algunos programas que
recuperan datos, como las hojas de calculó de PI DataLink.

PI points
Valor típico
El atributo TypicalValue documenta un ejemplo de valor razonable para este punto. Para
puntos numericós, TypicalValue debe ser mayor o igual que el valor del atributo Zero, y menor
o igual que el valor Zero mas los valores del atributo Span. Algunas interfaces utilizan
TypicalValue como el valor inicial o predeterminado.
Zero
El atributo Zero indica el valor mas bajo posible. No tiene que igual al valor mas bajo del
instrumento, pero esa es generalmente una ópción lógica. Algunas interfaces requieren que los
atributos Zero y Span coincidan con el intervalo del sistema del instrumento. Consulte la
dócumentación de la interfaz para obtener detalles. Se requiere este atributo para los puntos de
tipo de datos numericós.
Zero es el valor mínimó del intervalo utilizado para escalar los valores flóat16 en el archivo
históricó. Si el valor para un punto de tipo flóat16 es menor que el mínimó del intervalo, el
valor se registra en el archivo históricó con el estado Under range cuando la cache del archivo
históricó se transfiere al disco. Zero tambien se utiliza al definir tendencias en herramientas
cliente (como PI ProcessBook) con una escala vertical de base de datos.
Para los puntos digitales, el servidor PI Data Archive asigna el valor para este atributo y no
tiene en cuenta los cambios que se le hayan hecho, como, por ejemplo, con PI Builder.
Este atributo no se utiliza para puntos que no son numericós.
El atributo Zero de un punto puede cambiarse sin afectar los datos que ya se encuentran en el
archivo históricó. Para los puntos de tipo flóat16, el atributo Zero antiguo se utiliza para
recuperar los datos de archivos históricós obtenidos antes de la edición. El nuevo valor Zero se
utiliza para los datos obtenidos despues de la edición.
Nota:
Algunas interfaces utilizan la infórmación del atributo Zero para filtrar los datos
entrantes. Estas interfaces a menudo convierten los datos que estan fuera del intervalo en
estados digitales por encima y por debajo del intervalo. Las interfaces tambien pueden
utilizar la cónfiguración del atributo Zero de otras maneras. PI Data Archive en sí mismo
no cambia los datos fuera del intervalo, excepto en el caso de los puntos de tipo flóat16.
Atributos de clases de puntos clásicos

Muchas interfaces de OSIsoft dependen de atributos clasicós. Utilice la clase de punto Clasicó
para todos los puntos de PI Interface si la interfaz utiliza los atributos InstrumentTag o de
códigó de ubicación.
En esta sección
• Filtercode
• Tag de instrumento
• Location1, Location2, Location3, Location4 y Location5
• Rangos de ExcMax y CompMax
• SquareRoot
• Srcptid
• UserInt1, UserInt2, UserReal1 y UserReal2

PI points
Filtercode
El Filtercode indica la constante de tiempo de un filtró de primer orden que se utiliza para
uniformar los datos entrantes. Aunque sí afecta los datos comprimidos, no afecta el informe de
excepciones.
Recomendamos no alterar los datos entrantes al dejar este códigó en su valor predeterminado
de 0. Las otras opciones son las siguientes:
Código Constante de tiempo (segundos)
1 10
2 60
3 120
4 600
Tag de instrumento
Cuando un valor se recupera de un sistema externo o se envía a el, como un DCS, algunas
interfaces utilizan el tag de instrumento como el tag del sistema externo. El campo
InstrumentTag puede tener cualquier longitud. Sin embargo, la mayóría de las interfaces solo
usan los primeros 32 caracteres de este atributo. Algunas interfaces utilizan el descriptor
ampliado (ExDesc) en su lugar.
Location1, Location2, Location3, Location4 y Location5

Existen cinco códigós de ubicación enteros. Sus significadós dependen de la interfaz. Para
muchas PI Interfaces, usted utiliza el atributo Location1 para especificar el numeró de ID de la
interfaz y el atributo Location4 para asignar la clase de scan. En las interfaces de
instrumentación, los códigós de ubicación suelen describir una dirección de hardware o
software para leer o escribir el valor.
Por ejemplo, en PI Interface para OPC DA:
• El atributo Location1 permite especificar la instancia de la interfaz a la que pertenece el
PI point.
• Location2 permite cónfigurar cómó manejar los tipos de datos.
• Location3 permite especificar si este PI point es un punto de sondeo, aviso, evento o salida.
• Location4 permite cónfigurar la scan class del PI point. La scan class determina la frecuencia
con la que se escanean los tags de entrada en busca de valores nuevos.
• Location5 permite especificar un valor de banda muerta para elementos de OPC analógicós.
Rangos de ExcMax y CompMax

El protocolo PI API define los atributos ExcMax y CompMax como un entero con firma de
16 bits. Si PI Data Archive almacena un valor que es superior a 32 767, el valor que devuelve PI
API es 32 767.
Las interfaces usan el valor maximó de excepción para garantizar que envían datos entre el
valor mínimó y el valor maximó de excepción; dichos valores se mantienen en una variable de
numeró entero 16, lo que significa que los valores pueden encontrarse entre -32767 y 32767.
Es importante tener en cuenta que las interfaces NO estan obligadas a seguir estos parametrós.

PI points
En casos especiales, las interfaces que tienen datos superiores a 32767 o inferiores a -32767
pueden decidir no seguir estos parametrós. Esto depende de la interfaz y del programador de la
interfaz.
PI Data Archive controla la cómpresión. Una vez cónfiguradó en el nodo de PI Data Archive, el
valor de cómpresión (32 bits) solamente afectara al nodo del servidor.
Los valores de estos atributos del punto se almacenan como enteros sin firma de 32 bits. El
valor maximó de cada uno es 4 294 967 295 segundos.
Las aplicaciones de PI SDK obtienen de PI Data Archive los valores enteros con firma de 32 bits
para ExcMax y CompMax.
Nota:
Para obtener mas infórmación, consulte ExcDev, ExcDevPercent, ExcMax y ExcMin.
SquareRoot
Algunos programas de la interfaz utilizan el códigó de raíz cuadrada. Consulte el manual
correspondiente su interfaz.
Srcptid
Srcptid es un atributo de solo lectura que representa el numeró de PI point correspondiente al
tag especificadó en el atributo SourceTag.
UserInt1, UserInt2, UserReal1 y UserReal2

PI System se reserva estos cuatro atributos para las aplicaciones de usuario. La mayóría de las
aplicaciones de PI System no utilizan estos atributos. UserInt1 y UserInt2 son enteros de
32 bits. UserReal1 y UserReal2 son numerós de punto flótante de 32 bits.
Atributos de punto de conectores COM

Los conectores COM permiten que PI Data Archive obtenga datos de sistemas de datos
externos. Para hacer esto, debe crear un punto especial con atributos que identifiquen la
ubicación de los datos en el sistema externo.
El terminó asignar significa establecer una relación entre un punto del sistema externo y un
punto de PI Data Archive. Durante la óperación de PI Data Archive, los clientes solicitan datos
usando infórmación de PI point. Luego, PI Data Archive obtiene datos del punto del sistema
externo al cual se asigna el punto PI Data Archive.
Para los puntos asignados, debe definir una clase de punto que incluya estos atributos:
Atributo Descripción
ctr_progid ID de programa de COM, como se almacenó en el registro de Windows. Este
nombre se utiliza para crear una instancia del objeto del conector COM.
ctr_lmap Parametró de asignación de palabra larga.
ctr_strmap Parametró de asignación de string.
ctr_progid utiliza PI Data Archive para cargar el conector COM. Los parametrós de asignación
ctr_lmap y ctr_strmap se transmiten al conector COM a traves del inicio del metódó de COM
de manera que pueda ubicar el punto correcto del sistema externo. El uso de estos dos
atributos se especifica siempre en el manual de los conectores COM.

PI points
PI Data Archive posee un archivo de script llamado classicctr.dif que la utilidad piconfig
puede procesar para definir una clase de punto denominada classicctr. Esta clase de punto
posee todos los atributos de la clase de punto clasicó, ademas de los tres atributos que definen
los puntos asignados. El archivo classicctr.dif puede utilizarse directamente o como una
plantilla para definiciónes personalizadas de clase de punto.
Atributos integrados
Los atributos integrados son parte de cada PI point, pero no pertenecen a ningun conjunto de
atributos en particular. Los tipos y valores predeterminados de los atributos integrados no
pueden editarse.
Atributo Valor predeterminado Límites
CompDevPercent 0 ≤ x ≤ 100
DataAccess o:rw g:r w:r Read, write o sin acceso (en
blanco)
DataGroup piadmins En la base de datos de PI Identity
DataOwner piadmin En la base de datos de PI Identity
DataSecurity piadmin: A(r,w) | piadmins: Read, write o sin acceso (en
A(r) | PIWorld: A(r) blanco)
DigitalSet system Solo se utiliza para puntos
digitales. El valor se especifica
cuando se crea el punto.
ExcDevPercent 0 ≤ x ≤ 100
NewTag
PointID 0 Asignado por el sistema
PtAccess o:rw g:r w:r Read, write o sin acceso (en
blanco)
PtClassName base Base, classic, Totalizer o
alarm
PtGroup piadmins En la base de datos de PI Identity
PtOwner piadmin En la base de datos de PI Identity
PtSecurity piadmin: A(r,w) | piadmins: Read, write o sin acceso (en
A(r) | PIWorld: A(r) blanco)
RecNo 1 Asignado por el sistema
SourceTag
Atributos asignados por el sistema

Al crear un punto, el sistema asignara varios atributos. No puede módificar los valores de estos
atributos.
En esta sección
• ChangeDate
• Cambiador
• CreationDate
• Creador
• PointID

PI points
• RecNo
ChangeDate
La fecha y hora en que se editó el punto por ultima vez.
Cambiador
El ultimó usuario que editó el punto.
CreationDate
La fecha y hora en que se creó el punto.
Creador
El usuario que creó el punto.
PointID
El numeró unicó que identifica el punto internamente. El PointID jamas se reutiliza, incluso
cuando se elimina un punto. El PointID es el identificadór de PI point que se transmite como un
parametró a la mayóría de las funciones de PI API. En el manual de PI API, este identificadór se
conoce como el numeró de punto o PtNum.
RecNo
El numeró de registro contiene el numeró de registros primarios del punto en el archivo
históricó. Esto es util al usar herramientas, como piartool -aw para examinar los archivos
históricós. RecNo no debe confundirse con el atributo PointID.
Búsqueda de puntos defectuosos

La herramienta Stale and Bad Points identifica los puntos que no han recibido datos en mucho
tiempo o cuyos valores actuales representan condiciones defectuosas o de error, como Tiempo
de espera de E/S, PtCreated, Entrada incorrecta y Cierre.
Cuando encuentre puntos erróneós u obsoletos, investigue el motivo de esta cóndición. Algunas
posibles causas son:
• No existe cónexión de red entre el servidor PI Data Archive y la interfaz.
• El equipo de la interfaz se cerró o perdió cónexión con el dispositivo.
• Alguien ha cambiado los atributos del punto.
Si los valores del punto estan obsoletos o son erróneós por algun motivo desconocido, debe
determinar la causa cuanto antes.
Cuando encuentre puntos que ya no sean utiles, como aquellos que representan datos de
equipos obsoletos, retírelós.

PI points
Creación de puntos
La manera mas facil de crear un punto es copiar un punto existente que sea similar al punto
que desea crear y luego editar sus atributos, segun sea necesario.
Point Builder en PI SMT proporciona un modo facil de editar y crear un pequenó numeró de PI
points. Si posee Microsoft Excel, utilice PI Builder para crear un gran numeró de puntos.
Nota:
Para crear puntos, debe tener acceso de lectura/escritura a la tabla PIPOINT. Consulte
Dónde establecer permisos de acceso.
Eliminar y retirar puntos

Al eliminar un punto, perdera todos los datos del mismo y estrópeara cualquier visualización
de los clientes que utilicen dicho punto. Despues de eliminar un punto, no es posible
recuperarlo. Si no esta seguro del própósitó de un punto o de la necesidad de disponer de algun
dato históricó asociado con este, considere la posibilidad de retirar el punto en lugar de
eliminarlo.
Nota:
Para eliminar puntos, debe tener acceso de lectura/escritura a la tabla PIPOINT. Consulte
Dónde establecer permisos de acceso.
En esta sección
• Retirada de un punto con Point Builder
• Retirada de varios puntos con PI Builder
Retirada de un punto con Point Builder

Procedimiento
1. Inicie PI SMT y seleccione el servidor PI Data Archive de ese punto.
2. En System Management Tools, seleccione Points > Point Builder.
3. Busque el punto.
4. Haga clic en la pestana Archive.
5. En Scan, seleccione Off.
Retirada de varios puntos con PI Builder

Procedimiento
1. Abra una hoja de calculó de Microsoft Excel.
2. Haga clic en PI Builder.
3. Seleccione el servidor de datos, el servidor de activos y la base de datos correspondientes.
4. Haga clic en PI Points > Find PI Points.
5. Busque y seleccione los puntos que desea retirar. En la ventana Select Object Types and
Column Headers, asegurese de que esten seleccionadas las opciones scan y pointsource. Los
puntos se móstraran en la hoja de calculó.
6. En la columna scan de la hoja de calculó, cambie 1 por 0 en todos los puntos.

PI points
Nota:
Algunas interfaces utilizan el bit pointsource y no el bit scan para desactivar puntos. A
fin de retirar puntos de una interfaz de este tipo, cambie el atributo pointsource por un
valor que utilice unicamente para puntos retirados.
7. Para publicar los cambios:
a. Haga clic en Publish.
b. En la lista Edit Mode, seleccione Edit only.
c. Haga clic en OK.
Cambiar tipo de PI point

Utilice PI SMT, PI Builder o piconfig para cambiar los tipos de puntos.
Procedimiento
1. Detenga la PI interface que recopila los datos para el punto que planea cambiar.
2. Abra PI SMT.
3. Vaya a Points > Point Builder.
4. Busque y seleccione el punto en relación con el cual desea cambiar el atributo de tipo.
5. En Point type, seleccione el tipo de punto deseado.
6. Guarde los cambios.
En esta sección
• Conversiones de tipos de puntos permitidas
• Cambios en el tipo de punto y archivos históricós
• Cónfigurar el control de errores
Conversiones de tipos de puntos permitidas

Para cambiar correctamente un atributo de tipo de punto, debe realizar el cambio entre tipos
de puntos que pueden convertirse. Por ejemplo, si cambia un tipo de punto a int16 y el valor
actual de snapshot es negativo, la edición falla porque int16 no traduce valores negativos. En
este caso, se devuelve el siguiente error.
[-10005] Subscript Under Range
Los datos del tipo anterior se convierten en el tipo actual al momento de la recuperación.
Si no se puede convertir un evento en el tipo de punto editado, el estado digital Error de
cónversión se devuelve de manera predeterminada. El estado digital Error de cónversión
funciona como marcador de pósición para un evento que PI Snapshot Subsystem no pudo
convertir. Los eventos out-of-order tambien pueden dar como resultado un estado digital de
Error de cónversión.
Utilice el parametró Archive_DataCoercionPolicy para traducir un estado digital. Para obtener
mas infórmación, consulte Cónfigurar el control de errores.
En la siguiente tabla, las conversiones de tipo de punto permitidas se muestran con una marca
de verificación (✓).
int16 int32 float16 float32 float64 digital string blob marca de
tiempo
int16 ✓ ✓5 ✓ ✓ ✓ ✓ N/C N/C

PI points
int16 int32 float16 float32 float64 digital string blob marca de

tiempo
int32 ✓1 ✓5 ✓ ✓ ✓3 ✓ N/C ✓
flóat16 ✓1 ✓2 ✓ ✓ ✓3 ✓ N/C N/C
flóat32 ✓1 ✓2 ✓5 ✓ ✓3 ✓ N/C ✓
flóat64 ✓1 ✓2 ✓5 ✓ ✓3 ✓ N/C ✓
digital ✓ ✓ ✓ ✓ ✓ ✓ N/C N/C
string5 ✓ ✓ ✓ ✓ ✓ ✓4 N/C ✓
blob N/C N/C N/C N/C N/C N/C N/C N/C
marca de N/C ✓ ✓ ✓ ✓ N/C ✓ N/C
tiempo
1Suponiendo que los valores se encuentran en el rango de 0 a 32767.
2Suponiendo que los valores se encuentran en el rango de -2 147 450 880 a 2 147 483 647.
3Suponiendo que los valores enteros y positivos son inferiores al numeró de los estados
digitales.
4Suponiendo que existe una correspondencia exacta, que no distingue mayusculas de
minusculas, con una cadena de estado.

5Suponiendo que el rango del origen es compatible con el rango de destino.
Nota:
Cuando cambia los tipos de puntos a int16 o digital, debe ingresar un valor para los
atributos Zero y Span.
Cambios en el tipo de punto y archivos históricos

Cuando cambia el atributo de un tipo de punto, el registro de archivo históricó actual se cierra y
un nuevo registro se abre. El nuevo registro utiliza el atributo de tipo de punto cambiado.
Las ediciones en el tipo de punto afectan la manera en que los usuarios ven los datos generados
recientemente y los datos que se archivaron anteriormente. Por este motivo, debe considerar si
desea:
• preservar el tipo de punto original en el historial de archivos históricós; o
• convertir todos los archivos históricós para reflejar el cambio en el tipo de punto.
De manera predeterminada, el tipo de punto original se preserva en los archivos históricós. Es
decir, los eventos que se crearon y archivaron antes de la edición del tipo de punto reflejaran el
tipo de punto que se utilizó antes de la edición de este.
Si desea que los datos archivados anteriormente reflejen el nuevo tipo de punto, puede
reprocesar sus archivos históricós sin cónexión para convertir los eventos almacenados en el
nuevo tipo de punto. Consulte Administración de ficherós de archivado desconectados con
piarchss.
Configurar el control de errores

Si PI Archive Subsystem no puede convertir un tipo de punto almacenado en un tipo de punto
editado, los valores se reemplazan segun lo especifica el parametró de ajuste
Archive_DataCoercionPolicy. Puede usar la herramienta PI SMT Tuning Parameters para

PI points
cónfigurar este parametró o usar piconfig para actualizar este parametró en PI Timeout
Table.
El parametró Archive_DataCoercionPolicy puede tener uno de estos valores:
0 DTC_MarkBad Los eventos con error se devuelven como DS -315 (“Error
de cónversión”)
1 DTC_Leave Se devuelven los eventos originales (tipos mixtos)
2 DTC_Zero Se devuelven como 0 o en blanco, segun el tipo
3 DTC_Hide Oculto (omita este evento)
Modificación de clases de PI point

PRECAUCIÓN:
La módificación de los conjuntos de clases de puntos puede activar una serie de ediciones
en muchos puntos y en muchos límites de usuarios y grupos. Módifique las clases de
puntos solo cuando sea absolutamente necesario. Antes de comenzar, realice una copia de
seguridad de su sistema.
Puede convertir un punto de una clase a otra. La óbtención de datos puede continuar para este
punto aunque el metódó de óbtención cambie. Por ejemplo, puede convertir un punto de
totalizador, que pertenece a la clase de punto de totalizador y se completa mediante PI
Totalizer Subsystem, a un punto de ecuación de rendimiento, que pertenece a la clase de punto
clasicó y se completa mediante Performance Equation Scheduler.
Puede módificar los atributos de punto de la siguiente manera:
• Cambie la clase de punto de un punto a otra clase de punto que contenga los atributos
deseados. Para hacer esto, cambie el atributo PtClassName del punto.
• Cambie la clase del punto de manera explícita eliminando y agregando conjuntos de
atributos.
• Cambie la clase del punto de manera implícita módificandó los conjuntos de atributos
existentes. La módificación de un conjunto de atributos activa una serie de ediciones en
todas las clases de puntos que utilizan el conjunto de atributos.
• Las módificaciónes implícitas y explícitas de las clases de puntos activan ediciones de todos
los puntos que pertenecen a la clase de punto módificada. Si no desea módificar todos los
puntos de una clase de punto, cambie las clases de puntos de puntos individuales.
En esta sección
• Permisos de acceso requeridos y otras restricciones
• Edición de la base de datos de las clases de puntos
• Editar la clase de punto de un punto
• Auditóría de la base de datos de puntos
Permisos de acceso requeridos y otras restricciones

Solo el usuario piadmin o el grupo piadmins puede crear, eliminar y editar clases de puntos.
Tambien debe contar con permisos de lectura y escritura en Point Database (PIPOINT). El
usuario piadmin siempre posee acceso de lectura/escritura a PIPOINT, pero si esta utilizando
piadmins, es posible que necesite cónfigurar los permisos de manera explícita.
Las siguientes restricciones se aplican al editar y eliminar clases de puntos (pero no al
crearlas).

PI points
• Puede editar y eliminar clases de puntos solo en modo independiente. Durante el modo
independiente, las conexiones existentes de las aplicaciones de PI SDK, PI API y PI Server se
cierran y se rechazan los intentos de recónexión. Los subsistemas y las utilidades ejecutadas
localmente, como piconfig y piartool pueden conectarse. Las ediciones de atributos
predeterminadas solamente se admiten en modo normal.
• No puede cambiar el nombre de los atributos.
• Puede agregar conjuntos de atributos a cualquier clase de puntos.
• Puede eliminar conjuntos de atributos de una clase de punto (solo si ningun punto los
utiliza), excepto:
◦ Conjuntos de atributos requeridos que se incluyen en clases de puntos predefinidas
(consulte Clases de punto predefinidas)
◦ Clases de puntos en uso
• Puede renombrar cualquier clase de punto, excepto las clases de puntos predefinidas.
• Puede eliminar cualquier clase de punto, excepto:
◦ Conjuntos de atributos predefinidós
◦ Clases de puntos en uso
Estas restricciones pueden limitar su capacidad para deshacer algunas acciones. Antes de
editar clases de puntos, realice una copia de seguridad de PI Point Database.
Edición de la base de datos de las clases de puntos

Nota:
Solo el usuario piadmin o el grupo piadmins puede crear, eliminar o editar clases de
puntos. Tambien debe contar con permisos de lectura y escritura en Point Database
(PIPOINT). El usuario piadmin siempre posee acceso de lectura/escritura a PIPOINT, pero
si esta utilizando piadmins, es posible que necesite cónfigurar los permisos de manera
explícita.
En esta sección
• Ejemplo: crear una clase de punto
• Ejemplo: eliminar una clase de punto
• Edición de clase de punto
• Ejemplo: cambiar el nombre de una clase de punto
Ejemplo: crear una clase de punto

Una vez que se crea una clase de punto nueva, puede comenzar a asignar puntos a esa clase.
Cree una clase de punto mediante el uso de piconfigy especifique que conjuntos de atributos
se deben incluir. Esto no requiere el modo independiente. Todas las clases de puntos deben
incluir el conjunto de atributos base.
Procedimiento
1. En una ventana del símbóló del sistema, cambie al directorio PI\adm.
2. Escriba:
piartool -sys -standalone on
3. En el símbóló piconfig , escriba:

PI points
@table piptcls
@mode create
@istru class
@istru set,...
MyPtClass
Base,MyAttribSet
@ends
4. Para volver al modo normal, ingrese:
piartool -sys -standalone off
Ejemplo: eliminar una clase de punto

Nota:
No puede eliminar las clases de puntos predefinidas o las clases de puntos en uso.
Procedimiento
2. Escriba:
piconfig
@table piptcls
@mode delete
@istru class
MyPtClass
@ends
Edición de clase de punto

Puede editar explícitamente una clase de punto al agregar o eliminar conjuntos de atributos
que forman la clase de punto.
piconfig puede mostrar que conjunto de atributos componen una clase de punto:
@table piptcls
@ostru class
@ostru set,...
@select class=MyPtClass
@ends
Esta función permite determinar con mayor facilidad que conjuntos de atributos se estan
utilizando para componer una clase de punto.
En esta sección
• Consideraciones para las ediciones de conjuntos de atributos
• Ejemplo: editar una clase de punto
• Mensajes informativos
Consideraciones para las ediciones de conjuntos de atributos

Cuando edite conjuntos de atributos, tenga en cuenta los siguientes comportamientos.
• Todas las clases de puntos contienen el conjunto de atributos base.

• Puede agregar cualquier conjunto de atributos a una clase de punto.
• No puede eliminar conjuntos de atributos de clases de puntos que se encuentren en uso.
• No puede eliminar conjuntos de atributos requeridos de clases de puntos predefinidas.

PI points
• No puede cambiar el nombre de las clases predefinidas.

• El cambio de nombre de una clase de punto no activa ninguna edición implícita de puntos.
Ejemplo: editar una clase de punto

Una lista de clases de puntos en piconfig muestra lo siguiente:
* (Ls - ) piconfig> @table piptcls
* (LS - PIPTCLS) piconfig> @mode list
* (Ls - PIPTCLS) piconfig> @ostru class
* (Ls - PIPTCLS) piconfig> @ostru set,...
* (Ls - PIPTCLS) piconfig> @select class=MyPtClass
* (Ls - PIPTCLS) piconfig> @ends
MyPtClass
base,classic
*----------
Procedimiento
1. Agregue los atributos MyAttribute1 (cadena) y MyAttribute2 (int32) a esta clase de punto.
Para hacer esto, cree un conjunto de atributos, MyAttributeSet, de la siguiente manera.
@table piatrset
@mode create
@istru set
@istru attrib,type,default
@istru ...
MyAttributeSet
MyAttribute1,string,my default string
MyAttribute2,int32,22
2. Verifique que el atributo se haya creado correctamente:
@table piatrset
@mode list
@ostru set
@ostru attrib,type,default
@ostru ...
@select set=MyAttributeSet
@ends
Vera el mensaje:
MyAttributeSet
MyAttribute1,String,my default string
MyAttribute2,Int32,22
* End Repeat...
*----------
3. Edite MyPtClass para incluir este conjunto de atributos. El sistema debe encontrarse en
modo independiente. Ingrese lo siguiente en un símbóló del sistema:
piartool -sys -standalone on
4. En piconfig, defina los conjuntos de atributos que deben pertenecer a la clase de puntos:
@table piptcls
@mode edit
@istru class
@istru set,...
MyPtClass
base,classic,MyAttributeSet
5. Compruebe que estos atributos formen ahora MyPtClass.
* (Ed - PIPTCLS) piconfig> @mode list
* (Ls - PIPTCLS) piconfig> @ostru class
* (Ls - PIPTCLS) piconfig> @ostru set,...
* (Ls - PIPTCLS) piconfig> @select class=MyPtClass
* (Ls - PIPTCLS) piconfig> @ends
Vera el mensaje:

PI points
MyPtClass
base,classic,MyAttributeSet
*----------
6. Para ver todos los atributos que se encuentran en esta clase de punto, ingrese:
@table pipoint
@ptclass MyPtClass
@?atr
7. Vuelva a colocar el sistema en modo normal:
piartool -sys -standalone off
Mensajes informativos
Algunos mensajes no se devuelven directamente al usuario, sino que se envían a PI Message
Subsystem. Dichos mensajes incluyen infórmación sobre el estado de los pasos incluidos en la
edición de una clase de punto (cambiar el nombre de la clase original, agregar una nueva clase,
editar puntos dependientes de manera implícita, eliminar la clase original) y el numeró de
puntos dependientes que se encontraron.
Ejemplo: cambiar el nombre de una clase de punto

Puede cambiar el nombre de todas las clases de puntos, excepto de las clases de puntos
predefinidas. Para cambiar el nombre, no es necesario que el sistema se encuentre en modo
independiente.
Procedimiento
2. Escriba:
piconfig
@table piptcls
@mode edit
@istru class,newclass
MyPointClass,MyNewPointClass
@ends
Editar la clase de punto de un punto

Cuando cambie la clase de punto de un punto, los atributos nuevos se agregaran y se
cónfiguraran con valores predeterminados. Se eliminaran los atributos que no correspondan a
la nueva clase de punto. Los atributos existentes se cópiaran si se encuentran en la nueva clase
de punto. Los tipos compatibles cónservaran sus valores y los tipos incompatibles se
cónfiguraran con los nuevos valores predeterminados.
Al editar un punto con piconfig, se pódran módificar nuevos atributos de manera simultanea.
Por ejemplo, puede editar el atributo PtClassName e incluir nuevos atributos que solo
pertenezcan a la nueva clase de punto y que no pertenecían a la clase anterior del punto. Sin
embargo, antes de que intente realizar este tipo de edición, debe cónfigurar la clase de destino.
A modo de ejemplo, intente editar un punto que pertenezca a la clase de punto Totalizer en la
clase de punto Classic en piconfig de la siguiente manera:
@table pipoint
@ptclass Totalizer
@mode edit
@istru tag,ptclassname,location4,pointsource
Se arrójara el siguiente error:

PI points
*piconfig Err> Unknown parameter <location4> in structure

*@istru tag,ptclassname,location4,pointsource
*piconfig Err> Complete Structure line removed
*@istru tag,ptclassname,location4,pointsource
Esto ocurre porque @ptclass Totalizer cónfigura el entorno para esta edición como clase
de punto Totalizer, que no posee el atributo location4. Para editar al mismo tiempo el
atributo PtClassName y los nuevos atributos específicós de la clase de punto de destino,
cónfigure el entorno como clase de punto de destino, Classic, mediante el uso de @ptclass
classic primero:
@ptclass classic
@istru tag,ptclassname,location4,pointsource
tagname,classic,1,C
Si no es necesario editar el atributo PtClassName y nuevos atributos al mismo tiempo, emita:

@ptclass classic
porque PtClassName es un atributo integrado y cada punto posee este atributo.
Convertir clases de conectores COM en clases de PI nativas y a partir de

estas
Se requiere un manejo especial en el caso de la edición de PtClassName de un PI point nativo en
una clase de punto de conector COM o viceversa. La dificultad surge porque, a fin de permitir la
recuperación transparente de datos para un punto que tiene algunos datos en una base de
datos externa y algunos en un archivo históricó de PI, PI Data Archive debe tener en cuenta las
fechas límite e ir a la fuente correcta. La posibilidad de que la cónversión puede producirse
varias veces se suma a la complejidad.
Se ignora el historial de conversiones y se envía una solicitud de datos a la fuente de datos
actual.
Auditoría de la base de datos de puntos

La Base de datos de auditóría incluye los conjuntos de atributos y las clases de puntos. El
parametró EnableAudit en el bit de PI Timeout Table (que empieza desde 0) se utiliza para la
Base de datos de auditóría del conjuntos de atributos y bit 4 para la Base de datos de auditóría
de clases de puntos.
Base de datos Bit Valor por habilitar (decimal)
Base de datos de puntos 0 1
Base de datos de los conjuntos de 2 4
atributos
Bases de datos de las clases de 4 16
puntos
Utilice la herramienta AuditViewer para trabajar con la Base de datos de auditóría.
Conjuntos de estados digitales

Un conjunto de estados digitales posee un nombre y consta de una lista de estados discretos, en
ocasiones denominada cadenas de estados digitales. Por ejemplo, podemos definir el conjunto
de estados digitales Valve-state-set como un conjunto que contiene los estados OPEN y CLOSE.
En esta sección
• Convenciones de nombres de estados digitales

PI points
• Conjunto predeterminado: conjunto de estados del sistema

• Definir un conjunto de estados digitales
Convenciones de nombres de estados digitales

• Los nombres de conjuntos digitales no pueden tener el prefijó “DIGSET_”. Este prefijó se
reserva para conjuntos de estados digitales eliminados.
• Los espacios a la izquierda y a la derecha se eliminan de los nombres de estados.
Conjunto predeterminado: conjunto de estados del sistema

El conjunto predeterminado, denominado conjunto de estados digitales del sistema, contiene
mas de 300 estados digitales que pueden aplicarse a cualquier punto. Se pueden agregar
estados a este conjunto, pero los estados del intervalo de cómpensación 193-320 se reservan
para uso por parte de PI Data Archive y su significadó no debe módificarse. El ultimó estado
posible en el conjunto de estados digitales del sistema es el numeró 16383. Este se reserva para
uso interno de PI Data Archive.
Nota:
Los cambios en el conjunto de estados digitales del sistema deben ser los mínimós
posibles. Como maximó, puede traducir los estados en otro idioma sin cambiar el
significadó. Los puntos digitales deben usar un conjunto digital definidó por el usuario,
no el conjunto de estados digitales del sistema.
A cóntinuación se ofrece un ejemplo de estados digitales predefinidós que representan estados
típicós del sistema:
Estado Descripción
I/O Timeout Las interfaces utilizan este estado para indicar que se produjo un error en la
cómunicación con un dispositivo remoto.
No Data Las funciones de recuperación de datos utilizan este estado para períódós en
los que no pueden existir valores de archivos históricós para un tag
10 minutos en el futuro o antes que el archivo históricó que se instaló con
mayor antiguedad.
Under Range Para los tipos de punto flóat16, este estado indica un valor inferior a cero
para el tag.
Over Range Para los tipos de punto flóat16, este estado indica un valor superior al valor
maximó del rango (Cero + Rango) para ese tag.
Pt Created Este estado se asigna a un tag cuando se crea. Este es el valor de un tag antes
de ingresar un valor en el sistema.
Shutdown Todos los tags que se cónfiguran para recibir eventos de cierre se establecen
en este estado en el cierre del sistema.
Arc Off-line Lo utilizan las funciones de recuperación de datos para indicar un períódó
que no cubre ningun archivo históricó instalado.
Bad Input Las interfaces usan este estado para indicar que un dispositivo presenta un
estado defectuoso.
Definir un conjunto de estados digitales

Para definir conjuntos de estados digitales, utilice la herramienta Digital States en PI SMT
(Points > Digital States) o piconfig. Los puntos digitales generalmente tienen solo un numeró
pequenó de estados validós. Antes de cónfigurar un punto digital, debe definir el conjunto de
estados digitales que este utilizara.

PI points
Por ejemplo, puede cónfigurar un punto para informar la pósición de una valvula con un valor
de códigó digital de 0 o 1, en el que 0 indica el estado CLOSED y 1 indica el estado OPEN.
Antes de cónfigurar este punto, debe crear un conjunto de estados digitales con dos cadenas:
CLOSED y OPEN. Puede asignarle el siguiente nombre a este conjunto de estados digitales:
"Pósición de valvula" . Puede definir otros puntos que tambien tengan los estados CLOSED y
OPEN para usar el mismo conjunto de estados digitales Pósición de valvula. Los puntos que
tienen estados ON y OFF deberían usar un conjunto de estados digitales diferente, al que pódría
ponerle el nombre "Pósición del interruptor" .
PI Server determina el valor del códigó digital, como 0 o 1, segun la pósición de la cadena de
estado digital en la Tabla de estados digitales. El primer valor es 0, el segundo es 1, el tercero es
2, etc.
Puede definir hasta 16 383 conjuntos de estados con hasta 16 383 estados en cada conjunto.
Para obtener mas infórmación, consulte Conjunto predeterminado: conjunto de estados del
sistema.

PI points

Archivos históricos
Los archivos PI son los que PI System utiliza para almacenar datos de PI. PI Data Archive 2015
presenta archivos especiales llamados “archivos futuros” para PI points que tienen cónfiguradó
el atributo “futuro”; normalmente, estos puntos se utilizan para almacenar datos pronosticados.
Los archivos tradicionales se utilizan para almacenar datos de series temporales denominados
“archivos históricós”.
Cuando ejecuta el programa de instalación, se habilita de manera predeterminada la creación
autómatica de archivos históricós.
Cada archivo históricó contiene eventos para el períódó especificadó por la hora de inicio y la
hora de finalización del archivo. El archivo que recibe datos se denomina archivo primario.
Cuando el archivo primario se llene, ócurrira un cambio de archivo histórico: se creara un nuevo
ficheró de archivado que se cónvertira en el archivo primario.
Para obtener infórmación sobre cómó administrar archivos futuros que se utilizan para
almacenar datos pronosticados, consulte Datos futuros.
En esta sección
• Ficheros de archivado
• Administración de archivos históricós
• Administración de la repósición
• Administración de ficherós de archivado desconectados con piarchss
Ficheros de archivado
Los ficherós de archivado pueden ser fijos o dinámicos. Los archivos históricós fijós asignan por
anticipado todo su espacio; esto significa que un archivo históricó vacíó y uno lleno utilizan la
misma cantidad de espacio en el disco. Los ficherós de archivado fijós tienen siempre el mismo
tamanó, independientemente de los datos que contengan. El tamanó de los ficherós de
archivado dinamicós aumenta a medida que reciben datos.
El tamanó de los ficherós de archivado varía entre 1 MB y 2 TB.
En esta sección
• Ficheros de archivado primarios
• Registros de archivos históricós
• Registros de índice
• Archivos históricós fijós y dinamicós
Ficheros de archivado primarios

El archivo primario es el ficheró de archivado históricó que cubre el intervalo de tiempo actual.
Para que un ficheró de archivado sea un archivo primario, debe estar registrado, debe poder
intercambiarse y estar abierto a escritura, ademas de ser lo suficientemente grande como para
gestionar el tamanó actual de la base de datos de PI point.
La hora de finalización del archivo primario se define cuando tiene lugar un intercambio de
archivo históricó. La hora del intercambio se convierte en la hora de finalización y ese archivo
históricó deja de ser el archivo primario.

Registros de archivos históricos

PI Data Archive almacena eventos de archivos históricós como registros de datos. Los registros
de datos son registros primarios o registros de desbordamiento. Cada punto de la base de datos
de PI point posee un registro primario asignado en cada ficheró de archivado. Los registros
primarios se almacenan al comienzo del ficheró de archivado. Cuando se completa el registro
primario de un punto, los datos de ese evento van a un registro de desbordamiento en el ficheró
de archivado. Los registros de desbordamiento comienzan al final del ficheró de archivado y se
completan hacia atras. Cada registro es un kilobyte.
Un punto puede tener tantos registros de desbordamiento como necesite. Es posible que los
puntos que reciben eventos a una velocidad lenta nunca necesiten asignar un registro de
desbordamiento, mientras que los puntos que reciben eventos a una velocidad rapida necesiten
asignar muchos registros de desbordamiento. PI Data Archive utiliza registros de índice para
realizar un seguimiento de multiples registros de datos de desbordamiento de un punto.
Registros de índice
Los registros de índice son registros que indexan los datos de desbordamiento de un punto por
tiempo. Despues de completar un registro de desbordamiento para un punto, PI Data Archive
crea un registro de índice para ese punto y un nuevo registro de desbordamiento. La
recuperación de datos de archivos históricós para puntos con cadenas de registros de índice es
ligeramente mas lenta que para los puntos con registros de índice cero o uno.
Archivos históricos fijos y dinámicos

Los archivos fijós tienen un tamanó fijó, sin importar cuantós datos contengan. Sin embargo, el
tamanó de los archivos históricós dinamicós aumenta a medida que obtienen datos. De manera
predeterminada, los archivos históricós de PI son fijós.
Utilice archivos históricós fijós para todas las operaciones normales. El espacio en disco para
un archivo históricó fijó se asigna en la fecha de creación, por lo que un archivo históricó vacíó
y un archivo históricó lleno utilizan la misma cantidad de espacio en disco. Un archivo históricó
fijó puede o no participar en intercambios de archivo históricó, segun su capacidad para
conservar datos para todos los puntos del sistema. Puede agregar nuevos puntos a un archivo
históricó fijó si es el archivo primario.
Los archivos históricós fijós se convierten en dinamicós si estan llenos, si existe espacio
suficiente en disco. Este proceso se conoce como conversión de archivo histórico dinámica
automática. La cónversión de archivo históricó dinamica autómatica es util, por ejemplo, si
necesita incorporar datos repuestos en un archivo históricó fijó que no es primario y dicho
archivo esta lleno. Si un archivo históricó convertido se convierte en primario, se vuelve a
convertir a un tamanó fijó. No se módifica el espacio asignado en el disco para los archivos
históricós.

Despues de que se convierte un archivo fijó que no es primario a un archivo dinamicó y se

rellenan los datos, puede volver a convertir el archivo dinamicó en un archivo fijó usando
Offline Archive Utility piarchss.
El tamanó del ficheró de archivado dinamicó es flexible, lo que permite asignar espacio en el
disco solo si es necesario. Los archivos históricós dinamicós abarcan un intervalo de tiempo
específicó. El ficheró de archivado crece a medida que se agregan registros de desbordamiento,
hasta un tamanó maximó especificadó o, como mucho, 2 TB.
Administración de archivos históricos

Los temas de esta sección explican cómó realizar las tareas en PI SMT cuando sea posible y
proporcionan instrucciones de línea de comandos cuando sea necesario. Para obtener mas
infórmación sobre el uso de las herramientas de línea de comandos para administrar archivos
históricós, consulte PI Data Archive Reference Guide.
Nota:
Para obtener infórmación sobre cómó administrar archivos futuros que se utilizan para
almacenar datos futuros, consulte Datos futuros. Para utilizar datos futuros, debe instalar
PI Data Archive 2015 o versiones posteriores.
En esta sección
• Herramientas de administración de archivos históricós
• Ubicación de los ficherós de archivado
• Prevención de perdida de datos de archivo históricó
• Restablecimiento autómaticó de la cola de eventos
• Creación de archivos históricós con PI SMT
• Tamanó del archivo históricó
• Registro de archivos históricós
• Intercambios de archivos históricós
• Arranque y detención de interfaces
• Annotations
• Administración de vacíós de archivos históricós
• Reprocesamiento de archivos históricós
• Cónfigurar el numeró de archivos históricós supervisados en busca de errores de lectura y
escritura
• Evitar cambios en los archivos históricós
• Exportar una lista de archivos históricós a un archivo
• Crear un archivo de registro .bat
• Mover ficherós de archivado
• Eliminar un evento de archivo históricó
• Eliminar un archivo históricó
• Verificar archivos danadós

Herramientas de administración de archivos históricos

Herramientas de administración de archivos históricos de SMT
La herramienta Archives de SMT muestra una lista de archivos históricós registrados para cada
servidor de PI Data Archive conectado. En la lista de archivos históricós se muestran el estado y
las propiedades de cada archivo históricó. Las funciones de la barra de herramienta y un menu
de contexto le permiten supervisar y administrar el uso de archivos históricós.
• Archive Editor
Vea, edite, inserte y elimine valores para los eventos de un PI archive. En SMT, seleccione
Data > Archive Editor.
• Herramienta Archives
Supervise y administre el uso de archivos históricós. La herramienta muestra una lista de los
archivos históricós registrados para cada servidor de PI Data Archive conectado, que incluye
el estado y las propiedades de cada archivo históricó. En SMT, seleccione Operation >
Archives.
• Herramienta Snapshot and Archive Statistics

Supervise la actividad y las estadísticas de uso del subsistema de archivos históricós y del
subsistema de Snapshot y de archivos históricós en los servidores conectados. Si revisa
periódicamente estas estadísticas, puede solucionar problemas de datos o del sistema antes
de que se conviertan en problemas mayores. Muchas de las estadísticas, como el Conteo del
registro de datos de desbordamiento, son informativas; otras son valiosas para realizar el
mantenimiento predictivo. En SMT, seleccione Operation > Snapshot and Archive Statistics.
Utilidades de línea de comandos

Para obtener infórmación sobre el uso de herramientas de línea de comandos para administrar
los archivos, consulte los temas de referencia de PI Data Archive "utilidades de la línea de
comandos de PI Data Archive" in Live Library (https://livelibrary.osisoft.com).
• piartool
Administre la mayóría de las tareas de administración de archivos históricós, que incluyen la
creación, el registro y la anulación de registro de los archivos históricós, la impósición de
intercambios de archivos históricós y la enumeración de los detalles de ficherós de
archivado.
• piarchss
Utilice un procesador sin cónexión para reorganizar (combinar y dividir) y reparar ficherós
de archivado.
Ubicación de los ficheros de archivado

Por defecto, el programa de instalación coloca los archivos históricós en el directorio PI\dat,
pero puede elegir otra ubicación si lo desea. La herramienta SMT Archives indica la ubicación
de todos los ficherós de archivado registrados.

Procedimiento
1. Inicie PI SMT y seleccione el servidor PI Data Archive en el que desea ver los archivos
históricós.
2. En System Management Tools, haga clic en Operation > Archives. Se abrira la herramienta
Archives. La columna Archive File indica todos los archivos históricós registrados en el
servidor seleccionado y muestra su ruta completa. El archivo primario es el primero de la
lista.
PRECAUCIÓN:
No utilice en los sistemas dedicados a la recogida de datos de próducción software
antivirus para escanear los directorios que contienen la base de datos de PI Data
Archive y los ficherós de archivado.
Prevención de pérdida de datos de archivo histórico

Luego de recibir datos de una interfaz, PI Snapshot Subsystem los coloca en la cola de eventos.
PI Archive Subsystem recupera estos datos casi al instante. Con este punto de paso de los datos,
PI Data Archive prosigue la óbtención de datos si los archivos históricós o el disco dejan de
estar disponibles.
Para aprovechar este punto de paso de los datos, no situe la cola de eventos en el mismo disco
físicó que los archivos. Compruebe la ubicación de la cola de eventos en su servidor y asegurese
de que este en un disco distinto del archivo primario..
Procedimiento
1. Abra PI SMT.
2. En System Management Tools, haga clic en Operation > Tuning Parameters y luego haga
clic en la pestana Snapshot.
3. Haga doble clic en el parametró Snapshot_EventQueuePath. Se abrira la ventana de
parametrós.
4. Establezca en Value la ruta deseada para la cola de eventos. Asegurese de que la ruta se
encuentre en un disco diferente del archivo primario.
5. Reinicie PI Snapshot Subsystem. La cola de eventos se trasladara a su nueva ubicación.
Puede eliminar el archivo de la antigua cola de eventos.
Restablecimiento automático de la cola de eventos

Si se dana un archivo de la cola de eventos, PI Data Archive restablece autómaticamente la cola
de eventos para intentar recuperar los datos. En muchas situaciones, el restablecimiento
autómaticó de la cola de eventos puede mantener el flujó de eventos, incluso si ocurre un error
inesperado mientras PI Data Archive lee o escribe en la cola de eventos. Se admite para las colas
de eventos históricós y futuros.
Nota:
La cola de eventos sirve como un bufer de memoria y disco entre los subsistemas de
snapshot y de archivos históricós. Para obtener mas infórmación, consulte Cola de
eventos.
Si PI Data Archive detecta danós en la cola de eventos, intenta recuperar los archivos existentes
de la cola de eventos. Si falla la recuperación, PI Data Archive mueve los archivos de la cola de
eventos a una nueva carpeta y crea una nueva cola. La nueva carpeta es una subcarpeta de la
carpeta principal de la cola de eventos, su nombre incluye una estampa de tiempo.

Nota:
La ubicación de la carpeta principal de la cola de eventos se establece durante la
instalación o la actualización. Para obtener mas infórmación, consulte el tema de
instalación de PI Data Archive, "Determine los vólumenes de disco para la
implementación" in Live Library (https://livelibrary.osisoft.com).
Si necesita recuperar los archivos antiguos de la cola de eventos, cómuníquese con el soporte
tecnicó de OSIsoft (consulte Pagina de contacto de soporte tecnicó de OSIsoft (https://
techsupport.osisoft.com/Contact-Us/)).
PI Data Archive escribe el mensaje con ID 2378 en el archivo de registro cuando intenta el
restablecimiento autómaticó de la cola de eventos y escribe mensajes adicionales para registrar
si la óperación se realizó correctamente o no.
Los siguientes contadores de rendimiento registran la infórmación sobre el restablecimiento
autómaticó de la cola de eventos.
Contador de rendimiento Description
Event Queue Error Count Cantidad de veces que ócurrió un error al leer o
escribir una cola de eventos.
Reset Folder Count Cantidad de carpetas de restablecimiento de la cola
de eventos que hay actualmente en el disco.
Event Queue Reset State Establecer como ON (o 1) durante un
restablecimiento autómaticó de cola y OFF (o 0)
una vez que el restablecimiento de la cola se haya
completado correctamente. Este contador de
rendimiento es un valor booleano.
Para obtener las listas de otros contadores de rendimiento que reunen estadísticas, consulte el
tema de referencia de PI Data Archive, "contadores de rendimiento de PI" in Live Library
Creación de archivos históricos con PI SMT

Utilice la herramienta Archives en PI SMT para crear archivos históricós. Tambien puede
utilizar la utilidad de línea de comandos piarcreate segun se describe en PI Data Archive
Reference Guide.
Nota:
PI Data Archive crea los archivos futuros de manera autómatica cuando los PI points
futuros se completan con datos.
En esta sección
• Crear un archivo históricó
• Crear archivos históricós multiples para la repósición
• Nombres de los archivos históricós
Crear un archivo histórico
Procedimiento
1. Seleccione Start > PI System Management Tools > Operation > Archives.
2. Haga clic en el bótón Create a New Archive ( ).
3. En el cuadro de dialógó Create a New Archive, seleccione Single Archive.

4. Haga clic en el bótón de explóración para cambiar la ruta del archivo históricó, si lo desea.
Puede almacenar un archivo históricó en cualquier directorio local o de red al que se pueda
acceder mediante PI Data Archive. El almacenamiento local con otros archivos históricós
proporciona una ópción conveniente para administrar archivos históricós.
5. Si no desea utilizar el nombre predeterminado numerado de manera crónólógica, ingrese un
nombre en Archive name.
Si el campo de texto es amarillo, otro archivo ya usa el nombre del archivo históricó,
posiblemente un archivo no registrado. Tal vez desee cancelar el procedimiento y utilizar el
archivo existente, si esta vacíó.
6. Seleccione una ópción de origen para crear el archivo históricó:
◦ Clone primary archive fixed size: crea un archivo históricó vacíó de tipo fijó que esta
basado en el tamanó del archivo primario actual.
◦ Create archive with a custom fixed size: crea un archivo históricó vacíó con un tamanó
diferente (generalmente mas grande) que el archivo primario actual. En el campo que lo
acómpana, especifique el tamanó en megabytes (MB). El tamanó debe ser igual o superior
al tamanó del archivo primario actual, hasta un maximó de 2 TB.
◦ Create archive with fixed start and end time: crea un archivo históricó vacíó que se
utilizara solo durante un períódó especificadó. Si selecciona esta ópción, para la ópción
Type, seleccione Fixed.
Nota:
Las horas de inicio y finalización no pueden superponerse en un archivo históricó
existente.
7. Haga clic en OK.
La herramienta Archives creara y registrara el archivo históricó.
Crear archivos históricos múltiples para la reposición

Nota:
Utilice este procedimiento para crear archivos históricós para la repósición. Para reponer
archivos futuros con datos pronosticados, no es necesario que cree archivos
manualmente.
Procedimiento
1. Seleccione Inicio > PI System Management Tools > Operation > Archives.
2. Haga clic con el bótón derecho en el ficheró de archivado del servidor PI Data Archive de
destino y seleccione Create New.
3. En el cuadro de dialógó Create a New Archive, seleccione Multiple archives for backfilling.
4. Haga clic en el bótón de explóración para cambiar la ruta del archivo históricó, si lo desea.
5. Ingrese un prefijó para el archivo en Archive name o acepte el prefijó predeterminado.
Las horas de inicio y de finalización se anexaran autómaticamente al nombre del archivo
históricó, segun los archivos históricós que se esten creando.
6. Defina la Duración máxima del archivo histórico para cada ficheró de archivado nuevo.
7. Ingrese los valores correspondientes en Start time y End time para los nuevos ficherós de
archivado mediante el uso del formato de hora de PI.

Nota:
Las horas de inicio y de finalización no deben superponerse en un archivo históricó
existente.
8. Haga clic en OK.
La herramienta Archives registra de manera autómatica los archivos históricós creados
recientemente.
Nombres de los archivos históricos

Utilice una cónvención de nomenclatura para sus PI archives que sea valida para el sistema
operativo subyacente y asegurese de que la ubicación del archivo cuente con espacio suficiente
en disco. No existen otras limitaciones para nombrar los PI archives.
Los nombres de los ficherós de archivado predeterminados son piarch.xxx, donde xxx es
001, 002, 003, etc.
El archivo de anotaciones asociado tiene el mismo nombre de ruta completa que su ficheró de
archivado con el sufijó .ann. Por ejemplo, el archivo de anótación para el ficheró de archivado
piarch.001 sería piarch.001.ann.
Tamaño del archivo histórico

El tamanó del archivo históricó influye en las copias de seguridad, la repósición, la frecuencia
de intercambio y el numeró total de puntos permitidos.
Para determinar el tamanó del archivo históricó, siga las siguientes directrices:
• Si esta reponiendo datos, consulte Administración de la repósición.
• Deje al menos 2 KB para cada punto del sistema.
• Un ficheró de archivado no puede exceder los 2 TB. Sin embargo, si su servidor PI Data
Archive tiene 50 000 puntos o menos, puede usar con seguridad el valor predeterminado.
• Si tiene mas de 50 000 puntos, ejecute PI Data Archive de 64 bits en un sistema operativo de
Windows de 64 bits y cónfigure el tamanó del archivo históricó en 4 a 8 KB por el numeró
total de puntos, con las siguientes consideraciones sobre los recursos de memoria.
Seleccione un tamanó que permita que al menos dos ficherós de archivado se integren en la
Cache del sistema de archivos de Windows (FSC). La mayóría de las veces, PI Data Archive
escribe en los dos o tres ficherós de archivado mas recientes y lee de ellos. La FSC se limita a
aproximadamente 1 GB en sistemas de 32 bits, pero puede utilizar toda la memoria RAM en
sistemas de 64 bits. Por lo tanto, el límite superior seguro para ficherós de archivado es de
256 MB en sistemas de 32 bits y (RAM ÷ 3) en sistemas de 64 bits.
Consejo:
Muchos administradores miden sus archivos históricós segun el tamanó que es
conveniente usar con sus medios de copia de seguridad deseados. Por regla general,
cónfigure la cola de eventos de Snapshot en la mitad del tamanó del archivo históricó.
Límites en el tamaño del archivo histórico y en el conteo de puntos

El tamanó del archivo históricó limita el numeró de puntos que pueden crearse. No se pueden
asignar como registros primarios para un archivo históricó fijó mas de la mitad de los registros
de archivos históricós. Para resolver esto, antes de crear puntos adicionales, convierta los
archivos históricós en un archivo históricó mas grande. Para obtener mas infórmación, consulte
Forzar un intercambio de archivo históricó.

Tamaño del archivo histórico y frecuencia de intercambio

Mientras mayor sea el tamanó del ficheró de archivado, menos frecuente sera el cambio de
archivo históricó. Para decidir que tamanó de archivo históricó es óptimó para su sistema,
tenga en cuenta los siguientes factores:
• Dispositivo de copia de seguridad

• Espacio en disco disponible
• Velocidad promedio de datos entrantes
Calcular el uso de archivos históricos

Puede determinar la utilización de sus archivos históricós con cualquiera de los siguientes
metódós.
• En PI SMT, en Operación > Archivos históricos, observe los valores en la columna %Full para
cada uno de los archivos históricós.
• Examine el resultado del comando piartool -al , tal como se muestra en el siguiente
procedimiento.
Procedimiento
2. Escriba el comando: piartool -al.
El resultado del comando enumera los archivos históricós en orden crónólógicó inverso (los
archivos históricós con datos mas nuevos antes que los archivos históricós con datos mas
antiguos). El campo Usado indica el porcentaje de uso del archivo históricó específicó.
◦ En el caso de los archivos históricós de tamanó fijó, este es el porcentaje de los registros
totales disponibles en uso e indica cuantó espacio esta disponible en el archivo históricó
para los datos.
◦ En el caso de los archivos dinamicós, este es el porcentaje de registros primarios en uso e
indica cuan cerca se encuentra del numeró maximó de puntos que pueden crearse para
ese archivo históricó.
Registro de archivos históricos

El registro de archivos históricós de PI Data Archive contiene el nombre, la ubicación, el
tamanó, el conteo de registros y el tamanó del registro para cada ficheró de archivado. Esta
infórmación se almacena en el archivo binario PI\dat\piarstat.dat.
En esta sección
• Registrar archivos históricós
• Anular el registro de archivos históricós
• Mostrar el encabezado de un archivo históricó sin registrar
• Registro de archivos históricós de forma masiva

Registrar archivos históricos

A fin de que PI Data Archive reconozca un archivo como ficheró de archivado, debe registrar el
archivo. Despues de registrar un archivo históricó, este pasa a estar disponible en el sistema y
participa en cambios, almacenamientos y recuperaciones de datos de eventos.
Procedimiento
1. Seleccione Start > PI System Management Tools > Operation > Archives. La herramienta
Archives detalla todos los archivos históricós registrados en el servidor seleccionado.
2. Haga clic con el bótón derecho en un ficheró de archivado del servidor PI Data Archive de
destino y seleccione Register Archive.
3. Busque el ficheró de archivado que desea y haga clic en Open.
Anular el registro de archivos históricos

Para trasladar o reprocesar un ficheró de archivado, debe anular su registro, realizar los
cambios y volver a registrarlo. No es posible anular el registro de un archivo primario. Si el
servidor PI Data Archive no se encuentra en el equipo local, esta tarea debe contar con acceso
de lectura y escritura en la base de datos PIARCADMIN.
Procedimiento
2. Haga clic con el bótón derecho en un ficheró de archivado del servidor PI Data Archive de
destino y seleccione Unregister Archive.
3. Haga clic en Yes.
Mostrar el encabezado de un archivo histórico sin registrar

Para ver las propiedades (como las horas de inicio y de finalización) de un archivo históricó sin
registrar, puede mostrar su encabezado.
Procedimiento
2. En la barra de herramientas, haga clic en Display Unregistered Archive .
3. Desplacese al directorio correcto, seleccione el ficheró de archivado sin registrar y haga clic
en Open.
PI SMT agregara el archivo históricó sin registrar a la lista de archivos históricós.
Registro de archivos históricos de forma masiva

Use la utilidad piartool para registrar o anular el registro de los archivos históricós de forma
masiva. La utilidad piartool le permite utilizar el cómódín * y el signo de interrógación ? para
realizar operaciones de forma masiva. El símbóló * busca todas las posibilidades con cualquier
numeró de caracteres. El símbóló ? busca un solo caracter y se puede utilizar un numeró
ilimitado de veces.
En esta sección
• Registrar archivos históricós de forma masiva
• Anular el registro de los archivos históricós de forma masiva

Registrar archivos históricos de forma masiva
Procedimiento
• Para registrar archivos históricós, utilice el comando piartool -ar. La sintaxis es la
siguiente:
piartool -ar path
La ruta path especificada debe ser la ruta absoluta de un ficheró de archivado existente.
Por ejemplo, para registrar un solo archivo históricó denominado piarch.006 en el
directorio PI\dat de la unidad D:
piartool -ar D:\PI\dat\piarch.006
Puede utilizar los caracteres comodines * y ?. El símbóló * coincide en todas las

posibilidades con cualquier numeró de caracteres. El símbóló ? coincide con un unicó
caracter y se puede utilizar un numeró ilimitado de veces.
Por ejemplo, para registrar todos los ficherós de archivado en el directorio PI\dat que
comienza con el prefijó piarch.0:
piartool -ar D:\PI\dat\piarch.0*
Anular el registro de los archivos históricos de forma masiva
Procedimiento
• Para anular el registro de un archivo históricó, utilice el comando piartool -au. La
sintaxis es la siguiente:
piartool -au path
donde path especifica un nombre de ruta absoluto.

Por ejemplo, para anular el registro de un archivo históricó denominado piarch.006 en el
directorio PI\dat de la unidad D:
piartool -au D:\PI\dat\piarch.006
Puede utilizar los caracteres comodines * y ? para registrar archivos de forma masiva. El
símbóló * coincide en todas las posibilidades con cualquier numeró de caracteres. El
símbóló ? coincide con un unicó caracter y se puede utilizar un numeró ilimitado de veces.
Por ejemplo, para anular el registro de todos los ficherós de archivado que comienzan con el
prefijó piarch.0 y se ubican en el directorio PI\dat:
piartool -au D:\PI\dat\piarch.0*
Intercambios de archivos históricos

El archivo primario es el archivo que recibe los datos actuales. En algun momento, necesitara
un cambio de archivo históricó para que se cree un ficheró de archivado nuevo que se convierta
en el archivo primario. El cambio de archivo históricó se activa cuando el archivo primario esta
casi lleno.
Nota:
Durante el intercambio de un archivo históricó, no puede anadir, editar ni eliminar
puntos.
Es posible manejar cambios de archivos históricós de los siguientes modos.

• Cambios autómaticós de archivos históricós: el cambio de archivo históricó se activa cuando

el archivo primario esta casi lleno.
• Cambios programados de archivos históricós: usted especifica la fecha y hora en que desea
que ocurra el cambio.
Nota:
Si programa cambios de archivos históricós, los cambios autómaticós no se
próduciran. Sin embargo, pódra forzar un cambio de archivo históricó si lo necesita.
En esta sección
• Cambios autómaticós de archivos históricós
• Creación autómatica de archivos históricós
• Programar cambios de archivos históricós
• Definición de la disponibilidad de archivos históricós para cambios
• Forzar un intercambio de archivo históricó
• Error en el intercambio de archivo históricó
Cambios automáticos de archivos históricos

PI Data Archive realiza un intercambio de archivo históricó antes de que el archivo primario se
llene por completo. Como resultado, el archivo contiene espacio adicional de manera que, si es
necesario, pueda agregar datos posteriormente.
Creación automática de archivos históricos

PI Data Archive genera autómaticamente un archivo históricó nuevo para el cambio de archivo
históricó.
Normalmente, es mas sencillo hacer un seguimiento del espacio disponible en el disco que de
los archivos históricós montados, de su contenido y de su capacidad de sobrescritura. Si su
disco se llena, PI Data Archive puede comportarse de la siguiente manera:

• Sobrescribir antiguos ficherós de archivado

• Conservar datos en la cola de eventos sin enviarlos a un archivo históricó
OSIsoft recomienda usar MCN Health Monitor para monitorear el espacio en disco en PI Data
Archive, y usar las nótificaciónes cuando hay poco espacio libre en el servidor de PI Data
Archive.
En esta sección
• Ver el horario del próximó intercambio de archivo históricó pronosticado
• Parametrós de ajuste para la creación autómatica de archivos históricós
• Desactivar la creación autómatica de archivos históricós
Ver el horario del próximo intercambio de archivo histórico pronosticado

La herramienta PI SMT Archives (Operation > Archives) posee una columna de prónósticó de
intercambios que pronostica el horario del próximó intercambio de archivo históricó, segun el
numeró promedio de registros de archivos históricós que se consumen por hora, mas la
velocidad de consumo. Si el archivo primario esta completo en menos del 20 %, el prónósticó se
basa en las velocidades de archivos históricós anteriores.
Parámetros de ajuste para la creación automática de archivos históricos

Los siguientes parametrós especifican el comportamiento de la creación autómatica de
archivos históricós.
Parámetros de ajuste Descripción
Archive_AutoArchiveFileRoot Especifica la ruta y el prefijó del nombre de archivo para los
nuevos archivos históricós. Por ejemplo, una cónfiguración de
"C:\PI\arc\auto_" especifica que los nuevos archivos
históricós se crean en la carpeta C:\PI\arc con un prefijó de
nombre de archivo de "auto_" .
Archive_AutoArchiveFileFormat y
Archive_AutoArchiveFileExt especifican cómó se
fórmara el resto del nombre del archivo históricó.
Archive_AutoArchiveFileExt Especifica la extensión del archivo para el ficheró de
archivado. El valor predeterminado es ".arc" .
Archive_AutoArchiveFileFormat Especifica la parte generada del nombre de archivo para el
ficheró de archivado. Los valores posibles son los siguientes:
0: _D_Mon_YYYY_H_M_S.ext
1: prefix_YYYY-MM-DD_HH-MM-SS.ext
2: prefix_UTCSECONDS.ext
Donde prefix es el prefijó del nombre de archivo especificadó
en Archive_AutoArchiveFileRoot y .ext es la extensión
del archivo especificada en Archive_AutoArchiveFileExt.

Parámetros de ajuste Descripción

Archive_AutoArchiveFileSize Especifica el tamanó de los nuevos archivos primarios que se
crean a traves de la creación autómatica de archivos
históricós. Cuando se cónfigura en 0 (la cónfiguración
predeterminada), el tamanó del archivo primario es siempre
el mismo que el archivo primario actual. Cuando se cónfigura
en cualquier otro valor, especifica el tamanó del nuevo
archivo primario cuando se produce un cambio en la creación
autómatica de archivos históricós. Si disminuye el tamanó del
archivo frente al archivo primario actual, el tamanó
especificadó debe ser lo suficientemente grande para
satisfacer los registros primarios de los puntos que se
encuentran actualmente en uso.
Nota:
En un servidor de PI Data Archive, puede cónfigurar los parametrós de ajuste mediante PI
SMT. Abra SMT y haga clic en Operación > Parámetros de ajuste. Haga clic en la pestana
Archivo histórico, haga doble clic en el parametró de ajuste que desee editar, escriba el
valor escogido y haga clic en Aceptar.
Desactivar la creación automática de archivos históricos
Procedimiento
1. Seleccione Start > PI System Management Tools > Operation > Tuning Parameters.
2. Haga clic en la pestana Archive.
3. Seleccione el parametró Archive_AutoArchiveFileRoot y desactive el campo Value
(dejeló en blanco).
Programar cambios de archivos históricos

Ahora, los usuarios pueden cónfigurar PI Archive Subsystem para que cambie autómaticamente
archivos históricós a una frecuencia horaria específica, en lugar de hacer que
PI Archive Subsystem realice cambios en función del espacio de archivo históricó restante o de
forzar un cambio. El resultado de este proceso son los archivos históricós de tiempo fijó.
Con la frecuencia diaria, los cambios ocurren cada día a la medianoche. Con la frecuencia
semanal, los cambios ocurren cada domingo a la medianoche. Con la frecuencia mensual, los
cambios ocurren el primer día de cada mes a la medianoche. En las regiones donde el cambio
ocurre a la medianoche y hay horario de verano, el cambio sucedera a la 1:00:00 (horario de
verano) durante la transición a la primavera. Durante la transición al ótónó, el cambio ócurrira
a las 0:00:00 (hora estandar). El cambio natural supone permitir que el cambio ocurra
autómaticamente cuando se llena el archivo históricó.
Cuando se cónfigura el parametró de ajuste de Archive_AutoArchiveFileSize, el tamanó
del nuevo archivo primario depende de este valor. Cuando no se cónfigura,
PI Archive Subsystem calcula el tamanó del nuevo archivo primario en función de la velocidad
de datos anterior y la duración del cambio, de modo que el archivo históricó pueda ajustarse al
volumen previsto de datos.
En entornos colectivos, es posible cónfigurar el intercambio programado en el servidor
primario y este se aplicara a todos los miembros. Los miembros secundarios cambiaran segun
la zona horaria del servidor primario. Al igual que en versiones anteriores, los archivos de
futuro cóntinuan cónsiderandóse archivos mensuales. Actualmente, en un entorno colectivo, las
horas de inicio y finalización de los archivos de futuro dependen de la zona horaria del servidor
primario.

Nota:
Si actualiza un PI Collective existente, debera actualizar todos los miembros secundarios
antes de actualizar el servidor primario. Para obtener mas infórmación, consulte
"Cambios programados de archivos históricós en el gestor de colectivos" in Live Library
Configurar cambios programados
Procedimiento
1. Abra SMT
2. Haga clic en Operation
3. Haga clic en Archives
4. En el panel principal, con la pestana Historic seleccionada, haga clic en Review and update
parameters
5. Seleccione la duración del cambio en shift duration dentro de la lista Shift Schedule
6. Haga clic en Save
Nota:
Si esta seleccionada la ópción Auto create size(MB) y se cambia el tipo de cambio de
natural a programado, SMT eliminara autómaticamente el ajuste de tamanó. Auto
create size(MB) equivale al parametró de ajuste de Archive_AutoArchiveFileSize.
Cuando la ópción no esta seleccionada, PI Archive Subsystem calcula autómaticamente
el tamanó del archivo históricó segun la velocidad de datos anterior y la duración del
cambio. Si igualmente desea cónfigurar el tamanó en la casilla Auto create size(MB),
introduzca el tamanó deseado y haga clic en Save.
Forzar cambios
Cuando se cónfigura un cambio programado, si se fuerza un cambio dentro de los 10 minutos
anteriores al siguiente cambio programado, el cambio tendra lugar, la nueva hora de inicio del
archivo primario se ajustara a la siguiente hora de cambio programada, y el siguiente cambio
programado se ómitira.
Compatibilidad de PowerShell con cambios programados

Para obtener los ajustes actuales para un cambio programado en Powershell, use el cmdlet
Get-PIArchiveSetSettings.
En el siguiente ejemplo, 420_cp1 es el nombre colectivo. Puede usar el nombre de servidor
objetivo o el nombre colectivo (nombre en KST).
PS C:\WINDOWS\system32> Get-PIDataArchiveConnectionConfiguration 420_cp1 |
Connect-PIDataArchive | Get-PIArchiveSetSettings
Ejemplo de salida:
Para ajustar la prógramación del cambio, use el comando Set-PIArchiveSetSettings.

PS C:\WINDOWS\system32> Get-PIDataArchiveConnectionConfiguration 420_cp1 |

Connect-PIDataArchive | Set-PIArchiveSetSettings -Name 0_Historical -
ShiftFrequency Monthly
Definición de la disponibilidad de archivos históricos para cambios

Para definir si un archivo históricó esta disponible para cambiarlo y convertirlo en el nuevo
archivo primario, siga este procedimiento.
Procedimiento
1. En PI SMT, seleccione Operation > Archives.
2. En la vista de lista, haga clic con el bótón derecho sobre un archivo y seleccione Make Non-
shiftable o Make Shiftable.
Forzar un intercambio de archivo histórico

Durante el funcionamiento normal, no necesita forzar un intercambio de archivo históricó. Sin
embargo, puede forzar un cambio de archivo históricó si hace falta.
Use este procedimiento para forzar el intercambio de un servidor de un archivo históricó a
otro.
Procedimiento
2. Haga clic con el bótón derecho en el archivo primario del servidor en la lista y seleccione
Force Shift.
Error en el intercambio de archivo histórico

Unos de los motivos mas comunes por el que se produce un error en el intercambio es el
espacio inadecuado en el disco. Si se produce un error en el intercambio de archivo históricó
por algun motivo, se deshabilitaran todos los demas intercambios y se enviara un mensaje al
registro. Cuando el motivo del error se resuelva (por ejemplo, al proporcionar mas espacio en el
disco), reinicie PI Archive Subsystem para habilitar el intercambio de archivo históricó. Si se
produce un error debido a la falta de un archivo históricó disponible para intercambiar, registre
un nuevo archivo históricó vacíó y habilite el intercambio en el archivo nuevo.
Los intercambios con error no ocasionan perdida de datos porque el archivo históricó ingresa
en modo de solo lectura y esto evita que los datos se escriban en el ficheró de archivado. PI
Snapshot Subsystem coloca todos los datos entrantes en la cola de eventos.
Arranque y detención de interfaces

La primera vez que arranque una PI interface, hagaló desde el panel de control de Servicios de
Windows. En adelante, pódra arrancar o detener la interfaz desde PI ICU.
Procedimiento
1. Haga clic en Start > Control Panel > Administrative Tools > Services.
2. En la ventana Servicios, busque la interfaz que desee arrancar o detener. Por ejemplo, la
interfaz PI Random Simulator (aleatoria) X64.
3. Haga clic derecho en el servicio de interfaz y seleccione Start o Stop.

Annotations
Use las anotaciones para asociar infórmación arbitraria, como comentarios de texto y otros
datos binarios, a un valor de PI archive.
Utilice el PI Annotations Editor en PI SMT Archive Editor para ver, editar, insertar y eliminar
anotaciones en los PI point values. Las anotaciones pueden incluir comentarios, notas, valores
complementarios con tipos de datos especificadós y archivos.
Puede anotarse cada valor del snapshot o del archivo históricó. Los eventos anotados siempre
omiten la cómpresión. Una anótación puede ser de cualquier tipo de dato binario. El parametró
de ajuste de Snapshot_AnnotationSizeLimit controla el tamanó de una anótación.
Cada ficheró de archivado posee un solo archivo de anótación relacionado, con una
extensión .ann. El archivo de anótación se crea si no existe. Es importante almacenar ficherós
de archivado y archivos de anótación juntos, especialmente al restaurar un ficheró archivado
con copia de seguridad.
Nota:
Cualquier óperación de una anótación se traduce en una E/S real y omite un
almacenamiento en cache de archivos históricós. Los eventos anotados son menos
eficientes que los eventos no anotados.
Puede usar los siguientes modos para conservar anotaciones.
• Modo Estándar/Predeterminado
Proporciona un formato de tabla que puede incluir valores alternativos con tipos de datos
asignados. Use este modo para las anotaciones de cadenas simples, anotaciones que no
requieren datos estructurados o para adaptarse a las anotaciones heredadas de versiones
anteriores de PI Data Archive.
• Modo String/VARIANT
Almacena datos de anótación como un tipo de datos VARIANT sin especificar. Utilice este
modo para datos de anotaciones que estan estructurados, que se leen mediante
prógramación o que exportan para uso por parte de otra aplicación.
En esta sección
• Conservar anotaciones de PI con Archive Editor
• Anadir o editar anotaciones
• Importar un archivo a una anótación

Conservar anotaciones de PI con Archive Editor

Procedimiento
1. Seleccione Start > PI System Management Tools > Data > Archive Editor.
2. Seleccione un evento en la lista de eventos archivados y haga clic en el bótón Anotaciones,
o haga clic con el bótón derecho en el valor y seleccione Anotaciones.
La ventana PI Annotations Editor se abre en el modo Standard de forma predeterminada.
Para utilizar el modo String/Variant, seleccione la casilla de verificación Use String
Annotations? en el panel de busqueda.
3. Haga clic con el bótón derecho en una fila de anótación para seleccionar entre estas
opciones (la barra de herramientas de PI Annotations Editor tambien proporciona estas
opciones):
◦ Delete
Permite eliminar el evento seleccionado.
◦ Import
Permite importar un objeto de archivo en una fila de anótación.
◦ Export
Permite exportar un objeto de archivo desde una fila de anótación.
◦ Show Details
Permite visualizar infórmación detallada sobre el registro de anótación en la barra de
estado.
Añadir o editar anotaciones

Procedimiento
o haga clic con el bótón derecho del ratón en el valor y seleccione Anotaciones.
2. En la ventana Mantenimiento de anotaciones de PI, módifique la siguiente infórmación o
introduzca nuevas filas que contengan:
a. Valores de punto o cualquier otro dato que requiera un tipo de datos específicó en la
columna Valor. Si la anótación consta solo de una cadena, intróduzcala en la columna
Valor.
b. Tipos de datos que coincidan con los valores correspondientes de la columna Tipo de
valor. El campo Tipo de valor se cónfigura de forma autómatica y solo debe módificarse si
es incorrecto.
Si necesita cambiar un Tipo de valor, seleccione una de las siguientes opciones.
▪ String (tipo predeterminado)

▪ Byte, Short, Long

▪ Single, Double
▪ Boolean
▪ PITime, DateTime
Otros tipos de datos mostrados son para uso interno y no se pueden utilizar con las
anotaciones.
c. Infórmación relacionada y anotaciones secundarias en formato de cadena de la columna
Descripción.
3. Introduzca las filas que necesite y haga clic en Guardar.
Importar un archivo a una anotación

Procedimiento
o haga clic con el bótón derecho del ratón en el valor y seleccione Anotaciones.
2. En la ventana Mantenimiento de PI Annotations, establezca el Tipo de valor como Archivo y
haga clic en la celda Valor.
3. Haga clic en el bótón Importar .
4. Seleccione un archivo y haga clic en Abrir.

5. Haga clic en Guardar.
Administración de vacíos de archivos históricos

PRECAUCIÓN:
Utilice este procedimiento solo para archivos históricós, no para archivos del futuro.
Un vacíó de archivo históricó, o archive gap, es un intervalo de tiempo durante el cual no se
registra ningun archivo históricó. Si se envía un evento al archivo históricó y no se registra
ningun archivo dentro del intervalo de tiempo correcto, el evento se descarta y se registra un
error. Si se intentan obtener datos durante un intervalo de tiempo que se solape con un vacíó,
los datos recuperados incluiran el estado digital Arc Offline, que indica el inicio del vacíó. Esto
evita que los valores se interpolen cuando falten datos.
Generalmente, los ficherós de archivado de PI reflejan todo el historial, sin vacíós ni
superposiciones. Si se produce un vacíó accidental entre ficherós de archivado, puede usar
PI SMT o la herramienta pidiag para resolverlo. Hasta que resuelva el vacíó, no sera posible
recopilar ni almacenar datos en el intervalo de tiempo del vacíó.
Procedimiento
Aparece una lista de todos los archivos históricós registrados en el PI Data Archive
seleccionado. Todos los vacíós de archivos estan etiquetados y resaltados en color rojo.
2. Haga clic con el bótón derecho en la línea que muestra el vacíó del archivo históricó y
seleccione Create New.
Aparecera el cuadro de dialógó Create New Archive. El cuadro de dialógó muestra la hora de
inicio y de finalización correctas para rellenar el vacíó de archivo.
3. Haga clic en Aceptar.
Se crea y se registra el nuevo archivo históricó, y el vacíó de archivo deja de aparecer en la
lista de archivos históricós.

Reprocesamiento de archivos históricos

A partir de PI Data Archive 2016, puede usar la herramienta Archives de PI SMT para
reprocesar archivos históricós mientras estan conectados.
Nota:
De todos modos, debe realizar algunas tareas de reprocesamiento cuando un archivo
históricó esta desconectado mediante el uso de la herramienta de la línea de comandos
piarchss. Por ejemplo, use piarchss para combinar ficherós de archivado o dividir un
ficheró de archivado grande en archivos mas pequenós. Consulte Administración de
ficherós de archivado desconectados con piarchss si desea mas infórmación.
Cuándo es necesario reprocesar un archivo histórico

Siempre es necesario evaluar si reprocesar un archivo históricó es el mejor curso de acción. El
reprocesamiento se debe realizar segun sea necesario, no de manera autómatica ni
programada.
Las situaciones siguientes constituyen razones recomendadas para reprocesar archivos
históricós:
• Para reparar un archivo históricó danadó a fin de permitir el acceso a sus datos
• Para comprimir un archivo históricó a fin de recuperar espacio (reprocesamiento sin
cónexión, unicamente)
Por ejemplo, si eliminó muchos PI points, puede eliminar los datos de los puntos eliminados
o comprimir los archivos históricós que no esten completos.
• Para mejorar el tiempo de acceso a un archivo históricó para determinadas consultas
El reprocesamiento de un archivo históricó suele mejorar el rendimiento de las llamadas
consultas profundas, que leen puntos individuales en un intervalo de tiempo prolongado,
por ejemplo, en las tendencias de PI ProcessBook. Sin embargo, el reprocesamiento de un
archivo históricó puede reducir el rendimiento de las consultas que leen varios puntos
durante un intervalo de tiempo (por ejemplo, los puntos asociados con batches o marcos de
evento).
Fuera de estas situaciones, reprocesar los archivos históricós no ofrece ninguna ventaja, e
incluso puede ocasionar la degradación potencial del rendimiento por la competencia
innecesaria por recursos del sistema en un sistema de próducción (RAM, espacio en disco,
CPU). En particular, no es necesario reprocesar archivos históricós despues de una
actualización de PI Data Archive, ni programar una tarea nocturna, semanal o mensual para
reprocesar todos los ficherós de archivado.
Cómo reprocesar un archivo histórico en línea

Cuando abra la herramienta Archives en la sección Operations de PI SMT, los archivos
históricós danadós se marcaran para que sepa que debe reprocesarlos.
Nota:
No recibira un mensaje acerca del danó en el caso de los archivos históricós que PI Data
Archive no haya leídó recientemente. Cuando PI Data Archive acceda a ese archivo
históricó posteriormente, por ejemplo, para consultar sobre los datos o escribir datos
nuevos, utilizara esa oportunidad para verificar el danó.
Seleccione uno o mas archivos históricós para reprocesar; estos se reprócesaran en secuencia.
La herramienta Archives muestra el progreso del trabajo de reprocesamiento y al finalizar
proporciona el estado de la óperación.

Nota:
Si necesita reprocesar el archivo primario, primero debe realizar un intercambio de
archivo históricó. Para obtener mas infórmación, consulte Forzar un intercambio de
archivo históricó.
Mientras el archivo se reprocesa, aun puede leer los datos de ese archivo. Ademas, los datos
nuevos se conservan en la memoria y estan disponibles para su lectura. Despues de finalizar el
reprocesamiento, los datos que se encuentran en la memoria se escriben en el ficheró de
archivado.
El archivo históricó de entrada cambia de nombre a un sufijó y una estampa de tiempo, y el
archivo históricó de salida toma el nombre original, la hora de inicio y la hora de finalización
del archivo históricó de entrada. Los archivos históricós de salida se conectan y registran
despues del reprocesamiento. Todos los archivos históricós, dinamicós y fijós, se reprocesan en
un archivo históricó fijó.
Si PI Data Archive se cierra mientras se esta ejecutando una tarea de reprocesamiento, al inicio
la tarea actual se reinicia y la cola existente de solicitudes de tareas se mantiene.
Para obtener mas infórmación sobre cómó usar la herramienta Archives, consulte el tema de PI
SMT, "Reprocesar un archivo históricó" in Live Library (https://livelibrary.osisoft.com).
Errores informativos durante el reprocesamiento o las verificaciones de

integridad de los archivos históricos
Durante el reprocesamiento o la verificación de integridad de un archivo históricó, puede
encontrar uno de los mensajes que figuran a cóntinuación, especialmente si se produce un
cierre anormal. Por ejemplo:
• El mensaje [-16305] indica que los eventos en el registro del archivo históricó no estan en
orden. Se muestra generalmente junto con [-16302].
• El mensaje [-16302] indica que la cadena del registro de índice y de desbordamiento esta
rota.
Estos mensajes son informativos y normalmente no son fatales. En algunos casos, puede haber
perdidas de datos segun la naturaleza del danó.
Si obtiene los mensajes durante la verificación de integridad de un archivo históricó, reprocese
el archivo afectado para repararlo. Despues de reprocesar el archivo históricó, se muestra un
informe de todos los errores que se encontraron y resolvieron.
Si obtiene estos errores mientras se reprocesa un archivo históricó, los mensajes seran
informativos y la utilidad de reprocesamiento intentara reparar las discrepancias que se
encontraron.
Número de mensaje Texto del mensaje
-16300 Cadena de desbordamiento inversa no valida
-16301 Cadena de índice inversa no valida
-16302 Registro de desbordamiento no encontrado en los
registros de índices
-16303 Entrada de índice con referencia de registros de
desbordamiento multiples
-16304 Registro de desbordamiento out-of-order en el
registro de índice
-16305 Evento out-of-order encontrado en el registro de
desbordamiento

Número de mensaje Texto del mensaje

-16306 Evento marcado como anotado sin indicador de
anotaciones
-16307 Registro de anotaciones no encontrado para el
evento anotado
-16308 Registro de anotaciones con referencia de eventos
multiples
-16309 El índice no coincide con la hora de inicio del
registro de desbordamiento
-16310 Evento anterior a la hora de inicio del archivo
históricó
-16311 Evento posterior a la hora de finalización del
archivo históricó
-16312 Tipo de dato inesperado para el registro de índices
-16313 La hora de inicio del índice no coincide con la hora
de inicio del archivo históricó
-16314 El primer registro de desbordamiento posee un
registro anterior
-16316 Tipo de dato inesperado para el registro de índices
-16317 Numeró de ficheró de archivado no validó
-16318 Cadena circular de registro de desbordamiento
-16319 Cadena circular de registro de índices
-16320 Demasiados errores, filtradó de errores que no son
fatales
-16321 Evento en la hora de finalización del archivo
históricó
-16322 Errores detectados en la cómpróbación de
coherencia de archivo históricó
-16323 Demasiadas advertencias, filtradó de advertencias
adicionales
-16324 Demasiados registros de índices
Errores con información sobre archivos dañados

PI Data Archive coloca un flag cuando se detectan danós dentro del archivo.
Si obtiene los mensajes durante la verificación de integridad de un archivo históricó, reprocese
el archivo afectado para repararlo. Para conocer cómó ejecutar un analisis de integridad del
archivo, consulte "Verificar la integridad de los ficherós de archivado" in Live Library (https://
livelibrary.osisoft.com). Despues de reprocesar el archivo históricó, se muestra un informe de
todos los errores que se encontraron y resolvieron.
Si obtiene estos errores mientras se reprocesa un archivo históricó, los mensajes seran
informativos y la utilidad de reprocesamiento intentara reparar las discrepancias que se
encontraron.
Número Texto del mensaje Si se detectan daños, ¿colocar el flag de daños?
de
mensaje
-11001 Error de coincidencia de versiones Sí
en el encabezado del registro

Número Texto del mensaje Si se detectan daños, ¿colocar el flag de daños?

de
mensaje
-11002 Error de coincidencia de datos en el Sí
encabezado del registro
-11018 Desbordamiento de danós o Sí
punteros de registro primario
-11064 Error de coincidencia de recid en el Sí
encabezado del registro
-11065 Error de coincidencia del puntero en Sí
la cadena del encabezado del
registro
-11141 Demasiados eventos en el registro; Sí
muy posiblemente sean danós
Configurar el número de archivos históricos supervisados en busca de

errores de lectura y escritura
De manera predeterminada, PI Archive Subsystem deja de escribir datos de series temporales
en los ficherós de archivado despues de detectar un error al leer o escribir datos. Esta función
protege los datos de los archivos históricós. El parametró de ajuste
Archive_DisableArchivingOnIOError permite esta función.
Procedimiento
• Para cónfigurar el numeró de archivos históricós supervisados, especifique un numeró en el
parametró Archive_DisableArchivingOnIOErrorRange.
PI Archive Subsystem supervisa el numeró especificadó de archivos en busca de errores de
lectura y escritura; comienza con el archivo primario. Por ejemplo, si se cónfigura en 3 (el
valor predeterminado), PI Archive Subsystem supervisa el archivo primario, ademas de los 2
archivos históricós anteriores. Un valor de 0 indica que PI Archive Subsystem supervisa
todos los archivos.
Nota:
Si PI Archive Subsystem pierde la cónexión con el dispositivo de almacenamiento en el
que reside el archivo primario, el subsistema no intenta volver a conectarse con el
archivo históricó. Los datos se desplazan a la cola de eventos, pero no se almacenan en
el ficheró de archivado. Para volver a conectar y almacenar los datos en el archivo
históricó, detenga y reinicie el subsistema. Para obtener mas infórmación, consulte el
artículó de Soporte Tecnicó de OSIsoft 3106OSI8: Tipos de dispositivos de
almacenamiento compatibles con los ficherós de archivado de PI Data Archive
(https://techsupport.osisoft.com/Troubleshooting/KB/3106OSI8).
Evitar cambios en los archivos históricos

Para proteger a un archivo históricó de la sobrescritura, OSIsoft recomienda utilizar el
parametró de ajuste EditDays para establecer un límite de tiempo para los cambios en los
archivos históricós. Mediante el uso del parametró EditDays, usted especifica un límite de
tiempo en un numeró de días anterior a la fecha actual en la que los eventos pueden insertarse
o editarse. El snapshot rechaza eventos con marcas de tiempo anteriores al límite. De manera
predeterminada, no existe límite.

Aunque es posible cónfigurar un ficheró de archivado para que sea de solo lectura, al hacerlo
puede perder los datos. Los ficherós de archivado de solo lectura no pueden participar en
intercambios de archivos históricós ni pueden módificarse.
En esta sección
• Módificar el parametró de ajuste EditDays
• Cónfigurar un archivo para que sea de solo escritura o de solo lectura
Modificar el parámetro de ajuste EditDays

Puede módificar el valor del parametró EditDays con el numeró de días pasados en que los
eventos pueden módificarse, en las bases de datos de Snapshot o de Archive.
Procedimiento
1. Seleccione Start > PI System Management Tools > Operation > Tuning Parameters.
2. En el panel Collectives and Servers, seleccione el servidor PI Data Archive adecuado.
3. Haga clic en la pestana Snapshot del subsistema en el que desea editar el valor del
parametró de ajuste.
4. Si es necesario, agregue el parametró de ajuste EditDays a la lista. Consulte Agregar un
parametró de ajuste a la lista.
5. Haga clic con el bótón derecho en el parametró EditDays y luego haga clic en Edit.
6. Ingrese un valor y haga clic en OK. El valor cero significa que no se realiza ninguna
cómpróbación de hora.
7. Para aplicar los cambios, reinicie el servidor PI Data Archive.
Configurar un archivo para que sea de solo escritura o de solo lectura

Procedimiento
• Para cambiar el flag Write de prótección para un ficheró de archivado, haga clic con el bótón
derecho en el archivo históricó de la vista de lista y seleccione la ópción correcta.
◦ Para que un archivo históricó de solo lectura se convierta en archivo de escritura,
seleccione Make Writable.
◦ (No recomendado). Para que un archivo históricó de escritura se convierta en archivo de
solo lectura, seleccione Make Read-Only.
PRECAUCIÓN:
Si cónfigura un archivo históricó como archivo de solo lectura puede ocasionar la
perdida de datos. El metódó preferido para evitar cambios en los archivos históricós
es utilizar el parametró de ajuste EditDays para cónfigurar un límite de tiempo
para los cambios en los archivos históricós.
Exportar una lista de archivos históricos a un archivo

Procedimiento
2. Seleccione un archivo históricó del servidor PI Data Archive de destino de la lista.
3. Haga clic en Export Archive List y seleccione un tipo de archivo.

4. En la ventana Save Archive List As, seleccione una ubicación para almacenar el ficheró de
archivado.
5. Haga clic en Save.
Crear un archivo de registro .bat

Procedimiento
1. Abra SMT
2. Seleccione Operation
3. Seleccione Archives
4. Seleccione Registration BAT File
Mover ficheros de archivado

En algunos casos, es posible que deba mover ficherós de archivado. Por ejemplo, puede instalar
un nuevo disco duro y desea mover los archivos históricós a este.
Procedimiento
1. Edite el parametró de ajuste Archive_AutoArchiveFileRoot para cónfigurar la ruta
completa en el nuevo directorio de archivo históricó.

El nuevo archivo primario se crea en el nuevo directorio.

2. Fuerce un intercambio de archivo históricó.
3. Mueva los archivos históricós que no son primarios:
a. Anule el registro de los archivos históricós que no son primarios.
b. Mueva los archivos históricós que no son primarios y los archivos de anótación asociados
a un nuevo directorio.
c. Vuelva a registrar los archivos históricós que no son primarios.
Eliminar un evento de archivo histórico

El siguiente procedimiento es util para eliminar un solo evento de archivo históricó o una
cantidad pequena de eventos de archivos históricós. Para eliminar grandes cantidades de datos,
utilice los metódós ReplaceValues de AF SDK. Para obtener mas infórmación, consulte los
temas de referencia de AF SDK AFData.ReplaceValues Method (https://
techsupport.osisoft.com/Documentation/PI-AF-SDK/html/
Overload_OSIsoft_AF_Data_AFData_ReplaceValues.htm) y PiPoint.ReplaceValues Method
(https://techsupport.osisoft.com/Documentation/PI-AF-SDK/html/
M_OSIsoft_AF_PI_PIPoint_ReplaceValues.htm).
La óperación de eliminación no se puede deshacer. Si elimina grandes cantidades de datos,
puede afectar la disponibilidad de un servidor PI Data Archive en línea. Si elimina datos de
manera periódica, investigue la causa principal y considere alternativas para eliminar datos de
forma masiva. Las alternativas posibles pódrían ser las siguientes: usar las cónfiguraciónes
adecuadas de cómpresión y excepción, aumentar el espacio disponible en el disco, mover
archivos históricós mas antiguos a un almacenamiento en segundo nivel, etc.
Antes de empezar
Antes de eliminar datos reales, OSIsoft recomienda encarecidamente que practique eliminar
pequenas cantidades de datos en un sistema de prueba.
Procedimiento
1. Realice una copia de seguridad de sus datos.
2. En el panel Servidores, seleccione el servidor del que desea eliminar los datos.
3. En el panel System Management Tools, seleccione Datos > Editor de archivado.
4. Haga clic derecho en el valor que desea eliminar y seleccione Delete.
5. Haga clic en Guardar.
Nota:
No aparecera ningun mensaje para cónfirmar la eliminación de los valores.
Eliminar eventos de archivo histórico de estado digital mediante el uso

de piconfig
Si necesita eliminar los valores de un estado digital, utilice piconfig como se muestra aquí.
Procedimiento
1. Copie los siguientes comandos en un archivo de texto denominado DELEVENTS.TXT y
guardeló en el directorio pi\adm.
En este ejemplo se utiliza el PI point cdt158.

*DELEVENTS.TXT
@table piarc
@mode list
@istructure tag, starttime, endtime, count
@ostructure tag, time, status
@ostructure ...
@timf 9
@sigd 9
@output tmpdelevents.dat
cdt158,*-6h,*,*
*@exit - uncomment this to exit and review before deleting
@mode edit
@modify mode=remove
@istructure tag, time, value
@input tmpdelevents.dat
@exit
2. Edite DELEVENTS.TXT y reemplace cdt158 con los PI points (tags) e intervalos de tiempo de
los cuales desea realizar la eliminación.
Si desea eliminar eventos de varios PI points, agregue entradas multiples. Por ejemplo:
cdt158,*-6h,*,*
cdm158,y,t,10000
sinusoid,*-1m,*,20
El formato es PI point name, starttime, endtime, count of events you want

to delete.
3. Abra un símbóló de sistema, vaya al directorio PI\adm y ejecute piconfig con
DELEVENTS.TXT como entrada.
C:\PI\adm>piconfig < delevents.txt
Eliminar un archivo histórico

Debe anular el registro de un archivo históricó para poder eliminar sus archivos.
Procedimiento
1. En PI SMT, seleccione Operation > Archives.
2. Haga clic con el bótón derecho sobre el archivo históricó y seleccione Unregister Archive.
3. Abra Windows Explorer y vaya a la carpeta de archivos históricós (de manera
predeterminada, C:\Program Files\PI\arc).
4. Elimine el ficheró de archivado (archive_name.arc) y el archivo de anótación relacionado
(archive_name.arc.ann).
Verificar archivos dañados

Al utilizar la herramienta PI SMT Archives, puede verificar con facilidad que no existan archivos
danadós. Es específicamente importante verificar lo siguiente:
• Que el archivo primario no este danadó.
• Que, si esta reponiendo datos, el archivo históricó que este reponiendo no este danadó.
La herramienta PI SMT Archives marca los archivos danadós y le permite reprocesarlos
mientras estan conectados. Para obtener mas infórmación, consulte Reprocesamiento de
archivos históricós.

Administración de la reposición
La repósición es el proceso que consiste en importar datos históricós de otra fuente en PI Data
Archive. OSIsoft ofrece varias interfaces para la repósición, incluida la Base de datos relacional
de PI (RDBMS a traves de ODBC), la interfaz RDBMSPI, el archivo universal y la Interfaz del
cargador de secuencia (UFL).
En esta sección
• Practicas recomendadas para la repósición
• Preparar PI Data Archive para la repósición de datos
• Reponer un archivo históricó nuevo
• Reponer archivos históricós existentes con datos de PI points nuevos
• Borrar el snapshot Pt Created
• Reponer datos con un script de picónfig
Prácticas recomendadas para la reposición

Durante la repósición, los datos de los archivos se envían a PI Data Archive a una velocidad que
es superior a la velocidad del sistema de control. Para minimizar la carga en PI Data Archive,
sigas estas recomendaciones.
• Para evitar cualquier carga en su servidor de próducción principal y arriesgar los datos
reales, realice tareas de repósición en un servidor PI Data Archive sin cónexión.
• Para evitar archivar datos innecesarios y garantizar una repósición eficiente, realice la
repósición con cómpresión.
• Los puntos de todos los datos repuestos deben definirse en la base de datos de puntos.
• Procese los datos de todos los puntos en pequenós batches, por ejemplo, un batch por día.
• Realice la repósición de los datos en orden crónólógicó, de mas antiguo a mas nuevo, en cada
punto. Si realiza la repósición de datos out-of-order, estos no se cómprimiran.
En el caso de grandes cantidades de datos, siga estas recomendaciones adicionales.
• Considere escribir una aplicación personalizada para realizar la repósición.
• Antes de la repósición, realice una prueba de repósición con un intervalo de tiempo mas
corto a fin de garantizar que los datos se importen correctamente. Durante la prueba,
verifique las estadísticas de archivos históricós y de snapshots para ver de que manera la
repósición afecta el rendimiento de PI Data Archive y resuelva cualquier otro problema que
sea necesario.
Preparar PI Data Archive para la reposición de datos

Procedimiento
1. Evalue los datos que esta reponiendo.
Determine el numeró y la cónfiguración de nuevos tags, el períódó que abarcan todos los
tags y la cantidad aproximada de datos que debe importar.
2. Cree los puntos que repóndra.
Si los puntos corresponden a interfaces activas, asegurese de que los datos actuales no se
envíen al punto desde la interfaz. Una manera de hacer esto es creando los puntos con el

conjunto de atributos Scan cónfiguradó en 0 (cero, que esta desactivado) o cónfigurar el

atributo Point Source para los puntos y L para el punto Lab. Pódra cambiarlos despues.
(Puede importar datos en puntos existentes que ya contengan valores, pero no pódra
comprimir los datos).
3. Verifique los ficherós de archivado existentes mediante el uso de la herramienta Archives de
PI SMT o el comando piartool -al . Tome nota de la hora de inicio, la hora de finalización
y del nombre de archivo (incluida la ruta) de todos los archivos históricós que se encuentran
en el intervalo de tiempo de los datos de repósición.
4. Realice una copia de seguridad de su servidor PI Data Archive, incluidos todos los archivos
históricós que planea reprocesar (si es necesario) y reponer. Consulte Copias de seguridad
de PI Data Archive.
5. Cree archivos históricós adicionales segun sea necesario.
Si los datos que desea reponer incluyen valores anteriores al archivo históricó mas antiguo,
cree un nuevo archivo históricó dinamicó con una hora de inicio igual o anterior a la marca
de tiempo mas antigua y una hora de finalización igual a la hora de inicio del archivo
históricó mas antiguo actual. Consulte Creación de archivos históricós con PI SMT.
6. Verifique que el valor mas antiguo este ahora en el snapshot de puntos nuevos.
Reponer un archivo histórico nuevo

Nota:
De manera predeterminada, los datos se comprimen. Si no desea que se compriman,
deshabilite el parametró de ajuste Snapshot_DoNotReplacePTCreatedOnOOO.
Antes de empezar
Antes de llevar a cabo los siguientes procedimientos, asegurese de seguir los pasos en Preparar
PI Data Archive para la repósición de datos.
Procedimiento
1. Instale PI Data Archive, inicie el servidor PI Data Archive, cree todos los puntos y luego
detenga el servidor PI Data Archive.
2. Aísle el servidor PI Data Archive de todos los datos de proceso entrantes.
Para hacer esto, siga uno de estos metódós:
◦ Cierre las PI interfaces en todos los nodos de PI API y PINet.
◦ No permita todas las conexiones de PI API en el servidor. Inicie piconfig sin iniciar PI
Data Archive. Ignore los mensajes de error de cónexión e ingrese:
@table pifirewall
@mode edit,t
@istr hostmask,value
"*.*.*.*",DISALLOW
Nota:
Las entradas que permiten el acceso a nombres o direcciones específicas anulan la
ópción DISALLOW. Edite todas las demas entradas de DISALLOW. Las conexiones
locales no se veran afectadas por las entradas de la tabla PIFirewall; verifique que
las aplicaciones que puedan escribir datos no se esten ejecutando.
3. Inicie el servidor PI Data Archive con el parametró -base. Esto garantiza que PI Data
Archive se inicie solo con la cantidad mínima de subsistemas requeridos. Introduzca el
comando:
pisrvstart.bat -base

4. Use piartool -acd para crear y registrar uno o mas ficherós de archivado para el períódó
de repósición. Tambien puede utilizar la herramienta Archives de PI SMT para crear
archivos multiples para la repósición. Para obtener mas infórmación, consulte Crear
archivos históricós multiples para la repósición.
5. Si el parametró Snapshot_DoNotReplacePTCreatedOnOOO esta habilitado, elimine todos
los eventos de Pt Created del snapshot. Para obtener mas infórmación, consulte Borrar el
snapshot Pt Created.
6. Si esta usando la cómpresión, realice una de las siguientes acciones:
◦ Para reponer con cómpresión, envíe los datos de origen en orden de secuencia de tiempo
con los datos mas antiguos primero.
Nota:
Asegurese de que las fuentes de datos no se escriban en los puntos que se esten
reponiendo. De lo contrario, se ómitira la cómpresión para los datos que se hayan
escrito antes de la hora de snapshot.
◦ Para reponer sin cómpresión, especifique la hora de inicio como la marca de tiempo de
los datos mas antiguos que se repóndran y la hora de finalización como la hora de inicio
del archivo históricó mas antiguo, segun el listado de piartool -al. Los datos que
reponga no estaran comprimidos debido a que la hora de inicio del archivo históricó mas
antiguo es anterior a la hora de snapshot.
Si despues de haber comenzado la repósición descubre que el archivo históricó de
repósición requiere mas de 2 TB de espacio en disco, elimíneló y cree archivos históricós
dinamicós multiples para almacenar los datos. Divida el intervalo de tiempo de destino
entre los archivos históricós dinamicós y luego intente realizar la repósición de datos
nuevamente.
7. Si utilizó la tecnica de módificación de la tabla PIFirewall en el paso 2 anterior, ejecute
piconfig para cambiar el valor de hostmask a ALLOW o eliminar hostmask.
8. Inicie las aplicaciones de PI Data Archive restantes al ejecutar pisrvstart.bat sin el flag -
base.
Reponer archivos históricos existentes con datos de PI points nuevos

Procedimiento
1. Agregue los puntos nuevos al archivo históricó existente. Utilice PI Builder para cargar
puntos en batch o la herramienta PI SMT Point Builder para crear puntos individuales.
2. Si los puntos corresponden a interfaces activas, asegurese de que los datos actuales no se
envíen al punto desde la interfaz.
3. Utilice la herramienta PI SMT PI Archive Manager o el comando piartool -al para
verificar los ficherós de archivado existentes. Tome nota de la hora de inicio, la hora de
finalización y el nombre de archivo (incluida la ruta) de todos los archivos históricós que se
encuentran en el intervalo de tiempo de los datos de repósición.
4. Realice una copia de seguridad del servidor PI Data Archive, incluidos todos los archivos
históricós que planea reponer.
5. Los datos se cómprimiran de manera predeterminada. Si no desea que se compriman,
habilite el parametró de ajuste Snapshot_DoNotReplacePTCreatedOnOOO.
6. Reponga los datos.

Borrar el snapshot Pt Created

Nota:
Si el parametró de ajuste Snapshot_DoNotReplacePTCreatedOnOOO no se cónfigura en
1 (el valor predeterminado es 0), omita este procedimiento.
Para eliminar un valor de snapshot Pt Created de un punto a la vez, utilice Archive Editor de
PI SMT.
Para exportar puntos con valores de snapshot de Pt Created y eliminar esos valores de la
tabla de snapshot, siga estos pasos.
Procedimiento
1. Cree un archivo de script de piconfig llamado gettags.txt. Incluya los siguientes
comandos en el archivo:
@table pisnap
@select status = Pt Created, tag = *
@ostr tag, time
@output snap_to_delete.txt
@ends
2. Guarde y cierre el archivo gettags.txt.
3. Abra un símbóló del sistema.
4. Vaya al directorio PI\adm.
5. Ejecute piconfig, mientras redirige el archivo de script creado anteriormente. (Si utilizó
una ruta o nombre de archivo diferente para su archivo de script, cambie la ruta real y el
nombre del archivo de su archivo de script por c:\gettags.txt en el siguiente ejemplo).
Piconfig < c:\gettags.txt
6. Abra el archivo snap_to_delete.txt en el directorio PI\adm para verificar que puntos
poseen valor Pt Created en el snapshot. Edite el archivo para eliminar los puntos que no
planea reponer.
7. Guarde el archivo snap_to_delete.txt.
8. Ejecute piconfig con los siguientes comandos:
@table piarc
@mode edit, t
@istr tag, time
@modi mode = remove
@input snap_to_delete.txt
@ends
Reponer datos con un script de piconfig

OSIsoft recomienda usar una interfaz de OSIsoft (como UFL, RDBMS o RDBMSPI) para reponer
los datos en PI Data Archive. Sin embargo, tambien puede usar un script de picónfig para
reponer los datos.
Procedimiento
1. Cree un archivo de texto separado por comas que contenga los datos.
Formatee el archivo de texto de la siguiente manera:
◦ Un valor de tag por línea.
Cada línea debe incluir el nombre del tag, la marca de tiempo y el valor. La marca de
tiempo debe tener el formato que se muestra en el siguiente ejemplo:
A1HV074B,08-Aug-89 11:00:00,3659

Nota:
Para obtener mas infórmación sobre PI time, consulte "expresiones de PI time" in
Live Library (https://livelibrary.osisoft.com).
◦ Se pueden incluir valores de multiples tags en un solo archivo.
◦ Los valores deben estar en orden temporal (de mas antiguo a mas nuevo) para que cada
tag reponga con cómpresión.
2. Si tiene una gran cantidad de datos, separelós en archivos mas pequenós para que pueda
administrar y realizar un seguimiento de la repósición con facilidad (por ejemplo, un día por
vez)
3. Anada el siguiente script piconfig al comienzo del archivo:
@mode edit,t
@table pisnap
@istr tag, time, value
A1HV074B,08-Aug-89 11:00:00,3659
... [followed by the rest of your data]
4. Guarde el archivo como un archivo *.csv, por ejemplo data.csv.
5. Pruebe el script piconfig con una pequena muestra de los datos.
Siempre ejecute una prueba de repósición con una cantidad pequena de datos primero y
luego con el resto de los datos. De esta manera, puede verificar su script piconfig y
garantizar que los datos se importen correctamente. Verifique las estadísticas de archivos
históricós y de snapshots durante la prueba para ver de que manera la repósición afecta el
rendimiento de PI Data Archive.
Verifique las estadísticas de archivos históricós y de snapshots durante la prueba para ver
de que manera la repósición afecta el rendimiento de PI Data Archive.
6. Fuerce un intercambio de archivo históricó para evitar reponer en un archivo primario si
esta reponiendo en un sistema de próducción. La manera mas facil de hacer esto es con el
móduló PI SMT Archive Editor.
7. Abra una ventana del símbóló del sistema.
8. Cambie al directorio PI\adm.
9. Ejecute piconfig y redirija su archivo de datos preparado anteriormente. Sustituya la ruta
actual y el nombre del archivo de su archivo de texto preparado para c:\tags\data.csv
en el siguiente ejemplo:
piconfig < c:\tags\data.csv
10. Verifique sus datos mediante el uso de DataLink o de ProcessBook.
Administración de ficheros de archivado desconectados con

piarchss
La herramienta de archivo desconectado utiliza el ejecutable piarchss que se ejecuta en PI
Archive Subsystem.
La herramienta de archivo desconectado funciona con los ficherós de archivado que no estan
registrados con un servidor PI Data Archive en ejecución (es decir, archivos desconectados). El
servidor PI Data Archive puede continuar archivando datos actuales mientras usted trabaja en
ficherós de archivado desconectados. Si intenta utilizar la herramienta de archivo desconectado
en un ficheró de archivado registrado, la utilidad anulara el registro del archivo.
Utilice la herramienta de archivo desconectado para realizar lo siguiente:

• Combinar archivos históricós.

• Dividir un ficheró de archivado en archivos mas pequenós.
• Extraer un períódó específicó de un archivo históricó.
Nota:
Para recuperar un archivo históricó danadó, consulte Reprocesamiento de archivos
históricós.
Nota:
A partir de PI Data Archive 2016 R2, si se dana un archivo de cola de eventos, se lo
recupera autómaticamente siempre que sea posible. Para obtener mas infórmación,
consulte Restablecimiento autómaticó de la cola de eventos.
La herramienta de archivo desconectado puede crear ficherós de archivado fijós o dinamicós.
Los archivos creados poseen el mismo formato que los ficherós de archivado que creó
piartool -ac. Cada ficheró de archivado posee un archivo de anótación paralelo creado con
el archivo históricó. El archivo de anótación, que posee la extensión de archivo .ann, debe
permanecer en el mismo directorio que su ficheró de archivado asociado.
En esta sección
• Consejos para utilizar la herramienta de archivo desconectado
• Mostrar infórmación de archivo históricó no registrado
• Opciones de línea de comandos de la utilidad de archivo desconectado
• Ejecutar la herramienta de archivo desconectado
• Intervalos de tiempo
• Compensaciones para marcas de tiempo de eventos (-tfix -tfixend)
• Fusionar o dividir archivos históricós
Consejos para utilizar la herramienta de archivo desconectado

• Si el archivo históricó de entrada es el archivo primario, no puede anular su registro. Para
resolver esto, fuerce un intercambio de archivo históricó mediante el uso del comando
piartool -fs o cierre PI Archive Subsystem temporalmente.
• Si el archivo de salida no existe, la herramienta lo creara.
• Si no se especifica un nombre de ruta completa para el archivo históricó de salida, la
herramienta cólócara el archivo históricó de salida en el directorio actual.
• Al final del procesamiento, no se registrara ninguno de los archivos históricós, ni el de
entrada ni el de salida.
• La integridad del archivo históricó de entrada se verifica antes de su uso. Para desactivar
este comportamiento, utilice la ópción –noinputcheck.
• De manera predeterminada, la herramienta de archivo desconectado crea archivos
históricós dinamicós. Para especificar un archivo históricó fijó, utilice la ópción -f .
Nota:
Los archivos históricós dinamicós se convierten en archivos que no pueden
intercambiarse una vez que se genera un solo registro de desbordamiento, pero
pueden seguir intercambiandóse si no se generan registros de desbordamiento.
• Puede ejecutar la herramienta de archivo desconectado mientras PI Data Archive y PI
Archive Subsystem se estan ejecutando. Cómó mínimó, PI Network Manager, PI Base

Subsystem y PI Snapshot Subsystem deben estar ejecutandóse, ya que la herramienta

necesita acceder a la base de datos de PI point durante las operaciones sin cónexión.
Mostrar información de archivo histórico no registrado

Solamente puede usar este comando si el ficheró de archivado no esta registrado o si PI Data
Archive esta deshabilitado. Si lo usa con un ficheró de archivado registrado, el comando pidiag
-ahd arrójara un error de acceso.
Procedimiento
pidiag -ahd path
donde path es la ruta al archivo históricó no registrado.
Por ejemplo:
pidiag -ahd d:\pi\dat\piarch.001
El resultado es similar al del comando piartool -al para un solo ficheró de archivado:
D:\PI\adm>pidiag -ahd d:\pi\dat\piarch.001
PIarcfilehead[$Workfile: piarfile.cxx $ $Revision: 129 $]::
Version: 8 Path: D:\PI\dat\piarch.001
State: 3 Type: 0 (fixed) Write Flag: 1 Shift Flag: 1
Record Size: 1024 Count: 131072 Add Rate/Hour: 27.9
Offsets: Primary: 1837/65536 Overflow: 106950/131072
Annotations: 1/65535 Annotation File Size: 2064
Start Time: 16-Aug-09 23:08:12
End Time: Current Time
Backup Time: 25-Aug-09 14:26:11
Last Modified: 24-Sep-09 14:31:27
Opciones de línea de comandos de la utilidad de archivo desconectado

La herramienta de archivo desconectado admite varias opciones. Puede ingresar opciones en
cualquier orden. La utilidad de archivo desconectado requiere las opciones -if y -of. En las
secciones posteriores se analiza cómó puede utilizar algunas de las opciones. Para ver todas las
opciones disponibles, escriba piarchss -?.
Opción Nombre Descripción
-acceptprompts Aceptar todos Cuando se especifique, todos los símbólós que presenta la
los símbólós herramienta durante el reprocesamiento se aceptaran de
manera predeterminada.
-dup Registros Permitir registros de archivos históricós de entrada con horas
duplicados duplicada. De manera predeterminada, los duplicados se
ignoran.
-evq Archivo de la Indicar que el archivo de entrada es un archivo de la cola de
cola de evento PI 3 (por ejemplo, pimapeq.dat).
eventos
-f size Convertir un Especificar el tamanó en MB. Si el tamanó es igual a 0, se utiliza
archivo el tamanó del archivo de entrada. El valor predeterminado es el
históricó de archivo dinamicó.
salida en un
archivo
históricó fijó


-filter start end Filtro Procesar eventos solamente en el intervalo de tiempo
(inclusivo) especificadó. Requiere ambas marcas de tiempo.
Consulte Filtros de hora.
-filter_ex start end Filtro que Procesar eventos solo en el intervalo de tiempo especificadó
excluye la (incluye la hora de inicio; excluye la hora de finalización).
hora de Requiere ambas marcas de tiempo. Consulte Filtros de hora.
finalización
-id pathname Especificar el Especificar el nombre de archivo y la ruta binaria de cónversión
archivo de de ID. Consulte Especificar un archivo de cónversión de ID.
cónversión de
ID
-idci input_file - Creación de Crear archivo de cónversión de ID a partir de archivo de
idco outfile archivo de entrada especificadó.
cónversión de
ID
-if pathname Fichero de Necesario. La ruta completa y la letra de la unidad son
archivado de obligatorias. Esto es correcto para todos los argumentos de
entrada archivos pasados.
-noinputcheck Deshabilitar la Deshabilitar la verificación de integridad del archivo históricó
verificación de entrada.
de entrada del
archivo
históricó de
entrada
-oet option Hora de Especificar la hora de finalización del archivo de salida.
finalización Consulte Especificar la hora de finalización para el archivo de
del archivo de salida para obtener mas detalles.
salida
-of pathname Fichero de Necesario.
archivado de
salida
-ost option Hora de inicio Especificar la hora de inicio del archivo de salida. Consulte
del archivo de Especificar una hora de inicio para el archivo de salida para
salida obtener mas detalles.
-outputcheck Permite Despues de finalizar el reprocesamiento, se verificara el archivo
verificar el históricó de salida para garantizar que tenga integridad.
archivo
históricó de
salida
-silent Modo Suprimir mensajes de advertencia.
silencioso
-tfix Transformar Aplicar una transfórmación de hora especificada a los datos de
hora entrada. Consulte Compensaciones para marcas de tiempo de
eventos (-tfix -tfixend).
-tfixend time_stamp Finalizar la Especificar una marca de tiempo despues de la cual no deba
transfórmaci realizarse ninguna transfórmación de la hora. Opcional: solo si
ón de hora se utiliza junto con –tfix.
-tzf pathname Archivo de Se utiliza cuando la entrada es diferente de la DST estandar.
especificación
de zona
horaria


-vah Validar Aplicar algoritmo de validación. Se detectaran y arreglaran
indicadores multiples eventos que hagan referencia a una sola anótación. Se
de verifica que las anotaciones de la Base de datos de batches sean
anotaciones coherentes.
Ejecutar la herramienta de archivo desconectado

Para ejecutar la herramienta de archivo desconectado (piarchss), ingrese un ficheró de
archivado de entrada y un ficheró de archivado de salida, junto con los parametrós de comando
relevantes.
Procedimiento
1. En el símbóló del sistema, vaya al directorio PI\bin.
piarchss -if inputPath -of outputPath
donde inputPath es la ruta completa (incluido el nombre del archivo) del ficheró de
archivado de entrada, outputPath es la ruta completa (incluido el nombre de archivo) del
ficheró de archivado de salida.
Resultados
La herramienta de archivo desconectado toma el archivo de entrada, lo procesa de acuerdo con
los parametrós del comando y luego envía el archivo procesado a la ubicación especificada. La
herramienta de archivo desconectado no módifica el archivo de entrada en ninguna
circunstancia.
En esta sección
• Códigós de salida de la herramienta de archivo desconectado
• Consecuencias de realizar el reprocesamiento en el estado digital
• Especificar un archivo de cónversión de ID
Códigos de salida de la herramienta de archivo desconectado

Para facilitar el procesamiento de archivos de batches, la herramienta de archivo desconectado
devuelve un códigó de salida al sistema operativo.
Código Definición
0 Sin errores: se prócesó al menos un registro de entrada.
1 Errores durante la fase de entrada.
2 Sin errores de procesamiento: 0 registros procesados, posiblemente un
archivo de entrada vacíó.
<0 Los mensajes de registro de verificación de procesamiento de resultados
arrojaron un error.
Consecuencias de realizar el reprocesamiento en el estado digital

Los estados digitales se almacenan en los archivos históricós como compensaciones en un
conjunto de estados digitales. El numeró de conjunto de estados digitales se registra en cada

registro de archivo históricó de un punto digital. Los estados digitales del sistema pueden
aparecer en cualquier registro.
Las compensaciones se preservan cuando se reprocesa un archivo históricó, pero el conjunto
digital se convierte en el conjunto digital actual del punto. Esto puede generar cónfusión
cuando se cambia el estado digital de un punto. Por ejemplo, si los datos se almacenan para un
punto con un conjunto de On,Off estos datos representan 0 y 1. Posteriormente, el punto se
cambia para utilizar un conjunto con Open, Close. Cuando se reprocesan, los datos antiguos se
muestran como Open y Closed. Este comportamiento pódría ser deseado en algunos casos y
confuso en otros.
Para obtener mas infórmación sobre las consecuencias de realizar el reprocesamiento en el
estado digital, consulte el artículó de la base de conocimientos What happens when I change a
digital tag's digital state set or delete a digital state set.
Especificar un archivo de conversión de ID

Utilice la ópción -id para especificar un archivo de cónversión de ID al reprocesar archivos
históricós, por ejemplo, al mover un ficheró de archivado de PI a un servidor PI Data Archive
diferente. El archivo de cónversión de ID es un archivo binario que asigna el ID de punto del
archivo históricó de origen al ID de punto del sistema de destino. Al especificar un archivo de
cónversión de ID, los procesos de la herramienta de archivo desconectado procesa y convierte
los puntos incluidos en el archivo.
Siempre utilice esta ópción al traer un ficheró de archivado de otro servidor PI Data Archive.
Cree el archivo binario a partir del texto de entrada con la ópción -idci:
piarchss -idci ID_conversion_input_file -idco ID_conversion_binary_file
El ID_conversion_input_file es la ruta completa y el nombre del archivo para el archivo de texto

de entrada.
El ID_conversion_binary_file es la ruta completa y el nombre del archivo binario que se creara.
La herramienta de archivo desconectado informa sobre los puntos del archivo de entrada que
no existen en el sistema de destino.
Intervalos de tiempo
Puede especificar el intervalo de tiempo de los registros que procesa la herramienta de archivo
desconectado y puede especificar la hora de inicio y la hora de finalización del archivo de salida
que produce la herramienta de archivo desconectado.
En esta sección
• Filtros de hora
• Especificar una hora de inicio para el archivo de salida
• Especificar la hora de finalización para el archivo de salida
Filtros de hora
Para procesar eventos que se produjeron durante un períódó específicó, utilice el flag de filtró
con piarchss.
• -filter

Especifica el períódó entre la hora de inicio y la hora de finalización, e incluye ambas horas.
La herramienta de archivo desconectado descarta eventos fuera del intervalo. El uso es el
siguiente:
piarchss -filter starttime endtime
• -filter_ex
Especifica el períódó entre la hora de inicio y la hora de finalización, e incluye la hora de
inicio, pero excluye la hora de finalización. La herramienta de archivo desconectado descarta
eventos fuera del intervalo. El uso es el siguiente:
piarchss -filter_ex starttime endtime
Para ambos flags, la hora de inicio debe ser anterior a la hora de finalización.
Especificar una hora de inicio para el archivo de salida

Para especificar la hora de inicio del archivo de salida, use el flag -ost con el comando
piarchss.
piarchss -ost option
Donde option es una de las siguientes opciones:

Opción Description
input Cónfigura la hora de inicio en la hora de inicio del archivo de entrada. Este es
el comportamiento predeterminado.
event Cónfigura la hora de inicio en la hora del primer evento del archivo de
entrada.
time Cónfigura la hora de inicio en la cadena de hora especificada. Se aplican las
siguientes reglas:
• Especifique las horas en formato de hora de PI fijó o de referencia. No se
admiten compensaciones de tiempo.
• Las horas deben colocarse entre comillas dobles cuando contengan
espacios.
• Si solo se especifica la fecha, la hora predeterminada es 00:00:00
(medianoche).
• Las horas de inicio y finalización del archivo de salida deben diferir en al
menos un segundo.
Ejemplos de cadenas de tiempo:
"22-JAN-17 23:59:59"
23-JAN-17
21-Feb
NFE Cónfigura la hora de inicio en la hora del primer evento que pasa el filtró de
hora.
Especificar la hora de finalización para el archivo de salida

Para especificar la hora de finalización del archivo de salida, use el flag -oet con el comando
piarchss.
piarchss -oet option
Donde option es una de las siguientes opciones:

Opción Descripción
input Cónfigura la hora de finalización en la hora de finalización del
archivo de entrada. Este es el comportamiento predeterminado.

event Cónfigura la hora de finalización en la hora del ultimó evento del
archivo de entrada.
time Cónfigura la hora de finalización en la cadena de hora especificada.
Se aplican las siguientes reglas:
• Especifique las horas en formato de hora de PI fijó o de
referencia. No se admiten compensaciones de tiempo.
• Las horas deben colocarse entre comillas dobles cuando
contengan espacios.
• Si solo se especifica la fecha, la hora predeterminada es 00:00:00
(medianoche).
• Las horas de inicio y finalización del archivo de salida deben
diferir en al menos un segundo.
Ejemplos de cadenas de tiempo:
“22-JAN-17 23:59:59”
23-JAN-17
21-Feb
NFE Cónfigura la hora de finalización en la hora del ultimó evento que

pasa el filtró de hora.
primary Cónfigura la hora de finalización para indicar que el archivo históricó
es el archivo primario.
NoChange La hora de finalización no se módifica.
Compensaciones para marcas de tiempo de eventos (-tfix -tfixend)

Las compensaciones, como una función del tiempo, se definen en el archivo de cónversión
temporal. Use las compensaciones para aplicar correcciones de tiempo en los sistemas que
tengan marcas de tiempo incorrectas.
Para agregar una determinada cómpensación de tiempo a cada evento:
-tfix conversion_file
El parametró opcional -tfixend le permite especificar una marca de tiempo despues de la cual
no se realizan correcciones de marcas de tiempo. Por ejemplo, se especifica la siguiente
cómbinación de -tfix y -tfixend para realizar las correcciones de marca de tiempo
especificadas en el archivo conversion_file.txt y para no módificar ninguna marca de
tiempo de un evento a partir de las 13:00:00 del 1 de enero de 2010:
-tfix conversion_file.txt -tfixend "1-jan-2010 13:00:00"
Formato de archivos de conversión de hora

Tenga en cuenta lo siguiente sobre el formato de archivos de cónversión de hora:
• Las líneas que comienzan con “#” son comentarios.
• Se ignoran las líneas vacías y los espacios en blanco.
• Las líneas de datos tienen el formato:
StartTime, offset
StartTime puede expresarse como segundos de UTC desde el 1/1/70 o como cadena de
marca de tiempo local de PI. Las marcas de tiempo y las cadenas de UTC no pueden
entremezclarse; el primer formato se asume para todas las entradas.

Offset es un numeró de segundos agregado a la marca de tiempo de cada evento dentro del
intervalo de tiempo. No se admiten los segundos en fracciones. Se aplica la cómpensación de
la marca de tiempo hasta la próxima marca de tiempo, pero no la incluye a esta.
Ejemplos de archivos de conversión de hora

Adelantar 1 hora el archivo históricó completo:
0,3600
2000000000,3600
Adelantar 1 hora el archivo históricó completo (otro formato):

01-Jan-70 00:00:00,3600
01-Jan-30 00:00:00,3600
Aplicar una cónversión de DST faltante a un archivo históricó que abarque el verano de 2016:
01-Jan-16 00:00:00,0
13-Mar-16 02:00:00,3600
06-Nov-16 02:00:00,0
31-Dec-16 23:59:59,0
Aplicar los ajustes de hora para cada períódó como una serie de valores y compensaciones de
UTC:
814953600,-61200
828871200,-57600
846403200,-61200
860320800,-57600
Fusionar o dividir archivos históricos

Los ficherós de archivado se organizan segun los intervalos de tiempo que abarcan. En
ocasiones, puede resultarle util cambiar la órganización de sus ficherós de archivado. Utilice la
herramienta de archivo desconectado para realizar lo siguiente:
• Combinar ficherós de archivado con fechas que se superponen en un ficheró de archivado.
• Combinar ficherós de archivado con intervalos de tiempo adyacentes en un ficheró de
archivado.
• Dividir un ficheró de archivado en ficherós de archivado mas pequenós para que cada uno
abarque una parte del intervalo de tiempo original.
En esta sección
• Fusionar multiples archivos históricós en un solo archivo históricó
• Dividir un archivo históricó en archivos históricós mas pequenós
Fusionar múltiples archivos históricos en un solo archivo histórico

Para combinar varios archivos históricós, invoque una vez la herramienta de archivo
desconectado (piarchss) para cada archivo de entrada y utilice el mismo archivo de salida para
todos los archivos de entrada. Inicie desde el archivo de entrada mas antiguo y cóntinue en
orden temporal ascendente (la herramienta de archivo desconectado no funciónara en orden
temporal aleatorio o descendente). Por ejemplo:
piarchss -if D:\pi\dat\oldest.dat -of D:\pi\dat\bigfile.dat
piarchss -if D:\pi\dat\newer.dat -of D:\pi\dat\bigfile.dat
piarchss -if D:\pi\dat\newest.dat -of D:\pi\dat\bigfile.dat
En este ejemplo, bigfile.dat no existe antes de la óperación. La primera sesión crea el

archivo; la segunda y la tercera agregan eventos al archivo. De manera predeterminada, la
utilidad crea el archivo como archivo históricó dinamicó. Despues de crear el archivo, puede

registrar el archivo históricó y PI Snapshot Subsystem puede agregar eventos al ficheró de

archivado.
Cualquiera de los tres archivos de entrada que se registraron antes de la óperación quedan sin
registrar durante la óperación. Cuando la óperación finaliza, puede registrarlos nuevamente.
Los archivos históricós dinamicós, que son el tipo predeterminado creado por la herramienta
de archivo desconectado, no pueden intercambiarse.
Puede adelantar la hora de finalización del archivo de salida segun sea necesario, pero no
puede cambiar la hora de inicio despues de la creación.
Los archivos históricós con una hora de finalización desconocida deben procesarse en un nuevo
archivo históricó para determinar la hora de finalización real. Luego, el archivo históricó
resultante puede fusionarse crónólógicamente. Para fusionar una serie de archivos históricós
con fechas que se superponen, primero debe procesar el archivo históricó con la hora de inicio
mas antigua y luego debe procesar los restantes en orden crónólógicó, segun las horas de
finalización del archivo históricó.
Para obtener mas infórmación sobre cómó usar la utilidad piarchss, consulte Opciones de
línea de comandos de la utilidad de archivo desconectado y Ejecutar la herramienta de archivo
desconectado.
Dividir un archivo histórico en archivos históricos más pequeños

Para dividir un solo archivo históricó en archivos históricós mas pequenós, invoque una vez la
herramienta de archivo desconectado para cada archivo de salida y utilice el mismo archivo de
entrada para todas las salidas. En cada invócación, especifique una hora de inicio y una hora de
finalización diferentes en formato de hora de PI absoluto.
Por ejemplo, las siguientes sentencias dividen un archivo históricó en dos archivos mas
pequenós:
piarchss -if D:\pi\dat\bigfile.dat -of D:\pi\dat\january.dat -filter "1-jan"
"31-jan-02 23:59:59" -ost "1-jan" -oet "31-jan-02 23:59:59"
piarchss -if D:\pi\dat\bigfile.dat -of D:\pi\dat\february.dat -filter "1-feb" "28-
feb-02 23:59:59" -ost "1-feb" -oet "28-feb-02 23:59:59"
En este ejemplo, january.dat y february.dat no existen antes de la óperación. La

herramienta de archivo desconectado los crea como archivos históricós dinamicós de forma
predeterminada. Despues de que la herramienta Offline Archive utility crea los archivos, puede
registrarlos con piartool -ar y, luego, agregar eventos a los ficherós de archivado de la
manera habitual. Debido a que estos archivos históricós de salida son archivos dinamicós, no
pueden intercambiarse.
La hora de inicio del filtró de january.dat se especifica como 1-jan. El valor predeterminado
es 1-jan, del anó actual, a la hora 00:00:00. La hora de finalización del filtró se incluye entre
comillas dobles debido al caracter de espacio incorporado. Las horas de inicio y finalización del
archivo históricó de salida se especifican de manera explícita. La exclusión de los flags -ost y -
oet genera el comportamiento predeterminado. Para obtener mas detalles, consulte
Especificar una hora de inicio para el archivo de salida y Especificar la hora de finalización para
el archivo de salida.
Si el archivo de entrada se registró antes de la óperación, se anulara su registro durante la
óperación. Cuando finalice la óperación, pódra usar piartool -ar para registrar el archivo
nuevamente.
Para obtener mas infórmación sobre cómó usar la utilidad piarchss, consulte Opciones de
línea de comandos de la utilidad de archivo desconectado y Ejecutar la herramienta de archivo
desconectado.
Para obtener mas infórmación sobre cómó usar la utilidad piartool, consulte "opciones de
línea de comandos de piartool" in Live Library (https://livelibrary.osisoft.com).

Tambien puede resultar util el siguiente artículó de la base de conocimientos KB00590: Cómó
evitar eventos duplicados en el límite del archivo históricó cuando se divide PI archive (https://
techsupport.osisoft.com/Troubleshooting/KB/KB00590).

Seguridad de PI Data Archive
En esta sección, se explican las tareas basicas de administración de una cónfiguración de
seguridad de PI Data Archive. No explica cómó planificar e implementar una nueva
cónfiguración de seguridad. Para cónfigurar la seguridad en un servidor PI Data Archive nuevo
o para actualizar un PI Data Archive mas antiguo mediante la adópción de la versión 3.4.380 o
de una posterior, consulte PI Data Archive Security Configuration Guide.
En esta sección
• Descripción general de la seguridad
• Administración de la autenticación
• Administración de la autórización
• Aumento de la seguridad
Descripción general de la seguridad

La cónfiguración de seguridad de Servidor PI posee estos componentes principales:
• Administración de la autenticación: ¿que usuarios y aplicaciones pueden conectarse a

Servidor PI?
• Administración de la autórización: ¿que permisos de acceso tienen los usuarios o las
aplicaciones autenticadas en Servidor PI?
Como administrador del sistema, considere seguir pasos adicionales para mejorar la seguridad
de Servidor PI. Los pasos basicós se explican en Aumento de la seguridad.
Administración de la autenticación
Los siguientes metódós de autenticación se detallan en el orden de mas a menos seguro (no
recomendado).
Con anterioridad a PI Data Archive 2016 R2, los trusts se utilizaban habitualmente para
autenticar las PI interfaces, mientras que las asignaciones se usaban para el inicio de sesión
unicó de los usuarios de Windows en los servidores de PI Data Archive. Con PI API 2016 for
Windows Integrated Security, la autenticación de Windows se amplía a las PI interfaces.
OSIsoft no recomienda utilizar PI trusts ni nombres de usuario explícitós para realizar la
autenticación. Para contar con un entorno mas seguro, OSIsoft recomienda Windows Integrated
Security.
Nota:
PI API 2016 for Windows Integrated Security amplía la autenticación de Windows a las
aplicaciones cliente basadas en API. Si elige instalar PI API 2016 for Windows Integrated
Security, solo puede utilizar Windows Integrated Security para la autenticación. Tanto los
trusts como los nombres de usuario explícitós fallaran. Para obtener mas infórmación,
consulte "Cónfiguración de seguridad" in Live Library (https://livelibrary.osisoft.com).
• Cuentas de usuario y contraseñas de Windows

Con este metódó de autenticación, el usuario inicia sesión con su cuenta de usuario de
Windows y se autentica autómaticamente en PI Data Archive. No es necesario introducir un
nombre de cuenta y una cóntrasena aparte para PI Data Archive. Este es el metódó de
autenticación mas seguro disponible en Servidor PI.

• PI Trusts
Los PI trusts permiten que las aplicaciones accedan a Servidor PI sin tener que introducir un
nombre de usuario y una cóntrasena. No utilice PI trusts para aplicaciones compatibles con
la autenticación de Windows.
• Cuentas de usuario y contraseñas de Servidor PI

Con este metódó de autenticación, los usuarios pueden iniciar sesión en PI Data Archive al
escribir un nombre y una cóntrasena de cuenta de usuario de PI. Esto se denomina inicio de
sesión explícito. El inicio de sesión explícitó es el modo menos seguro de autenticarse en PI
Data Archive. Cónfigure PI Data Archive para que utilice la autenticación de Windows y, a
cóntinuación, desactive el inicio de sesión explícitó.
En esta sección
• Administración de la autenticación con la seguridad de Windows
• Administración de la autenticación de interfaces con PI trusts
• Administrar cuentas de usuario y grupos de PI Data Archive
Administración de la autenticación con la seguridad de Windows

Para cónfigurar PI Data Archive de modo que emplee la autenticación de Windows, utilice PI
identities y PI mappings. Cree una PI mapping entre la PI identity y un grupo de Windows
(pódría ser un grupo de Active Directory o un grupo de seguridad de Windows local). Mediante
la asignación, los usuarios autenticados en Windows quedan autómaticamente autenticados en
PI Data Archive.
Nota:
Las PI identities son ideales para las asignaciones porque no implican la administración
directa de usuarios en PI Data Archive. No obstante, tambien puede utilizar grupos y
usuarios PI para crear asignaciones.
Las tareas basicas de administración de la autenticación de Windows son:
• Administración de asignaciones
• Administración de PI identities
• En sistemas actualizados, es posible que tenga usuarios y grupos heredados que necesite
utilizar en las asignaciones (Administrar cuentas de usuario y grupos de PI Data Archive)
Para obtener instrucciones basicas sobre cómó planificar e implementar este tipo de
cónfiguración, consulte PI Data Archive Security Configuration Guide.
En esta sección
• Administración de asignaciones
• Administración de PI identities
Administración de asignaciones
Una asignación crea una asóciación entre una entidad en Windows (como un grupo de AD) y
una entidad en PI Data Archive (como una PI identity).
Puede crear, eliminar y editar asignaciones mediante la herramienta PI SMT Mappings &
Trusts.
En esta sección
• Lado Windows de la asignación

• Lado PI Data Archive de la asignación

• Herramienta Mappings & Trusts
• Crear una asignación en PI SMT
Lado Windows de la asignación

Puede asignar una PI identity a un usuario o grupo de Active Directory o a un usuario o grupo
local.
Las PI mappings pueden utilizar los siguientes recursos de Windows:
• Cualquier Active Directory (AD) Principal (usuario o grupo)
• Cualquier usuario o grupo de Windows local
Si utiliza la seguridad de Windows local, las cuentas de usuario de Windows en PI Data Archive
deben coincidir exactamente con las cuentas de usuario de Windows en todas las estaciones de
trabajo cliente. Tanto los nombres de cuenta como las cóntrasenas deben ser identicós en el
servidor y en todas las maquinas cliente. Cuando una cóntrasena cambie para una cuenta de
usuario de Windows, debera realizar el cambio en PI Data Archive y en todas las maquinas
cliente participantes.
La autenticación local de Windows no es tan segura como la autenticación AD. Si es posible,
utilice Active Directory (AD) en vez de la seguridad local de Windows. La autenticación local de
Windows sigue siendo mucho mas segura que las cuentas de usuario de PI individuales.
Lado PI Data Archive de la asignación

En el lado PI Data Archive de la asignación, puede utilizar una identidad de PI, un usuario de PI
o un grupo de PI. Por coherencia, es mejor utilizar una identidad de PI. Los usuarios de PI y los
grupos de PI implican la administración directa de los usuarios en PI Data Archive. Si ya no
administra usuarios en PI Data Archive, esto pódría causar cónfusión entre otros
administradores de PI Data Archive. Si utiliza identidades de PI solo para asignaciones o trusts
y usuarios/grupos de PI solo para la administración de cuentas de PI, otros administradores
pódran interpretar con facilidad su cónfiguración de seguridad.
Nota:
Si necesita usar una cuenta de usuario de PI en una asignación, desactive el inicio de
sesión explícitó para esa cuenta. Las cóntrasenas de usuario de PI no son seguras.
Para obtener mas infórmación sobre la cónfiguración de seguridad, consulte "Cónfiguración de
seguridad" in Live Library (https://livelibrary.osisoft.com).
Herramienta Mappings & Trusts

La herramienta Mappings & Trusts de PI SMT le permite cónfigurar asignaciones en sus PI Data
Archive.
Para utilizar la herramienta Mappings & Trusts, seleccione Security > Mappings & Trusts. La
herramienta dispone de dos pestanas: una para trusts y una para asignaciones. La pestana
Mappings enumera toda las asignaciones de PI de todos los servidores de PI Data Archive
seleccionados.

Crear una asignación en PI SMT
Procedimiento
1. En el panel Collectives and Servers, seleccione el servidor o colectivo.
2. En el panel System Management Tools, seleccione Security > Mappings and Trusts.
3. Seleccione la pestana Mappings.
4. En la barra de herramientas, haga clic en el bótón New para abrir el cuadro de dialógó
Add New Mapping.
5. En Windows Account, introduzca un AD principal o un grupo o usuario local de Windows.
Para seleccionar la cuenta, realice una de las siguientes operaciones:
◦ Haga clic en el bótón de explóración para buscar la cuenta.
◦ Escriba el nombre de la cuenta, luego haga clic en el bótón de resólución SID para
verificar que esta sea una cuenta valida. Si la cuenta es valida, en el campo aparecera un
Dispositivo de interfaz de sonido (SID). En caso contrario, se abrira un cuadro de dialógó
con un mensaje de error.
6. En Description, introduzca una descripción de la asignación. No hay restricciones en cuanto
al contenido de este campo optativo.
7. En Server, elija el servidor donde desea crear la asignación. Esta lista desplegable contiene
todos los servidores de PI Data Archive que estan seleccionados en Collectives and Servers y
que tienen la versión 3.4.380 o posterior. Las versiones anteriores de PI Data Archive no
permiten la creación de asignaciones.
8. En PI Identity, introduzca una identidad, grupo o usuario de PI.
Para elegir, haga clic en el bótón de explóración y abra el cuadro de dialógó Select PI Identity,
PI Group o PI User. Para filtrar las opciones, realice una selección en Type. En la lista,
seleccione una PI identity, un grupo de PI o un usuario de PI y haga clic en OK.
OSIsoft recomienda seleccionar una PI identity. Los usuarios y grupos de PI representan un
modelo de seguridad antiguo que requiere la administración de cuentas de usuario
individuales en PI Data Archive. Las cuentas de usuario y cóntrasenas de PI no son tan
seguras como las cuentas Windows.
9. Haga clic en OK para crear la asignación.
Administración de PI identities
Cada PI identity representa un nivel de acceso a los recursos en PI Server. Por ejemplo, una PI
identity pódría tener permiso para crear puntos y otra para leer datos de puntos, pero no para
crear puntos nuevos.
Cuando existe una asignación entre una PI identity y un grupo de Windows, todos los usuarios
del grupo Windows quedan autómaticamente autenticados en PI Server y reciben permisos de
acceso definidós por dicha PI identity.
Las PI identities se administran con la herramienta de PI SMT Identities, Users, and Groups .
Esta herramienta se encuentra en Security, en PI SMT. Por defecto, las identidades, los usuarios
y los grupos de todos los PI Data Archive aparecen en pestanas separadas. En la Ayuda en línea
de PI SMT hay instrucciones para el uso de la herramienta.
Nota:
Si no esta conectado a uno o mas servidores de PI Data Archive con versión 3.4.380 o
posterior, la pestana Identities no aparece.

Administración de la autenticación de interfaces con PI trusts

Con anterioridad a PI Data Archive 2016 R2, los trusts se utilizaban habitualmente para
autenticar las PI interfaces, mientras que las asignaciones se usaban para el inicio de sesión
unicó de los usuarios de Windows en los servidores de PI Data Archive. Con PI API 2016 for
Windows Integrated Security, la autenticación de Windows se amplía a las PI interfaces.
Security.
Nota:
Los PI trusts comparan las credenciales de cónexión de la aplicación que se conecta con los
registros de la base de datos de trust. Las credenciales de cónexión pueden incluir:
• Nombre de la aplicación que se conecta

• Dirección IP y mascara de red del nodo de interfaz
• Nombre de host completo del nodo de interfaz (por ejemplo, apollo.osisoft.com)
• Nombre de host corto del nodo de interfaz (por ejemplo, apollo)
Actualice PI trusts cuando el nodo de la interfaz cambie el nombre de host o la dirección IP.
Utilice la herramienta Mappings & Trusts de PI SMT para ver y gestionar sus PI trusts.
Cada PI trust se define en relación con una identidad de PI, un grupo de PI o un usuario de PI
unicós. Cuando una interfaz logra autenticarse a traves de un trust, obtiene el permiso de
acceso definidó por la identidad, el grupo o el usuario asociado.
Para obtener detalles sobre cómó obtener mayor seguridad, consulte Seguridad de PI Data
Archive.
Crear un trust
Procedimiento
1. En Servers (o si cuenta con una implementación colectiva, Collectives and Servers),
seleccione el servidor.
2. En System Management Tools, seleccione Security > Mappings & Trusts.
Aparecera la herramienta Mappings & Trusts.
3. Seleccione la pestana Trusts.
4. Haga clic en el bótón New para abrir el asistente para anadir trusts.
5. Seleccione el nombre del servidor PI Data Archive y escriba un nombre para el trust (y,
opcionalmente, una descripción). Haga clic en Next.
6. Seleccione el tipo de trust para anadir:
◦ Aplicación PI-API (es la elección adecuada para la mayóría de las PI interfaces)
◦ Aplicación de PI-SDK en un SO basado en Windows NT
7. Haga clic en Next.

Las siguientes pantallas le permiten definir infórmación opcional para el PI trust. Si deja
algun campo en blanco, no se cómpróbara esa infórmación para la autenticación del trust. Al
rellenar los campos, solo las aplicaciones con infórmación coincidente pódran autenticarse
con este PI trust.
◦ Nombre de aplicación
Esto es levemente diferente para las conexiones de PI API y PI SDK.
▪ API
Las aplicaciones PI API que se conectan envían un identificadór llamado nombre de
proceso de aplicación o procname. Se trata de una cadena de cuatro caracteres con
una E anexada (por ejemplo, el procname de la interfaz Perfmon es PIPeE).
▪ SDK
El nombre completo de la aplicación que se conecta, incluida la extensión, pero no la
ruta (por ejemplo, PI-ICU.exe).
◦ Dirección IP
La dirección IP del nodo de la interfaz.
◦ Net Mask
La mascara de red del nodo de interfaz (por ejemplo, 255.255.255.255).
Solo en el caso de las conexiones SDK, tambien se pueden usar los siguientes campos
opcionales:
◦ Dominio de Windows
El dominio Windows del usuario que ejecuta la aplicación (por ejemplo, osi).
◦ Cuenta de Windows
El nombre de usuario de Windows del usuario que ejecuta la aplicación (por ejemplo,
my_account).
8. Seleccione la identidad de PI que desea utilizar con este trust.
Las aplicaciones autenticadas mediante este trust dispóndran de todos los permisos de
acceso concedidos a esta identidad de PI. Para este paso, tambien es posible seleccionar un
grupo de PI o un usuario de PI.
En esta sección
• Tipos de cónexión
• Nombre de aplicación
• Infórmación IP
• Infórmación de cuenta de Windows
• Trusts predeterminados
Tipos de conexión
Al cónfigurar un PI trust, debe conocer el tipo de cónexión para el que se utilizara.
Existen dos tipos de cónexión diferentes en PI Data Archive. Cada PI interface esta cónfigurada
para utilizar uno de estos mecanismos (algunas interfaces, pocas, utilizan ambos). Los dos
mecanismos son:

• Conexión de PI API: la mayóría de las PI interfaces utilizan PI API para conectarse con PI
Data Archive. PI API no es compatible con la autenticación de Windows. Los PI trusts son el
modo estandar de autenticar conexiones PI API.
• Conexión de PI SDK: la mayóría de las aplicaciones cliente utilizan PI SDK para conectarse
con PI Data Archive. PI SDK 1.3.6 y posterior es compatible con la autenticación de
Windows, de modo que utilice la autenticación de Windows para estas conexiones, de ser
posible.
Si no esta seguro del tipo de cónexión de una interfaz, consulte la dócumentación de la misma.
Nombre de aplicación
Al especificar un nombre de aplicación en un trust, utilice el formato apropiado para el tipo de
cónexión:
• Las aplicaciones que se conectan mediante API envían un identificadór llamado nombre de
proceso de aplicación o procname. Se trata de una cadena de cuatro caracteres con una E al
final. Por ejemplo, el procname de la interfaz Perfmon es PIPeE.
Nota:
Las versiones de PI API anteriores a 1.6.0 siempre envían una cadena de cinco
caracteres: 4 caracteres mas una E mayuscula. En las versiones PI API 1.6.0 o posterior,
el nombre puede tener hasta ocho caracteres, sin la E mayuscula al final.
• Para las aplicaciones que se conectan a traves de SDK, utilice el nombre completo de la
aplicación, incluida la extensión, pero no la ruta. Por ejemplo, el nombre de aplicación de PI
ICU es PI-ICU.exe.
Si esta ejecutando la misma PI interface en otro PI Data Archive, puede utilizar PI SMT para
determinar el nombre correcto de la aplicación. Seleccione Operation > Network Manager
Statistics. Busque la interfaz en la lista. El nombre de la aplicación se muestra en el campo
Name.
Información IP
Un PI trust puede especificar infórmación IP acerca del ordenador que ejecuta la PI interface o
la aplicación cliente para la que se define el trust. Para obtener esta infórmación, ejecute
pidiag -host en el equipo donde se ejecuta la interfaz o la aplicación cliente. Esta acción
devuelve las credenciales de cónexión recuperadas del sistema operativo local.
Nota:
• Usar pidiag -host no garantiza que óbtendra la infórmación correcta. Los resultados
dependen de muchos factores, como el tipo de interfaz, la versión de SDK (si esta
basado en SDK) y si existen cortafuegos o dispositivos NAT entre el equipo de la
interfaz y el equipo con PI Data Archive. Si tiene problemas para cónfigurar el trust,
póngase en contacto con el soporte tecnicó OSIsoft.
• Cuando las aplicaciones se ejecutan en maquinas con varias tarjetas de red, no es
posible predecir las credenciales que la aplicación enviara a PI Data Archive para la
autórización del trust. Por este motivo, OSIsoft recomienda evitar tales cónfiguraciónes
o crear un PI trust por cada dirección IP en la maquina en que se ejecuta la aplicación.
Información de cuenta de Windows

Unicamente en las conexiones SDK, es posible especificar infórmación de una cuenta Windows
como parte del PI trust. Este tipo de trust no es necesario con el nuevo modelo de seguridad,

porque una PI mapping sirve al mismo própósitó que un trust basado en el nombre de usuario
del SO y la pertenencia a un dominio Windows.
• Dominio de Windows
El dominio Windows del usuario que ejecuta la aplicación.
• Cuenta de Windows
El nombre del usuario de Windows del usuario que ejecuta la aplicación.
Trusts predeterminados
PI Data Archive incluye trusts predeterminados que garantizan el acceso a todas las
aplicaciones que se ejecutan en la maquina local. Estos trusts predeterminados se vuelven a
crear autómaticamente cada vez que se inicia el sistema para garantizar que siempre esten
cónfiguradós en su estado predeterminado. Las distintas versiones de PI Data Archive tienen
diferentes trusts predeterminados. La siguiente lista incluye los trusts predeterminados para PI
Server 3.4.375 o posterior.
Nombre del trust Descripción Versión de PI Data Archive
!Proxy_127! Permite acceso a aplicaciones PI Todas las versiones
System locales.
!PIServerName_FQDN! Se emplea en la cómunicación No es necesario en versiones de

entre los servidores primario y PI Data Archive 3.4.380 o
secundario de un colectivo de PI posterior.
Data Archive.
Las versiones de PI Data Archive 3.4.380 o posterior no necesitan el trust FQDN y no se incluye
en las nuevas instalaciones. Sin embargo, el trust no se elimina en caso de que PI Data Archive
se actualice desde una versión anterior.
Administrar cuentas de usuario y grupos de PI Data Archive

PI Data Archive dispone de su propia seguridad mediante identificación de usuario y
cóntrasena, que puede administrarse mediante las cuentas de usuario de PI. Las cuentas de
usuario de PI no son seguras. Siempre que sea posible, utilice la autenticación de Windows.
Puede asignar usuarios a uno o mas grupos de PI. Cada usuario de PI y cada grupo al que
pertenecen tienen unos permisos de acceso definidós.
Los usuarios de PI y los grupos de PI son, en esencia, componentes heredados. Puede utilizar
usuarios de PI y grupos de PI en trusts y asignaciones. Sin embargo, esto puede crear cierta
cónfusión acerca del papel del usuario de PI o el grupo de PI en el servidor. ¿Utiliza estos
componentes para administrar cuentas reales de usuario de PI? ¿Los utiliza unicamente para
asignaciones y trusts? ¿O los emplea para ambas cosas? Si esta creando un nuevo componente
para usar en una asignación o un trust, utilice una identidad de PI para evitar la cónfusión.
Administre usuarios y grupos con la herramienta de PI SMT Security > Identities, Users, &
Groups. De manera predeterminada, las identidades, los usuarios y los grupos de todos los PI
Servers aparecen en pestanas separadas. En la Ayuda en línea de PI SMT hay instrucciones para
el uso de la herramienta.
Para obtener mas infórmación sobre la cónfiguración de seguridad, consulte "Cónfiguración de
seguridad" in Live Library (https://livelibrary.osisoft.com).

Administración de la autorización
La autórización consiste en la asignación y mantenimiento de los permisos de acceso definidós
para recursos de PI Data Archive.
Se puede controlar el acceso a una amplia variedad de recursos de PI Data Archive, como
puntos, módulós, cónfiguraciónes de archivo históricó, copias de seguridad, lotes, pistas de
auditóría, etcetera.
En esta sección
• Descripción de los permisos de acceso antiguos y nuevos
• Dónde establecer permisos de acceso
• Establecimiento de permisos de acceso
Descripción de los permisos de acceso antiguos y nuevos

PI Data Archive versión 3.4.380 presenta un cambio fundamental en el modelo de permisos de
acceso. Por lo tanto, la cónfiguración de los permisos de acceso depende de la versión de PI
Data Archive que se ejecute.
Los niveles de acceso posibles permanecen igual.
En esta sección
• Servidores 3.4.380 y posterior
• Servidores anteriores a la versión 3.4
• Niveles de acceso PI
Servidores 3.4.380 y posterior

En PI Data Archive 3.4.380 y posterior, los recursos pueden definir permisos de acceso para un
numeró ilimitado de PI identities, como muestra la siguiente ilustración.
Aunque la ilustración muestra las PI identities, tambien puede definir permisos de acceso para
usuarios y grupos de PI. No hay límite en cuanto al numeró de usuarios o grupos. Ya no existe el
concepto de propietario o grupo de un recurso, a diferencia de las versiones anteriores de PI
Data Archive.
PI Data Archive almacena los ajustes de cada objeto en una lista de control de acceso (ACL).
Cada objeto seguro en PI Data Archive dispone de una ACL que define los permisos de acceso
de ese objeto. La ACL indica cada identidad para la que el objeto dispone de permisos de
acceso. LA ACL para los datos TEST_POINT de la ilustración de arriba tendría este aspecto:
Identity1:A(r,w) | Identity2:A(r,w) | Identity3:A(r) | IdentityN:A(r,w)
Los permisos de acceso para cada PI identity se separan mediante una barra vertical (|). Cada
entrada consta del nombre de la PI identity, dos puntos (:) y el access specifier. El especificadór

de acceso se define con el siguiente formato: A(r,w). La A significa Allow (permitir) y r,w indica
los derechos de acceso permitidos (en este ejemplo, lectura y escritura).
Servidores anteriores a la versión 3.4

Las versiones de PI Data Archive mas antiguas utilizan, para los permisos de acceso, el modelo
propietario/grupal/universal.
Cada objeto puede tener un propietario, que debe ser un usuario de PI, y un grupo, que debe ser
un grupo de PI. Puede establecer el acceso para el propietario, para el grupo y para todos los
demas usuarios (lo que se denomina acceso universal).
Cada recurso tiene un grupo asociado (y solo uno). Cuando un usuario no es el propietario de
un determinado recurso de PI (como un punto o una base de datos), PI Data Archive
comprueba si el usuario es miembro del grupo asociado a dicho recurso. De ser así, el usuario
obtiene el nivel de acceso del que disfruta el grupo.
Como cada recurso solo dispone de un grupo asociado, a veces es necesario crear grupos
adicionales para dar acceso a todos los usuarios que lo necesitan. Por ejemplo, la siguiente
figura ilustra una órganización con tres grupos: desarrolladores, administradores y operadores.
Un usuario es miembro de los grupos Desarrolladores y Administradores.

Suponga que todos los usuarios de los grupos Desarrolladores y Administradores necesitan
acceso de lectura y escritura para un recurso concreto, como los atributos del punto Sinusoid.
Como un recurso solo puede tener un grupo asociado, pódría crear un grupo llamado DevMan
que contenga a todos los desarrolladores y administradores y despues asociar ese recurso al
nuevo grupo.
Normalmente, se crean distintos grupos de PI para los grupos de su órganización que necesiten
distintos puntos de acceso.
Niveles de acceso PI
Servidor PI proporciona los siguientes niveles estandares de permiso de acceso:
• Read-only access. Los usuarios pueden ver el elemento, pero no editarlo.

• Read-write access. Los usuarios pueden ver y editar el elemento.
• No access. Los usuarios no pueden ver ni editar el elemento.
Nota:
No access no es lo mismo que deny. No existe un nivel para deny, similar al de
Windows.
Dónde establecer permisos de acceso

Las entradas de la herramienta PI SMT Database Security controlan el acceso a los recursos de
PI Data Archive en el nivel mas alto.
En esta sección
• Permisos de acceso en Database Security
• Permisos de acceso a PI points

• Permisos de acceso a módulós de PI
Permisos de acceso en Database Security

La herramienta Database Security enumera los recursos para los que puede cónfigurar el
acceso y muestra los permisos de acceso actuales para cada entrada. Para cambiar estos
permisos de acceso, debe contar con acceso de lectura/escritura a la entrada PI Database
Security (PIDBSEC) y con acceso de escritura en la base de datos que esta editando. La entrada
PIDBSEC controla el acceso a todas las entradas de la tabla.
La tabla tambien incluye las entradas PIPOINT y PIModules que controlan el acceso a los PI
points y a los módulós de PI, respectivamente. Se puede restringir aun mas el acceso a los
puntos y módulós editando la seguridad directamente en el propio punto o móduló.
Por ejemplo, suponga que una identidad llamada PIEngineers tiene acceso de lectura/escritura
a un punto llamado TEST_POINT, pero solo dispone de acceso de lectura a PIPOINT en la
herramienta Database Security. Los usuarios con identidad PIEngineers pueden ver y editar
TEST_POINT, pero no pueden editar otros puntos del servidor.
Control de acceso para tareas básicas de administración de PI Data Archive

En la siguiente tabla se enumeran tareas basicas de administración de PI Data Archive y se
indican que tablas de la herramienta Database Security controlan el acceso a cada tarea.
Tarea de administración Tabla que controla la tarea
Administración de archivos históricós PIARCADMIN (tareas basicas de administración de
archivos históricós: creación de archivos históricós,
registros, cambios y reprocesamiento en línea) y
PIARCDATA (datos de archivos históricós no
dependientes de tags, como un listado de archivos
históricós; tareas de resólución de problemas de
archivos históricós)
Administración de copias de seguridad PIBACKUP
Administración de identidades, usuarios y grupos PIUSER
Administrar asignaciones PIMAPPING
Administración de trusts PITRUST
Administración de auditóría PIAUDIT
Creación/eliminación de puntos PIPOINT
Creación/eliminación de módulós PIModules
Edición de la tabla de seguridad de la base de datos PIDBSEC
Administración de la tabla del cortafuegos, PITUNING
parametrós de ajuste
Administración de registros de mensajes PIMSGSS
Administración de PI Data Archive colectivos PIReplication y PIBACKUP
Permisos de acceso a PI points

En el nivel superior, el acceso a los puntos lo controla la entrada PIPOINT de la herramienta
Database Security en PI SMT. Se pueden restringir mas los permisos de acceso para puntos
concretos, pero no se puede conceder mas acceso del permitido por PIPOINT.
La seguridad de los PI point consta de las seguridad de los datos y la de los puntos.

Tipo de seguridad Descripción

Seguridad de datos Especifica quien tiene acceso a los valores de datos de un punto (datos de
snapshot y de archivo históricó).
Seguridad de punto Especifica quien tiene acceso a la cónfiguración del punto (Zero, Span,
Descriptor y otros atributos de punto).
Se pueden tener diferentes permisos de acceso para los atributos y para los datos de un punto.
Por ejemplo, un usuario puede tener permiso para editar los datos de un punto, pero no para
editar los atributos de ese punto.
• Seguridad de datos
Para ver y editar datos de punto, tambien necesita acceso de lectura a la seguridad de punto.
Si un usuario no tiene permiso para ver los atributos de un punto, en la mayóría de los casos
no pódra ver los datos de dicho punto. (Esto se debe a que las aplicaciones cliente necesitan
acceso a los atributos de punto para obtener los datos.)
Para ver los atributos de punto, es necesario tener acceso de lectura a PIPOINT, así como
acceso de lectura a la seguridad de punto del propio punto. Del mismo modo, para editar los
atributos de un punto, necesita acceso de lectura/escritura a PIPOINT y acceso de lectura/
escritura a la cónfiguración del propio punto.
La siguiente tabla lista los permisos de acceso necesarios para tareas basicas.
Tarea Permisos de acceso necesarios
Ver datos de punto Acceso de lectura a PIPOINT, seguridad de datos para ese punto y
seguridad de punto para ese punto
Editar datos de punto Acceso de lectura/escritura a la seguridad de datos para ese punto;
acceso de lectura a la seguridad de punto para ese punto y PIPOINT
Ver atributos de punto Acceso de lectura a PIPOINT y a la seguridad de punto para ese
punto
Editar atributos de punto Acceso de lectura/escritura a PIPOINT, seguridad de datos para ese
punto y seguridad de punto para ese punto
Crear un punto Acceso de lectura/escritura a PIPOINT
Eliminar un punto Acceso de lectura/escritura a PIPOINT y a la seguridad de punto
para ese punto
Agregar un usuario a la Acceso de lectura/escritura a la seguridad de datos y a la seguridad
seguridad de datos de punto
Editar la cónfiguración de Acceso de lectura/escritura a la seguridad de datos y a la seguridad
seguridad de datos de un usuario de punto
Acceso predeterminado para puntos y módulos nuevos

Es posible establecer permisos de acceso predeterminados para puntos y módulós. Cuando se
crea un punto o móduló sin establecer explícitamente permisos de acceso, el punto o móduló
adquiere los permisos de acceso predeterminados.
• Los permisos de acceso predeterminados de todos los nuevos puntos (tanto los datos de
punto como la cónfiguración de punto) coinciden con los de la base de datos de puntos
(PIPOINT). Puede establecer permisos para PIPOINT con el complemento Database Security
para PI SMT.
• Del mismo modo, los permisos de acceso predeterminados para los módulós raíz coinciden
con los de la base de datos de módulós (PIModules). Es posible establecer permisos para

PIModules en la herramienta Database Security. Los nuevos módulós en el nivel raíz

heredan del móduló primario.
Permisos de acceso a módulos de PI

En el nivel superior, el acceso a los módulós lo controla la entrada PIModules de la herramienta
Database Security en PI SMT.
Se pueden restringir mas los permisos de acceso para módulós concretos, pero no se puede
conceder más acceso del permitido por la tabla PIModules. Ademas, los módulós tienen una
estructura jerarquica y cada móduló hereda los permisos de sus módulós primarios. No es
posible conceder a un móduló mas acceso del que se ha concedido a su móduló primario. La
siguiente tabla explica los permisos necesarios para tareas basicas.
Tarea Acceso requerido
Crear un móduló Acceso de escritura a PIModules, acceso de
escritura al móduló primario
Eliminar un móduló Acceso de escritura a PIModules, acceso de
escritura al móduló primario, acceso de escritura al
móduló
Renombrar un móduló Acceso de lectura a PIModules, acceso de escritura
al móduló
Editar un móduló (excepto la óperación de enlace) Acceso de lectura a PIModules, acceso de escritura
al móduló
Editar un móduló (óperación de enlace) Acceso de lectura a PIModules, acceso de escritura
al móduló primario, acceso de escritura al móduló
Establecimiento de permisos de acceso

Una variedad de herramientas cliente denominadas aplicaciones administrativas permiten
establecer los permisos de acceso. Las aplicaciones administrativas mas cómunmente
utilizadas son:
• Para el acceso de alto nivel, la herramienta PI SMT Database Security.

• Para los puntos, Point Builder de PI SMT o PI Builder.
• Para los módulós, Module Database Builder.
El cambio en el modelo de permisos de acceso a partir de la versión 3.4.380 de PI Data Archive
significa que los permisos se establecen de forma diferente en las versiones nuevas y en las
versiones antiguas de PI Data Archive. Para cónfigurar permisos para la versión 3.4.380 y
posterior, utilice las herramientas que sean compatibles con el nuevo modelo de permisos de
acceso (consulte ¿Que herramientas administrativas son compatibles con PI Data Archive?).
Si utiliza una versión mas antigua de cualquier herramienta para cónfigurar permisos sobre la
ultima versión de PI Data Archive, puede encontrar problemas de incompatibilidad.
En esta sección
• Establecimiento de permisos en SMT
• Aplicaciones cliente administrativas
• ¿Que herramientas administrativas son compatibles con PI Data Archive?

Establecimiento de permisos en SMT

Para editar los permisos de acceso de un PI point, seleccione el punto en PI SMT Point Builder y
haga clic en la pestana Security. Para editar los permisos de acceso de un elemento con la
herramienta Database Security, haga doble clic en el elemento para abrir el cuadro de dialógó
Properties. En ambos casos, vera una interfaz sencilla que permite cónfigurar la seguridad. La
interfaz depende de la versión de PI Server que este usando.
• En el caso de la versión PI Server 3.4.375.99 y anteriores, la interfaz muestra los permisos

de acceso de la siguiente forma:
Seleccione un propietario y un grupo y, a cóntinuación, especifique el propietario, el grupo y

el acceso universal. Consulte Servidores anteriores a la versión 3.4 para obtener mas
infórmación sobre este modelo de permiso de acceso.
• Para PI Data Archive 3.4.380 y posterior, la interfaz muestra los permisos de acceso de la
siguiente forma:
Seleccione una PI identity, usuario o grupo y, a cóntinuación, especifique los permisos de

acceso de lectura/escritura. Consulte Servidores 3.4.380 y posterior para obtener mas
infórmación sobre este modelo de permiso de acceso.
Aplicaciones cliente administrativas

Las aplicaciones administrativas son aplicaciones que permiten cónfigurar permisos de acceso.
Algunos ejemplos son PI SMT, Point Builder y Module Database Builder. Al actualizarse a

Servidor PI 3.4.380, sus permisos de acceso existentes se cónvertiran al nuevo modelo. Las
nuevas versiones de la mayóría de las herramientas administrativas pueden mostrar permisos
de acceso para el modelo anterior o el nuevo, segun la versión del PI Data Archive conectado.
Las versiones anteriores de las aplicaciones administrativas no pueden interpretar los
permisos de acceso del nuevo modelo salvo que dichos permisos sean compatibles con el
modelo antiguo. La visualización de los permisos de acceso incompatibles depende de cada
herramienta cliente. Normalmente, la herramienta móstrara:
owner: PIUserIncompatible
group: PIGroupIncompatible
PIUserIncompatible y PIGroupIncompatible son PI identities integradas en la instalación de

Servidor PI 3.4.380.
¿Qué herramientas administrativas son compatibles con PI Data

Archive?
Para trabajar con permisos de acceso para Servidor PI 3.4.380 o posterior, ejecute SDK 1.3.6 o
posterior y utilice las siguientes herramientas administrativas:
• PI SMT versión 3.3.1.3 o posterior (incluye Point Builder, la herramienta Module Database y
la herramienta Database Security)
• PI Builder
• Module Database Builder versión 1.2.1.3 o posterior
• PI ICU 1.4.7 o posterior
• PI APS 1.2.5.0 o posterior
Aumento de la seguridad
En esta sección se describen algunos pasos sencillos que puede realizar para aumentar la
seguridad en PI Data Archive. No se trata en modo alguno de una lista exhaustiva.
En esta sección
• Prótección de la cuenta piadmin
• Cóntrasenas obligatorias en todas las cuentas de usuario
• Descativar todos los inicios de sesión explícitós en PI Data Archive
• Desactivar inicios de sesión explícitós para cuentas de usuario individuales
Protección de la cuenta piadmin

Cada servidor PI Data Archive dispone de una cuenta de administrador llamada piadmin. Esta
cuenta tiene permisos para realizar cualquier acción en el PI System, independientemente de la
cónfiguración de seguridad. Para contar con un entorno seguro, no utilice la cuenta piadmin.
Si debe utilizar la cuenta piadmin, OSIsoft recomienda deshabilitar el inicio de sesión explícitó
para esta cuenta (Desactivar inicios de sesión explícitós para cuentas de usuario individuales).
Si no esta preparado para desactivar los inicios de sesión explícitós para piadmin, cree al
menos una cóntrasena para la cuenta.

Contraseñas obligatorias en todas las cuentas de usuario

Las cóntrasenas del usuario de PI Data Archive proporcionan un nivel mínimó de seguridad a PI
Data Archive. Si va a utilizar cuentas de usuario de PI individuales para administrar PI Data
Archive, exija al menos que las cuentas de usuario esten protegidas mediante cóntrasena (las
cuentas de usuario de PI que no tengan cóntrasenas no se pódran autenticar en PI Data
Archive).
Procedimiento
1. En PI SMT, seleccione un servidor en Collectives and Servers. Solo se puede cambiar la
cónfiguración de un PI Data Archive a la vez.
2. Abra la herramienta Security Settings (Security > Security Settings.) La herramienta
Security Settings aparece (solo para la versión 3.4.380 o posterior de PI Data Archive).
3. Elija la ópción Blank password not allowed.
4. Detenga y reinicie PI Base Subsystem para aplicar los cambios.
Descativar todos los inicios de sesión explícitos en PI Data Archive

Es una buena practica de seguridad desactivar los inicios de sesión explícitós en PI Data
Archive. En las nuevas instalaciones de PI Data Archive, los inicios de sesión explícitós estan
desactivados por defecto. Al actualizar PI Data Archive, se le indicara que desactive los inicios
de sesión explícitós, pero es opcional. Tras cónfigurar las asignaciones para reemplazar los
inicios de sesión de usuario de PI, planteese desactivar los inicios de sesión explícitós. Antes de
hacerlo, asegurese de que ya no sean necesarios.
Procedimiento
1. En PI SMT, seleccione un servidor en Collectives and Servers. Solo se puede cambiar la
cónfiguración de un PI Data Archive a la vez.
2. Abra la herramienta Security Settings (Security > Security Settings.) La herramienta
Security Settings aparece (solo para los servidores de PI Data Archive que ejecutan la
versión 3.4.380 o posterior).
3. Elija la ópción Explicit login not allowed .
4. Para aplicar los cambios, detenga y reinicie PI Base Subsystem.
Desactivar inicios de sesión explícitos para cuentas de usuario individuales

Procedimiento
1. En PI SMT, abra la herramienta Identities, Users, & Groups (En System Management Tools,
seleccione Security > Identities, Users, & Groups).
2. Haga clic en la pestana PI Users.
3. Haga doble clic en el nombre de usuario del usuario de PI.
Se abrira el cuadro de dialógó Properties para ese usuario de PI.
4. En la pestana General , marque la ópción User cannot be used for an explicit login.
Para reactivar los inicios de sesión explícitós de una cuenta de usuario de PI, desmarque de
la ópción.


Datos futuros
Definición
Los datos futuros son datos asociados con una marca de tiempo futura. PI Data Archive 2015
permite el almacenamiento y la recuperación de datos con marcas de tiempo posteriores a la
hora actual, lo que le permite almacenar datos en un intervalo de tiempo desde enero de 1970 a
enero de 2038. Con PI Data Archive 2015, puede capturar y analizar datos con marcas de
tiempo futuras, y utilizar las herramientas de PI Visualization para crear graficamente posibles
predicciones o prónósticós para su empresa. Puede almacenar y utilizar estos datos
pronosticados para predecir requisitos de recursos o actividades de mantenimiento, encontrar
diferencias entre rendimientos de próducción pronosticados y reales, etcetera.
Diferencia entre datos históricos y datos futuros

Antes de la versión 2015, PI Data Archive solo admitía datos en tiempo real, no datos futuros.
Estos datos generalmente son datos de series temporales obtenidos en tiempo real y agregados
al final de flujós de datos en una frecuencia regular o intervalo de muestra. Los datos se
almacenan efectivamente en ficherós de archivado segmentados por tiempo. Con PI Data
Archive 2015, este tipo de datos de series temporales se diferencia de datos futuros en la
manera en que se define el PI point, así como la manera en que los datos de PI point se
almacenan y en que se accede a ellos.
Normalmente, los datos futuros se generan en un intervalo de tiempo específicó, por ejemplo,
un día o una semana antes de la hora actual, y se actualizan periódicamente apenas haya un
nuevo conjunto de predicciones disponible. Normalmente, el intervalo de actualización es mas
corto que el intervalo de prónósticó, para que los datos del prónósticó anterior se puedan
truncar antes de que se anadan o sobrescriban nuevos valores. Las interfaces pueden
cónfigurar un modo apropiado (con el cual los datos se envían a PI Data Archive) para adjuntar
prónósticós nuevos o sobrescribir un prónósticó existente con un prónósticó nuevo. La mayóría
de las interfaces pueden enviar los datos en un modo para reemplazar los valores
pronosticados existentes. Esto permite al archivo históricó de datos almacenar el valor mas
nuevo de cada actualización de un prónósticó y, por lo tanto, mantener un registro util de los
valores pronosticados mas precisos. Estos prónósticós de datos se pueden comparar con
medidas reales de manera visual (por ejemplo, mediante tendencias graficas de PI) o analítica
(por ejemplo, mediante hojas de calculó de PI DataLink). Conservar el historial de sus
prónósticós tambien puede ser util para las optimizaciones del modelo y los analisis
“hipóteticós”.
Formato de marca de tiempo futura

PI Data Archive almacena marcas de tiempo en formato de hora universal coordinada (UTC) a
fin de cumplir con una sola hora de referencia. Todas las marcas de tiempo futuras reflejan la
cónfiguración de DST segun se define en la zona horaria local para el equipo cliente. Para cada
zona horaria, la cónfiguración de DST actual se considera valida hasta que las autoridades
locales la cambian. Los datos medidos que se originan en otra zona horaria no se consideran
datos futuros.
Puede completar PI points futuros con datos que tengan marcas de tiempo anteriores a la hora
actual: PI Data Archive le permite escribir valores de PI point futuros en cualquier lugar en el
intervalo de tiempo UTC (1970-2038).
En esta sección
• Productos que admiten datos futuros
• PI points futuros

Datos futuros
• Archivos futuros
• Analisis con datos futuros
• Casos de uso y ejemplos
• Ejemplo del tiempo: procedimiento de alto nivel
Productos que admiten datos futuros

Productos de OSIsoft que admiten datos futuros
Producto Versión más antigua que admite datos del futuro
PI Data Archive 3.4.395
PI AF 2.7
Cliente de PI AF 2015
PI Coresight 2015
PI Vision 2017
PI DataLink 2015
PI ProcessBook. 2015
Ademas, PI SMT 2015 y PI Collective Manager 2015 se han mejorado para admitir datos
futuros. PI Audit Viewer tambien admite las mismas capacidades de auditóría para PI points
futuros que para PI points históricós.
Productos de OSIsoft que no admiten datos futuros
Producto Detalles
PI SDK, PI ACE En su formato de lanzamiento, PI SDK puede utilizarse para leer y escribir
valores en el futuro, pero existen limitaciones con PI points futuros, como la
falta de soporte para Event Pipe. Estas limitaciones restringen el soporte
inmediato de datos futuros en aplicaciones basadas en PI SDK, como PI ACE.
Por ejemplo, no puede utilizar PI points futuros para activar de la manera
habitual calculós de PI ACE en forma directa, y la cache de PI ACE puede no
permanecer sincronizada y no se puede garantizar que sea precisa para los PI
points futuros. PI ACE sí ofrece activadores de calculó basados en reloj y la
cache de PI ACE puede desactivarse a nivel global, pero estas limitaciones
pueden ser demasiado graves.
PI Performance Los PI points futuros no pueden utilizarse como tags de salida, entrada o
Equation Scheduler activación para PIPESCHD.
(PIPESCHD)
PI EFGen PI EFGen no puede utilizarse para activar event frames de PI points futuros.
PI points futuros
PI Data Archive 2015 proporciona un nuevo atributo de punto llamado "futuro" que puede
activar para un nuevo PI point disenadó para almacenar datos futuros. El atributo “futuro” es
una parte de todas las clases de puntos, como “base” y “clasicó”. Los PI points que no tienen este
atributo activado, denominados PI points “históricós”, rechazaran datos con marcas de tiempo
superiores a 10 minutos posteriores a la hora actual. El atributo futuro de un PI point no puede
módificarse despues de la creación del PI point; por lo tanto, los PI históricós existentes no
pueden convertirse a PI points futuros. Ademas, el atributo futuro de un PI point esta
deshabilitado (cónfiguradó en “0”) por defecto debido a que se anticipa que la mayóría de los PI
points nuevos se crean para almacenar datos históricós continuos o en tiempo real.

Datos futuros
Elegir entre PI points históricós o futuros es una decisión clave que depende de si los datos que
se deben almacenar son datos en tiempo real, es decir, de sensores que recopilan medidas
continuas o si son datos que pueden estar alejados de la hora actual o se revisan
frecuentemente (por ejemplo, prónósticós o predicciones). Es probable que dicha distinción
clave de los valores almacenados no cambie en la vida util de un PI point.
PRECAUCIÓN:
Aunque los PI points de datos futuros pueden almacenar datos con marcas de tiempo
pasadas y futuras, OSIsoft no recomienda mezclar los datos pronosticados y los medidos
en el mismo PI point. Utilice PI points de datos futuros para datos pronosticados, y PI
points históricós para datos reales o medidos.
Creación de PI points futuros

Para crear un PI point futuro, puede usar una de estas herramientas:
• System Management Tools (SMT). Para crear un PI point futuro, cónfigure la ópción Stored
Values (que se encuentra en el complemento Point Builder, en la pestana General) en
“Future Data”. Para obtener mas infórmación, consulte el tema de Servidor PI, "Atributos
generales" in Live Library (https://livelibrary.osisoft.com).
• PI Builder. Este complemento de Microsoft Excel le permite cónfigurar el atributo futuro de
un PI point en “1”. Consulte la sección de Servidor PI, "PI Builder" in Live Library (https://
livelibrary.osisoft.com).
• PI System Explorer. Consulte la sección Servidor PI, "PI System Explorer" in Live Library
Nota:
Por defecto, los PI points futuros tienen su atributo step activado (cónfiguradó en 1).
Esto se debe a que la mayóría de los PI Points futuros almacenan senales discontinuas
(por ejemplo, una serie de predicciones discretas) para las cuales no se puede asumir la
interpólación lineal. Al tener el atributo step encendido, las tendencias demuestran un
patrón escalonado. Por defecto, los PI points futuros tambien tienen compression,
excmin, excmax y excdev desactivados (cónfiguradó en 0).
Escritura de datos en PI points futuros

Una vez que haya creado PI points futuros, puede escribir en ellos de la misma manera en que
escribe en los PI points históricós. Puede utilizar cualquiera de estos metódós:
• PI SMT Archive Editor.
PRECAUCIÓN:
No puede utilizar PI SMT Archive Editor para propagar valores de PI points futuros a
todos los miembros de un colectivo de PI Data Archive. PI SMT no esta disenadó para
utilizarse como un generador de datos continuo para cualquier tipo de datos. Para
enviar datos a todos los miembros del colectivo, use una aplicación basada en PI
Interface, PI Connector o PI AF SDK que pueda aprovechar PI Buffering. PI SMT
Archive Editor solo debe utilizarse para un numeró pequenó de ediciones que son
específicas de un miembro del colectivo.
• Interfaces estandares de OSIsoft, como las interfaces PI UFL o PI RDBMS.
• Sus propias aplicaciones que utilizan AF SDK, PI Web API o PI OLEDB Enterprise.
Visualización de datos de PI points futuros

Puede utilizar una variedad de clientes de visualización y herramientas de soporte para leer
datos de PI points futuros, incluidos los siguientes:

Datos futuros
• PI Vision o PI Coresight 2015 a 2016 R2. Para obtener mas detalles, consulte la
"dócumentación de PI Vision" in Live Library (https://livelibrary.osisoft.com) o la
"dócumentación de PI Coresight" in Live Library (https://livelibrary.osisoft.com).
• PI DataLink 2015 o posterior. Para obtener mas detalles, consulte la "dócumentación de PI
Datalink" in Live Library (https://livelibrary.osisoft.com).
• PI ProcessBook 2015 o posterior. Para obtener mas detalles, consulte la dócumentación de
"PI ProcessBook" in Live Library (https://livelibrary.osisoft.com).
• PI SMT 2015 o posterior. Debe especificar el PI point y un intervalo de tiempo adecuado si
utiliza Archive Editor. Si utiliza valores actuales, probablemente deba actualizar
manualmente los valores actuales para ver valores actualizados de los PI points futuros.
Restricciones con PI points futuros

Los PI points futuros poseen las siguientes restricciones de uso y clase de PI point:
• Los PI points de futuro no son miembros compatibles de estas clases de puntos: Alarma,
SQC_Alarma, Totalizador o Conector COM.
• Los PI points de futuro no se admiten como PI points de salida, entrada o activación en
PI Performance Equation Scheduler (PIPESCHD).
• Los PI points futuros no se admiten en PI Batch Database (BDB) ni en PI Batch Subsystem
(BSS).
Los PI points de futuro son diferentes de los PI points de históricó, y se recomienda que los
clientes de visualización de PI se actualicen a la versión mas reciente.
Nota:
Si el valor de fin de secuencia de un PI point de datos futuros se encuentra en el pasado,
una herramienta cliente, como PI Coresight, no móstrara el valor de PI point extrapolado
al momento actual, sino que indicara que no hay datos.
La nóción del "valor actual" de un PI point futuro depende del uso y de los requisitos
particulares de la aplicación cliente. Para los PI points históricós, el valor actual de un PI point
es el ultimó valor crónólógicó o el valor del fin de secuencia. Para los PI futuros, las aplicaciones
normalmente consideran que el valor actual es el que esta mas cerca de la hora actual. Dado
que el valor de fin de secuencia de un PI point de datos futuros pódría resultar confuso para los
usuarios, PI Server 2015 y las versiones posteriores siempre arrojan el mensaje Future Data
Unsupported como valor de fin de secuencia de un PI point de datos futuros.
Archivos futuros
Creación de archivos futuros
Para administrar datos futuros que no son continuos o secuenciales como los datos históricós
de PI point en tiempo real, PI Data Archive utiliza archivos separados llamados “archivos
futuros” que se crean de manera autómatica. Los archivos futuros tienen intervalos de tiempo
predeterminados y se crean solo cuando se reciben datos. Cada archivo futuro tiene un tamanó
inicial de 1 MB, crece de manera dinamica y tiene un intervalo de tiempo que esta siempre
ligado a un mes de calendario. Por ejemplo, si un nuevo valor de PI llega un 7 de enero a las
08:00 a. m. y no existe un archivo históricó para el mes de enero, PI Data Archive crea uno
autómaticamente. Los archivos futuros se optimizan para datos no secuenciales, a diferencia de
los datos en tiempo real almacenados en archivos “históricós”. Los archivos históricós y futuros
se pueden manejar independientemente, en función de sus necesidades específicas de
retención de datos, disponibilidad, rendimiento y cónfiabilidad.

Datos futuros
Los datos en los archivos futuros nunca se mezclan o se intercambian con los datos en los
archivos históricós. Cuando el tiempo transcurre y los datos pronosticados se mueven al
pasado, permanecen almacenados en los mismos archivos futuros; PI Data Archive no descarta
ni mueve los datos.
En situaciones excepcionales, es posible que desee crear y registrar manualmente archivos
futuros debido a que el tamanó inicial o la duración no son deseables. El algoritmo autómaticó
cómpletara todos los “vacíós” antes y despues de todos los archivos futuros existentes y vólvera
a alinear nuevos archivos históricós con la duración del mes de calendario. Por ejemplo, si crea
manualmente un archivo futuro desde las 11:00 a. m. del 7 de enero hasta las 09:00 a. m. del 14
de enero, PI Data Archive crea autómaticamente un ficheró de archivado desde las 12:00 a. m.
del 1 de enero hasta las 11:00 a. m. del 7 de enero y un segundo ficheró de archivado desde las
09:00 a. m. del 14 de enero hasta las 12:00 a. m. del 1 de febrero. PI Data Archive solo crea estos
archivos históricós adyacentes si los datos se reciben efectivamente para ambos intervalos de
tiempo.
Administración de archivos históricos

Puede administrar archivos históricós y futuros al usar el móduló o las utilidades de la línea de
comandos de PI SMT Archives.
• Módulo PI SMT Archives

El móduló PI SMT Archives organiza los archivos históricós por servidor y tipo de archivo
históricó, ya sea históricó o futuro.
Como administrador de PI system, debe elegir la ubicación de los archivos futuros y
garantizar que el servidor PI Data Archive tenga espacio en disco suficiente. Esta ópción
tambien esta disponible durante el proceso de instalación de PI Data Archive. Los archivos
futuros se crean en la ubicación predeterminada PI\arc\future y tienen el nombre de
archivo predeterminado “server-name_datetime-stamp”. Opcionalmente, tambien puede
personalizar los nombres de los ficherós de archivado.
Para cambiar la ubicación de sus archivos históricós creados autómaticamente, en PI SMT,
vaya a Operation > Archives, haga clic para expandir la sección Review and update
parameters e ingrese la nueva ubicación en Auto create path. Los cambios en la ubicación
del archivo históricó entraran en vigor la próxima vez que se cree un archivo históricó. Los
archivos históricós existentes no se móveran.
• Utilidades de línea de comandos

La mayóría de las herramientas de línea de comandos adoptan un parametró adicional: -
hist o -future. Este parametró restringe un comando para llevar a cabo su acción en el
archivo o PI point especificadó. Por ejemplo, tenga en cuenta el comando piartool para
enumerar los archivos históricós:
Utilice piartool -al para enumerar todos los archivos históricós.
Utilice piartool -al -hist para enumerar solo los archivos históricós relevantes para
los tags históricós.
Utilice piartool -al -future para enumerar solo los archivos históricós relevantes para
los tags futuros.
Análisis con datos futuros

Utilice la función de analisis de activos de PI AF para aprovechar completamente los datos
futuros al activar calculós de PI points futuros y realizar analisis mediante el uso de PI points
históricós y futuros. Puede utilizar los datos futuros en analisis de dos maneras:

Datos futuros
• Datos futuros como entradas de un analisis. Los valores de los eventos futuros se utilizan en
los calculós al igual que cualquier otro valor. Sin embargo, las entradas con datos futuros
pueden afectar las evaluaciones de un analisis con prógramación controlada por eventos.
Por ejemplo, puede comparar un valor medido real (como la temperatura) almacenado en
un PI point históricó con su valor pronosticado, almacenado en un PI point futuro.
• Utilice un analisis para producir datos futuros al especificar una marca de tiempo futura
para el resultado de un analisis.
Por ejemplo, almacena el resultado de los calculós usando PI points históricós y futuros en
un nuevo PI point futuro.
Las versiones actuales de PI Nótificatións no pueden activar directamente las nótificaciónes de
PI en PI points futuros. Sin embargo, puede generar una PI nótificatión cuando se detecta una
cóndición anómala futura al usar un PI point históricó intermediario.
Casos de uso y ejemplos

Segun la industria o aplicación, puede usar datos pronosticados para lo siguiente:
• Identificar riesgos y oportunidades al registrar y visualizar datos pronosticados para
comparar con los numerós de próducción reales.
• Optimizar la prógramación de su servicio para que funcione con la maxima eficiencia y la
mayor seguridad, mientras minimiza los errores y los tiempos de inactividad.
• Utilizar el analisis predictivo para generar y optimizar modelos de proceso que mantienen a
sus operaciones en total cumplimiento.
• Garantizar la seguridad y disponibilidad de los datos de sus sistemas al predecir patrones de
retención y almacenamiento de datos para su centro de datos.
Consulte Ejemplo del tiempo: procedimiento de alto nivel para crear una muestra de datos
futuros relacionados con el tiempo que pueda utilizar para analizar tendencias del tiempo.
Ejemplo del tiempo: procedimiento de alto nivel

Usamos el tiempo como un ejemplo de aplicación generalizada para mostrarle cómó usar PI
points futuros en un analisis de prónósticó. El analisis de prónósticó de lluvias fuertes, vientos,
tormentas de tierra, etc., puede aplicarse en diversas industrias: puede dar como resultado el
envíó de grupos adicionales para distintos tipos de tareas de mantenimiento, dar la orden de
arrojar la cantidad de sal suficiente para contrarrestar el hielo en las autopistas, garantizar
potencia adicional en el tendido electricó durante períódós de tormentas fuertes, etc.
Siga estos pasos para cónfigurar un sistema del tiempo de muestra y pruebe las capacidades de
los puntos futuros. De manera alternativa, puede usarlos como directrices para crear un
esquema especializado para su propia aplicación, segun las necesidades específicas de su
industria.
Procedimiento
1. Verifique la instalación de PI Server. Consulte Ejemplo del tiempo: verificare la instalación
de PI Server si desea mas infórmación.
2. Cree PI points históricós para datos del tiempo pasados y PI points futuros para datos del
tiempo pronosticados. Rellene los PI points con datos del tiempo obtenidos de una fuente
publica. Ejemplo del tiempo: crear y rellenar PI points con datos sobre el tiempo
3. Cónfigure una plantilla de elemento de AF y plantillas de atributo relacionadas para obtener
sus valores de los PI points históricós y futuros cónfiguradós. Luego cree elementos de PI AF

Datos futuros
para varias ubicaciones geógraficas. Consulte Ejemplo del tiempo: crear elementos y
atributos de PI AF
4. Mediante el uso de PI Vision o de PI ProcessBook 2015 o una versión posterior, genere
tendencias durante un períódó específicó para visualizar las tendencias históricas frente a
las tendencias pronosticadas de un atributo del tiempo en particular. Ejemplo del tiempo:
crear tendencias y analizar datos
Ejemplo del tiempo: verificare la instalación de PI Server

Antes de crear un sistema de muestra mediante el uso de datos futuros, debe verificar que haya
instalado versiones correctas de los productos de OSIsoft.
Procedimiento
1. Verifique que haya instalado Servidor PI 2015 o una versión posterior. Servidor PI incluye PI
Data Archive y PI AF.
2. Verifique que haya instalado la ultima versión de una herramienta cliente, como PI Vision o
PI ProcessBook 2015 o una versión posterior.
3. Inicie PI Data Archive y un servidor de PI AF.
Ejemplo del tiempo: crear y rellenar PI points con datos sobre el tiempo
Puede crear PI points históricós, como “Temperatura actual”, y PI points futuros, como
“Temperatura pronosticada” o “Precipitación pronosticada”. Para generar valores y rellenar PI
points, puede usar datos generados mediante metódós estandares que se utilizan en su
órganización y que corresponden a su aplicación.
En el caso del ejemplo del tiempo, puede usar cualquier servicio web para generar datos del
tiempo históricós y pronosticados. Por ejemplo, el servicio de
developer.worldweatheronline.com puede generar datos del tiempo pronosticados en formato
CSV (valores separados por comas), formato JSON y otros. Brindamos instrucciones detalladas
sobre cómó usar este servicio, pero puede usar cualquier otro servicio en su lugar.
Procedimiento
1. Vaya a World Weather Online Developer Portal (http://developer.worldweatheronline.com).
2. Seleccione el servicio Free Weather API.
3. Seleccione “Get local weather”. Ingrese el códigó postal de la ubicación que desea supervisar
y seleccione el archivo CSV como el archivo de salida. Puede seleccionar otras opciones,
como numeró de días pronosticados, intervalos de tiempo de los prónósticós, etc.
4. Cargue el archivo CSV en Excel.
5. Seleccione las columnas que son de su interes y, mediante el uso de PI DataLink, cree una
tabla de valores de atributo y estampas de tiempo pronosticadas de PI point. Tambien puede
contar con atributos de PI point para datos históricós, como “Temperatura actual”, que
puede comparar posteriormente con los datos de “Temperatura pronosticada”.
6. Cónfigure PI Data Archive con los valores y PI points del tiempo.
Nota:
Si desea extender este modelo a miles de ubicaciones, use PI Builder para cónfigurar
sus PI points.

Datos futuros
Ejemplo del tiempo: crear elementos y atributos de PI AF

Use una plantilla de elemento para crear elementos de PI AF con atributos que designen
diversos aspectos del tiempo.
Nota:
Para obtener infórmación sobre cómó crear plantillas de elementos, elementos y
atributos en PI AF, consulte el Manual del usuario de PI System Explorer.
Procedimiento
1. Mediante el uso de PI System Explorer, cree una plantilla de elemento llamada
WeatherByLocation con atributos del tiempo, como:
◦ Temperatura actual
◦ Temperatura pronosticada
◦ Precipitación pronosticada
◦ Dirección del viento pronosticada
◦ Velocidad del viento pronosticada
◦ Luz del sol
◦ Tiempo pronosticado
2. Asigne los tipos de valores correspondientes a los diversos atributos de elementos, como
“grado Farenheit” para Predicted Temperature o “porcentaje” para Predicted Precipitation.
Puede usar efectivamente el tipo “conjunto enumerado” para cónfigurar, por ejemplo, un
conjunto enumerado de códigós del tiempo para Predicted weather, como:
◦ 113
Soleado
◦ 116
Parcialmente nublado
◦ 122
Cubierto
De igual manera, puede cónfigurar un conjunto enumerado de direcciones en una brujula de
16 puntos para el atributo “Dirección pronosticada del viento”.
3.
Nota:
Debe haber creado PI points que correspondan a los atributos del tiempo antes de
realizar este paso.
Cree referencias de datos para cada atributo. Vincule atributos de PI point históricós, como
“Temperatura actual”, con el PI point históricó correspondiente y atributos de PI point
futuros, como “Temperatura pronosticada”, con el PI point futuro correspondiente.
4. Cree algunos elementos a partir de la plantilla de elementos WeatherByLocation. Los
elementos deben corresponder a las ubicaciones geógraficas en las que desea supervisar las
condiciones del tiempo pronosticadas.

Datos futuros
Ejemplo del tiempo: crear tendencias y analizar datos

Utilice las herramientas de visualización de PI para representar o crear tendencias de datos de
PI points históricós y futuros. Luego, utilice Asset Analytics (incluido en Servidor PI) para
recibir asistencia en su analisis de los datos obtenidos, pronosticados o computados.
Procedimiento
1. En PI Vision, cree una tendencia de Current Temperature y Predicted Temperature
para una sola ubicación.
Seleccione la hora de inicio y la hora de finalización de modo que sea relativa a la hora
actual. La línea “now” permanece visible si eligió un intervalo de tiempo relativo que
comprende la hora actual, como *-2 h a *+2 h.
Los cursores de tendencia establecidos para una hora futura móstraran valores para los PI
points futuros, pero los PI points históricós móstraran No data.
2. Puede usar valores de PI points futuros como entradas para sus analisis.
Por ejemplo, puede calcular la diferencia entre Predicted Temperature y Current
Temperature, y escribirla en un atributo de salida denominado DeltaTemperature, y
crear una tendencia de los valores de DeltaTemperature para ver en que medida coincide
su prónósticó con los valores reales registrados.
Tambien puede determinar que un evento se active cuando DeltaTemperature alcance un
valor en particular.

Datos futuros

PI interfaces
Las PI interfaces son las aplicaciones de software que extraen los datos de una fuente de datos
y los envían a PI Data Archive. Existen cientos de PI interfaces diferentes y cada interfaz esta
totalmente documentada en su propio manual específicó. Sin embargo, la mayóría de las
interfaces comparten un conjunto cómun de funciones.
Las PI interfaces suelen ejecutarse en un sistema dedicado, llamado nodo de interfaz, que se
conecta tanto a la fuente de datos como a PI Data Archive. El nodo de interfaz pódría ser una
maquina que forma parte de un sistema de datos externo, una maquina interfaz dedicada e
independiente o incluso un servidor PI Data Archive (PI a PI). Los nodos de interfaz pueden
ejecutar multiples interfaces y conectar multiples servidores PI Data Archive.
Para la mayóría de las interfaces, es importante cónfigurar el almacenamiento en bufer en el
nodo de interfaz. Esto evita la perdida de datos cuando PI Data Archive no esta disponible, por
ejemplo, durante una actualización. Algunas interfaces (como la interfaz UFL y las interfaces de
batches, como la interfaz Emerson DeltaV Batch) no requieren el almacenamiento en bufer
porque la fuente de datos en sí misma esta almacenada en bufer. Consulte la dócumentación de
su interfaz.
Nota:
Los nodos de interfaz son denominados en ocasiones nodos API o nodos de fuentes de
datos.
Como las fuentes de datos se ejecutan sin intervención humana, no son aplicables los inicios de
sesión de usuario. Con anterioridad a PI Data Archive 2016 R2, los trusts se utilizaban
habitualmente para autenticar las PI interfaces, mientras que las asignaciones se usaban para el
inicio de sesión unicó de los usuarios de Windows en los servidores de PI Data Archive. Con PI
API 2016 for Windows Integrated Security, la autenticación de Windows se amplía a las PI
interfaces.
Security.
Nota:
En esta sección
• Utilidades de PI interface
• Interfaces incluidas con PI Data Archive
• Instalación de la interfaz
• Mantenimiento de la interfaz
• Dócumentación adicional sobre las interfaces

PI interfaces
Utilidades de PI interface
• Estructura de la interfaz UniInt: UniInt es una estructura de OSIsoft para el desarrollo de
interfaces que proporciona interfaces con un conjunto de funciones y comportamientos
coherentes.
• PI API: la mayóría de las interfaces de OSIsoft utilizan PI Application Programming Interface
(PI API) para recuperar infórmación sobre la cónfiguración de PI Data Archive y para
escribir los datos en el servidor PI Data Archive.
• PI SDK: algunas interfaces que no son de batches utilizan PI Software Development Kit (PI
SDK) para recuperar la infórmación sobre la cónfiguración de PI Data Archive y para crear PI
points, estados digitales, etc. La mayóría de las interfaces de batches utilizan PI SDK para
escribir datos de batches en PI Data Archive.
Estructura de la interfaz UniInt

UniInt es una estructura de OSIsoft para el desarrollo de interfaces. UniInt corresponde a
“interfaz universal”. El própósitó de UniInt es proporcionar interfaces con un conjunto de
funciones y comportamientos coherentes. UniInt realiza muchas tareas que deben ejecutar la
mayóría de las interfaces, como cargar puntos, analizar líneas de comandos, argumentos y
programar scans de datos. Las interfaces basadas en UniInt utilizan algunos de los parametrós
de cónfiguración suministrados por UniInt y algunos parametrós específicós de la interfaz.
UniInt utiliza PI API para escribir y leer datos en y desde PI Data Archive.
PI API
PI Application Programming Interface (PI API) es una biblioteca de funciones que lee y escribe
valores en PI Data Archive y desde este, y ademas le permite recuperar infórmación sobre la
cónfiguración de puntos. OSIsoft utiliza API para crear interfaces que se ejecutan en una
variedad de plataformas.
PI API tambien proporciona la capacidad para almacenar datos en bufer que se envían a PI Data
Archive, lo que permite desconectar el servidor PI Data Archive para realizar actualizaciones de
hardware o software sin comprometer la óbtención de datos. Cuando el servidor vuelve a estar
disponible, los datos almacenados en bufer se reenvían a el.
API Nodes son estaciones de trabajo que ejecutan programas, como interfaces, que se basan en
PI API. En la practica, el terminó API Node se utiliza en ocasiones como sinónimó de nodo de
interfaz, ya que, históricamente, la mayóría de las interfaces se basan en API.
Puede iniciar PI API desde C, C++, Visual Basic u otros lenguajes. Para obtener mas infórmación
sobre PI API, consulte PI API Programmer's Help. Puede acceder a ella desde PI SDK Help.
PI SDK
PI Software Development Kit, (PI SDK), es un servidor ActiveX en proceso que proporciona
acceso COM a analistas de OSIsoft. El producto proporciona un enfoque orientado a objetos
para interactuar con PI Systems, en contraste con los metódós de procedimiento que se utilizan
en PI API.
PI SDK puede instalarse unicamente en Windows. Solo las interfaces que se ejecutan en
Windows pueden aprovechar la funcionalidad que proporciona PI SDK. Todas las interfaces
escritas para UNIX o VMS utilizan PI API de manera exclusiva para toda la cómunicación con el
servidor de PI Data Archive.

PI interfaces
Algunas interfaces utilizan PI SDK debido a que PI API no proporciona determinadas

funcionalidades. Por ejemplo, PI SDK permite a las interfaces crear puntos y conjuntos
digitales. Ademas, cualquier interfaz que escriba datos de batches en PI, como PI Batch
Generator Interface (PIBaGen), debe utilizar PI SDK para escribir los datos.
El servicio BufServ no almacenara en bufer los datos que PI SDK escriba en PI Data Archive. Por
este motivo, todas las interfaces escriben datos de series temporales en PI Data Archive
mediante el uso de PI API.
Las interfaces que se conectan a PI Data Archive mediante el uso de PI SDK y PI API conservan
dos conexiones separadas con el servidor PI Data Archive.
Interfaces incluidas con PI Data Archive

La instalación de PI Data Archive incluye versiones de varias interfaces utiles. Estas versiones
basicas poseen conteos limitados de puntos y otras restricciones. Puede descargar e instalar
versiones completas de estas interfaces. Estas interfaces incluyen:
Interfaz Descripción Ubicación
PI Batch Generator (PIBaGen) Obtiene datos de PI Data Archive, pipc\Interfaces\PIBaGen
genera datos de lotes y escribe
los datos de batches en PI Batch
Database. PIBaGen se utiliza
cuando no existe una interfaz
nativa para generar y almacenar
datos de batches en PI System.
Ejecute PIBaGen directamente en
el servidor PI Data Archive.
PerfMon Lee los contadores de pipc\Interfaces
rendimiento de Windows y \PIPerfMon_Basic
almacena los valores en PI points.
PI Interface Status Interface Una utilidad que determina si un pipc\Interfaces
programa de la interfaz escribe \PIIntStatus
valores nuevos en sus puntos.
Comprueba, periódicamente, si
un PI point particular, conocido
como tag de vigilancia, recibe
valores nuevos.
Ping Supervisa la disponibilidad de pipc\Interfaces\PING_Basic
red de los sistemas de equipo al
comprobar mediante ping la
disponibilidad de estos y
almacena los tiempos de
respuesta en PI points.
Aleatorio y Ramp Soak Dos interfaces del simulador que pipc\Interfaces\Random
pueden simular datos aleatorios,
pipc\Interfaces\rmp_sk
sinusoidales y de batches. Puede
ejecutarlas de forma remota o
directa en el servidor PI Data
Archive.
SNMP Obtiene datos de rendimiento de pipc\Interfaces\SNMP_Basic
sistemas de equipo y
enrutadores de red mediante el
uso del Protocolo simple de
administración de redes y
almacena los valores en PI points.

PI interfaces
En esta sección
• Cónfiguración de puntos en la interfaz Ramp Soak
• Cónfiguración de puntos en interfaz Random
Configuración de puntos en la interfaz Ramp Soak

Ramp Soak Simulator, que se instala y cónfigura cuando instala PI Data Archive, es una
excelente fuente de datos de prueba. La interfaz simula la salida de un sistema de batches al
escribir datos de batches simulados y fases de batches en los PI points de fase y PI points de
batches activos. Una onda típica posee fases de nivelación (espera), de ascenso y descenso. El
ruido puede simularse en la hora de la senal y en la hora de finalización de la fase. El origen de
punto predeterminado para esta interfaz es “9”. Para detallar los puntos que el instalador de PI
Data Archive crea y para crear puntos para la interfaz Ramp Soak, utilice la ópción Point
Builder de PI System Management Tools.
Cónfigure los atributos del punto de la siguiente manera:
• Point Type (tipo de datos): se admiten los tipos de puntos Float16, flóat32, int16, int32 y
digitales. Para los datos, solo se admiten tipos numericós. Para tags activos y de fase, el tipo
de datos puede ser numericó o digital.
• Location1: tiempo en minutos que se debe esperar antes de que empiece el ciclo, en el
inicio del simulador.
• Location2: tiempo en minutos entre ciclos.
• Location3: ruido de senal maximó, especificadó como porcentaje * 10. Por ejemplo, para
un ruido del 10 %, ingrese 100.
• Location4 (clase de scan): determina la frecuencia en la que se generan valores nuevos.
• Location5: ruido de la hora de finalización de la fase especificadó como porcentaje * 10.
Por ejemplo, para el 10 %, ingrese 100.
• InstrumentTag: cónfigura el tag activo del batch opcional y los tags de la fase. Especifica
los nombres de tag separados por un espacio. Al inicio de un ciclo (el comienzo de la
primera fase), la interfaz escribe un valor de 1 en el tag activo del batch y 0 en el tag de la
fase. El tag de la fase se incrementa de a 1 al comienzo de cada fase subsiguiente. Al final de
la ultima fase, la interfaz escribe un valor de 0 en el tag de batch activo. Esta función permite
realizar el seguimiento de batches simulados usando PI-Batch.
Nota:
No cónfigure mas de un tag para una unidad simulada. Si simula batches, puede tener
mas de un punto de ramp soak para la unidad simulada (por ejemplo, temperatura y
presión). Solo uno de esos puntos puede especificar tags activos o de fase; de lo
contrario, ambos escribiran en los tags activos y de fase, mas probablemente en
momentos diferentes.
• ExDesc: infórmación sobre la fase necesaria para simular ascensos, descensos y esperas.
Cada fase requiere una entrada con el siguiente formato: (period, end_value), donde:
◦ period es la hora en minutos.
◦ end_value es el valor para el tag al finalizar el períódó de la fase. De manera
predeterminada, los valores se informan en unidades de ingeniería. Para informar valores
como porcentaje del intervalo, especifique un símbóló de porcentaje (%) despues del
parametró de valor final.
Por ejemplo, para cónfigurar un ciclo con cinco fases, especifique:
(10,33) (11,33) (15,50) (15,43) (3,0)

PI interfaces
Esto cónfigura cinco fases para un tiempo total de ciclo de 54 minutos:

◦ Fase 1: ascenso de 10 minutos desde el cero del tag hasta 33
◦ Fase 2: períódó de 11 minutos que permanece en 33
◦ Fase 3: ascenso de 15 minutos de 33 a 50
◦ Fase 4: descenso de 15 minutos a 43
◦ Fase 5: descenso de 3 minutos a 0
La tendencia que se genera como resultado para el tag se parece a esto:
Si se especifica un ruido de la fase de senal (Location5), el períódó de la fase real varía en el

intervalo especificadó. Las duraciones de las fases restantes se ajustan de manera que cada
ciclo tenga el mismo tiempo general. Este enfoque sincroniza varios tags para simular datos de
batches.
Configuración de puntos en interfaz Random

Random Simulator, una interfaz que se instala y cónfigura con PI Data Archive, es una excelente
fuente de datos de prueba. Puede cónfigurar puntos para generar diversos tipos de datos
aleatorios. El origen de punto predeterminado para esta interfaz es “R”. Para detallar los puntos
que crea el instalador de PI Data Archive y para crear puntos para la interfaz Random, utilice la
ópción PI Builder de PI System Management Tool. Para cónfigurar el tipo de datos generado
para un punto, cónfigure Location5. La interfaz puede generar los siguientes tipos de datos:
• Datos sinusoidales (Location5=0)

Datos de onda sinusoidal que oscilan durante un períódó y una amplitud especificada.
• Datos aleatorios (Location5=1)

Una senal similar a un ruido blanco; los valores van de 0 a 1.
• Datos de estación (Location5=2)

Los datos de la interfaz Random cambian en un punto medio especificadó.
• Datos fractales (Location5=3)

Conjuntos de Mandelbrot que se asemejan a los datos de proceso y al ruido rosa.
• Datos de modelo de perfil (Location5=4)

Datos basados en un modelo de perfil para uso con la aplicación cliente PI-Prófile.

PI interfaces
• Datos de cadena (Location5=5)
Datos en cadena de longitud aleatoria.
Cónfigure los atributos del punto de acuerdo con el tipo de datos que desea generar, segun se
describe a cóntinuación. Se admiten los siguientes tipos de datos de punto:
• flóat16
• flóat32
• int16
• int32
• string
• digital
Datos sinusoidales
Para cónfigurar cómó se generan los datos de onda sinusoidal, cónfigure los atributos del tag de
la siguiente manera:
• Location2: el numeró de ciclos por día para la onda sinusoidal. Por ejemplo, si cónfigura
Location2 en 2, se establece un períódó de 12 horas para la onda.
• Location3: cómpensación de la fase a partir de la medianoche, en segundos. La hora puede
ser hora local o UTC. Para especificar la hora UTC, Location2 se cónfigura en un numeró
negativo cuyo valor absoluto representa ciclos por día.
• Span: el valor maximó que se generara
• Zero: el valor mínimó de la onda
Datos aleatorios
Para cónfigurar los datos aleatorios que se generaran, cónfigure los atributos del tag de la
siguiente manera:
• Location2: limita la cantidad de cambios entre cada valor, especificadó como milesimas de
Span
• Span: el rango de valores que se generaran
• Scale: factor de escala opcional por el cual el valor generado se multiplicara
Datos de estación
Los valores aleatorios de estación son utiles para experimentar con el analisis SQC (control de
calidad estadísticó). De manera predeterminada, el punto medio es (cero + Span)/2. Para
restablecer periódicamente el punto medio, cónfigure Location3 en la frecuencia deseada de
restablecimiento.
• Span: cantidad maxima de excursión

• Zero: valor mínimó
• Location3: (opcional) cantidad de valores que se deben generar antes de restablecer el
punto medio en el valor actual
Datos fractales
Los conjuntos de Mandelbrot se asemejan al ruido rosa y son utiles para simular tendencias de
proceso. Cónfigure Location2 en el factor de escala para cambiar el tamanó (velocidad) en
unidades de 0,001 de Span. El factor de escala predeterminado es 25.

PI interfaces
Datos de modelo de perfil

Para simular datos basados en un modelo de perfil para uso con la aplicación cliente PI-Prófile,
cónfigure los atributos del tag de la siguiente manera.
• Location1: numeró del modelo de perfil (0, 1, 2, …, 9). Este atributo corresponde a una
maquina de papel.
• Location2: numeró de la serie de atributos (0, 1, 2,…,9). Este atributo corresponde a un
atributo de una maquina de papel.
• Location3: el tipo de punto del modelo. Se admiten los siguientes tipos:
◦ 1 Reel Number Tag (valor entero)
◦ 2 Elapsed Distance Tag (real)
◦ 3 Grade Tag (digital)
◦ 4 HiHi Limit Tag (valor entero o real)
◦ 5 Hi Limit Tag (valor entero o real)
◦ 6 Target Limit Tag (valor entero o real)
◦ 7 Lo Limit Tag (valor entero o real)
◦ 8 LoLo Limit Tag (valor entero o real)
◦ 9 Attribute Array Tag (valor entero o real)
◦ 10 Defect Type (digital)
◦ 11 Defect MD start (real)
◦ 12 Defect MD length (real)
◦ 13 Defect CD start (real)
◦ 14 Defect CD width (real)
• ExDesc: junto con el atributo Location3, cónfigura características del tipo de punto del
modelo.
◦ Loc3=1: MinReelTime, MaxReelTime y ResetTime (en segundos). Los valores
predeterminados son 1800, 3600, 23 400.
◦ Loc3=2: velocidad del equipo (en distancia/minutos). El valor predeterminado es 50,0.
◦ Loc3=3: no se utiliza
◦ Loc3=4-8: LoValue, HiValue
◦ Loc3=9: si ExDesc no esta en blanco, el tag siempre tendra datos defectuosos.
◦ Loc3=10: frecuencia de defectos por scan (0,0 a 1,0). El valor predeterminado es 0,02.
◦ Loc3=11: no se utiliza
◦ Loc3=12: DefectMinLen, DefectMaxLen (en porcentaje de velocidad de la maquina). Los
valores predeterminados son 0,5 y 10,0.
◦ Loc3=13: ancho de la maquina. El valor predeterminado es 30,0
◦ Loc3=1:4 DefectMinWidth, DefectMaxWidth (en porcentaje de ancho). Los valores
predeterminados son 0,01 y 0,05.

PI interfaces
Cadena
La interfaz genera cadenas con longitudes que varían entre el mínimó y el maximó cónfiguradó
para el tag. Se admiten cadenas de longitud cero. La cadena contiene caracteres alfabeticós
ASCII en orden de A-Y, seguido de a a-y, y repite si es necesario. Por ejemplo:
ABCDEFGHIJKLMNOPQRSTUVWXYabcdefghijklmopqrstuvwxyABCDEFGHIJ
Cónfigure los atributos del tag de la siguiente manera:
• Location2: longitud mínima de la cadena, 0 o superior.

• Location3: longitud maxima de la cadena, (maximó de 976).
Instalación de la interfaz
En esta sección se proporciona infórmación general para la instalación de interfaces. No incluye
infórmación específica de la interfaz. Consulte la dócumentación de su interfaz para obtener
datos mas específicós.
Si esta familiarizado con la ejecución de programas de la interfaz de óbtención de datos de PI,
esta sección le ayudara a ejecutar la interfaz.
En esta sección
• Instalación de una interfaz: pasos generales
• Características de interfaz avanzadas (opcional)
• Diagnósticó de interfaz (opcional)
Instalación de una interfaz: pasos generales

En este tema se proporciona infórmación general para la instalación de interfaces. No incluye
infórmación específica de la interfaz. Consulte la dócumentación de la interfaz para obtener
infórmación específica.
En la mayóría de los casos, no debe ejecutar interfaces en el equipo PI Data Archive. La
ejecución de interfaces en un equipo separado permite desmontar PI Data Archive para el
mantenimiento mientras la interfaz cóntinua obteniendo y almacenando datos en bufer.
Ademas, usted no desea que las interfaces compitan con PI Data Archive por los recursos del
equipo.
Estos pasos se basan en PI Interface Cónfiguratión Utility (ICU). Si utiliza PI ICU para cónfigurar
una interfaz, PI ICU mantiene el archivo de batches de la interfaz y todos los cambios en la
cónfiguración se conservan en ese archivo y en la Module database. Para cónfigurar una
interfaz mediante el uso de PI ICU, debe instalar PI ICU en el nodo de interfaz.
Procedimiento
1. Cónfirme que pueda usar PI SMT para cónfigurar PI Data Archive. No es necesario ejecutar
PI SMT en el mismo equipo en el que ejecuta esta interfaz.
2. Ejecute el kit de instalación de PI Interface Cónfiguratión Utility (ICU) en el nodo de interfaz.
Este kit ejecuta el kit de instalación de PI SDK, que instala PI API y PI SDK.
Nota:
Asegurese de que el kit de instalación de PI ICU incluya PI API 2016 for Windows
Integrated Security o posterior.
3. Ejecute el kit de instalación para la interfaz.

PI interfaces
4. Si ejecuta la interfaz en un nodo de interfaz, verifique las propiedades de zona horaria del
equipo. Una cónfiguración de zona horaria incorrecta puede provocar que PI Data Archive
rechace los datos que escribe esta interfaz.
5. Ejecute ICU y cónfigure una nueva instancia de esta interfaz. Los parametrós de inicio
esenciales para esta interfaz son los siguientes:
◦ Point Source
◦ Interface ID
◦ PI Server
◦ Scan Class
6. Utilice la herramienta Connection para cónfirmar la cónexión entre el nodo de interfaz y el
dispositivo.
7. Si utilizara puntos digitales, defina los conjuntos de estados digitales correspondientes.
8. Agregue los estados correspondientes a los conjuntos de estados digitales que ha definidó
en el paso anterior.
9. Cree tags de entrada y, si lo desea, tags de salida para esta interfaz.
10. Inicie la interfaz de manera interactiva y cónfirme su cónexión correcta con el servidor PI
Data Archive sin el almacenamiento en bufer.
11. Cónfirme que la interfaz obtenga datos correctamente.
12. Detenga la interfaz y cónfigure una aplicación de almacenamiento en bufer (Bufserv o
PIBufss).
13. Inicie la aplicación de almacenamiento en bufer y la interfaz. Cónfirme que la interfaz
funcione junto con la aplicación de almacenamiento en bufer al eliminar físicamente la
cónexión entre el nodo de interfaz y el equipo PI Data Archive, o al detener el servidor PI
Data Archive.
14. Cónfigure la interfaz para que se ejecute como servicio. Cónfirme que la interfaz se ejecute
correctamente como servicio.
15. Reinicie el nodo de interfaz y cónfirme que la interfaz y la aplicación de almacenamiento en
bufer se reinicien.
Características de interfaz avanzadas (opcional)

Considere cónfigurar la interfaz para un inicio sin cónexión. De igual manera, considere
cónfigurar la cónmutación por error de UniInt. Para obtener detalles, consulte UniInt Interface
User Manual.
• Puntos de salud de UniInt

Los puntos de salud de UniInt son puntos de interfaz a los que UniInt escribe, los cuales
indican el estado operativo de la interfaz. Puede crear puntos de salud de UniInt usando PI
Interface Cónfiguratión Utility. Para obtener mas infórmación, consulte el artículó de
Soporte Tecnicó de OSIsoft KB01231: Resólución de problemas de rendimiento con tags de
salud de UniInt (https://techsupport.osisoft.com/Troubleshooting/KB/KB01231).
• Sincronización automática de puntos (APS)

Muchas interfaces, como la interfaz PI OPC, admiten la sincrónización autómatica de puntos
(APS). Por ejemplo, se pueden crear autómaticamente PI points en PI Data Archive segun los
puntos del servidor OPC mediante el uso de un conjunto de reglas que pueden cónfigurarse.
Para determinar si su interfaz admite APS, verifique la dócumentación específica de la
interfaz.

PI interfaces
Si la interfaz de interes posee un conector de APS, consulte el manual de PI AutoPointSync

Connector de la interfaz para conocer los pasos de la cónfiguración. Tambien puede
consultar el manual del usuario de PI AutoPointSync y el manual del usuario de OSI PI COM
Connector para obtener infórmación adicional.
Diagnóstico de interfaz (opcional)

Procedimiento
1. Cónfigure los puntos de rendimiento de la clase de scan.
2. Instale PI Performance Monitor Interface en el nodo de la interfaz.
3. Cónfigure los puntos del contador de rendimiento.
4. Cónfigure los puntos de supervisión de estado de UniInt.
5. Cónfigure el punto de velocidad de E/S.
6. Instale y cónfigure la Utilidad de estado de interfaz en el equipo PI Data Archive.
7. Cónfigure el punto de estado de interfaz.
Mantenimiento de la interfaz
Una vez instalada y cónfigurada una PI interface, normalmente puede dejarla ejecutandóse
indefinidamente sin intervención alguna. Si realiza actualizaciones de software o ejecuta
parches de seguridad, o si la infraestructura de la red cambia, es posible que deba realizar
algunas tareas basicas.
• Autenticación de interfaces
El metódó de autenticación de PI interfaces depende de su versión de PI API. En PI Data
Archive 2016 y versiones anteriores, los trusts se usaban generalmente para autenticar PI
interfaces. Con PI API 2016 for Windows Integrated Security, la autenticación de Windows
se amplía a las PI interfaces.
◦ PI API 2016 for Windows Integrated Security o posterior (recomendado)

Las interfaces se conectan a PI Data Archive con autenticación de Windows.
Para obtener mas infórmación sobre la cónfiguración de seguridad, consulte
"Cónfiguración de seguridad" in Live Library (https://livelibrary.osisoft.com).
◦ PI API 1.6.8 o anterior (no recomendado)

Las interfaces se conectan a PI Data Archive mediante trusts, normalmente basados, en
parte, en infórmación de red para el nodo de interfaz. Al instalar una interfaz, debe
cónfigurar un trust para ella. Si su infraestructura de red cambia (el nombre de host o la
dirección IP, por ejemplo), debe recónfigurar el trust. Consulte Administración de la
autenticación de interfaces con PI trusts.
• Configuración de interfaces
Al instalar una interfaz, debe registrarla con ICU. Si el nodo de interfaz no tiene cónfiguradó
el almacenamiento en bufer, tambien debera cónfigurarló. Consulte PI Buffering User Guide
para obtener instrucciones.
• Monitorización del rendimiento de la PI interface

Si sospecha de algun problema con una interfaz, puede supervisar su rendimiento.

PI interfaces
En esta sección
• Arranque y detención de interfaces
• Cónfiguración de interfaces
• Mónitórización del rendimiento de la PI interface
• Administración de equipos de fuentes de datos
Arranque y detención de interfaces

La primera vez que arranque una PI interface, hagaló desde el panel de control de Servicios de
Windows. En adelante, pódra arrancar o detener la interfaz desde PI ICU.
Procedimiento
1. Haga clic en Start > Control Panel > Administrative Tools > Services.
2. En la ventana Servicios, busque la interfaz que desee arrancar o detener. Por ejemplo, la
interfaz PI Random Simulator (aleatoria) X64.
3. Haga clic derecho en el servicio de interfaz y seleccione Start o Stop.
Configuración de interfaces
Utilice PI Interface Cónfiguratión Utility (ICU) para gestionar sus PI interfaces. Debe ejecutar PI
ICU en el ordenador donde se ejecuta la PI interface. Cónfigure la interfaz inicialmente en PI
ICU para registrar la interfaz con PI ICU.
Procedimiento
1. En la barra de herramientas de PI ICU, haga clic en el bótón Create a New Interface Instance
from EXE para abrir el cuadro de dialógó Configure a New Interface.
2. Especifique el ejecutable de la interfaz.
a. Haga clic en Browse.
b. Vaya al directorio que contiene el ejecutable de la interfaz. Por defecto, PI instala los
ejecutables de interfaz en un subdirectorio de interfaces en el directorio Archivos de
programa\PIPC\Interfaces.
c. Seleccione el archivo ejecutable.
d. Haga clic en Open.
3. En Host PI Server/Collective, seleccione el PI Data Archive anfitrión o colectivo que contiene
los puntos de esta interfaz. Si el servidor o colectivo deseado no aparece, use PI Connection
Manager para conectar con dicho servidor o PI collective..
4. Introduzca un nombre descriptivo para la interfaz (opcional).
5. En Point Source, introduzca la cadena unica que identifica a la interfaz en los puntos
cónfiguradós. Para obtener infórmación sobre las restricciones, consulte Cónfiguración de
interfaz y origen de punto.
6. En Interface ID, introduzca el nombre que asocia puntos con una copia de la interfaz.
La ID de la interfaz puede ser cualquier valor entero positivo. Los puntos que utilizan la
interfaz suelen usar el numeró ID como valor para el atributo Location1. Consulte la
dócumentación de la interfaz al cónfigurar la ID de la interfaz.
7. En Service ID, introduzca un numeró que identifique esta instancia de la interfaz.

PI interfaces
La ID de servicio no esta relacionada con la ID de interfaz; sin embargo, puede usar el mismo
valor para ambas.
8. Haga clic en Agregar.
En esta sección
• Cónfiguración de interfaz y origen de punto
• Cónfiguración de la clase de scan y de la interfaz
Configuración de interfaz y origen de punto

Al cónfigurar una interfaz, debe especificar un origen de punto, una cadena unica que identifica
la interfaz.
Todos los puntos que pertenecen a esa interfaz deben usar esa cadena origen de punto como
valor para el atributo Point Source. Algunas interfaces pueden usar valores multicaracter para
el origen de punto, mientras que otras requieren un unicó caracter. Si no esta seguro, consulte
la dócumentación de la interfaz.
PI Server viene precónfiguradó con aplicaciones que utilizan caracteres de origen de punto
reservados. Al seleccionar una cadena de origen de punto para sus interfaces, no utilice
ninguna de las siguientes cadenas reservadas:
Cadena Reservada para
9 Simulador RampSoak
@ Alarm
G
C Performance Equations Scheduler
Lab Cadena por defecto de origen de punto
R Simulador de interfaz aleatorio
T Programa totalizador
La herramienta PI SMT Point Source Table indica todos los valores Point Source en uso para el
PI Server seleccionado. En PI SMT, seleccione Points > Point Source Table para ver esta
herramienta.
Configuración de la clase de scan y de la interfaz

Una clase de scan es un códigó que las PI interfaces utilizan para programar la óbtención de
datos. Es posible definir la scan class en PI ICU cuando se cónfigura una interfaz.
Las clases de scan constan de los siguientes componentes:
Componente Description Opcional Ejemplo
Periodo Especifica con que frecuencia No 01:00:00
(frecuencia de obtiene datos la interfaz.
Obtener datos cada hora.
explóración)
Desplazamiento Especifica la hora de inicio del Sí 01:00:00, 13:00:00
calculó. PI Data Archive interpreta el
Obtener datos cada hora,
valor comenzando desde la
comenzando a la 1:00 p. m.
medianoche del día actual.

PI interfaces
Componente Description Opcional Ejemplo

Hora UTC Requiere que la prógramación se Sí, pero 02:00:00,13:00:00,U
sincronice con UTC. Para usarla, recomendado
Obtener datos cada dos
anada “,U” al final de la clase de scan.
horas, comenzando a la
Las clases de scan UTC no se veran
1:00 p. m., hora UTC.
afectadas por el horario de verano
porque la prógramación de la clase
de scan se sincroniza con la hora
UTC, no con la hora local. La hora
UTC no tiene incidencia si el períódó
de la clase de scan es de 1 hora o
menos.
Hora local Especifica que: Sí, su uso fuerza 23:00:00,08:00:00,L
• Durante la transición del horario la Prógramación
Durante la transición del
de verano al horario estandar, el del reloj de pared
horario de verano al
períódó de la clase de scan es de horario estandar, obtiene
24 horas. datos al cabo de 24 horas.
• Durante la transición del horario Durante la transición del
estandar al horario de verano, el horario estandar al horario
períódó de la clase de scan es de de verano, obtiene datos al
22 horas. cabo de 22 horas.
Para especificar la hora local,
agregue “,L” despues de la clase de
scan. Esta cónfiguración no tiene
incidencia si el períódó de la clase de
scan es de 1 hora o menos.
A cóntinuación, se presenta un ejemplo de clase de scan:
Esta clase de scan utiliza un formato de hh:mm:ss y especifica un períódó, una cómpensación y
una hora UTC.
Al especificar una clase de scan en el ICU puede utilizar cualquiera de los siguientes formatos:
ss
ss,ss
hh:mm:ss
hh:mm:ss,hh:mm:ss
hh:mm:ss,hh:mm:ss,t
donde hh son horas, ss son segundos, mm son minutos y t puede ser una U (para la hora UTC) o
una L (para la hora local).
Nota:
En PI ICU, las especificaciónes de clases de scan no pueden contener ningun espacio.

PI interfaces
Monitorización del rendimiento de la PI interface

Para monitorizar el rendimiento de cada interfaz, puede comprobar los puntos de tasa de E/S y
de rendimiento de cada interfaz y consultar los archivos de registro.
En esta sección
• Cómpróbación de los puntos de velocidad de E/S y de rendimiento
• Cómpróbación de los archivos de registro
Comprobación de los puntos de velocidad de E/S y de rendimiento

Cree una visualización PI ProcessBook que muestre los puntos de velocidad de E/S y de
rendimiento de cada interfaz.
Algunas interfaces carecen de puntos de rendimiento, de modo que para ellas solo puede
basarse en los puntos de velocidad de E/S.
Point Type Acción
IORates Monitoriza el flujó de datos desde una interfaz. Cada 10 minutos, cada punto
de velocidad de E/S registra la velocidad media de transferencia de datos
hacia PI Data Archive en ese períódó de 10 minutos en eventos/segundo.
Rendimiento Lee el valor en segundos que la interfaz necesita para completar una ronda de
óbtención de datos para un conjunto de puntos. Puede crear un punto de
rendimiento para cada clase de scan de cada interfaz.
Nota:
Puede crear puntos de velocidad de E/S y de rendimiento para una interfaz mediante PI
ICU (consulte Cónfiguración de interfaces).
Comprobación de los archivos de registro

PI System registra los errores de interfaz y de almacenamiento en bufer en los archivos
pipc.log y pigetmsg.log del nodo de interfaz. Utilice la herramienta Message Logs de PI
SMT para ver estos mensajes. Algunas interfaces tambien generan un archivo de salida de
interfaz que puede contener infórmación sobre su rendimiento.
La mayóría de las interfaces tambien escriben cada 8 horas un resumen de rendimiento en
pipc.log. Para cada clase de scan, el resumen indica:
• Duración del scan mas reciente

• Porcentaje de scans no ejecutados
• Porcentaje de scans omitidos
Las interfaces cuentan una explóración como que falta si se inició despues de su hora de inicio
programada porque tardó demasiado una explóración anterior. Las interfaces cuentan una
explóración como omitida si no tuvo oportunidad de ejecutarse en absoluto. Una explóración
anterior puede pertenecer a cualquiera de las clases de scan definidas.
Utilice puntos de rendimiento para cónfigurar las clases de scan. Si una explóración dura
demasiado, es posible que la siguiente se omita, lo que próduciría una perdida de datos. Puede
ajustar las clases de scan cambiando la frecuencia de explóración, el desplazamiento y el
numeró de tags en la lista de explóración. Para obtener mas infórmación sobre la cónfiguración
de clases y las listas de explóración, consulte el manual de su interfaz.

PI interfaces
Administración de equipos de fuentes de datos

Las fuentes de datos incluyen Sistemas de Control Distribuido (DCS), Controladores Lógicós
Programables (PLC), sistemas de laboratorio, Sistemas de Control de Supervisión y Adquisición
de Datos (SCADA), modelos de proceso y otros sistemas de infórmación empresarial.
Puede anadir equipos nuevos, eliminar equipos antiguos cuando se vuelvan obsoletos o
sustituir un instrumento por otro.
En esta sección
• Anadir equipos nuevos
• Eliminación de equipos obsoletos
• Sustitución de equipos
Añadir equipos nuevos

Cuando el equipo nuevo se conecte, cónfigure PI System para que lo reconozca y cónfigure
puntos para recopilar datos:
1. Conecte el equipo a un nodo de interfaz e instale el software de interfaz adecuado. Puede

descargar la dócumentación de la interfaz de Sitio web de soporte tecnicó de OSIsoft
(https://techsupport.osisoft.com).
2. Si se trata de un nuevo nodo de interfaz, instale PI ICU y cónfigure la autenticación.
autenticación. Para contar con un entorno mas seguro, OSIsoft recomienda Windows
Integrated Security.
Nota:
PI API 2016 for Windows Integrated Security amplía la autenticación de Windows a
las aplicaciones cliente basadas en API. Si elige instalar PI API 2016 for Windows
Integrated Security, solo puede utilizar Windows Integrated Security para la
autenticación. Tanto los trusts como los nombres de usuario explícitós fallaran. Para
obtener mas infórmación, consulte "Cónfiguración de seguridad" in Live Library
Para usar los trusts para la autenticación, consulte Trusts predeterminados.
3. Instale la interfaz.
4. Registre y cónfigure la interfaz con PI ICU.
5. Cónfigure el almacenamiento en bufer si no se esta ejecutando mas en este nodo de interfaz.
Consulte PI Buffering User Guide para obtener instrucciones.
6. Cree nuevos puntos para llevar los datos desde el equipo hasta PI Data Archive (consulte
Creación de puntos).
Eliminación de equipos obsoletos

Si no retira los puntos obsoletos, PI System seguira intentando obtener valores de ellos, lo cual
repercute en el rendimiento del sistema y puede provocar una perdida de datos de otros
puntos. Vease Retirada de un punto con Point Builder.

PI interfaces
Sustitución de equipos
Si sustituye un instrumento por otro distinto que mida el mismo valor de proceso, es mejor
seguir utilizando el mismo punto.
Edite el punto como sea necesario para obtener los nuevos datos. Si el instrumento es
significativamente distinto, puede ser necesario ajustar los atributos de cómpresión y
excepción, entre otros. No cambie el atributo Name (a veces denominado Tag). Cuando cambie
el punto, inserte un evento digital en los datos para indicar cuandó tuvo lugar la transición del
antiguo instrumento al nuevo.
Documentación adicional sobre las interfaces

Cada PI interface tiene un documento propio en el que se describe cómó cónfigurar la interfaz.
Ademas, los siguientes manuales de OSIsoft proporcionan infórmación general sobre la
cónfiguración y la administración de la interfaz. Se encuentran disponibles en Sitio web de
soporte tecnicó de OSIsoft (https://techsupport.osisoft.com).
• PI API Installation Instructions

En Windows, el kit de instalación de PI SDK instala este manual en el directorio pipc\bin.
En el manual se incluyen varios detalles importantes relacionados con el momento posterior
a la instalación para cónfigurar PI API y el almacenamiento en bufer.
• PI Buffering User Guide

En este manual se explica cómó cónfigurar el almacenamiento en bufer para las interfaces.
• UniInt Interface User Manual

La mayóría de las interfaces se basan en OSIsoft Universal Interface (UniInt) y, por lo tanto,
comparten un conjunto cómun de características. Determinadas funciones de UniInt se
pueden describir con mayor detalle en el documento UniInt Interface User Manual que en la
dócumentación específica de la interfaz. Sin embargo, no todas las características que se
describen en UniInt Interface User Manual se admiten en todas las interfaces de UniInt.
• PI Interface Configuration Utility User Manual

PI Interface Cónfiguratión Utility proporciona una interfaz de usuario grafica para
cónfigurar la línea de comandos de la interfaz, los servicios de la interfaz y varios PI points
que son utiles para supervisar el rendimiento de la interfaz.
• PI Performance Monitor Interface to the PI System

PI Performance Monitor Interface, PIPerfMon, obtiene los datos del contador de
rendimiento de Microsoft Windows y los envía a PI System.
• Interface Status Interface to the PI System

PI Interface Status Utility es una interfaz que se ejecuta en el nodo de PI Server. La utilidad
escribe eventos, como “ISU Saw No Data”, en los PI Points que no recibieron valores para un
períódó que se puede cónfigurar en una interfaz específica.
• PI AutoPointSync for Interfaces and PI COM Connectors

Algunas interfaces (como la interfaz OPC) admiten la sincrónización autómatica de puntos.
PIAutoPointSync (PIAPS) es una utilidad que sincroniza PI points para una interfaz
mediante el uso de definiciónes de tag en la fuente de datos de la interfaz.

PI interfaces
• Sitio web de soporte técnico

Proporciona una pagina de producto dedicada a las PI interfaces y una pagina de recursos
para gestores de PI System. Ademas de infórmación sobre nuevos lanzamientos, puede
obtener infórmación sobre PI ICU y otras herramientas.
• Serie de interfaces Quickstart

La serie Quickstart esta disenada para aquellos que estan familiarizados con los aspectos
basicós de las PI interfaces (cónfiguración de autenticación y creación de servicios) y desean
ver un ejemplo específicó de cónfiguración de tag. Si usted no esta familiarizado con la
cónfiguración de interfaces, consulte la dócumentación completa de la interfaz para obtener
instrucciones detalladas.
Los siguientes vínculós de las series Quickstart lo llevan a Sitio web de soporte tecnicó de
OSIsoft (https://techsupport.osisoft.com).
◦ Interfaz de PI OPC: ejemplo de tag de infórmación (https://techsupport.osisoft.com/
Troubleshooting/KB/KB00772)
◦ Interfaz de PI UFL: ejemplo de cónfiguración (https://techsupport.osisoft.com/
◦ Interfaz de PI RDBMS: ejemplo de tag de salida (https://techsupport.osisoft.com/

PI interfaces

Supervisión de PI Data Archive
En esta sección
• Supervisión de los contadores de rendimiento de Windows
• Mensajes de PI System
• Verificación de estado diaria de PI Data Archive
• Historial de cónexión
• Administre la fragmentación de los archivos de PI Data Archive
Supervisión de los contadores de rendimiento de Windows

Para recopilar estadísticas sobre cómó esta funcionando su sistema PI Data Archive, utilice los
contadores de rendimiento de Windows. Vea los datos de estos contadores de cualquiera de las
siguientes maneras:
• Ejecute Performance Monitor Interface (PIPerfMon) y este óbtendra datos de los contadores
de rendimiento de Windows para los cuales crea PI points en PI SMT.
Puede crear PI points para los contadores de rendimiento de PI System, así como para los
contadores de Windows, como uso de la CPU. Para observar las tendencias de rendimiento,
cree una pantalla de PI Vision o PI ProcessBook que contenga esos puntos.
• Utilice el monitor de rendimiento de Windows.
En esta sección
• Que contadores de rendimiento supervisar
• Cónfiguración de la interfaz PIPerfmon
• Creación de puntos de mónitórización de rendimiento
• Utilizar una tendencia para supervisar los puntos de rendimiento
Qué contadores de rendimiento supervisar

OSIsoft recomienda que supervise los siguientes contadores de rendimiento.
Contador de rendimiento Descripción
PI Archive Subsystem
Archived Events/sec Tasa de incórpóración correcta de eventos al archivo históricó.
Archiving Indica si los datos se estan archivando. Existen algunas situaciones
en las que el archivado se encuentra desactivado, por ejemplo,
durante un intercambio de archivo históricó. Pero, si permanece
desactivado, debe averiguar el motivo.
Cache Flush Operations/sec Velocidad a la que los puntos se transfieren de la cache de archivo
históricó a disco.
Cache Record Count Registros de cache de archivo históricó en memoria
Corrupted Archives Count Numeró de archivos que se sabe que estan danadós.
Events Read/sec Tasa de eventos de archivo históricó leídós.
Failed Archive Shift Indica si se produjo un error en el intercambio de archivo históricó
mas reciente. Si se produjo un error, debe investigar la causa, por
ejemplo, la falta de recursos del sistema.


Failed Events/sec Cantidad de eventos que generaron error que se agregaran a la
memoria o a un ficheró de archivado.
Out of Order Events/sec Numeró de eventos incorrectos publicados en el archivo históricó.
Primary Archive % Used Porcentaje de registros utilizados en el ficheró de archivado
primario.
Record Load Time Average Es util para resolver posibles problemas de rendimiento.
Time to Archive Shift Numeró de segundos hasta el cambio previsto del archivo históricó.
Este tiempo no se calcula si esta ocupado menos del 10 % del
Total Unflushed Events Numerós de eventos sin transferir.
PI Backup Subsystem
Backups Started Numeró de copias de seguridad que se iniciaron. Se restablece en 0
cuando se reinicia PI Backup Subsystem.
Failed Backups Cantidad de copias de seguridad que generaron error. Se restablece
en 0 cuando se reinicia PI Backup Subsystem. No refleja errores de
pisitebackup.bat y copias de seguridad de terceros.
Last Backup Failed Especifica si se produjo un error en la ultima copia de seguridad (1)
o no (0). No refleja errores de pisitebackup.bat y copias de
seguridad de terceros.
Verificatión Failures Numeró total de errores en la verificación.
PI Base Subsystem
Module Count Numeró de módulós en PI Module Database. Se restablece en 0
cuando se reinicia PI Backup Subsystem.
Point Count Numeró total de puntos definidós. Este numeró incluye el recuento
de puntos conectores.
PI Network Manager
Total_Receive Errors Numeró de veces que se produce un error mientras PI Network
Manager recibe un mensaje.
Total_Send Errors Numeró de veces que se produce un error mientras PI Network
Manager envía un mensaje.
Estadísticas de PI Server
Is Available Indica si el servidor esta disponible.
Is In Sync Indica si el servidor esta sincronizado con otros miembros del
colectivo.
Estadísticas de PI Session
Bytes Received/Sec Numeró de bytes recibidos por la sesión de PI Data Archive.
Bytes Sent/Sec Numeró de bytes enviados por la sesión de PI Data Archive.
Messages Received/Sec Numeró de mensajes recibidos por la sesión de PI Data Archive.
Messages Sent/Sec Numeró de mensajes enviados por la sesión de PI Data Archive.
Receive Errors Numeró de veces que se produce un error mientras la sesión de PI
Data Archive recibe un mensaje.
Send Errors Numeró de veces que se produce un error mientras la sesión de PI
Data Archive envía un mensaje.
PI Snapshot Subsystem
Event Queue Error Count Cantidad de veces que ócurrió un error al leer o escribir una cola de
eventos.
Event Queue Reset State Indica si la cola de eventos se esta restableciendo actualmente como
resultado de un error (1) o no (0).


Events in Overflów Queues Numeró de eventos en los archivos de cola de desbordamiento. Este
valor debe ser cero cuando PI Data Archive procesa datos entrantes
de manera correcta. Si este valor comienza a aumentar, puede
indicar problemas con archivos danadós o colas de eventos, u otro
problema que este causando inconvenientes en PI Archive
Subsystem con el procesamiento de datos nuevos.
Events in Primary Queue Numeró de eventos en el archivo de cola primaria.
GetSnapshots/sec Tasa de eventos leídós desde el snapshot.
Number of Overflów Queues Numeró de archivos de cola de desbordamiento (0 si solo esta activa
la cola primaria).
OutOfOrderSnapshots/sec Eventos incorrectos enviados al snapshot.
Reset Folder Count Cantidad de carpetas de restablecimiento de cola de eventos en
almacenamiento actualmente.
Queued Events/sec Eventos enviados a la cola de eventos.
Snapshots/sec Eventos enviados al snapshot.
Caché (contador de Windows)
Copy Read Hits % Tasa de exitó para encontrar detalles en la cache del sistema de
archivos y, por lo tanto, la eficiencia de la cache.
Logical Disk (contador de Windows)
Free MegaBytes Cantidad de espacio sin asignar en la unidad del disco del equipo PI
Data Archive. Si este es inferior a 500 MB, libere espacio al ajustar el
tamanó de la cola de eventos o del archivo históricó.
Memoria (contador de Windows)
Available MBytes Cantidad de memoria física inmediatamente disponible. Si este valor
permanece en cero durante mas de 30 minutos, analice y ajuste las
cargas.
Private Bytes Observe el uso de CPU de cada uno de los subsistemas principales.
Proceso (contador de Windows)
Elapsed Time (process) Numeró de segundos en que un proceso se ha estado ejecutando. Si
esto es erróneó u obsoleto, tal vez deba reiniciar los siguientes
procesos:
• PI Archive Subsystem (piarchss)
• PI Base Subsystem (pibasess)
• PI Message Subsystem (pimsgss)
• PI Network Manager (pinetmgr)
• PI Snapshot Subsystem (pisnapss)
Procesador (contador de Windows)
Total_%Processor Time Cantidad de uso del procesador. Para calcular este valor, se obtiene el
porcentaje de tiempo en que el procesador esta ocupado ejecutando
el subproceso inactivo y, luego, se resta dicho porcentaje del 100 %.
Sistema (contador de Windows)
System Up Time Numeró de segundos en que el equipo se ha estado ejecutando desde
que se inició por ultima vez. Si este valor es erróneó u obsoleto, es
posible que haya problemas en el sistema operativo.
En esta tabla solo se enumera un subconjunto de los contadores de rendimiento de PI. Para
obtener una lista completa, consulte el tema de Servidor PI, "Contadores de rendimiento de
PI Performance" in Live Library (https://livelibrary.osisoft.com).

Configuración de la interfaz PIPerfmon

Cuando ejecuta la interfaz PIPerfMon, se generaran datos de PI points que usted asignó a los
contadores de rendimiento de Windows.
Procedimiento
1. Inicie PI Interface Cónfiguratión Utility (ICU).
2. Haga clic en el bótón para crear una interfaz . Se abrira la ventana Configure a New
Interface.
3. Haga clic en Browse y desplacese a la ubicación del ejecutable PIPerfmon.
Por defecto, el programa de instalación busca el ejecutable PIPerfmon en el directorio PIPC
en Interfaces\PIPerfMon.
4. Seleccione el ejecutable y haga clic en Open.
5. Introduzca las propiedades de interfaz:
◦ Para Host Data server/collective, seleccione el PI System anfitrión.
◦ Opcionalmente, en Interface name as displayed in the ICU, introduzca un nombre
descriptivo para la interfaz, como Performance Monitor Interface o PIPerfmon.
◦ En Point, introduzca un origen de punto. El origen de punto predeterminado para
PIPerfmon es el símbóló (#).
◦ En Interface ID, introduzca una ID de la interfaz. Si no esta seguro de que numeró
introducir, haga clic en el bótón Suggest y PI ICU intróducira uno autómaticamente.
6. Haga clic en Add.
8. Haga clic en el bótón de nueva clase de scan e ingrese una frecuencia de clase de scan
adecuada para la interfaz.
Por ejemplo, para realizar un scan por minuto, ingrese:
00:01:00
9. Haga clic en Apply.
10. Haga clic en el encabezado Service, en el lado izquierdo de PI ICU.
11. Introduzca un nombre de usuario y cóntrasena para una cuenta de Windows con privilegios
administrativos en el servidor PI Data Archive.
Esta cuenta es necesaria porque la interfaz se ejecuta como un servicio Windows.
12. Haga clic en Create para instalar la interfaz.
13. Para iniciar la interfaz, haga clic en el bótón de la barra de herramientas Start interface
service, en la parte superior de PI ICU.
Creación de puntos de monitorización de rendimiento

Utilice PI SMT para crear PI points y realizar un seguimiento de los datos del contador de
rendimiento que recopila la interfaz PIPerfmon.

Procedimiento
1. Para iniciar PI SMT, seleccione Start > All Programs > PI System > PI System Management
Tools.
2. Seleccione el servidor PI Data Archive en el que desea crear los puntos de rendimiento.
3. Expanda IT Points y seleccione Performance Counters.
4. En la pestana Tag Settings, seleccione una PI Performance Monitor Interface existente.
Si no aparecen interfaces en la lista, asegurese de que PIPerfmon este instalada y
ejecutandóse en el servidor PI Data Archive. Puede cónfigurar PIPerfmon mediante el uso de
PI Interface Cónfiguratión Utility (ICU). Para obtener mas infórmación, consulte
Cónfiguración de la interfaz PIPerfmon.
5. Haga clic en la pestana Build Tags y seleccione los puntos de mónitórización de rendimiento
que desee crear de la lista de contadores disponibles. Consulte Que contadores de
rendimiento supervisar.
6. Haga clic en Create Tags para crear los puntos de mónitórización de rendimiento.

Para ver los valores actuales de los puntos de mónitórización de rendimiento, en PI SMT
seleccione Data > Current Values y utilice la busqueda de tag para encontrar sus puntos.
A fin de monitorizar los datos que registraron estos puntos, cree tendencias en PI ProcessBook
o PI Vision.
Utilizar una tendencia para supervisar los puntos de rendimiento

Puede utilizar PI Vision o PI ProcessBook para crear una pantalla que supervise los datos de los
puntos de PI Performance Monitor de manera que usted pueda verificar PI Data Archive de un
vistazo. Una pantalla que utilice un objeto multiestado para cada contador de rendimiento y
muestre un color específicó para los datos que indican un problema pódría ayudarlo a
identificar los problemas de un vistazo. Para obtener infórmación sobre cómó crear pantallas,
consulte el tema de PI Vision, "Visualización de datos de proceso con símbólós" in Live Library
En la siguiente ilustración, se muestra un ejemplo del uso de la pantalla de PI ProcessBook para
realizar el seguimiento de las tendencias de rendimiento.

Tambien puede crear nótificaciónes en PI Asset Framework para recibir correos electrónicós
cuando haya problemas en cualquiera de los contadores de rendimiento. Para hacerlo, debe
instalar PI Asset Framework y es posible que primero deba cónfigurar los analisis y event
frames. Para obtener mas infórmación, consulte el tema de PI Server "Cónfiguración de reglas
de nótificación para analisis o event frames" in Live Library (https://livelibrary.osisoft.com).
Mensajes de PI System
Todos los procesos de PI Data Archive envían mensajes a PI Message Subsystem, que escribe
mensajes en el registro de mensajes de PI. Diversas herramientas y utilidades pueden consultar
el registro de mensajes. El archivo de definición de mensajes de PI contiene ID de mensajes y
definiciónes.
En esta sección
• Ver mensajes de PI Data Archive con PI SMT
• Ver mensajes en el registro de eventos de Windows
• Estructura de mensaje
• Niveles de gravedad
• Archivo de definición de mensajes de PI
• Interpretar códigós de error
• Verificaciónes de estado del subsistema (mensajes de error de RPC resolver)
• Cónvención de nomenclatura de archivos de registro
Ver mensajes de PI Data Archive con PI SMT

Utilice PI System Management Tools (PI SMT) para buscar mensajes en todos los servidores y
colectivos PI Data Archive seleccionados. Consulte la sección Ayuda de PI SMT para obtener
mas infórmación acerca del uso de esta herramienta.

Procedimiento
1. Ejecute PI SMT.
2. Seleccione Operation > Message Logs.
Ver mensajes en el registro de eventos de Windows

Cuando PI Message Subsystem no esta disponible, los componentes de PI Data Archive escriben
mensajes en el registro de eventos de Windows. Puede ver estos mensajes con el visor de
eventos de Windows si esta ejecutando PI Data Archive como servicio o con las ventanas de
comandos si esta ejecutando PI Data Archive de manera interactiva. Cuando se inicia PI
Message Subsystem, este fusiona mensajes del registro de eventos de Windows en el registro
de mensajes.
Nota:
Durante el inicio, algunos componentes pueden escribir mensajes en el registro de
eventos de Windows antes de que se inicie PI Message Subsystem.
Estructura de mensaje
Los mensajes contienen la siguiente infórmación:
• Gravedad
Uno de los siguientes niveles de gravedad (pigetmsg muestra el nivel de gravedad en un
códigó de una sola letra):
◦ Críticó (C)
◦ Error (E)
◦ Advertencia (W)
◦ Infórmación (I)
◦ Depurar (D)
• Marca de tiempo
La hora en que el componente escribió el mensaje.
• Origen
El componente que escribió el mensaje.
• ID de mensaje
El identificadór unicó de un tipo de mensaje en particular.
• Texto
El texto del mensaje, que describe el evento.
Por ejemplo:
C 23-Jul-08 09:27:46.243 piarchss:piarcmgr (2050)
>> Primary archive file failed to load or has invalid dates. Archiving will be
turned off.

Niveles de gravedad
Nivel de gravedad Descripción
Críticó Perdida de funcionalidad del sistema. Requiere atención inmediata.
Error Se produjo un error en la acción.
Advertencia Se produjo una anómalía que no afecta el usuario.
Infórmación Infórmación sobre la acción, como un inicio de sesión correcto o incorrecto.
Depuración Mensaje de depuración/seguimientó.
En los mensajes, el caracter de la izquierda indica el nivel de gravedad Por ejemplo:

• Críticó
C 23-Jul-08 09:27:46.243 piarchss:piarcmgr (2050)
>> Primary archive file failed to load or has invalid dates. Archiving will
be turned off.
• Error
E 23-Jul-08 09:27:46.243 piarchss:piarcmgr (2049)
>> Failed to load archive file F:\PI archives\8-Sep-04_14-Sep-04: [3] The
system cannot find the path specified.
• Advertencia
W 23-Jul-08 09:41:32.733 piarchss:pievqreader (6012)
>> Invalid queue creation path "E:\PI\dat\", using default location
• Infórmación
I 29-Jul-08 18:31:53.211 pinetmgr (7039)
>> Connection accepted: Process name: pigetmsg(6260) ID: 3
• Depuración
D 29-Jul-08 15:22:59.421 pibackup (5136)
>> PIvsswriter::OnFreeze. succeeded
Archivo de definición de mensajes de PI

El archivo de definición de mensajes almacena infórmación sobre los mensajes. Esta base de
datos asocia un ID de mensaje con cada mensaje, junto con el texto, los parametrós, la gravedad
y demas infórmación del mensaje. El archivo de definición de mensajes se denomina
pimdf.dat y se almacena en el directorio PI\dat.
Cada instalación de producto puede actualizar la definición con nuevos mensajes. Si el archivo
de definición de mensajes no esta presente o corresponde a una versión anterior, algunos
mensajes pueden no estar disponibles para convertirse en texto legible. En este caso, el
mensaje se leera de un modo similar al siguiente:
E 29-Jul-08 17:44:17 pibasess (8020)
>> Unknown Message # 8020
Para ver que versión del archivo de definición de mensajes esta instalada, escriba:
pidiag -mdfv
Interpretar códigos de error

Use la utilidad pidiag para interpretar los códigós de error incluidos en los registros de
mensajes.
Para visualizar el mensaje de error, ingrese:
pidiag -e errorcode

donde errorcode es el numeró de error que se aparece en el registro de mensajes. Los valores
de códigó de error pueden ser positivos o negativos.
Por ejemplo, si el códigó de error es -11137, ingrese:
pidiag -e -11137
[-11137] Primary archive is Read-only. Archiving and archive shifts disabled.
Tambien puede utilizar la utilidad pidiag para traducir códigós de error del sistema operativo,
que siempre son numerós positivos.
Verificaciones de estado del subsistema (mensajes de error de RPC resolver)

Cada pocos minutos, pinetmgr envía un mensaje de verificación de estado a cada uno de los
subsistemas PI Data Archive. Si pinetmgr no recibe una respuesta en una determinada
cantidad de tiempo, genera el siguiente menaje y el subsistema (RPC resolver) se marca como
desconectado:
>> Deleting connection: pisnapss, Subsystem Healthcheck failed.
Si se realiza una llamada de procedimiento remoto (RPC) a un subsistema que esta marcado
como desconectado, vera este mensaje:
[–10733] PINET: RPC Resolver is Off–Line
El resultado incluira detalles solo si se recuperó la primera parte del mensaje. En este ejemplo,
el mensaje contiene la longitud del mensaje. Sin embargo, se agótó el tiempo de espera cuando
pinetmgr intentó recuperar el resto del mensaje:
>> Deleting connection: pisnapss, Connection lost(1),
[-10731] PINET: incomplete message
Convención de nomenclatura de archivos de registro

Durante el funcionamiento normal, PI Message Subsystem conserva archivos de registro
centrales para los mensajes de todos los subsistemas PI Data Archive. PI Data Archive crea un
nuevo archivo de registro todos los días, en formato de hora universal coordinada (UTC), coloca
los archivos de registro en el directorio PI\log y asigna un nombre a cada registro de acuerdo
con la fecha. Los nombres de archivos utilizan el formato pimsg_YYYMMDD.dat, donde:
• YYY corresponde a los anós desde 1900. Por ejemplo, si el anó es 2016, YYY es 116.
• MM corresponde al mes. Por ejemplo, si el mes es enero, MM es 01.
• DD corresponde al día. Por ejemplo, si es el quinto día del mes, DD es 05.
Por ejemplo, el archivo de registro del 5 de enero de 2016 recibe el nombre
pimsg_1160105.dat.
Utilice la herramienta PI SMT Message Logs o la utilidad pigetmsg para ver los archivos de
registro de mensajes y buscar mensajes. PI Data Archive debe estar ejecutandóse para ver los
mensajes.
De manera predeterminada, PI Data Archive crea un nuevo archivo de registro cada día, lo
almacena durante 35 días y luego elimina autómaticamente los archivos de registro. Para
conservar los archivos de registro durante mas de 35 días, módifique el parametró de ajuste
MessageLog_DayLimit (hasta 10 000 días).
Verificación de estado diaria de PI Data Archive

OSIsoft recomienda que verifique regularmente los elementos clave de su sistema PI Data
Archive. Este proceso se ha denominado tradicionalmente daily health check aunque la mayóría

de las verificaciónes no necesitan realizarse diariamente. Estas verificaciónes le permiten

identificar y resolver posibles problemas antes de que estos sean graves. Tambien puede
determinar cómó funciona su sistema PI Data Archive en condiciones normales y establecer
una base de referencia para utilizar al cónfigurar la supervisión autómatica.
Diariamente
Componente Tarea Herramientas Para obtener más
información
Archivos históricós Verifique que no existan archivos históricós PI SMT: Operation > Consulte Archivos
danadós y especialmente que: Archives históricós
• El archivo primario no este danadó. piartool -al
• Si esta reponiendo datos, que el archivo
históricó en el que esta reponiendo
datos no este danadó.
La herramienta PI SMT Archives marca los
archivos históricós danadós y le permite
reprocesarlos mientras estan conectados.
Copias de seguridad Verifique que las copias de seguridad PI SMT: Operation > Consulte Copias de
programadas se hayan estado ejecutando y Backups seguridad de PI Data
que tenga espacio en disco suficiente para Archive
piartool -al
las copias de seguridad futuras.
Semanalmente o con mayor frecuencia

Componente Tarea Herramientas
Registros de mensajes de PI System Revise los registros de mensajes del PI SMT: Operation > Message Logs
sistema al menos una vez por
pigetmsg
semana para detectar errores
críticós y eventos inusuales.
Registros de la interfaz Verifique los registros de la interfaz PI SMT: Operation > Message Logs
para detectar errores críticós y
eventos inusuales.
Flujo de datos de Snapshot Determine si el flujó de datos de PI SMT: Operation > Snapshot and
Snaphot es normal. Archive Statistics
piartool -ss
Contadores de velocidad de E/S Los puntos de velocidad de E/S PI DataLink o PI ProcessBook

supervisan el flujó de datos de una
interfaz. Cada 10 minutos, cada
punto de velocidad de E/S registra
la velocidad promedio de
transferencia de datos hacia PI
Server en ese periodo de 10 minutos
en eventos/segundo. Si el valor deja
de actualizarse en PI, es posible que
la interfaz haya dejado de obtener
datos.
Mensualmente
Límites de licencia y uso Realice estadísticas de uso y PI SMT: Operation > Licensing
verificaciónes de conteo de puntos
piartool -lic
mensuales para que su PI System
anticipe las necesidades de aumento
de licencia.

En la instalación inicial
Contadores de rendimiento Utilice contadores de rendimiento Interfaz de Windows Performance
(Windows) clave de Windows para revisar Monitor, PI Performance Monitor
estadísticas sobre todos los (PerfMon)
subsistemas.
Según sea necesario

Datos de PI point Asegurese de que las referencias de PI SMT: Data > Current Values
los datos de PI point se esten
pisnap.bat
actualizando.
pisnap.sh
Conexiones de cliente Si tiene problemas de flujó de datos PI SMT: Operation > Update
de cliente, verifique las conexiones Manager
de cliente con PI Data Archive.
pilistupd
Historial de conexión
PI Data Archive almacena el historial de conexiones de los clientes, las interfaces y otras
aplicaciones. Este historial se almacena en su equipo local y los datos se conservan durante
1 anó de manera predeterminada. Puede acceder a estos datos para contar las conexiones del
cliente y la infórmación asociada de períódós específicós y, opcionalmente, escribir la
infórmación en un archivo.
Use el comando pidiag para recuperar la infórmación histórica de conexiones, por ejemplo:
• la dirección IP;
• el nombre del archivo ejecutable de la aplicación conectada (producto);
• la hora de inicio de la cónexión;
• la hora de finalización de la cónexión (si ya se descónectó);
• la infórmación sobre la licencia.
Para obtener infórmación sobre las opciones del comando pidiag que sirven para personalizar
su consulta, vea el tema de referencia PI Data Archive "Infórmación histórica de conexiones" in
Live Library (https://livelibrary.osisoft.com). Por ejemplo, el comando siguiente devuelve
infórmación acerca de las conexiones realizadas durante un intervalo de tiempo especificadó.
Muestra conexiones exclusivas del producto entre el 30 de marzo de 2017, a las 10:50 a. m. y el
31 de marzo de 2017, a las 10:50 a. m.
pidiag -connectionhistory -u -s "30-Mar-17 10:50:00" -e "31-Mar-17 10:50:00"
Start time: 30-Mar-17 10:50:00
End time: 31-Mar-17 10:50:00
Product Number of node IPs Node IP address[es]
PI-IN-OS-RMP 1 127.0.0.1
pibasess 1 127.0.0.1
pimsgss 1 127.0.0.1
piarchss 1 127.0.0.1
PIPC Log Server 1 127.0.0.1
Number of unique products: 5

Administre la fragmentación de los archivos de PI Data

Archive
La fragmentación puede llevar a la degradación del rendimiento de lectura y escritura. A fin de
alcanzar un rendimiento óptimó del sistema, OSIsoft recomienda detectar y reducir la
fragmentación con regularidad. Los archivos de datos del futuro y los archivos históricós con
archivado autódinamicó es probable que incurran en fragmentación. La fragmentación no suele
ser un problema de los archivos históricós de tamanó fijó.
Nota:
Los tipos de ficheró de archivado aparecen en la herramienta Archives de PI SMT, en la
columna Type. Si la columna Type no esta visible, haga clic con el bótón derecho sobre los
encabezados de columna y elija Type.
Para controlar la fragmentación, realice el reprocesamiento en línea de los archivos históricós
que esten muy fragmentados unicamente. El reprocesamiento en línea asigna sectores
contiguos nuevos para los ficherós de archivado que usted reprocese. Este metódó le permite
mantener los datos en línea y, en consecuencia, disponibles lo maximó posible.
Procedimiento
1. Defragmente la unidad y ejecute los procesos de analisis y defragmentación.
Nota:
Los ficherós de archivado registrados con el servidor PI Data Archive se analizan pero
no se defragmentan, porque estan bloqueados.
2. Utilice el informe de fragmentación para identificar los ficherós de archivado que esten muy
fragmentados.
3. Reprocese esos ficherós de archivado en línea.
Para obtener mas infórmación, consulte Reprocesamiento de archivos históricós.

Para realizar una defragmentación total de un sistema PI Data Archive completo, se debe
detener el servidor de PI Data Archive. Mientras este detenido, se pueden defragmentar todos
los archivos. Puede ser conveniente hacerlo cuando tenga tiempo de inactividad del sistema
programado para mantenimiento.
Para situaciones mas complicadas, cómuníquese con el soporte tecnicó de OSIsoft. Consulte la
Pagina de contacto de soporte tecnicó de OSIsoft (https://techsupport.osisoft.com/Contact-
Us/).

Parámetros de ajuste de PI Data Archive
La mayóría de los servidores PI Data Archive no requieren ajustes y funcionan correctamente
con la cónfiguración predeterminada. Sin embargo, usted puede ajustar los parametrós de
ajuste PI Data Archive si es necesario. Los valores del parametró de ajuste se preservan durante
las actualizaciones.
Utilice la herramienta Tuning Parameters de PI SMT para visualizar y editar la cónfiguración de
los parametrós de ajuste.
En esta sección
• Parametrós de ajuste que pueden cónfigurarse
• Editar parametrós de ajuste
• Agregar un parametró de ajuste a la lista
Parámetros de ajuste que pueden configurarse

De manera predeterminada, cada pestana de la herramienta Tuning Parameters proporciona
una lista de la cónfiguración de servidor mas cómunmente utilizada para cada categóría. La
cónfiguración se muestra en estas pestanas:
• General: herramienta de línea de comandos y cónfiguración de aplicaciones del servidor.
• Archive: cónfiguración de PI Archive Subsystem.
• Backup: cónfiguración de PI Backup Subsystem.
• Base: cónfiguración de PI Base Subsystem, incluidos los parametrós de Module database.
• Net Manager: cónfiguración de PI Network Manager.
• Snapshot: cónfiguración de PI Snapshot Subsystem, incluida la cónfiguración de la cola de
eventos para los valores almacenados en bufer que aun no se archivaron.
• Update Manager: cónfiguración de Update Manager que afecta a programas que se
suscriben a actualizaciones de datos o puntos, que incluyen ProcessBook y la mayóría de las
interfaces.
• Security: los ajustes de seguridad que afectan la autenticación, las PI identities y las
asignaciones.
Si el parametró de ajuste que desea utilizar no se muestra en estas listas, puede agregarlo.
Editar parámetros de ajuste

Procedimiento
1. En PI System Management Tools, seleccione Operation > Tuning Parameters.
2. En el panel Collectives and Servers, seleccione el servidor PI Data Archive en el que desea
editar el parametró.
3. Desactive las casillas de verificación para todos los demas servidores PI Data Archive.
4. Haga clic en la pestana del subsistema en el que desea editar el valor de un parametró de
ajuste.
5. Si es necesario, Agregar un parametró de ajuste a la lista.

Parámetros de ajuste de PI Data Archive
6. Haga clic con el bótón derecho en un parametró existente de la lista y seleccione Edit.
7. Ingrese un valor y haga clic en OK.

Algunos cambios realizados en los parametrós de ajuste no surtiran efecto hasta que reinicie PI
Data Archive o el subsistema asociado. Algunas aplicaciones que ya estaban conectadas
reflejaran las ediciones realizadas en el parametró de ajuste una vez usted vuelva a conectarse.
Agregar un parámetro de ajuste a la lista

De manera predeterminada, en la lista de Parametrós de ajuste de PI SMT solo se muestran los
parametrós de ajuste utilizados con mas frecuencia. Si necesita módificar un parametró de
ajuste que no se encuentra en la lista, cómuníquese con soporte tecnicó OSIsoft.
Procedimiento
1. En el panel Collectives and Servers, seleccione el servidor PI Data Archive en el que desea
agregar el parametró.
2. Desactive las casillas de verificación para todos los demas servidores PI Data Archive.
3. En la barra de herramientas, haga clic en el icono New Parameter ( ).
4. En Parameter name, seleccione el parametró que desea agregar a la lista. Si conoce el

nombre, puede ingresarlo exactamente.
5. Opcional: ingrese un valor para el parametró de ajuste.
6. Haga clic en OK. El parametró se agregara a la lista.
7. Detenga y reinicie el servidor PI Data Archive o el subsistema relacionado con el parametró
actualizado.

PI SQL Subsystem
PI SQL Subsystem (pisqlss) prepara y ejecuta sentencias SQL para que PI Data Archive las
ejecute. Los usuarios primarios de este subsistema son PI ODBC driver y PI SDK. Este
controlador cumple con las normas de ODBC API y permite que los datos de PI aparezcan
organizados en tablas de datos. La versión PIODBC1.1.2 o una posterior es necesaria para
conectarse a PI Data Archive.
La implementación de SQL de OSIsoft otorga a las aplicaciones acceso a PI Point Database,
snapshot y archivos históricós. Para obtener infórmación de soporte, como detalles de la
implementación de SQL de OSIsoft, consulte PI ODBC Client User Manual.
La capacidad de procesamiento de SQL tambien se implementa en PI System for OpenVMS. Las
diferencias entre las dos se analizan en esta sección.
En esta sección
• Arquitectura de PI SQL Subsystem
• Cónfiguración de PI SQL Subsystem
• Resólución de problemas de PI SQL Subsystem
Arquitectura de PI SQL Subsystem

Indicadores de sentencia
La mayóría de las interacciones entre PI clients y PI Data Archive no requieren que el servidor
conserve registros de la óperación del cliente. Se puede responder a cualquier solicitud de
infórmación sobre puntos o datos de archivos históricós usando solamente la infórmación que
própórciónó el cliente en la solicitud misma.
El procesamiento de sentencias SQL es diferente. Cuando se procesa una sentencia SQL, el
servidor PI Data Archive debe conservar un registro del estado de la sentencia para poder
realizar las operaciones posteriores. Esto se realiza al permitir que PI SQL Subsystem asigne un
indicador de sentencia cuando un cliente inicia el procesamiento de una sentencia SQL. El
cliente conserva el identificadór del indicador y se lo proporciona al servidor con cada
solicitud.
Los detalles de la asignación y anulación de asignación de indicador se administran
internamente mediante una aplicación cliente basada en PI API, como PI ODBC Driver.
Si se pierde la cónexión entre el cliente y PI Data Archive, PI SQL Subsystem conserva los
indicadores de sentencias que asignó el cliente. Estos indicadores se convierten en huerfanós y
no se puede acceder a ellos nuevamente. Se anula la asignación de indicadores cuando se cierra
PI SQL Subsystem. Durante el cierre, pisqlss informa el numeró total de indicadores asignados
durante su ejecución y el numeró de indicadores huerfanós que se abortaron.
Concurrencia
PI SQL Subsystem se encarga del procesamiento de SQL para todas las conexiones cliente en PI
Data Archive.
Operaciones como el analisis de una sentencia SQL y la recuperación de los resultados son
relativamente asequibles. Sin embargo, la ejecución puede tardar tiempo y requerir recursos
del sistema, ya que los datos se obtienen de otros subsistemas.

PI SQL Subsystem
Configuración de PI SQL Subsystem

No necesita ninguna cónfiguración avanzada para iniciar PI SQL Subsystem (pisqlss). Se
inicia y se detiene exactamente de la misma manera que otros subsistemas. En Windows,
pisqlss puede ejecutarse como servicio.
Se pueden realizar algunos ajustes de rendimiento de pisqlss . Se puede cambiar la
cónfiguración mediante el uso de un archivo de inicialización, de parametrós de línea de
comandos pisqlss y a traves de la cónfiguración de un producto cliente, como PI ODBC Driver.
Nota:
El uso de un archivo de inicialización puede cambiar a un metódó alternativo en un
lanzamiento posterior. En ese momento, se migrara la cónfiguración específica del sitio
que se encóntró en el archivo de inicialización.
Consulte la dócumentación del producto cliente para obtener instrucciones sobre cómó
cambiar la cónfiguración de procesamiento de SQL en la aplicación cliente.
En esta sección
• Jerarquía de la cónfiguración de PI SQL Subsystem
• Cónfiguración del archivo de inicialización
• pisqlss
Jerarquía de la configuración de PI SQL Subsystem

Debido a que es posible cónfigurar parametrós mediante el uso de mas de una tecnica, algunas
cónfiguraciónes pueden estar en cónflictó. El valor real de la cónfiguración utilizada sigue este
esquema de prioridades:
• Cónfiguración del archivo de inicialización

• Argumentos de línea de comandos de PI SQL Subsystem (pisqlss)
• Cónfiguración de producto de cliente
Las cónfiguraciónes que figuran mas abajo en la lista anulan las cónfiguraciónes que estan mas
arriba. Por ejemplo, si el tiempo de espera de la consulta SQL se cónfigura en 45 segundos en el
archivo de inicialización y en 60 segundos en la línea de comandos pisqlss, el valor utilizado es
de 60 segundos.
Configuración del archivo de inicialización

El archivo de inicialización se denomina pisql.ini y puede encontrarse en el directorio PI
\dat de su instalación de PI Data Archive. El archivo incluye valores predeterminados para
toda la cónfiguración. Puede editar este archivo para cambiar la cónfiguración.
La cónfiguración del archivo de inicialización se lee cuando se asigna una nueva declaración.
Cualquier cambio realizado en este archivo se reflejara en la próxima declaración nueva.
Nota:
En PI System para OpenVMS, el archivo de inicialización es PISysDat:pisql.ini. La
interpretación de la cónfiguración del archivo es la misma.
Para obtener detalles sobre la cónfiguración, consulte PI ODBC Client User Manual.

PI SQL Subsystem
pisqlss
Esta sección describe la cónfiguración de PI SQL Subsystem (pisqlss) que puede alterarse
usando argumentos de línea de comandos. El mecanismo para especificar argumentos de línea
de comandos difiere entre las plataformas admitidas. En esta sección se describe las tecnicas.
Opciones de línea de comandos de pisqlss

En general, usted especifica una ópción de línea de comandos al usar un token de argumento,
uno o mas espacios y el valor del argumento. El token de argumento siempre comienza con un
guión adelante (-). Por ejemplo:
pisqlss -t 60 -ts 7200 -o trace,aggrtimestart
En este ejemplo, el tiempo de espera de la consulta de SQL esta cónfiguradó en 60 segundos, el

paso de tiempo predeterminado (para las consultas de la tabla piinterp) se cónfigura en
7200 segundos (es decir, 2 horas) y se han cónfiguradó las opciones trace y aggrtimestart.
PI SQL Subsystem (pisqlss) admite los siguientes argumentos de línea de comandos:
Argumento Descripción
-o Opciones (letra "o", no cero). Las opciones se especifican en una lista de
tokens separados por comas. La interpretación de los tokens no distingue
entre mayusculas y minusculas. Consulte la siguiente tabla para conocer la
lista de opciones admitidas.
-t Tiempo de espera de la consulta de SQL, en segundos. Si se agota el tiempo de
espera, PI SQL Subsystem próvócara que la consulta devuelva un error de
tiempo de espera o un subconjunto de resultados reales, si se cónfigura la
ópción SUBSET. Consulte la tabla de opciones a cóntinuación.
-ts Valor predeterminado de la columna de intervalo de tiempo en la tabla
PIINTERP. Este valor puede sobrescribirse para cualquier consulta al
especificar una restricción en el intervalo de tiempo en la sentencia SELECT.
El argumento -o esta seguido de una lista de tokens de ópción separados por comas, sin
espacio entre los tokens. Las opciones admitidas son las siguientes:
Token de opción Descripción
AGGRTIMESTART Permite que todas las consultas de las tablas de agregados usen la hora en
que comienza el intervalo para identificar el agregado; el valor
predeterminado usara la hora en que finaliza el períódó de agregado.
EXECSAFE Si se cónfigura, la consulta no se ejecutara si PI SQL determina que una
consulta es demasiado inespecífica y demóraría demasiado en ejecutarse.
LOG Escribe un resumen de cada óperación por parte de pisqlss en un indicador
de sentencia en el archivo sqltrace.log de su directorio pi\log. Consulte
tambien la ópción TRACE. Este archivo se genera en todas las cónfiguraciónes
de PI Data Archive, excepto mientras no se ejecute como servicio en
Windows. En este caso, la salida se dirige a la salida estandar, que es la
ventana de comandos.
QEP Provoca que la puerta de enlace vuelque un plan de ejecución de la consulta
en un archivo denominado pisql_n.qep en el directorio pi\log, en el
equipo PI Data Archive, en el que n es el numeró de indicador.
SUBSET Si se agota el tiempo de espera de una consulta mientras esta ópción esta
vigente, PI SQL Subsystem devuelve un subconjunto de los resultados reales
sin error. Si esta ópción esta vigente, los resultados que se devuelven no
representan los resultados finales reales de la consulta. Cuando se complete
el desarrollo de la consulta, elimine esta ópción.

PI SQL Subsystem
Token de opción Descripción

TRACE Escribe un resumen de cada óperación de preparación, es decir, del analisis
de consultas y de la óperación de ejecución por parte de PI SQL Subsystem en
el archivo sqltrace.log en su directorio pi\log . Consulte tambien la
ópción LOG.
Iniciar pisqlss como servicio de Windows

Puede iniciar subsistemas al ejecutar Services en Control Panel o al utilizar el archivo
pisrvstart.bat de su directorio PI\adm.
Para enviar argumentos de línea de comandos a PI SQL Subsystem que se ejecutan como
servicio de Windows:
1. En Control Panel, abra Administrative Tools > Services.
2. En la ventana Services, haga clic con el bótón derecho en PI SQL Subsystem y seleccione
Properties.
3. Detenga el servicio e ingrese los argumentos en el cuadro de dialógó Start parameters.
4. Haga clic en Start para reiniciar PI SQL Subsystem.
Nota:
Este metódó funciona solo una vez. Si cierra Services, vuelva a abrir y a seleccionar su
servicio, no vera argumentos de línea de comandos de la ultima ejecución. No puede
utilizar este metódó para proporcionar parametrós de línea de comandos a los servicios
que se iniciaron autómaticamente cuando arranca el sistema Windows.
Iniciar pisqlss en una ventana de comando

Los argumentos de línea de comandos pueden proporcionarse a un programa de Windows al
enumerarlos despues del nombre del programa. Puede editar el archivo pistart.bat para
incluir argumentos de línea de comandos al iniciar subsistemas.
Si inicia de este modo generara una ventana de comandos para cada subsistema. No puede
desconectar Windows en esta cónfiguración y dejar el sistema en ejecución.
Tenga precaución al editar pistart.bat. Este archivo se sobrescribe en cada actualización de
PI Data Archive.
Resolución de problemas de PI SQL Subsystem

Pueden generarse errores inesperados al utilizar una aplicación de ODBC para comunicarse
con PI Data Archive. En esta sección se describen las tecnicas para ayudarle a validar la
óperación de PI SQL Subsystem y registrar sus pasos de procesamiento.
En esta sección
• Archivos de seguimiento de PI SQL
• Borrar problemas de consulta costosos
• Contadores de rendimiento
• Plan de recuperación por cierre o corte de energía inesperado de PI System
• Informes de problemas y soporte tecnicó

PI SQL Subsystem
Archivos de seguimiento de PI SQL

Puede generar un archivo de seguimiento al iniciar PI SQL Subsystem con las opciones LOG o
TRACE.
Las opciones LOG y TRACE son similares. Ambas generan infórmación en el archivo
sqltrace.log en el directorio PI\log\. La ópción LOG proporciona mas detalles. Las
opciones pueden utilizarse en conjunto. El resultado de ambas se intercala.
En esta sección
• Resultado de la ópción TRACE
• Resultado de la ópción LOG
Resultado de la opción TRACE

Al invocar la ópción TRACE, se muestra un resumen de la preparación y ejecución de la
sentencia SQL unicamente.
En esta sección
• Resultado de preparación de la declaración
• Resultado de ejecución de la sentencia
Resultado de preparación de la declaración

Las líneas del resultado poseen la siguiente forma:
Prepare[HandleNum]>[ErrorCode][ElapsedTime] query_strng
El tiempo transcurrido se proporciona en segundos. Por ejemplo:

Prepare[1]>[0][0.012s] select * from picomp
where tag = sinusoid and time > ?
Esta declaración contiene un parametró, identificadó por un signo de interrógación ( ? ), cuyo

valor se proporciona en el tiempo de ejecución. Los parametrós de tiempo de ejecución se
analizan en detalle en PI ODBC Driver Manual.
Resultado de ejecución de la sentencia

Las líneas del resultado poseen la siguiente forma:
Execute[HandleNum]>[ErrorCode][ElapsedTime] Parameters: NParams Columns: Ncols
Rows: Nrows
Si el numeró de los parametrós de tiempo de ejecución no es cero, este mensaje aparecera

seguido de una línea para cada parametró proporcionado:
Pnn [DataType Length] parameter_value
donde nn es el numeró de parametró de tiempo de ejecución, que comienza con 0.

Por ejemplo, el mensaje de Ejecución que sigue al mensaje de Preparación de arriba puede
leerse:
Execute[1]>[0][0.041s] Parameters: 1 Columns: 4 Rows: 16
P00 [time32] 21-Jul-97 00:00:00
La consulta de este ejemplo devólvió 16 filas y 4 columnas. La consulta se própórciónó con un

parametró de tiempo de ejecución: una marca de tiempo.

PI SQL Subsystem
Resultado de la opción LOG

El resultado de la ópción LOG es mas detallado. Refleja directamente la lista de argumentos de
las Llamadas de procedimiento remoto (RPC) que implementa PI SQL Subsystem. La mayor
parte de la infórmación generada debe reenviarse a OSIsoft en el caso de que surjan problemas
de procesamiento de consultas.
En general, el primer argumento de cada RPC es el ID del indicador. La unica excepción es la
función newstatement, que es la rutina que genera el ID del indicador. En este caso, el ID del
indicador devuelto es el segundo argumento.
Formato de resumen de la función

La ópción LOG genera resultados que se parecen a este:
FunctionName(arg1, arg2, ...) [ErrorCode]
Durante la ejecución de las consultas, los mensajes de progreso se escriben en el archivo de

registro. Cada mensaje de progreso posee la siguiente forma:
(HandleId): Calls: n PctDone: n Etime: n Limit: n
Los elementos informados son los siguientes:

• Numeró de llamadas para obtener datos de PI de otros subsistemas.
• Porcentaje de cómpleción, segun un calculó inicial.
• Tiempo transcurrido desde el inicio de la ejecución, en segundos.
• Tiempo de espera (límite) en segundos. Si el numeró es 0, no se cónfiguró ningun límite de
tiempo de espera.
Por ejemplo:
newstatement(8,21) [0]
clear(21,1) [0]
clear(21,0) [0]
Prepare[21]>[0][0.431s] select * from picomp
where tag = "sinusoid" and time > "y"
execute(21,&params) begins...
callback(21): Calls: 1 PctDone: 0 Etime: 1 Limit: 0
fetch(21,*results) [0]
clear(21,1) [0]
Borrar problemas de consulta costosos

Es posible que una aplicación cliente de ODBC envíe a PI Server una consulta incompleta o una
consulta que arroje demasiados resultados. Cuando una consulta agota su tiempo de espera,
esta puede conservarse o no en el recurso del servidor, principalmente en la memoria virtual. Si
el tiempo de espera se agota durante la ejecución de la consulta, el indicador de sentencia y su
recurso se liberan. Si el tiempo de espera se agota durante la recuperación, el indicador de
sentencia no se libera. Para borrar el indicador de sentencia y su recurso, cierre y reinicie PI
SQL Subsystem.
Para hacer esto, envíe un comando de parada a PI SQL Subsystem mediante el uso de uno de
los siguientes metódós:
• En Control Panel > Administrative Tools, ejecute Services. Seleccione PI SQL Subsystem de
la lista y haga clic en Stop.
• En el símbóló del sistema, ingrese:
net stop pisqlss

PI SQL Subsystem
\pi\bin\pisqlss -stop
Se escribira un mensaje en el registro de mensajes, que indicara que PI SQL Subsystem se ha
detenido. Otro mensaje indicara el numeró de indicadores asignados y el numeró de
indicadores abortados durante el cierre.
Para reiniciar PI SQL Subsystem y reanudar el funcionamiento normal, utilice uno de los
siguientes metódós:
• En Control Panel > Administrative Tools, ejecute Services. Seleccione PI SQL Subsystem de
la lista y haga clic en Start.
• En el símbóló de línea de comandos, ingrese:
net start pisqlss
\pi\bin\pisqlss -start
Se escribira un mensaje en el registro de mensajes, que indicara que PI SQL Subsystem ha
continuado.
Puede cerrar y reiniciar el subsistema en cualquier momento y sera igualmente efectivo. Esta es
la unica ópción disponible al ejecutar PI SQL Subsystem en Windows de manera interactiva.
Contadores de rendimiento
En Windows, con la aplicación Performance Monitor, puede supervisar de manera continua
varios aspectos del procesamiento de PI SQL Subsystem.
Plan de recuperación por cierre o corte de energía inesperado de PI System

En el caso de que se produzca un apagado autómaticó de PI System, consulte el plan de
recuperación en este artículó del Soporte Tecnicó de OSIsoft, KB00669: Plan de recuperación
por apagado o corte de energía inesperado de PI System (https://techsupport.osisoft.com/
Troubleshooting/KB/KB00669).
Informes de problemas y soporte técnico

Si PI SQL Subsystem devuelve constantemente un error al procesar sentencias SQL o parece
generar resultados incorrectos, debe detener PI SQL subsystem y luego reiniciarlo con las
opciones TRACE y LOG habilitadas. Envíe el resultado sqltrace.log al soporte tecnicó
OSIsoft.

PI SQL Subsystem

Recuperación de datos con fuentes de datos
externas
En ocasiones, los datos no se almacenan en PI Data Archive. Los datos pueden almacenarse en
una fuente de datos externa. PI Base Subsystem, PI Archive Subsystem y PI Snapshot Subsystem
pueden solicitar datos de sistemas de almacenamiento de datos externos a traves de módulós
denominados conectores COM. Debe instalarse un conector COM por separado para establecer
la cómunicación con cada sistema de datos externo específicó.
La instalación de PI Data Archive puede incluir cualquier numeró de conectores COM. Debido a
que la identidad del conector COM que se utilizara se determina punto por punto, un solo
servidor PI Data Archive puede acceder a cualquier numeró de sistemas de datos externos.
Los subsistemas principales de PI Data Archive no se comunican directamente con los
conectores COM. En su lugar, los subsistemas envían solicitudes a PI Redirector, que actua como
intermediario de solicitudes. PI Redirector carga uno o mas conectores COM y les reenvía las
solicitudes.
PI Redirector y los conectores COM son objetos COM, implementados mediante el uso de la
tecnólógía Component Object Model (COM) de Microsoft. PI Redirector se instala como parte de
PI Server. Los conectores COM se instalan por separado.
Los conectores COM se instalan en el servidor PI Data Archive, pero no se cargan en la memoria
del servidor hasta que sea necesario. Cuando se cierra PI Data Archive, PI Redirector y todos los
conectores COM se descargan autómaticamente de la memoria.
Los conectores COM pueden ser objetos COM en proceso o fuera de proceso. Los objetos COM
en proceso son archivos .dll, mientras que los objetos COM fuera de proceso son
archivos .exe. Para obtener una lista de los conectores COM disponibles, consulte la pagina
sobre conectores COM en Sitio web de soporte tecnicó de OSIsoft (https://
techsupport.osisoft.com). Si los conectores COM existentes no se adaptan a sus necesidades,
cómuníquese con el soporte tecnicó de OSIsoft (https://techsupport.osisoft.com/Contact-Us/).
PI Redirector es un objeto COM fuera de proceso. No se ejecuta como servicio, lo que significa
que no se encuentra en la sección Services del Panel de control. Cuando se ejecuta PI
Redirector, los administradores de sistema pueden ver un proceso denominado piudsrdr.exe
en la pestana Processes del Administrador de tareas de Windows.
Las aplicaciones cliente no conocen la diferencia entre la recuperación de datos de PI Data
Archive y la recuperación de datos de un sistema de almacenamiento de datos externo
mediante el uso de un conector COM. En todos los casos, la aplicación se conecta a PI Network
Manager. Cada punto del que se recuperan datos se identifica mediante un tag y posee atributos
almacenados en la base de datos de PI point, independientemente de la fuente de los datos.
PI Data Archive envía los datos a las aplicaciones cliente exactamente de la misma manera,
independientemente de si los datos se almacenan en PI Archive Subsystem o en una fuente de
datos externa. Lo mismo ocurre con las solicitudes de datos de subsistemas, como PI Totalizer
Subsystem, PI Alarm Subsystem y PI Performance Equation Scheduler.
PI Data Archive puede escribir datos en un sistema de datos externo si el conector COM lo
admite para dicho sistema.
En esta sección
• Cónfiguración de punto
• Recuperación de datos de snapshot
• Recuperación de datos de archivos históricós

Recuperación de datos con fuentes de datos externas
• Ficheros de archivado
• Actualizaciones de Snapshot
• Cómpresión
Configuración de punto
Para interactuar con un punto de un sistema externo, un punto correspondiente (llamado
punto asignado o punto del conector COM) debe crearse en la base de datos de PI point.
Para crear un punto asignado, seleccione una clase de punto que incluya los siguientes
atributos de punto del conector COM, así como los atributos normales de una clase de punto:
Atributo Descripción
ctr_progid ID de programa de COM, como se almacenó en el registro de
Windows.
ctr_lmap Parametró de asignación de palabra larga.
ctr_strmap Parametró de asignación de string.
PI Data Archive incluye la clase de punto classicctr que contiene estos atributos de punto, así
como los conjuntos de atributos base y clasicó. Para crear esta clase de punto, ejecute el script
PI\adm\classicctr.dif usando la utilidad piconfig .
Construya puntos de acuerdo con las especificaciónes de la clase de punto. Para obtener mas
infórmación, consulte Clases y atributos de punto.
Cada vez que la infórmación sobre el punto indique que el punto solicitado es un punto
asignado, PI Redirector óbtendra los valores de los datos del punto del sistema externo
correspondiente.
Recuperación de datos de snapshot

Cuando se inicia PI Snapshot Subsystem, PI Base Subsystem le nótifica la presencia de puntos
asignados. Cuando una aplicación cliente solicita un valor de snapshot, PI Network Manager
redirige la solicitud a PI Snapshot Subsystem.
Si los datos del punto se almacenan normalmente en PI Data Archive, el valor de snapshot se
recuperara de PI Snapshot Subsystem y luego se devólvera a PI Network Manager.
Si se solicita un valor de snapshot para un punto asignado, la ruta de datos sera diferente. En
este caso, PI Snapshot Subsystem solicita el valor a PI Redirector, el cual, a su vez, solicita el
valor al conector COM correspondiente. El conector COM obtiene el valor del sistema de
almacenamiento de datos externo y lo devuelve a PI Redirector, el cual lo envía a PI Snapshot
Subsystem. Luego se redirige a PI Network Manager para la transmisión al cliente.

Recuperación de datos de archivos históricos

La recuperación de datos de archivos históricós del conector COM por parte de PI Archive
Subsystem es similar a la recuperación de snapshot por parte de PI Snapshot Subsystem.
Cuando se inicia PI Archive Subsystem, PI Base Subsystem le nótifica la presencia de puntos
asignados.
Si se solicitan valores de archivos históricós para un punto asignado, PI Archive Subsystem
solicita el valor a PI Redirector, que, a su vez, obtiene el valor del conector COM
correspondiente.

Ficheros de archivado
Aunque los ficherós de archivado no se utilizan si los datos se recuperan mediante el uso de
conectores COM, los archivos deben existir y dimensionarse como si todos los puntos fueran
puntos de PI archive. Cada punto del conector COM consume un registro primario en el ficheró
de archivado aunque nunca se utilizara para el almacenamiento o la recuperación de datos. Los
procedimientos normales de mantenimiento y copia de seguridad se aplican a los ficherós de
archivado.
Actualizaciones de Snapshot
El mecanismo de cónexión COM incluye soporte para el informe de excepciones. PI Snapshot
Subsystem inicia un metódó de suscripción en el conector COM si un cliente se suscribe a
informes de excepciones sobre un punto asignado. PI Snapshot Subsystem obtiene valores de
excepción del conector COM mediante PI Redirector.
Si el sistema externo no admite el control de excepciones, puede códificarse para devolver un
códigó de error COM estandar que indique que no se implementara el metódó.
Compresión
PI Data Archive no aplica al algoritmo de cómpresión de datos para los puntos externos
asignados. Si el conector COM admite el ingreso de nuevos valores de datos en el sistema
externo, ese sistema sera responsable del almacenamiento. El sistema externo puede o no
admitir la cómpresión.

Seguridad de punto
Los datos recuperados de un sistema de datos externo esta sujeto a la misma cónfiguración de
seguridad que los valores de datos recuperados del almacenamiento en PI Data Archive. Cada
PI point, ya sea asignado o no, posee un descriptor de seguridad que define el acceso que los
usuarios de PI pueden tener a los datos. Para obtener detalles sobre cómó cónfigurar la
seguridad de punto, consulte Establecimiento de permisos de acceso.


Resolución de problemas
Los datos atraviesan varios pasos para entrar o salir de un archivo históricó. Durante la
resólución de problemas, es importante identificar las rutas de datos que funcionan
correctamente y las que presentan un funcionamiento defectuoso.
En esta sección
• Lista de verificación para la resólución de problemas
• Tareas generales de resólución de problemas
• Problemas específicós
Lista de verificación para la resolución de problemas

Para resolver problemas, realice los pasos que figuran en esta lista de verificación. Si no
resólvió el problema despues de llevar a cabo estos pasos, cómuníquese con soporte tecnicó de
OSIsoft (http://techsupport.osisoft.com).
Procedimiento
1. Busque los mensajes de error. Si conoce el mensaje de error específicó, busqueló en el sitio
de soporte tecnicó. Si aun no posee un mensaje de error específicó, busque los registros de
mensajes en el nodo de servidor y en el nodo de cliente. Para los mensajes del servidor,
utilice la herramienta Message Log de PI SMT. Filtre los mensajes segun la gravedad de
Error a mayor. Consulte Niveles de gravedad.
No puede ver el registro de mensajes de un nodo de cliente de manera remota. Ejecute PI
SMT directamente en el nodo de cliente o utilice pigetmsg. Si tiene problemas con la
interfaz, examine los archivos pipc\dat\pipc.log directamente en el nodo de la interfaz.
Si este es un problema de instalación, observe los registros de instalación en el directorio
pipc\dat de 32 bits.
Para obtener una descripción en texto de un numeró de error, utilice:
pidiag -e errornumber
Para obtener mas infórmación sobre los mensajes de error, consulte Mensajes de PI System.
Para obtener infórmación sobre pigetmsg, consulte PI Data Archive Reference Guide.
2. Determine que equipo presenta el problema:
◦ Equipos cliente
◦ Equipos servidores
◦ Equipos de interfaz
Para aislar los equipos, ejecute el sistema dudoso frente a un sistema que funcione
correctamente y revise los resultados.
◦ Es posible que se produzca un problema de red si todos los equipos presentan un mal
funcionamiento.
◦ Un problema de servidor se indica si el mal funcionamiento se produce en todos los
clientes.
◦ Es posible que se produzca un problema de hardware o de red si las aplicaciones que
funcionan de manera incorrecta no utilizan PI System. Ejecute telnet para aislar aun
mas el problema. Si telnet funciona, es probable que la red no sea el problema, aunque
puede ser un problema de red como DNS o bloqueo de firewall.

3. Si este es un problema de cliente, realice lo siguiente:

◦ Revise la seguridad para garantizar que el usuario cuente con los privilegios correctos.
◦ Verifique Update Manager para asegurarse de que el cliente este suscrito para recibir las
actualizaciones y las reciba efectivamente. Use la utilidad de comandos pilistupd para
verificar si hay actualizaciones.
◦ Si una tendencia de PI ProcessBook presenta una línea delgada, consulte Tendencias con
líneas delgadas en PI ProcessBook.
4. Si este es un problema de servidor, realice lo siguiente:
◦ Verifique que todos los procesos de PI Data Archive se esten ejecutando. Para ver el
estado de todos los procesos que se ejecutan como servicios, use la herramienta PI
Services de PI SMT.
Nota:
PI Systems puede tardar varios minutos en iniciarse; la carga de Point Database,
snapshot y archivos históricós es lo que tarda mas tiempo. Las utilidades como
piartool y piconfig no seran totalmente operativas hasta que se haya
completado el inicio.
◦ Incluso si un proceso figura como en ejecución, puede encontrarse en un estado en el que
no se comunica con PI Network Manager (PINet Manager). Compruebe lo siguiente:
▪ En la herramienta SMT PI Services, seleccione el servicio y verifique los detalles en
Thread Details for Selection. Observe la columna Duration. Si el servicio esta en
ejecución y Duration resulta inesperadamente grande, el subproceso puede
bloquearse.
▪ Para obtener mas infórmación, utilice la herramienta SMT Network Manager Statistics.
Consulte Verificación de cónexión.
▪ Para verificar que los procesos PI Data Archive individuales se comuniquen, use las
utilidades que se enumeran en Verificación de que los procesos de PI Data Archive se
esten ejecutando. Para obtener infórmación sobre conexiones, consulte las estadísticas
de Network Manager.
▪ Para verificar si un subsistema responde, utilice
piartool -block subsystem -verbose
◦ Ejecute el servidor PI Data Archive con pistart.bat, en lugar de ejecutarlo como
servicio. Las ventanas de comando interactivo pueden mostrar mensajes de estado
adicionales.
5. Si se produce una falla en el subsistema, puede existir infórmación adicional util para
nuestros desarrolladores. Cónfigure un depurador de aplicaciones para generar un archivo
de volcado de fallas. Para obtener mas infórmación, consulte el artículó de Soporte Tecnicó
de OSIsoft KB00046: Cómó obtener un depurador de suspensión o de fallas, y cómó
conseguir y usar herramientas de depuración (https://techsupport.osisoft.com/
Troubleshooting/KB/KB00046).
6. Utilice netstat -a para verificar si hay otros procesos que se comunican en el puerto
5450; si es así, PINet Manager se cómunicó correctamente de una vez.
7. Si tiene un problema de archivo históricó o snapshot, use las utilidades piartool -as y
piartool -ss para reunir mas infórmación sobre el flujó de datos. Consulte Verificación de
que los procesos de PI Data Archive se esten ejecutando.
◦ Recupere un snapshot de todas las siguientes maneras; los resultados combinados de
estas pruebas ayudan a determinar el origen del problema:

▪ apisnap desde un nodo remoto (utiliza API + red)

▪ apisnap desde un nodo principal (utiliza API)
▪ piconfig < pisnap.dif desde el nodo principal (utiliza cómunicación interna)
◦ Vuelque un snapshot con piartool -sd. Ejecute esto algunas veces para determinar si
el snapshot cambia para los tags en los que esta interesado.
◦ Para determinar si el archivo esta danadó, use piartool -aw.
◦ Si se trata de un problema de PI Update Manager, use la utilidad pilistupd a fin de ver
que procesos se registran para recibir eventos. Use pilistupd –cs para ver la lista de
consumidores.
8. Cada PI System se distribuye con un conjunto estandar de puntos, que incluye sinusoid,
cdep158 y cdm158. Verifique que los puntos funcionen correctamente. Las interfaces
RampSoak y Random deben encontrarse en ejecución; de lo contrario, estos puntos no se
actualizaran.
9. Para resolver problemas de copia de seguridad, consulte Copias de seguridad de PI Data
Archive.
10. Para resolver problemas de PI collectives, utilice Collective Manager para verificar el estado
de todos los miembros. Luego, use piconfig < pisysdump.dif:
◦ isavailable debe ser 1 para todos los miembros.
◦ lastsynctime indica la ultima cónexión realizada correctamente.
◦ role debe ser 1 para el primario y 2 para un secundario.
11. Si el problema ocurre con las interfaces, intente lo siguiente:
◦ Ejecute una interfaz con solo un punto.
◦ Ejecute la interfaz de manera interactiva.
◦ Ejecute la interfaz sin almacenamiento en bufer. Al realizar la ejecución de manera
interactiva, es muy posible que utilice una cuenta diferente, por lo que la seguridad puede
afectar sus resultados.
◦ Determine si el problema ocurre en todos los puntos de todas las interfaces o solo en
algunos puntos de algunas interfaces.
◦ Verifique que la autenticación este cónfigurada para el nodo o la interfaz.
◦ Verifique la base de datos de PI Firewall.
◦ Verifique los archivos de registro individuales de la interfaz, si los hubiere; ademas,
verifique el registro de mensajes de PI en el nodo de interfaz. Use la utilidad pigetmsg,
ubicada en la carpeta pipc\adm, para verificar los mensajes de este archivo.
◦ Si una interfaz de API no se puede conectar, intente conectarla con apisnap.
◦ Asegurese de que SDK pueda conectarse mediante el uso de la utilidad AboutPI-SDK.
◦ Ejecute como administrador del sistema. Si el problema se resuelve, entonces tiene un
problema de permiso.
◦ Si esta es la interfaz OPC, verifique la cónfiguración de DCOM. La cónfiguración se
documenta en OPC Interface Manual.

Tareas generales de resolución de problemas

En esta sección
• Verificación de que los procesos de PI Data Archive se esten ejecutando
• Verificación de cónexión
Verificación de que los procesos de PI Data Archive se estén ejecutando

Cuando PI Data Archive se encuentra en ejecución, todos sus procesos deben estar
ejecutandóse. Cuando se detiene PI Data Archive, todos los procesos de PI Data Archive deben
detenerse. La excepción es pishutev, que solo se ejecuta brevemente en el inicio.
Para ver el estado de los servicios de PI, utilice la herramienta PI Services de PI SMT: en PI SMT,
seleccione Operation > PI Services. Incluso si la herramienta indica que un proceso se
encuentra en ejecución, este puede no estar cómunicandóse con PI Network Manager. Para
verificar que cada proceso se comunique de manera adecuada, utilice piartool :
piartool -thread subsystem -info
Para enumerar todos los procesos que se ejecutan como servicios, ingrese lo siguiente en un
símbóló del sistema:
net start
Si esta ejecutando un proceso o interfaz de PI Data Archive de manera interactiva, ese proceso
posee una ventana de comando separada y etiquetada con el nombre del proceso.
En esta sección
• PI Archive Subsystem
• PI Base Subsystem
• PI License Manager
• PI Snapshot Subsystem
• Update Manager
• Operación independiente de los procesos de PI Data Archive
PI Archive Subsystem
Ejecute el comando piartool –al (listado de archivos históricós), piartool –as
(estadísticas de archivos históricós) y pisnap para probar PI Archive Subsystem. Si PI Archive
Subsystem (piarchss) no funciona correctamente, vera el mensaje:
C:\PI\adm>piartool -al
Getarchivefilelist Failed: [-10733] PINET: RPC Resolver is Off-Line.
C:\PI\adm>piartool -as
Getarcmemtablestatistics Failed: [-10733] PINET: RPC Resolver is Off-Line.
C:\PI\adm>pisnap
C:\PI\adm>apisnap localhost:5450
PI-API version 1.6.1.5

Attempting connection to localhost:5450
Enter tagname: sinusoid
Error: piar_getarcvaluex -10733

Error: piar_getarcvaluesx 100
Tag = SINUSOID Point Number = 1 Type = Real-32

12 Hour Sine Wave
Snapshot value
Value = ERROR ERROR
Status = ERROR
Latest archive value

Value = ERROR ERROR
Status = ERROR
Los eventos de archivo históricó se ponen en cola cuando PI Archive Subsystem no funciona
correctamente. Use el comando piartool -qs para ver el conteo de la cola de eventos.
PI Base Subsystem
Ejecute las utilidades pisnap y piconfig para probar PI Base Subsystem. Si PI Base
Subsystem no funciona correctamente, vera el mensaje:

Error -994, connecting to localhost:5450
C:\PI\adm> piconfig
* (Ls - ) PIconfig> @tabl pipoint
*PIconfig Err> Table initialization error (PIPOINT
*@tabl pipoint
*[-10733] PINET: RPC Resolver is Off-Line.
PI License Manager
PI License Manager, pilicmgr, proporciona servicios de licencia para los programas de PI,
incluidos subsistemas, aplicaciones cliente e interfaces. Por ejemplo, PI Archive Subsystem se
registra con PI License Manager para obtener una licencia valida. Si no obtiene su licencia, no
puede funcionar correctamente.
Ejecute el comando piartool -lic usage para probar PI License Manager. Si pilicmgr no
funciona correctamente, vera el mensaje:
C:\PI\adm>piartool -lic usage
Continue after failure to register with License Manager. [-10733] PINET: RPC
Resolver is Off-Line.
PI Snapshot Subsystem
Ejecute los comandos piartool -ss y pisnap para probar PI Snapshot Subsystem. Si PI
Snapshot Subsystem no funciona correctamente, vera el siguiente mensaje:
C:\PI\adm>piartool -ss
Getsnaptablestatistics Failed: [-10733] PINET: RPC Resolver is Off-Line.
C:\PI\adm>pisnap

Enter tagname: sinusoid
Error: pisn_getsnapshotsx -10733

Error: piar_getarcvaluex -10733
Error: piar_getarcvaluesx 100
Tag = SINUSOID Point Number = 1 Type = Real-32

12 Hour Sine Wave
Snapshot value
Value = ERROR ERROR
Status = ERROR
Latest archive value

Value = ERROR ERROR
Status = ERROR
Update Manager
Si un cliente no recibe actualizaciones, use la herramienta Update Manager de PI SMT para
verificar el estado de las actualizaciones de los productores y consumidores. Para obtener
detalles, consulte el tema de PI SMT "Update Manager" in Live Library (https://
livelibrary.osisoft.com).
Operación independiente de los procesos de PI Data Archive

Durante el funcionamiento normal, todos los procesos de PI Data Archive se inician juntos
mediante el uso del script pisrvstart y se detienen juntos mediante el uso del script
pisrvstop. Al resolver un problema, es posible que deba ejecutar un subconjunto de procesos
de PI Data Archive. En Windows, pisrvstart.bat inicia cada subsistema de manera
interactiva en su propia ventana de comandos.
Existen dependencias entre procesos con PI System. Por ejemplo, todos los subsistemas PI Data
Archive dependen de PINet Manager. La mayóría de los subsistemas requieren, para su
ejecución, PI License Manager (que proporciona servicios de licencias) y PI Update Manager
(que proporciona servicios clave). Ademas, PI Archive Subsystem requiere PI Snapshot
Subsystem para el inicio normal. Generalmente, al resolver problemas, debe iniciar los
siguientes subsistemas en el orden detallado:
1. pinetmgr
2. pimsgss
3. pilicmgr
4. piupdmgr
5. pibasess
6. pisnapss
7. piarchss
Verificación de conexión
Para obtener infórmación sobre conexiones, consulte las estadísticas de Network Manager.
Puede verlas en la herramienta PI SMT Network Manager Statistics (seleccione Operation >
Network Manager Statistics). El proceso pinetmgr administra las llamadas de procedimiento
remoto (RPC) que los subsistemas y procesos de PI Data Archive utilizan para comunicarse
entre ellos.
Por ejemplo, si PI Snapshot Subsystem (pisnapss) envía un evento a PI Archive Subsystem
(piarchss) para el almacenamiento, la cómunicación fluye de pisnapss a pinetmgr y a
piarchss. Si PI Archive Subsystem escribe un mensaje en el Registro de mensajes del sistema,
la cómunicación fluye de piarchss a pinetmgr y a pimsgss.

La herramienta Network Manager Statistics muestra mucha infórmación. Compruebe lo

siguiente:
• En las columnas BytesSent y BytesRecv, identifique las aplicaciones que soliciten o envíen
cantidades de datos inusuales. Si el valor de una aplicación o interfaz es grande en
cómparación con otras aplicaciones o interfaces de ese tipo, ese valor puede apuntar al
problema de cónexión. (Los valores de las columnas BytesSent y BytesRecv de PINetMgrson
siempre son los mas elevados).
• Que procesos de cliente se conectan de determinados nodos.
• Durante cuantó tiempo han estado conectado los clientes.
• En la columna RegAppType, determine que tipo de aplicación se esta conectando:
◦ OSISDKApp indica una aplicación de SDK.
◦ OSIinterface indica una interfaz.
• En la columna ProtocolVersion, determine si la cónexión es de una aplicación de SDK o de
API. El numeró de versión 1.x indica una aplicación de API. El numeró de versión 3.x indica
una aplicación de SDK.
Problemas específicos
En esta sección
• Tendencias con líneas delgadas en PI ProcessBook
• Problemas con los conectores COM
• Límite de actualización pendiente
Tendencias con líneas delgadas en PI ProcessBook

Si una tendencia de PI ProcessBook presenta líneas delgadas, es posible que tenga problemas
con PI ProcessBook, PI Data Archive, el rendimiento/la conectividad/la cónfiguración de red o
la fuente de datos. Estos son algunos pasos de diagnósticó posibles que debe seguir:
Procedimiento
1. Determine si resultan afectados uno o mas puntos específicós. Vea otra tendencia en PI
ProcessBook para comprobar si el problema se limita solo a algunos puntos. Si el problema
involucra varios puntos, vaya al paso 2. Si el problema involucra solo un punto, vaya al
paso 4.
2. Intente recuperar los datos del archivo históricó; para ello, cierre y vuelva a abrir la ventana
de la tendencia. Si la tendencia parece normal, el problema puede encontrarse en la
suscripción a actualizaciones. Vaya al paso 3. Si la tendencia aun no muestra datos, vaya al
paso 4.
3. Si no hay tags que produzcan tendencias, ejecute la herramienta de PI SMT Operation >
Update Manager y verifique si PI ProcessBook no esta suscrito para recibir actualizaciones.
4. Para determinar si el problema es con PI Data Archive o con la aplicación cliente, vea los
numerós pendientes en los resultados. Los numerós pendientes representan el numeró de
eventos en cola y que aun no recuperó el cliente, como PI ProcessBook. Si los datos no
provienen de la fuente de datos, el numeró pendiente permanece en 0. Si PI ProcessBook del
cliente no recupera las actualizaciones, el numeró pendiente crecera continuamente y no
disminuira.

5. Si las actualizaciones pendientes aumentan, reinicie PI System. Si esto no soluciona el

problema, cómuníquese con el soporte tecnicó de OSIsoft (https://techsupport.osisoft.com/
Contact-Us/) para obtener mas ayuda. Si las actualizaciones pendientes permanecen en
cero, vaya al paso 4.
6. Si todos los puntos estan suscritos para recibir actualizaciones y la actualización de los
datos del archivo históricó aun arroja una tendencia con línea delgada, el problema pódría
encontrarse en el archivo históricó, en la fuente de datos o en comunicaciones con la fuente
de datos.
7. Para determinar si el servidor esta funcionando, cree una tendencia de un punto con datos
generados en el servidor, como Sinusoid, que lo genera la interfaz aleatoria en el servidor.
◦ Si la tendencia del punto Sinusoid aparece correctamente, el archivo históricó esta
funcionando, al igual que la cómunicación entre el servidor y el cliente. Vaya al paso 6.
◦ Si la tendencia de Sinusoid no aparece correctamente, vaya al paso 5.
8. Use el comando piartool -as o piartool -al para verificar que el archivo históricó este
funcionando correctamente.
9. Con la utilidad piconfig , PI DataLink o la herramienta Archive Editor de PI SMT, intente
insertar datos en un punto de prueba para crear una tendencia. Si esto se realiza
correctamente, vaya al paso 6. De lo contrario, cómuníquese con el soporte tecnicó de
OSIsoft (http://techsupport.osisoft.com) para obtener mas ayuda.
10. Si todas estas pruebas se llevan a cabo con exitó, es posible que la fuente de datos de los
puntos con líneas delgadas no este funcionando. Examine el atributo de punto de origen del
punto para detectar que interfaz esta suministrando datos al punto en cuestión.
11. Visite el sitio web del soporte tecnicó de OSIsoft (https://techsupport.osisoft.com) para
verificar que el programa de la interfaz se este ejecutando y este conectado al servidor.
12. Verifique que el programa de la interfaz este cómunicandóse con la fuente de datos externa
(sistema DCS, sistema RDB, etc.). Consulte la dócumentación de la interfaz específica para
obtener detalles.
13. Si la fuente de datos se ejecuta correctamente, vaya al paso 14.
14. Examine los archivos de registro de la interfaz y los archivos de registro de mensajes de PI
Data Archive. Verifique que la interfaz de fuente de datos y PI ProcessBook tengan el acceso
correcto al sistema.
15. Revise los ajustes de seguridad para garantizar que la interfaz cuente con acceso de
escritura a todos los puntos y que PI ProcessBook tenga acceso de lectura a todos los puntos.

Si ninguno de estos pasos resuelve el problema, cómuníquese con el soporte tecnicó de OSIsoft
(http://techsupport.osisoft.com) para obtener mas ayuda.
Problemas con los conectores COM

En ocasiones, se observan errores cuando las aplicaciones cliente de OSIsoft no pueden obtener
datos de proceso. Si los errores se relacionan con un analista de datos externos, las aplicaciones
generalmente reciben códigós de error en el intervalo de -11200 a -11209, en lugar de devolver
los datos. Use el comando pidiag -e para traducir estos errores en texto.
El origen del error puede ser Redirector o el conector COM específicó en uso. Antes de resolver
un problema de cónexión de COM, verifique que Redirector este funcionando correctamente.
Los errores pueden registrarse en el registro de eventos de Windows o en el registro de
mensajes de PI Data Archive En general, la distinción es la siguiente:

• Redirector registra infórmación sobre sus propias actividades en el Registro de aplicaciones

de eventos de Windows. Esto incluye inicio, cierre y carga de conectores COM.
• Los subsistemas PI Data Archive registran errores en la busqueda de puntos del sistema
externo y la recuperación de datos en el registro de mensajes de PI Data Archive.
En esta sección se ofrecen algunas directrices para resolver problemas de recuperación de
datos de los conectores COM. A medida que nuevas tecnicas se ponen a dispósición, estas se
publican en la pagina de conectores COM en Sitio web de soporte tecnicó de OSIsoft (https://
techsupport.osisoft.com).
En esta sección
• Verificar los puntos asignados en la base de datos de PI point
• Verificar el proceso de PI Redirector
• Script de volcado de PI Redirector
• Verificar la instalación de PI Redirector
• Conectores COM
Verificar los puntos asignados en la base de datos de PI point

Los puntos asignados deben definirse correctamente en la base de datos de PI point. Un punto
asignado es uno que posee tres atributos de punto que lo identifican: ctr_progid, ctr_strmap y
ctr_lmap.
Procedimiento
piconfig
3. En el símbóló del sistema piconfig , escriba:
@table pipoint,classicctr
@mode list
@ostructure tag, ctr_progid, ctr_strmap, ctr_lmap
@select ptclassname=classicctr
@ends
Tenga en cuenta que, aunque este ejemplo utiliza la clase de punto classicctr, los conectores
COM no se limitan a utilizar esta clase de punto si los tres atributos de punto de
identificación estan presentes en su clase de punto. La clase de punto classicctr puede
crearse mediante el uso del archivo piconfig classicctr.dif que se proporciona con el
kit de instalación de PI Server. Puede crear sus propias clases de puntos para los puntos
asignados de PI Server.
Verificar el proceso de PI Redirector

Si se definen los puntos asignados de PI Data Archive, se debería ejecutar un proceso
denominado piudsrdr.exe.
Procedimiento
1. Abra el Administrador de tareas de Windows.
2. En la pestana Processes, cónfirme que el proceso piudsrdr.exe se este ejecutando.

Nota:
Despues de iniciar el servicio piudsrdr, este permanece en la lista de procesos en
ejecución, incluso si todos los puntos asignados se eliminan posteriormente.
En esta sección
• Verificar el registro de mensajes de PI
• Verificar el visor de eventos de Windows
• Revisar la cónfiguración de las propiedades de las aplicaciones
Verificar el registro de mensajes de PI

Si PI Redirector no se esta ejecutando, verifique el registro de mensajes de PI usando la utilidad
pigetmsg . Verifique los mensajes relacionados con PI Redirector o con un conector COM. Si
aparece el siguiente mensaje, significa que PI Redirector no esta instalado correctamente:
0 pipoints 23-Jun-03 16:07:25
>> Error getting UDS Point interface. [-2147467261] Invalid pointer
Intente reinstalarlo; para ello, abra una ventana de comando, establezca el directorio PI\bin
como predeterminado y emita el comando:
piudsrdr /RegServer
Se móstrara un mensaje de Windows en un cuadro de alerta si se produce un error en el

registro. Si PI Redirector ya esta instalado correctamente, la emisión de este comando no
tendra efecto.
Verificar el visor de eventos de Windows

Utilice el visor de eventos para resolver una falla de PI Redirector.
PI Redirector tampoco se iniciara si el registro de eventos de Windows excede el tamanó de
registro maximó. De manera predeterminada, se sóbrescribiran los eventos segun sea
necesario cuando el archivo de registro exceda el tamanó maximó precónfiguradó.
Procedimiento
1. Ejecute el visor de eventos.
2. Seleccione Application.
3. Busque el mensaje que indique que PI Redirector puede iniciarse pero no puede seguir
ejecutandóse.
Revisar la configuración de las propiedades de las aplicaciones

Debe ajustar la cónfiguración de acuerdo con la pólítica de su sitio en cuanto a los registros y a
la capacidad del disco.
Procedimiento
1. Ejecute el visor de eventos de Windows.
2. Seleccione Application > Properties.
La cónfiguración predeterminada es la siguiente:

3. Puede borrar manualmente el registro haciendo clic en Clear Log a fin de liberar espacio
para mas eventos de registro.
Script de volcado de PI Redirector

Cada conector COM implementa un metódó para obtener infórmación sobre sus puntos
asignados. Puede obtener un script para solicitar esta infórmación de Sitio web de soporte
tecnicó de OSIsoft (https://techsupport.osisoft.com).
Para garantizar que este script funcione correctamente, siga estas directrices:
• Cónfigure la identidad de PI Redirector en This User, en dcomcnfg; es decir, un usuario de
dominio con privilegios administrativos en el equipo que aloja.
• Reinicie PI Base Subsystem, PI Snapshot Subsystem y PI Archive Subsystem solo si la cuenta
de usuario registrada es diferente de la cuenta con la que se estan ejecutando esos
subsistemas.
• Si la identidad se cónfigura en The launching user, es posible que cualquier usuario
registrado que ejecuta el script inicie otra instancia de Redirector. Dicha instancia de
Redirector no cómpartira infórmación con la que inició PI Base Subsystem, que contiene la
infórmación del punto asignado.
• Si se realiza un cambio a la cónfiguración de la identidad, reinicie Redirector al reiniciar PI
Base Subsystem, PI Snapshot Subsystem y PI Archive Subsystem.
• Si la identidad de PI Redirector se cónfigura en un usuario específicó, asegurese de que este
usuario pueda iniciar y acceder a todos los conectores COM fuera de proceso.

Para obtener mas infórmación sobre cómó resolver problemas de PI Redirector y los
conectores COM, vaya a Sitio web de soporte tecnicó de OSIsoft (https://
techsupport.osisoft.com) y seleccione Products > COM Connectors > PI COM Connectors.
Verificar la instalación de PI Redirector

PI Redirector no se instala de forma separada; se instala como parte de PI Data Archive. Para
verificar que PI Redirector se haya instalado correctamente, consulte el archivo del registro de
instalación de PI Data Archive (piudsinst.log) ubicado en la raíz del disco de su sistema.
Busque dos líneas que indiquen:
Registering PI UDS Redirector.
Creating EventLog registry key for piudsrdr
Puede usar la utilidad de Windows dcomcnfg para cónfirmar la instalación y verificar las
propiedades de PI Redirector.
Procedimiento
1. En el símbóló del sistema, escriba dcomcnfg para abrir la ventana Component Services.
2. En Console Root, expanda Component Services > Computers > My Computer > DCOM
Config.
3. Verifique que OSI PI-UDS Redirector este incluido en la lista de aplicaciones de DCOM.

Despues de cónfirmar la instalación de OSI PI-UDS Redirector, cóntinue hasta resolver el
problema.

Despues de solucionar el problema, debe reiniciar PI Redirector. Para reiniciar PI Redirector,

cierre PI Base Subsystem, PI Snapshot Subsystem y PI Archive Subsystem, y luego reinícielós.
No existe ningun metódó para reiniciar PI Redirector de manera independiente. PI Redirector
no se iniciara si no se cónfigurarón puntos asignados en el sistema.
Conectores COM
Si PI Redirector carga correctamente un conector COM, se escribira un mensaje como este en el
registro de eventos de Windows:
Successfully registered PI Universal Data Server COM Connector pipi.pipiconnector.
Si el conector COM no puede cargarse, se registrara un mensaje a tal efecto. Los pasos para la
resólución de problemas dependen de cómó se implemente el conector COM. Para obtener
detalles, consulte el manual del conector COM individual.
Los conectores COM son de dos tipos diferentes: en proceso o fuera de proceso. El manual del
conector COM específicó que esta utilizando le indicara el tipo de conector.
En esta sección
• Conector COM en proceso
• Conector COM fuera de proceso
Conector COM en proceso

Un conector COM en proceso se implementa como una Biblioteca de vínculós dinamicós (DLL).
Cuando PI Base Subsystem carga un punto que hace referencia al conector COM, esta DLL se
carga en el espacio de proceso de PI Redirector. No vera un proceso separado en ejecución.
Consulte el registro de eventos de Windows, que indica si el conector COM no esta registrado.
En este caso, intente volver a registrar el conector COM: abra una ventana de comando de
Windows, cónfigure el directorio predeterminado en la ubicación de la DLL del conector COM y
ejecute la utilidad regsvr32 . Por ejemplo, si la DLL del conector COM tuviera el nombre
myconn.dll, ingrese:
regsvr32 myconn.dll
Se móstrara un cuadro de alerta si no puede registrarse el objeto COM que implementó la DLL.
Una causa cómun por la cual no se puede realizar el registro es que las DLL de las que depende
la DLL del objeto COM no estan instaladas. Las DLL faltantes pueden ser aquellas que
proporciona el proveedor analista de datos externos.
Nota:
Los objetos COM en proceso no son visibles para la utilidad dcomcnfg . Para visualizar las
DLL que cargó PI Redirector, utilice la utilidad ListDLLs que esta disponible en Microsoft
(http://msdn.microsoft.com/).
Conector COM fuera de proceso

Este tipo de conector COM aparecera como proceso separado en el Administrador de tareas de
Windows.
Tambien debe verificar las propiedades de los objetos COM mediante el uso de dcomcnfg. Las
propiedades y la identidad deben coincidir con las de PI Redirector, a menos que en el manual
del conector COM se indique lo contrario.
Si el conector COM no aparece en la lista de dcomcnfg , no se ha registrado correctamente.
Intente volver a registrar el conector COM al abrir una ventana de comandos de Window,

cónfigurar el directorio predeterminado en la ubicación del ejecutable del conector COM y

ejecutarlo con el interruptor /RegServer. Por ejemplo, si el ejecutable del conector COM
recibiera el nombre myconn.exe, debería ingresar:
myconn.exe /RegServer
Se móstrara un cuadro de alerta si faltan DLL dependientes. No se móstraran otros errores.
Límite de actualización pendiente

El parametró MaxUpdateQueue establece el numeró maximó de eventos por consumidor. El
valor predeterminado es de 50 000 actualizaciones pendientes por consumidor. De manera
similar, el parametró TotalUpdateQueue establece la cantidad maxima de eventos en cola, en
la base de datos completa de Update Manager. La cantidad maxima predeterminada de eventos
es 1 000 000.
Si se alcanza cualquiera de estos límites, se envía un mensaje al registro de mensajes de PI. Se
envía otro mensaje cuando el nivel desciende por debajo del 99 % del límite y se reanuda la
cola. Los mensajes para los consumidores que usan menos del 0,1 % del límite de
TotalUpdateQueue (100 para el valor predeterminado) aun estan en cola cuando se alcanza el
límite total.
El valor predeterminado es adecuado para la mayóría de los sistemas, con las siguientes
excepciones:
• Aumente el valor en los sistemas con:

◦ Memoria física muy grande
◦ Alta frecuencia de actualizaciones (normalmente snapshots)
◦ Aplicaciones que pueden recuperar límites de actualización de manera lenta
• Si el nodo PINet o la interfaz PItoPI se conecta al servidor PI Data Archive, es probable que el
valor MaxUpdateQueue predeterminado sea demasiado bajo. Aumente el valor, como
mínimó, al conteo de puntos del servidor PI Data Archive. Este valor garantiza que todas las
actualizaciones de puntos solicitadas por PINet puedan ponerse en cola si el administrador
de un sistema realiza una óperación de edición en cada punto.

Reparaciones
En esta sección
• Reparación del archivo de datos de Archive Manager
• Danós en los ficherós de archivado
• Córrección de marcas de tiempo de eventos de archivo
• Recuperación de snapshots
• Reparación de bases de datos
• Diagnosticar y reparar archivos de bases de datos de PI Data Archive
• Recuperarse de un cambio accidental de la hora del sistema
Reparación del archivo de datos de Archive Manager

El archivo de datos de Archive Manager piarstat.dat contiene la lista de ficherós de
archivado que PI Data Archive conoce y en la cual esta registrado. Si este archivo esta danadó,
puede usar la utilidad pidiag para reconstruirlo.
opción de pidiag Descripción
-ad Vuelca el archivo piarstat.dat actual, que se usa para revisar los datos en
el archivo.
-ar Proporciona una utilidad interactiva de recuperación para renombrar el
antiguo archivo piarstat.dat con el nombre piarstat.old y generar uno nuevo
con una sola entrada (el archivo primario) que proporciona el usuario.
-ara Proporciona una utilidad de recuperación automatizada que renombra el
antiguo archivo piarstat.dat con el nombre piarstat.old y genera uno
nuevo con todas las entradas del archivo original. Cualquier error causara que
la versión automatizada se anule y usted deba recurrir a la versión
interactiva.
Procedimiento
1. Copie el archivo piarstat.dat a una ubicación temporal. No sobrescriba el archivo
original. Renombre el archivo en caso de que lo necesite posteriormente.
2. Detenga el servidor PI Data Archive.
3. Ejecute el comando pidiag -ad, recopile el volcado del archivo piarstat.dat y
compruebe el resultado.
4. Si los resultados del volcado lucen normales, pruebe la recuperación automatizada. De lo
contrario, use la interactiva.
5. Reinicie el servidor PI Data Archive.
6. Verifique el message log para ver si todos los archivos históricós se cargaron. Si se usa la
versión interactiva, se carga solamente el archivo primario.
7. Registre los archivos históricós y futuros restantes. Si se usó la versión interactiva, se deben
registrar todos los demas archivos históricós.

Reparaciones
Daños en los ficheros de archivado

Los ficherós de archivado cuentan con un encabezado y una estructura de registro. Los
registros incluyen datos e infórmación complementaria para indexar y vincular los registros a
fin de facilitar el acceso a datos.
Todos los datos pueden danarse si ocurre una falla en el sistema, por ejemplo, una interrupción
del suministro de energía. Cuando se dana un ficheró de archivado y ya no es posible leerlo, es
importante recuperar el ficheró al estado mas completo posible.
Use la utilidad Offline Archive utility piarchss para recuperar los datos a fin de reconstruir el
encabezado del archivo y los metadatos asociados.
En esta sección
• Recuperación de un archivo que no es primario
• Recuperar un archivo primario
Recuperación de un archivo que no es primario

Para recuperar los datos de un archivo que no sea primario y este danadó, ejecute piarchss y
especifique el archivo danadó como archivo de entrada y un archivo no existente como archivo
de salida. De manera predeterminada, las horas de inicio y finalización del archivo de entrada
se usan como las horas de inicio y finalización del archivo de salida creado recientemente.
Es posible recuperar los datos en un archivo que no es primario mientras PI Data Archive
tódavía archiva datos. La herramienta Offline Archive utility anula el registro del archivo
durante la óperación de recuperación.
Este es un ejemplo de comando para recuperar un archivo que no es primario:
$ ../bin/piarchss -if /export/PI/dat/piarch.001 -of piarch1.fix -f 0
...First pass...
...Sorting input archive...
...Output pass...
676 Loaded in 2( 1 + 1 ) Seconds 338 Event/Sec.
739 Archive Total seconds - ratio: 369
En este ejemplo, el archivo piarch1.fix no existe antes de la óperación. Se crea como un

archivo fijó con el mismo tamanó del archivo de entrada porque se especificó la ópción -f 0.
Despues de que se crea, se lo puede registrar usando el comando piartool -ar; luego, es
posible agregar eventos de datos al archivo históricó de la manera habitual.
Si se registra el archivo de entrada antes de la recuperación, el registro se anulara durante la
óperación. Debe registrar el archivo de entrada cuando finalice la recuperación.
Recuperar un archivo primario

PI Data Archive no puede archivar datos durante el proceso de recuperación si el archivo
danadó es el primario. Dado que no es posible anular el registro de un archivo primario, debe
seguir uno de estos metódós para recuperarlo:
• Detener PI Archive Subsystem

• Forzar un cambio de modo tal que el archivo históricó ya no sea el primario
Para forzar un cambio, use el comando piartool -fs.

Reparaciones
Procedimiento
1. Detenga PI Archive Subsystem.
2. Ejecute piarchss y especifique los parametrós:
◦ El archivo de salida es de tamanó fijó (-f 0)
◦ El tiempo de finalización restante queda abierto (-oet Primary)
3. Cuando se realice la recuperación, siga estos pasos:
a. Renombre el archivo primario antiguo.
b. Renombre el archivo de resultado con la misma ruta y el mismo nombre de archivo del
archivo primario original.
c. Reinicie PI Archive Subsystem.
Ejemplo de recuperación de un archivo primario

En este ejemplo, se puede ignorar el mensaje Failed to unregister input archive. Este
mensaje aparece porque PI Archive Subsystem se detuvo antes de la recuperación.
$ ../bin/piarchss -if /export/PI/dat/piarch.005 -of piarch.005.fix
-f 0 -oet 0
...First pass...
...Sorting input archive...
Failed to unregister input archive: [-10733] PINET: RPC Resolver is Off-Line
Archive utility not running - or archive not registered
Continue processing...
...Output pass...
1084 Loaded in 2( 0 + 2 ) Seconds 542 Event/Sec.
1038 Archive Total seconds - ratio: 519
En este ejemplo, el archivo piarch.005.fix no existe antes de la óperación. Se crea como un

archivo fijó con el mismo tamanó del archivo de entrada porque se especificó la ópción -f 0. El
tiempo de finalización del archivo de salida se deja abierto porque se especificó la ópción -oet
0.
Corrección de marcas de tiempo de eventos de archivo

El procesamiento de archivo históricó fuera de línea con transfórmación de tiempo difiere
ligeramente del procesamiento de archivo históricó fuera de línea estandar. Todos los
argumentos deben especificarse, por ejemplo, el archivo de entrada y el archivo de salida. Los
argumentos adicionales especifican el comportamiento de la transfórmación de tiempo. Los
argumentos adicionales son los siguientes:
-tfix time_conversion_file [-tfixend time -oeendtime time]
Se requiere el argumento -tfix seguido de la especificación completa del archivo. Los

argumentos tfixend y oeendtime son opcionales.
La primera ópción, -tfixend, seguida de una marca de tiempo, especifica el tiempo para no
realizar transformaciones. Todos los eventos con marcas de tiempo superiores o equivalentes a
este tiempo no se transforman.
Esta ópción se usa cuando solamente una parte del archivo históricó tiene marcas de tiempo de
evento incorrectas. Por ejemplo, si PI System se ejecutó durante un períódó con una
cónfiguración de reloj de sistema incorrecta y, luego, se cónfiguró correctamente el reloj y se
ejecutó durante un períódó específicó antes de aplicar una córrección de transfórmación de
tiempo.
La segunda ópción, -oeendtime, seguida por una marca de tiempo, especifica una marca de
tiempo para definir como tiempo de finalización del archivo históricó cuando se completa la

Reparaciones
cónversión. El tiempo de finalización del archivo históricó se define con el valor aprobado si
todos los eventos son anteriores a dicho tiempo; de lo contrario, el tiempo de finalización se
define segun el tiempo del evento de archivo mas antiguo.
Formato de archivos de conversión de hora

El archivo de cónversión de hora es un archivo ASCII que contiene una lista de pares de marcas
de tiempo o desplazamientos. La marca de tiempo y el desplazamiento estan separados por una
coma. Se ignoran las líneas que comienzan con #, las líneas vacías y los espacios en blanco.
La marca de tiempo puede ser una cadena de hora local en formato de hora de PI, ya sea una
hora fija en el formato dd-mmm-yy hh:mm:ss o una hora de referencia, como *-300d o *. Solo
puede utilizarse un formato de marca de tiempo en un archivo determinado. El primer formato
encontrado se asumira para todas las marcas de tiempo.
El desplazamiento es la cantidad de segundos que se agregaran a las marcas de tiempo del
evento. No se admite la precisión de subsegundos del cambio de hora. El desplazamiento se
aplicara a todos los eventos con marcas de tiempo superiores o iguales a la marca de tiempo
especificada, pero inferiores a la siguiente marca de tiempo en el archivo de cónversión.
Ejemplo 1
El siguiente ejemplo utiliza el formato de hora UTC en segundos. La marca de tiempo 0 es el 1
de enero de 1970 y la marca de tiempo 2000000000 es una fecha muy lejana en el siglo 21. El
desplazamiento es el numeró positivo 3600 (una hora).
Por lo tanto, este archivo de datos simplemente adelantara 1 hora todos los eventos.
# Example 1, Moves entire archive ahead by 1 hour
0,3600
2000000000,3600
Ejemplo 2
De manera similar al primer ejemplo, este ejemplo utiliza marcas de tiempo local para
especificar un intervalo de tiempo que sea lo debidamente extenso para abarcar todos los
eventos. El desplazamiento es el numeró negativo -3600. Este archivo de datos atrasara 1 hora
todos los eventos.
# Example 2, Also moves entire archive back by 1 hour
01-Jan-70 00:00:00,-3600
01-Jan-30 00:00:00,-3600
Ejemplo 3
Este ejemplo aplica una cónversión a DST faltante para el verano de 2003 del hemisferio norte.
La primera marca de tiempo esta cónfigurada como 1 de enero de 2003 para incluir todos los
eventos hasta la transición a DST; no se aplica ningun desplazamiento hasta antes de las
02:00:00 del 06 de abril de 2003. Desde las 02:00:00 del 06 de abril de 2003 hasta antes de las
02:00:00 del 26 de octubre de 2003 se agrega 1 hora a todos los eventos. No se aplica ningun
desplazamiento desde las 02:00:00 del 26 de octubre de 2003 hasta la hora actual.
# Example 3, Applies a missed dst conversion to an
# archive that covers summer of 2003
01-Jan-03 00:00:00,0
06-Apr-03 02:00:00,3600
26-Oct-03 02:00:00,0
31-Dec-03 23:59:59,0
Recuperación de snapshots
Existen dos tipos de danós posibles a las snapshots de los cuales PI Data Archive se puede
recuperar:

Reparaciones
• Horas de snapshots en el futuro. Este problema puede ocurrir si se cambia accidentalmente

la hora del sistema PI Data Archive al futuro; como mínimó, todos los puntos que se
recopilen de manera local se ubicaran en el futuro. Los eventos de snapshot se reemplazan
cuando se recibe un valor mas nuevo; por lo tanto, estos eventos permanecen en la snapshot
hasta que se actualiza a la hora real. Los eventos anteriores a la hora de la snapshot omiten
la cómpresión. Los eventos que omiten la cómpresión pueden generar una gran carga en PI
Data Archive.
• Archivo de snapshot danadó (piarcmem.dat). Los danós pueden ocurrir por errores de
disco o de alimentación.
En esta sección
• Recuperarse de horas futuras en la snapshot
• Reconstruir el archivo de snapshot
• Eliminación de snapshots del futuro
Recuperarse de horas futuras en la snapshot

Procedimiento
1. Detenga PI Snapshot Subsystem (el proceso pisnapss) en un servidor PI Data Archive en
ejecución.
2. Reinicie PI Snapshot Subsystem desde un símbóló del sistema y transmita el argumento -f:
pisnapss -f
Esto debe realizarse de modo interactivo, no como servicio de Windows. Al inicio, PI
Snapshot Subsystem buscara todas las snapshots tomadas mas de 20 minutos despues.
Estas snapshots futuras se sóbreescribiran con un valor NULO. PI Snapshot Subsystem
infórmara la cantidad de eventos futuros detectados en el registro de mensajes. Si no se
detectaron snapshots futuras, no se escribira ningun mensaje para solucionar el error en el
registro de mensajes. Los nuevos datos entrantes sóbreescribiran inmediatamente la
snapshot con valor NULO, incluso si el valor entrante esta fuera de orden.
PI Snapshot Subsystem cóntinuara ejecutandóse normalmente despues de que se haya
solucionado el error.
3. Presione Ctrl+C en el proceso interactivo pisnapss y reinícieló como servicio.
Nota:
Las snapshots cuyos errores se solucionaron mediante este procedimiento
permaneceran cónfiguradas con valor NULO hasta que llegue un nuevo evento de
snapshot. El valor NULO de una snapshot se reemplazara por cualquier evento nuevo
que se reciba para un punto, incluso si el evento es un evento fuera de orden.
Reconstruir el archivo de snapshot

Si recibe un mensaje que indica que PI Data Archive no se puede iniciar debido a que no es
posible cargar el archivo de snapshot (piarcmem.dat o piarcmem_1.dat), genere uno nuevo.
Un archivo de snapshot reconstruido contiene eventos basados en Point Database y, en algunos
casos, estados digitales de SnapFix. El archivo de snapshot reconstruido se actualiza a medida
que PI System recibe datos nuevos.
Nota:
Si el archivo piarcmem.dat o piarcmem_1.dat esta danadó, póngase en contacto con el
Soporte Tecnicó OSIsoft para obtener ayuda con el procedimiento.

Reparaciones
Procedimiento
1. Apague PI Base Subsystem, PI Archive Subsystem y PI Snapshot Subsystem.
2. En el símbóló del sistema, vaya al directorio PI\bin y escriba:
pibasess -snapfix [parameters]
Si lo necesita, puede escribir estos parametrós adicionales:

Parámetro Descripción
-file [filename] No puede usar esta ópción con el parametró -directory.
Proporciona el nombre de archivo completo de un archivo de
entrada para usar en lugar del archivo de snapshot
predeterminado, almacenado en %PISERVER%\dat.
Si filename hace referencia a piarcmem_1.dat, este comando
procesa el archivo como un archivo de snapshot futuro; de lo
contrario, lo procesa como archivo de snapshot históricó.
En ambos casos, el comando procesa de manera implícita el
archivo de snapshot para el otro conjunto (futuro o históricó)
usando el archivo piarcmem*.dat en la ubicación %PISERVER%
\dat\ predeterminada. Si desea procesar explícitamente dos
archivos desde un unicó directorio, considere usar el parametró -
directory.
Escriba un filename solamente si tiene un archivo desde el que
desea que se construya su nuevo archivo piarcmem.dat. Para
reconstruir el archivo de snapshot con los valores mas actuales de
la snapshot, no escriba un filename.
Si existe un archivo piarcmem.dat, PI Base Subsystem
renómbrara el archivo piarcmem.dat que contiene los valores
actuales de snapshot a DD_MON_YY_piarcmem.dat. Luego,
cónstruira un nuevo archivo piarcmem.dat a partir del archivo
piarcmem.dat renombrado. Si no hay un archivo piarcmem.dat,
se creara uno nuevo.
-directory directory No es posible usar esta ópción con el parametró -file.

Proporciona el directorio de archivos de entrada que se usara en
lugar de la ubicación %PISERVER%\dat\ predeterminada.
Para poder procesarlos, el nombre de los archivos de este
directorio debe ser piarcmem.dat o piarcmem_*.dat.
-ds state Especifica un estado digital del sistema que se inserta en el archivo
nuevo. Use un estado digital existente.
-maxtime time Define la marca de tiempo mas reciente permitida en la snapshot;
pisnapss -f se trunca a los *+20 minutos. Indica un límite de
tiempo despues del cual el estado digital de eventos anterior se
reemplazara con SnapFix o con el estado digital que usted
especifique en el parametró state. Este parametró se aplica
solamente al archivo de snapshot históricó.
3. Si se encuentran puntos duplicados, use el parametró ptpurge para eliminarlos:

pibasess -snapfix -ptpurgepointtopurge
o
pibasess -snapfix -ptpurge filelist
donde pointtopurge es un solo punto, por ejemplo, mypoint. Si desea usar un archivo que
contenga el nombre de varios puntos, use filelist. Por ejemplo, pointstodelete.dat.

Reparaciones
Cuando finalice la recuperación, PI Base Subsystem escribira un mensaje final en la pantalla

y se cerrara.
4. Reinicie PI Base Subsystem, PI Archive Subsystem y PI Snapshot Subsystem.
Los valores actuales de snapshot se conservan en el archivo piarcmem.dat reconstruido.
Los puntos que no tienen datos anteriores usan el estado digital de SnapFix o el que usted
especifique en el parametró de estado, hasta que se reemplace el estado con nuevos valores
de snapshot. Se eliminara cualquier registro de snapshot que no tenga un punto de
coincidencia.
Consejo:
Puede ejecutar este comando de recuperación de snapshot mientras PI Data Archive
esta apagado.
Eliminación de snapshots del futuro

La utilidad piconfig se puede usar para eliminar eventos de snapshot específicós. Cuando se
elimina el evento de snapshot, PI Snapshot Subsystem intenta recuperar del archivo históricó el
evento que se archivó mas recientemente y usarlo para reemplazar el evento de snapshot. Si no
hay eventos para el punto en el archivo históricó, la snapshot se elimina y permanece sin
iniciarse hasta que se envía un nuevo evento de snapshot.
El siguiente script de ejemplo extrae todos los eventos que ya superaron los 10 minutos de la
hora actual en un archivo. Luego, usando la tabla de PIARC, el script elimina todos los eventos
extraídós de la snapshot. El ultimó evento de archivo de cada tag reemplaza la snapshot.
piconfig table pisnap
* (Ls - PISNAP) piconfig> @sele tag=*,time>"*+10m"
* (Ls - PISNAP) piconfig> @ostru tag,value,time
* (Ls - PISNAP) piconfig> @sigd 8
* (Ls - PISNAP) piconfig> @output deletesnap.dat
@endsection
@output
* (Ls - PISNAP) piconfig> @table piarc
* (Ls - PIARC) piconfig> @mode ed,t
* (Ed - PIARC) piconfig> @modify mode=remove
* (Ed - PIARC) piconfig> @istru tag,value,time
* (Ed - PIARC) piconfig> @echo v
* (Ed - PIARC) piconfig> @input deletesnap.dat
Es posible usar cualquier cómbinación de condiciones para seleccionar los eventos que se
eliminaran, por ejemplo, todas las tags de una interfaz específica.
Nota:
El comando de dígitó significativó @sigd 8 garantiza que los errores de redondeo no
provoquen la ómisión de valores.
Reparación de bases de datos

Si PI Base Subsystem no se inicia debido a una base de datos danada, aparecera un mensaje en
el registro que indique esta situación. Si este mensaje no aparece, inicie PI Base Subsystem en
modo interactivo y consulte los errores en la ventana. El danó en la base de datos es un evento
relativamente inusual. Normalmente, se debe a un error de hardware o a un apagado
inadecuado. Para reparar todas las bases de datos, realice lo siguiente:
pibasess -copydb path
Por ejemplo:
pibasess -copydb \pi\recovereddb

Reparaciones
Siguiendo este comando, la ruta de destino contiene copias recuperadas de todas las bases de
datos de cónfiguración. Los registros danadós se eliminan y se muestran los mensajes
relacionados.
Antes de copiar los archivos de bases de datos recuperados nuevamente en este directorio,
haga una copia de backup del directorio \pi\dat\.
Despues, PI Base Subsystem debería cargar todas las bases de datos y funcionar normalmente.
Los archivos generados tienen un tamanó apenas menor que los originales, ya que se
compactan durante el proceso.
Reparar la PI Module Database

Procedimiento
1. En el símbóló del sistema, vaya al directorio PI\bin.
pibasess -mdbfix
PI Base Subsystem realizara varias tareas:
◦ Verificara el tamanó del recuento de entradas de la tabla y del índice. Los recuentos de
entradas deberían ser los mismos.
◦ Eliminara los módulós que tienen un tamanó de registro de cero. Estos módulós no se
recuperaran.
◦ Eliminara las referencias primarias y secundarias a módulós no existentes.
Diagnosticar y reparar archivos de bases de datos de PI Data

Archive
PI Data Archive almacena la mayóría de sus datos internos en archivos que tienen una
estructura interna cómun, denominada estructura basada en archivo. Estos archivos de bases
de datos almacenan datos en registros indexados. Los archivos de PI Archive no estan basados
en archivo, aunque sí lo estan los archivos de anótación correspondientes.
En esta sección, se analizan las herramientas que puede usar para diagnosticar y reparar
ficherós de bases de datos basadas en archivo.
En esta sección
• Haga una lista del encabezado y del índice
• Comprimir archivo de base de un archivo
• Recuperar un ficheró basado en archivo
Haga una lista del encabezado y del índice

Antes de empezar
Para ejecutar este comando, debe desactivar el subsistema al que pertenece el archivo.
Procedimiento
1. En una ventana de línea de comandos, cambie al directorio PI\adm.
2. Escriba:

Reparaciones
pidiag -fb path [-header | -dv]

donde path es la ruta completa del archivo.
Use la ópción -header para hacer una lista del encabezado solamente (no del índice).
Utilice la ópción -dv para mostrar solo la versión del archivo.
Si el comando arroja un error, consulte Recuperar un ficheró basado en archivo para
solucionarlo.
Con la infórmación del encabezado, el Soporte Tecnicó OSIsoft puede determinar si existen
errores en la estructura del archivo:
D:\PI\adm>pidiag -fb d:\pi\dat\pidigst.dat -header
PIfilebaseheader[$Workfile: pifile.cxx $ $Revision: 125 $]::
File Name: D:\PI\dat\pidigst.dat
Major Version: 4
Minor Version: 0
Byte Alignment: 1
Directory Location: 1024
Directory Size: 1024
Record Count: 18
Last Recno: 0
Maximum Recno: 128
User Block Size: 512
Data Location: 2048
Data Size: 23325
Auto Compact %: 0
Last Modified: 10-Sep-09 09:45:11
Backup Time: 25-Aug-09 14:26:11
PIsecureobject[$Workfile: pisecobj.cxx $ $Revision: 46 $]::
ACL ID: 1 [ 1:A(r,w)|5:A(r)|2:A(r) ]
% unused: 0
Comprimir archivo de base de un archivo

Si un archivo tiene mas del 10 % de espacio sin utilizar, puede comprimir el archivo para
ahorrar espacio en disco.
Antes de empezar
Para ejecutar este comando, debe desactivar el subsistema al que pertenece el archivo.
Procedimiento
1. Encuentre el porcentaje de espacio no utilizado en un archivo. Consulte Haga una lista del
encabezado y del índice.
2. En una ventana de línea de comandos, cambie al directorio PI\adm.
3. Escriba:
pidiag -fbcpath [-header]
donde path es la ruta completa del archivo.
Use la ópción -header para hacer una lista del encabezado solamente.
Recuperar un fichero basado en archivo

Puede recuperar un ficheró basado en archivo que tenga un índice danadó o registros
inaccesibles o danadós. Use este procedimiento para recuperar registros de datos legibles de
un ficheró basado en archivo y reconstruir el índice.

Reparaciones
Nota:
Durante la recuperación de archivos, este comando descarta los registros ilegibles e
imprime un mensaje de error. Use esta herramienta solamente bajo la supervisión del
Soporte Tecnicó OSIsoft.
Procedimiento
1. En una ventana del símbóló del sistema, cambie al directorio PI\adm
2. Escriba:
pidiag -fbf
inpath outpath
[alignment] [-compress] [-header]
con las siguientes opciones:

inpath Ruta y nombre del archivo de entrada.
outpath Ruta y nombre del archivo de salida.
alignment Opcional. Define la alineación de bytes del archivo de salida. Un valor de 0 o 1
permite que el archivo aumente su tamanó a 2 GB. Los valores superiores
permiten que el archivo aumente su tamanó a 2 GB multiplicados por el valor
especificadó. Por ejemplo, con una alineación de 2, el archivo aumenta a 4 GB;
con una alineación de 4, el archivo puede aumentar a 8 GB.
-compress Opcional. Elimina los registros no utilizados al final del archivo y asigna el
espacio en disco no utilizado.
-header Opcional. Muestra solamente el encabezado del archivo nuevo en lugar del
encabezado y el índice del archivo nuevo despues de la recuperación.
Resultados
En algunos casos, pidiag -fbf informa lo siguiente:
Error reading input record # nn [-10466] No Record Available for Passed recno
Esto es habitual para los registros que se encuentran entre el ultimó registro real y el registro
maximó asignado. La advertencia desaparece si ejecuta la utilidad nuevamente.
Recuperarse de un cambio accidental de la hora del sistema

PI Data Archive administra autómaticamente todos los cambios en la hora del sistema. OSIsoft
le recomienda que nunca cambie manualmente la hora del sistema. En Windows, use siempre la
ópción DST autómatica.
De todos modos, los cambios son necesarios y pódrían ocasionar errores humanos. Por
ejemplo, en lugar de cambiar el reloj a las 2 a. m., se cambia a las 2 p. m. Tambien se ha sugerido
que el software de sincrónización de hora, disenadó para mantener la precisión de los relojes
de los equipos sin intervención de personas que puedan cometer errores, ha cambiado los
relojes de sistema de manera incorrecta. Como resultado, los eventos se registran en el futuro.
Normalmente, esto se detecta despues de que muchos de estos eventos ya se almacenaron en el
Procedimiento
1. Detenga PI System.
2. Corrija la hora del sistema y de todos los nodos conectados.

Reparaciones
Nota:
Si usa PI Buffer Subsystem para realizar el buffering de datos de interfaces de PI,
consulte Recuperarse del cambio de hora accidental en el nodo interfaz que utiliza PI
Buffer Subsystem.
3. Aísle el servidor PI Data Archive de los nodos interfaces. La mejor tecnica consiste en
desconectar el servidor de la red. Durante este tiempo, permita el almacenamiento en bufer
de datos hasta verificar que el sistema este funcionando normalmente.
4. Renombre el archivo de la cola de eventos (pimapevq.dat) para su procesamiento
posterior. La cola de eventos puede contener muchos eventos futuros. Renombre los
siguientes archivos almacenados en el directorio dat:
◦ pilastsnap.dat
◦ pilasttot_T.dat
◦ pilastalarm.dat
5. Cree un ficheró de archivado vacíó usando PI SMT o la utilidad piarcreate.
6. Escriba pidiag -ar y registre solamente el nuevo archivo vacíó.
7. Existen dos opciones para reparar la snapshot:
◦ Si es posible descartar los datos erróneós del futuro, inicie PI Snapshot Subsystem con el
flag -f, como se describe en Recuperarse de horas futuras en la snapshot.
◦ De lo contrario, conserve el archivo actual y, despues de iniciar el sistema, elimine o edite
valores individuales usando la utilidad piconfig, tal como se explica anteriormente.
8. Inicie el servidor PI Data Archive en el modo basicó:
pisrvstart -base
Esto inicia solamente los subsistemas mínimós requeridos: PI Network Manager, PI Message
Subsystem, PI License Manager, PI Update Manager, PI Snapshot Subsystem, PI Archive
Subsystem y PI Base Subsystem.
9. Registre todos los ficherós de archivado anteriores, salvo el archivo primario anterior con
datos del futuro.
10. Antes de usar el procesamiento de archivos históricós fuera de línea para fusionarlos,
examine el encabezado del ficheró de archivado no registrado para cónfirmar los límites de
tiempo de los diversos archivos históricós involucrados:
a. Para ver el encabezado de un archivo no registrado:
pidiag -ahd
b. Para ver los archivos registrados:
piartool -al
11. Cree un archivo primario nuevo usando el comando piartool -ac.
a. Especifique una hora de inicio anterior a cualquier evento futuro. Especifique el tiempo
de finalización como *.
Esto le indica a PI Archive Subsystem que registre el nuevo archivo como archivo
primario. La hora de inicio especificada debe abarcar todos los datos sujetos a buffering.
Si no esta seguro, defina la hora de inicio mucho antes de la hora en que ócurrió el
problema por primera vez.
b. Si es necesario, use despues el procesamiento de archivos históricós fuera de línea para
fusionar estos datos con archivos existentes.
12. Verifique que el PI System este ejecutandóse correctamente. Vuelva a conectar el servidor a
la red.

Reparaciones
13. Vuelva a procesar el antiguo archivo primario usando la herramienta fuera de línea para
filtrar los datos del futuro, o corrija la hora del archivo históricó con la diferencia necesaria.
14. Vuelva a procesar la cola de eventos en un ficheró de archivado y corrija las marcas de
tiempo necesarias.
15. Si lo desea, combine dos archivos históricós: el archivo primario antiguo y el resultado de la
cola de eventos.
16. Registre el ficheró de archivado corregido.
Recuperarse del cambio de hora accidental en el nodo interfaz que utiliza PI

Buffer Subsystem
Si la marca de tiempo de un nodo interfaz se módifica a una marca de tiempo futura y ese nodo
utiliza PI Buffer Subsystem, debera completar los pasos adicionales.
Procedimiento
1. Detenga PI Buffer Subsystem.
2. Detenga los nodos interfaz.
3. Elimine el archivo pibufmem.dat.
4. Reinicie PI Buffer Subsystem.
5. Reinicie los nodos interfaz.

Soporte técnico y otros recursos
Para obtener asistencia tecnica, póngase en contacto con el soporte tecnicó de OSIsoft llamando
al +1 510-297-5828 o visitando la pagina Contact Us del Soporte Tecnicó OSIsoft (https://
techsupport.osisoft.com/Contact-Us/). El sitio web ofrece mas opciones de contacto para
clientes fuera de los Estados Unidos.
Cuando se ponga en contacto con el soporte tecnicó de OSIsoft, tenga a mano la siguiente
infórmación:
• Nombre de producto, versión y numerós de versión
• Detalles sobre la plataforma del equipo (tipo de CPU, sistema operativo y numeró de
versión)
• Hora a la que se inició el problema
• Archivos de registro en ese instante concret
• Detalles sobre cualquier cambio en el entorno antes de que se produjera el problema
• Resumen del problema, incluidos los archivos de registro pertinentes durante el intervalo de
tiempo en que se produjo el problema
Para consultar a otros usuarios del software OSIsoft, participe en la comunidad de usuarios de
OSIsoft, PI Square (https://pisquare.osisoft.com). Los integrantes de la comunidad pueden
solicitar asesoramiento y compartir ideas sobre PI System. El espacio PI Developers Club
dentro de PI Square ofrece recursos para ayudarle con la prógramación e integración de los
productos OSIsoft.

Soporte técnico y otros recursos

PI Data Archive 2018 System Management Guide ES

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

PI Data Archive 2018 System Management Guide ES

Cargado por

Copyright:

Formatos disponibles

PI Data Archive 2018

Guía de administración del sistema

Guía de administrador del sistema PI Data Archive 2018

Introducción a la administración del sistema PI Data Archive.................................... 1

Herramientas para la administración de PI Server.................................................... 7

Flujo de datos de PI Data Archive..........................................................................11

Iniciar y detener PI Data Archive........................................................................... 17

Especificaciones y consideraciones de hora............................................................23

Copias de seguridad de PI Data Archive................................................................. 31

Guía de administrador del sistema PI Data Archive 2018 iii

iv Guía de administrador del sistema PI Data Archive 2018

Registros de archivos históricos...........................................................................................................88

Seguridad de PI Data Archive............................................................................. 129

Datos futuros.................................................................................................... 147

Guía de administrador del sistema PI Data Archive 2018 v

Productos que admiten datos futuros....................................................................................................148

Supervisión de PI Data Archive............................................................................175

Parámetros de ajuste de PI Data Archive............................................................. 187

PI SQL Subsystem............................................................................................. 189

vi Guía de administrador del sistema PI Data Archive 2018

Configuración de PI SQL Subsystem..................................................................................................... 190

Recuperación de datos con fuentes de datos externas.......................................... 197

Resolución de problemas.................................................................................... 203

Soporte técnico y otros recursos......................................................................... 229

Guía de administrador del sistema PI Data Archive 2018 vii

viii Guía de administrador del sistema PI Data Archive 2018

Descripción general de PI System

Guía de administrador del sistema PI Data Archive 2018 1

◦ PI Asset Framework (PI AF)

Estructura del directorio de PI Data Archive

2 Guía de administrador del sistema PI Data Archive 2018

Prácticas recomendadas del sistema de archivos de PI Data

Subsistemas de PI Data Archive

Guía de administrador del sistema PI Data Archive 2018 3

Subsistema Ejecutable Finalidad Dependencias

Performace Equations pipeschd.exe Realiza calculós de ecuaciones de rendimiento (PE)

4 Guía de administrador del sistema PI Data Archive 2018

Subsistema Ejecutable Descripción

Guía de administrador del sistema PI Data Archive 2018 5

6 Guía de administrador del sistema PI Data Archive 2018

PI System Management Tools (SMT)

PI Interface Configuration Utility (ICU)

Guía de administrador del sistema PI Data Archive 2018 7

Administrador de almacenamiento en búfer

8 Guía de administrador del sistema PI Data Archive 2018

Guía de administrador del sistema PI Data Archive 2018 9

10 Guía de administrador del sistema PI Data Archive 2018

Guía de administrador del sistema PI Data Archive 2018 11

En la ilustración precedente, la interfaz informa a PI Data Archive de los valores A, D y C. El

12 Guía de administrador del sistema PI Data Archive 2018

Desactivar el informe de excepciones

PI Data Archive evalua el snapshot anterior en cuanto a las especificaciónes de cómpresión y

Estos valores en PI Snapshot Subsystem se denominan eventos de snapshot o simplemente

Guía de administrador del sistema PI Data Archive 2018 13

El mismo principio se aplica a la cómpresión de datos reales. PI Data Archive utiliza un

14 Guía de administrador del sistema PI Data Archive 2018

Directrices relativas a la compresión

Guía de administrador del sistema PI Data Archive 2018 15

• Activar la cómpresión para las senales con ruido.

La cola de archivado se produce en los siguientes casos:

16 Guía de administrador del sistema PI Data Archive 2018

Iniciar PI Data Archive

Iniciar PI Data Archive como un servicio de Windows

Configurar el inicio automático de los servicios