PI Asset Framework. Guía de instalación y actualización de clientes. Para cliente de PI Asset Framework 2.9 incluido con PI Server 2017

Transcripción

1 PI Asset Framework Guía de instalación y actualización de clientes Para cliente de PI Asset Framework 2.9 incluido con PI Server 2017

2 OSIsoft, LLC 1600 Alvarado Street San Leandro, CA EE. UU. Tel. (01) Fax: (01) Web: Guía de instalación y actualización de cliente de PI Asset Framework 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 ningún medio, mecánico, 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 Developer s Club, PI Integrator for Business Analytics, PI Interfaces, PI JDBC driver, PI Manual Logger, PI Notifications, PI ODBC, PI OLEDB Enterprise, PI OLEDB Provider, PI OPC HDA Server, PI ProcessBook, PI SDK, PI Server, PI Square, PI System, PI System Access, PI Vision, PI Visualization Suite, PI Web API, PI WebParts, PI Web Services, RLINK y RtReports son marcas comerciales de OSIsoft, LLC. Todas las demás marcas y nombres comerciales utilizados en el presente documento pertenecen a sus respectivos propietarios. DERECHOS DEL GOBIERNO DE LOS EE. UU. Su uso, réplica o difusión por parte del Gobierno de EE. UU. está sujeto a las restricciones estipuladas en el contrato de licencia de OSIsoft, LLC, de acuerdo con lo que establecen las regulaciones DFARS , DFARS , FAR , FAR , según proceda. OSIsoft, LLC. Versión: 2.9 Publicación: 21 de abril de 2017

3 Contenido Instalación y actualización de Cliente de PI AF... 1 Instalación y actualización de PI AF Client... 1 Instalar cliente de PI AF... 2 Definir una conexión del servidor PI AF... 4 Activar varios idiomas en Cliente de PI AF... 5 Actualizar Cliente de PI AF... 5 Incompatibilidad de la versión... 7 Instalación y actualización silenciosa del cliente de PI AF...7 Extraer contenidos del paquete de instalación de PI AF... 7 Configurar la instalación silenciosa de PI AF Client... 8 Actualización silenciosa de PI AF Client Autenticación de clientes de PI AF y Windows...12 Ejecutar PI System Explorer con permisos elevados Cortafuegos entre PI AF Server y PI AF Client Cortafuegos entre cliente de PI AF y PI Data Archive Soporte técnico y otros recursos Guía de instalación y actualización de cliente de PI Asset Framework iii

4 Contenido iv Guía de instalación y actualización de cliente de PI Asset Framework

5 Esta sección incluye: Opciones de configuración para el cliente de PI Asset Framework (PI AF). Instrucciones de instalación y actualización para: Cliente de PI AF Complemento de administración para PI System Explorer Instalación silenciosa de Cliente de PI AF Seguridad para los clientes de PI AF Instalación y actualización de PI AF Client Antes de PI AF 2.7, PI SDK se instaló con el cliente de PI AF. A partir de PI AF 2.7, PI SDK no se incluye en la instalación del cliente de PI AF. La instalación del cliente de PI AF ahora incluye el subsistema de red de PI (PINS). PINS se instala en un equipo de cliente de PI AF que no incluye PI Data Archive. PINS admite las comunicaciones entre el equipo del cliente de PI AF y PI Data Archive. Subsistema de red de PI (PINS) La instalación del cliente de PI AF ahora incluye PINS. Si está actualizando un cliente de PI AF que incluye el PI SDK, la parte de PINS de la instalación del cliente de PI AF actualiza los archivos y servicios de PINS existentes. Después de instalar o actualizar el cliente 2.7 de PI AF, PINS se muestra como respaldo del subsistema de red de PI en el applet de programas y características del panel de control. PINS consta de los siguientes servicios: Administrador de red de PI (pinetmgr) Subsistema de mensajes de PI (pimsgss) La combinación del Administrador de red de PI (pinetmgr) y el Subsistema de mensajes de PI (pimsgss), así como los archivos de respaldo, se conocen como el Subsistema de red de PI. Las características del cliente de PI AF La instalación del cliente de PI AF incluye estas características opcionales: PI System Explorer PI System Explorer admite varios idiomas. Instale el paquete de idioma MUI para PI System Explorer a fin de permitir el acceso en diferentes idiomas. Si PI System Explorer no admite un determinado idioma, la interfaz de usuario se mostrará en inglés. Consulte Activar varios idiomas en Cliente de PI AF. Módulo Analysis Management PI Builder Nota: La instalación de PI System Explorer no es opcional si desea instalar el módulo Analysis Management. PI AF SDK.NET 3.5 Guía de instalación y actualización de cliente de PI Asset Framework 1

6 A partir de PI AF 2.7, PI AF SDK.NET 3.5 solo estará disponible como una función de instalación si ha instalado PI SDK previamente. Para utilizar la versión.net 3.5 de PI AF SDK, primero debe instalar PI SDK y, luego, instalar el cliente PI AF. La función se selecciona automáticamente en actualizaciones donde no se ha instalado PI SDK. Documentación del usuario de PI AF Características compartidas como parte de la instalación del servidor de PI AF Antes del PI AF 2.8.5, las características y los componentes del cliente PI AF se instalaron solo con el kit de instalación del cliente PI AF independiente. A partir del PI AF 2.8.5, las características y los componentes del cliente PI AF también están disponibles como parte del kit de instalación del servidor de PI AF como Características compartidas, además del kit de instalación del cliente PI AF independiente. En esta sección Instalar cliente de PI AF Definir una conexión del servidor PI AF Activar varios idiomas en Cliente de PI AF Actualizar Cliente de PI AF Incompatibilidad de la versión Instalar cliente de PI AF A partir de PI AF 2.7, PI SDK no se incluye en la instalación del cliente de PI AF. La instalación del cliente de PI AF ahora incluye el subsistema de red de PI (PINS). PINS se instala en un equipo de cliente de PI AF que no incluye PI Data Archive. PINS admite las comunicaciones entre el equipo de cliente de PI AF y PI Data Archive. Antes de empezar Si usted está ejecutando el programa de instalación del cliente de PI AF en el mismo equipo que el del servidor de PI AF, OSIsoft recomienda que instale primero el servidor de PI AF. Si desea instalar PI Processbook o PI WebParts, OSIsoft recomienda instalar SDK PI antes de instalar el cliente PI AF. Si desea instalar PI Builder en este equipo, primero debe instalar Microsoft Excel 2007 SP3 o una versión posterior. Si Microsoft Excel no está presente, PI Builder no se puede instalar. Asegúrese de haber cerrado todas las aplicaciones de cliente de PI AF antes de iniciar el programa de instalación del cliente de PI AF. El cliente de PI AF 2.7 (2015) admite el acceso a la versión 2.2 o una versión posterior del servidor de PI AF. El cliente de PI AF 2.8 (2016) y las versiones posteriores no permitirán una conexión de la versión 2.2 o una versión anterior del servidor de PI AF. Asegúrese de tener privilegios administrativos en el equipo. Procedimiento 1. Inicie sesión en el equipo del cliente con una cuenta con privilegios administrativos. 2. Vaya al directorio donde descargó el kit de instalación de PI AF. 3. Haga doble clic en el archivo ejecutable del kit de instalación del cliente de PI AF. Se abre la ventana Bienvenido a la instalación de Cliente de PI AF Guía de instalación y actualización de cliente de PI Asset Framework

7 4. Haga clic en Siguiente para continuar con la instalación del cliente. Se abre la ventana Programa de mejora de la experiencia del cliente del sistema PI. 5. Decida si participará en el programa o no. OSIsoft recomienda hacer clic en Sí para participar, pero puede hacer clic en No si esta vez prefiere no participar. 6. Haga clic en Siguiente para continuar. Se abrirá la ventana Carpeta de destino. Las ubicaciones predeterminadas para las aplicaciones del cliente de 32 bits y 64 bits se muestran en los campos Carpeta de destino (x86) y Carpeta de destino (x64), respectivamente. 7. Acepte el directorio de instalación predeterminado o especifique un nuevo directorio de instalación para cualquiera de los tipos de instalación. a. Haga clic en Explorar junto al tipo de instalación (de 32 bits o de 64 bits). Se abre la ventana Cambiar carpeta de destino actual. b. Especifique la carpeta de destino deseada. Vaya a la carpeta existente en el campo desplegable Buscar en... o use el botón Subir un nivel. Si desea crear una nueva carpeta en el directorio de instalación, haga clic en Crear nueva carpeta. O bien especifique una ruta de directorio de instalación en el campo Nombre de carpeta. c. Haga clic en Aceptar. 8. Haga clic en Siguiente para continuar. Se abre la ventana Información del servidor predeterminado. 9. Como paso opcional, escriba el nombre del equipo del servidor de PI AF predeterminado en el campo Servidor de recursos predeterminado. 10. Escriba el nombre del equipo del servidor de PI Data Archive predeterminado en el campo Servidor de datos predeterminado. 11. Haga clic en Siguiente para continuar. Aparecerá la ventana Seleccionar características. 12. En la ventana Seleccionar características, seleccione las características y los componentes del cliente PI AF que desea instalar: Opción PI AF SDK.NET 4 PI System Explorer Complemento Administración de análisis PI Builder PI AF SDK.NET 3.5 Documentación de usuario de PI AF Descripción Obligatorio. Proporciona acceso programático al servidor de PI Data Archive y PI AF, y es utilizado por aplicaciones del cliente de PI AF. Opcional. Una herramienta de interfaz de usuario gráfica que permite acceder al servidor de PI AF y a PI Data Archive. Incluye utilidades de AFImport y AFExport. Opcional. Un módulo de PI System Explorer para administrar los análisis en el servidor de PI AF. Requiere que se instale PI System Explorer. Opcional. Un complemento de Excel que proporciona configuración y acceso al servidor de PI Data Archive y PI AF. Esta función solo aparece si ha instalado previamente PI SDK x86 y x64, y es necesaria si desea instalar PI Processbook, PI WebParts, u otro cliente que requiere componentes.net 3.5 de PI AF SDK. Opcional. Proporciona guías de usuario de PI AF en formato de ayuda compilada. Guía de instalación y actualización de cliente de PI Asset Framework 3

8 Elija una de las siguientes acciones: Para seleccionar una sola característica, haga clic en. y seleccione Para seleccionar una característica, junto con características relacionadas, haga clic en y seleccione. Para anular una característica, haga clic en. y seleccione 13. Haga clic en Siguiente. 14. En la ventana Listo para instalar la aplicación, revise cuidadosamente las características del cliente PI AF que seleccionó, así como los servidores que aparecen en Configuración predeterminada que seleccionó para el servidor de PI AF y PI Data Archive. Si necesita cambiar algo, haga clic en Atrás y modifique las opciones que selecciona. 15. Haga clic en Instalar. Es posible que se muestre un mensaje de control de cuentas de usuario para que la instalación pueda seguir ejecutándose. Haga clic en Sí para que la instalación continúe. 16. Haga clic en Sí para que la instalación continúe desde UAC. Se abre la ventana Actualizando sistema, que muestra el progreso de la instalación. 17. Haga clic en Siguiente y, en la ventana La instalación ha finalizado, compruebe que todos los módulos en la Configuración 2017 del cliente de PI AF se hayan instalado correctamente. 18. Haga clic en Cerrar. Qué hacer a continuación Compruebe la instalación del cliente de PI AF ejecutando la aplicación de cliente de PI System Explorer. Definir una conexión del servidor PI AF Debe definir un servidor de PI AF si no introdujo un nombre de servidor de PI AF durante la instalación del cliente de PI AF. Nota: Consulte "Conexiones del servidor de PI AF" in Live Library ( livelibrary.osisoft.com) para obtener más información sobre cómo conectarse al servicio de aplicación de PI AF y otros servicios, administrar identidades y asignaciones de PI AF, y otros temas relacionados con la conexión de PI AF. Procedimiento 1. En el menú de Inicio de Windows o en la pantalla de Inicio de Windows, pulse el botón secundario sobre PI System Explorer y seleccione Ejecutar como administrador. 2. En respuesta al No se definieron servidores PI AF. Desea definir uno? mensaje, haga clic en Sí. 3. En la ventana Propiedades del servidor de PI AF, el nombre del equipo donde instaló el cliente de PI AF se muestra en el campo Host. Seleccione toda la cadena correspondiente al nombre y escriba el nombre del equipo de un servidor de PI AF en su red. 4. Haga clic en Conectar. 4 Guía de instalación y actualización de cliente de PI Asset Framework

9 Nota: Si DNS no puede resolver el nombre del equipo, es posible que deba introducir el nombre de la red completo del servidor en formato myassetserver.mycompanyname.com, o la dirección IP del servidor. 5. Haga clic en Aceptar. Debe aparecer la ventana PI System Explorer. Instalación y actualización de Cliente de PI AF Activar varios idiomas en Cliente de PI AF El cliente de PI AF admite varios idiomas. Instale el paquete de idiomas MUI 2017 de PI AF para permitir el acceso a varios idiomas. Si los componentes de cliente de PI AF no admiten un determinado idioma, la interfaz de usuario se mostrará en inglés. Procedimiento 1. Descargue el paquete de idiomas MUI 2017 de PI AF del sitio web de Soporte técnico de OSIsoft ( 2. Instale el paquete de idiomas MUI 2017 de PI AF. Actualizar Cliente de PI AF Las características que se seleccionan automáticamente dependerán de la versión a partir de la cual realizará la actualización. Si realiza la actualización a partir de una versión anterior de cliente de PI AF, es posible que algunas características que están instaladas no se puedan seleccionar, por lo que necesita para seleccionar las opciones de forma manual. Nota: A partir de PI AF 2.7, PI SDK no se incluye en la instalación del cliente de PI AF. La instalación del cliente de PI AF ahora incluye el subsistema de red de PI (PINS). PINS se instala en un equipo de cliente de PI AF que no incluye PI Data Archive. PINS admite las comunicaciones entre el equipo de cliente de PI AF y PI Data Archive. Antes de empezar Si ejecuta el programa de configuración del cliente de PI AF en el mismo equipo como el servidor de PI AF, OSIsoft recomienda que primero actualice el servidor de PI AF. Si desea instalar o actualizar PI ProcessBook o PI WebParts, OSIsoft recomienda instalar o actualizar PI SDK antes de actualizar el cliente de PI AF. Si desea instalar o actualizar PI Builder en este equipo, primero debe instalar Microsoft Excel 2007 SP3 o una versión posterior. Si Microsoft Excel no está presente, PI Builder no se puede instalar. Asegúrese de haber cerrado todas las aplicaciones de cliente de PI AF antes de iniciar el programa de instalación del cliente de PI AF. El cliente de PI AF 2.7 (2015) admite el acceso a la versión 2.2 o una versión posterior del servidor de PI AF. El cliente de PI AF 2.8 (2016) y las versiones posteriores no permitirán una conexión de la versión 2.2 o una versión anterior del servidor de PI AF. Asegúrese de tener privilegios administrativos en el equipo. Procedimiento 1. Inicie sesión en el equipo del cliente con una cuenta con privilegios administrativos. 2. Vaya al directorio donde descargó el kit de instalación de PI AF. Guía de instalación y actualización de cliente de PI Asset Framework 5

10 3. Haga doble clic en el archivo ejecutable del kit de instalación del cliente de PI AF. Se abre la ventana Mantenimiento de aplicaciones. 4. Seleccione Modificar. 5. Haga clic en Siguiente para continuar con la actualización. Aparecerá la ventana Seleccionar características. 6. Seleccione las características y los componentes del cliente de PI AF que desea actualizar en el equipo. En la ventana Seleccionar características, las características son seleccionadas de acuerdo a lo que se ha instalado previamente en el cliente de PI AF. Puede seleccionar otras características en tanto y en cuanto su equipo cumpla con los requisitos previos para cada componente seleccionado: Opción PI AF SDK.NET 4 PI System Explorer Complemento Administración de análisis PI Builder PI AF SDK.NET 3.5 Documentación de usuario de PI AF Descripción Obligatorio. Proporciona acceso programático al servidor de PI Data Archive y PI AF, y es utilizado por aplicaciones del cliente de PI AF. Opcional. Una herramienta de interfaz de usuario gráfica que permite acceder al servidor de PI AF y a PI Data Archive. Incluye utilidades de AFImport y AFExport. Opcional. Un módulo de PI System Explorer para administrar los análisis en el servidor de PI AF. Requiere que se instale PI System Explorer. Opcional. Un complemento de Excel que proporciona configuración y acceso al servidor de PI Data Archive y PI AF. Aparece si PI SDK x86 y x64 fue previamente instalado. Se requiere si desea instalar o actualizar PI Processbook, PI WebParts u otro cliente que utilice componentes de PI AF SDK.NET 3.5. Opcional. Proporciona guías de usuario de PI AF en formato de ayuda compilada. Elija una de las siguientes acciones: Para seleccionar una sola característica, haga clic en. y seleccione Para seleccionar una característica, junto con características relacionadas, haga clic en y seleccione. Para anular una característica, haga clic en. y seleccione 7. Haga clic en Siguiente. 8. En la ventana Listo para instalar la aplicación, revise cuidadosamente las características del cliente de PI AF que seleccionó, y la configuración predeterminada que seleccionó para el servidor de PI AF y PI Data Archive. Si necesita cambiar algo, haga clic en Atrás y modifique las opciones que selecciona. 9. Haga clic en Instalar. 10. Es posible que se muestre un mensaje de control de cuentas de usuario para que la actualización pueda seguir ejecutándose. Haga clic en Sí para que la instalación continúe. 6 Guía de instalación y actualización de cliente de PI Asset Framework

11 11. Haga clic en Sí para que la actualización continúe desde UAC. Se abre la ventana Actualización del sistema, que muestra el progreso de la instalación. 12. Una vez finalizado, haga clic en Siguiente para seleccionar una de las siguientes acciones: Si no se requiere realizar un reinicio, se muestra la ventana La instalación ha finalizado y usted puede validar todos los módulos que se instalaron correctamente en la instalación del cliente de PI AF Haga clic en Cerrar. Si se requiere realizar un reinicio, se muestra la ventana Reiniciar su equipo para finalizar. Puede revisar los módulos que provocaron que se requiera realizar un reinicio en la columna Comentario. Haga clic en Sí para reiniciar el equipo ahora. Incompatibilidad de la versión Entre ciertas versiones de PI AF Services y el cliente de PI AF existen las siguientes incompatibilidades: La versión 2.9 y las versiones posteriores de PI AF Services no permitirán una conexión de la versión 2.3 o una versión anterior del cliente de PI AF. La versión 2.8 y las versiones posteriores de PI AF Services no permitirán una conexión de la versión 2.2 o una versión anterior del cliente de PI AF. La versión 2.9 y las versiones posteriores del cliente de PI AF no permitirán una conexión de la versión 2.3 o una versión anterior del servidor de PI AF. La versión 2.8.x y las versiones posteriores del cliente de PI AF no permitirán una conexión de la versión 2.2 o una versión anterior del servidor de PI AF. Nota: El número de versión de una instalación previa de PI AF se puede mostrar en el panel de control Programas y características si la instalación o actualización se realizó de manera remota o utilizando la ejecución de scripts SQL. Como alternativa, quite la entrada (desinstale) del panel de control Programas y características. Nota: La versión del cliente de PI AF anterior a PI AF 2015 R2 (versión 2.7.5) no puede conectarse a un PI System que esté activado para usar abreviaturas de UOM que distinguen entre mayúsculas y minúsculas. Consulte "Distinción de mayúsculas en abreviaturas de unidades de medida" in Live Library ( Instalación y actualización silenciosa del cliente de PI AF Extraer contenidos del paquete de instalación de PI AF Ejecute el kit de instalación del cliente PI AF para extraer los archivos necesarios para realizar una instalación silenciosa y cancelar la instalación después de que se hayan extraído los archivos. Siga estos pasos para extraer el contenido del paquete del cliente de PI AF (PI AF Client_2017_.exe). Nota: Verifique el nombre de archivo ejecutable real en el kit de instalación para asegurarse de utilizar el nombre de archivo correcto en la sintaxis de la línea de comandos. El nombre de archivo ejecutable PI AF Client_2017_.exe se muestra a modo de ejemplo de uso de la sintaxis de la línea de comandos. Guía de instalación y actualización de cliente de PI Asset Framework 7

12 Procedimiento 1. Haga doble clic en el paquete para extraerlo. Si el Control de cuentas de usuario (UAC) está activado para el usuario que ha iniciado sesión, se mostrará un mensaje del UAC en el que se le preguntará si desea permitir que la instalación efectúe cambios en el equipo. 2. Haga clic en Sí para continuar. Haga clic en No para cancelar. Se mostrará un cuadro de diálogo con una ruta de extracción predeterminada para los archivos de instalación. 3. Cambie la ruta si desea extraer los archivos en una ubicación diferente. Puede usar el icono de la carpeta para buscar y seleccionar una ubicación diferente, o puede escribir una ruta nueva. 4. Haga clic en Aceptar para continuar. Haga clic en No para cancelar. Se mostrará un cuadro de diálogo con una barra de progreso que mostrará el progreso de extracción del archivo. Haga clic en Cancelar para salir del proceso de extracción. 5. Se abre la ventana Bienvenido. En este punto, los archivos se habrán extraído, por lo que podrá hacer clic en Cancel para salir de la instalación. 6. Desplácese a la ubicación en la que se extrajeron los archivos. Configurar la instalación silenciosa de PI AF Client Procedimiento 1. Extraiga el kit de instalación del cliente PI AF haciendo doble clic en el archivo. 2. Especifique el directorio para realizar la extracción. 3. Cancele al asistente de instalación cuando aparezca con un mensaje emergente. 4. Navegue hasta el directorio donde extrajo el kit de instalación del cliente PI AF. 5. Abra el archivo silent.ini y modifique el texto de configuración a la implementación deseada conforme a las instrucciones que se encuentran en el archivo silent.ini en sí. 6. Abra un mensaje emergente de comandos y navegue hasta el directorio donde está ubicado el archivo silent.ini. 7. Ejecute la instalación silenciosa con el comando: setup.exe /f silent.ini. Funciones especificadas mediante la propiedad ADDLOCAL para la instalación del cliente de PI AF En esta tabla se enumeran las funciones especificadas mediante la propiedad ADDLOCAL. Los nombres de función distinguen entre mayúsculas y minúsculas. Los valores ADDLOCAL constan de una lista separada por comas y no pueden incluir ningún espacio. Para instalar todas las funciones, use ADDLOCAL=ALL. Nota: PI AF SDK 4.0 es una función necesaria. Debe especificarse si se van a incluir funciones individuales. Nombre de la función interna/ Nombre utilizado en la línea de comandos Nombre de la función externa Descripción ALL N/C Se instalarán todas las funciones. 8 Guía de instalación y actualización de cliente de PI Asset Framework

13 Nombre de la función interna/ Nombre utilizado en la línea de comandos Nombre de la función externa Descripción FD_AFSDK PI AF SDK 4.0 (OBLIGATORIO) Esta función instala los archivos básicos de PI AF Client: PI AF SDK y Controles comunes de AF. FD_AFExplorer PI System Explorer Esta función instala PI System Explorer, que ofrece una interfaz de usuario para mostrar la estructura jerárquica de los servidores de PI AF y otras entidades de PI AF. También se incluyen las utilidades AFImport, AFExport y RegPlugIn. FD_AFAnalysisMgmt Administración (Requiere FD_AFExplorer) Esta función instala el cliente de administración en PI System Explorer. FD_AFBuilder PI Builder Esta función instala el complemento PI Builder en Excel. Si Excel no está instalado, se ignorará. FD_AFSDK35 PI AF SDK.NET 3.5 (Requiere la instalación de PISDK). Instala los componentes de AFSDK.NET 3.5 necesarios para admitir las aplicaciones basadas en.net 3.5. FD_AFDocs Documentación de PI AF Esta función instala la documentación, que es un conjunto de archivos de ayuda.chm para PI AF. Propiedades de línea de comandos para la instalación del cliente de PI AF Propiedades ADDLOCAL ALLUSERS Descripción Especifica características a instalar. Consulte Funciones especificadas mediante el argumento ADDLOCAL en la instalación de Cliente de PI AF. ADDLOCAL=ALL Se instalan todas las funciones del cliente de PI AF. Especifica el contexto de instalación por equipo o por usuario. Debe especificarse un valor de 1, el cual corresponde a la instalación por equipo. ALLUSERS=1 El contexto de instalación es el equipo. Guía de instalación y actualización de cliente de PI Asset Framework 9

14 Propiedades REBOOT AF_SERVER AFSDKONLY Descripción Permite al equipo reiniciarse durante el proceso de instalación. Utilice el valor Suprimir para las instalaciones silenciosas. REBOOT=SUPPRESS Cualquier reinicio del equipo se suprimirá hasta finalizar la instalación del paquete. Especifica el nombre del servidor de PI AF predeterminado (el equipo donde reside el servicio de aplicación de PI AF) del cliente. Si el usuario no define un valor y el servicio de aplicación de PI AF no reside en el equipo de instalación de destino, el nombre del servidor de PI AF predeterminado no se establecerá durante la instalación. Si no fue establecido, el nombre del servidor de PI AF predeterminado puede establecerse de forma manual una vez finalizada la instalación. Si un valor no está definido y el servicio de aplicación de PI AF ya se ha instalado en el mismo equipo, el equipo actual se establece como el servidor de PI AF predeterminado. La propiedad AF_SERVER no se utiliza durante una actualización. 0: Predeterminado. Ningún cambio en la instalación. 1: En una instalación limpia, instala solo AF SDK. Si es una actualización, se actualizará de forma normal. SENDTELEMETRY 0: El valor predeterminado durante la instalación silenciosa es 0. 1: Especifica la participación en el Programa de comentarios de clientes de PI System. SHUTDOWN_OPTIONS SKIPLAUNCHCONDITIONS Especifica si la instalación silenciosa debe detener o no los servicios y las aplicaciones que tienen bloqueado y en uso el archivo AFSDK.dll al momento de la actualización. 1: Cerrar las aplicaciones automáticamente e intentar reiniciar durante la instalación 2: No cerrar las aplicaciones. (Es necesario reiniciar). Cuando no esté configurado, la opción predeterminada será SHUTDOWN_OPTIONS=1 para evitar que el usuario tenga que reiniciar al final de la instalación. Si se especifica la opción 2, SHUTDOWN_OPTIONS=2, será necesario reiniciar si existe una actualización y el archivo AFSDK se encuentra en uso al momento de la instalación. En ese caso, se reiniciará automáticamente a menos que se establezca la opción REBOOT=Suppress. Cuando se utiliza SKIPLAUNCHCONDITIONS=1, esta opción omite la verificación de los requisitos previos y permite que se instale el archivo.msi incluso cuando no se cumple con una condición. Establecer este valor NO es una instalación recomendada. Propiedades de línea de comandos de tabla de servidores conocidos Debido a que el SDK de PI ya no se instala de forma predeterminada con el cliente de PI AF, se pueden especificar los siguientes argumentos para configurar la tabla de servidores conocidos (KST). 10 Guía de instalación y actualización de cliente de PI Asset Framework

15 Propiedad IMPORT_KST=[value] KST_INI_FILE=[path\filename] PI_ALIAS=[handle] PI_SERVER=[network path] PI_USER=[pidemo] NOPISDKBUFFERING=1 Descripción Configure en 1 para activar la importación de un archivo KST.ini existente. El archivo KST.ini se puede exportar utilizando PI SDK Utility. Especifica la ruta y el nombre de archivo del archivo KST.ini (de forma predeterminada, se exporta como KST.ini). Especifica el nombre del PI Data Archive predeterminado. Esta configuración se ignora si ya se definió un PI Data Archive predeterminado. Especifica el nombre del PI Data Archive predeterminado. Esta configuración se ignora si ya se definió un PI Data Archive predeterminado. Si no define el PI_SERVER, se creará una definición de PI Server mediante el uso del nombre del equipo local. Usuario predeterminado para el PI Data Archive predeterminado. Desactiva el almacenamiento en búfer de PI SDK a través de pibufss si PISDK ya está instalado. El valor predeterminado, si se especifica NOPISDKBUFFERING, es no cambiar el comportamiento de almacenamiento en búfer de una instalación de PI-SDK existente. Ejemplos de sintaxis de instalación silenciosa de Cliente de PI AF En la siguiente tabla, se proporcionan ejemplos de la sintaxis que podría utilizar en el archivo silent.ini junto con el archivo setup.exe del cliente AF, donde se sustituye el texto en la sección [COMMANDLINE] del archivo silent.ini. En forma alternativa, si solo debe instalar el archivo.msi del Cliente de AF (AFClient_x64.msi O AFClient_x86.msi), puede usar los ejemplos de sintaxis proporcionados, precedidos por msiexec.exe /i AFClient_x64.msi O msiexec.exe /i AFClient_x86.msi, en una ventana de símbolo del sistema. El formato del archivo.ini se divide en 4 secciones: NUMSETUPMODULES, SETUPMODULES, COMMANDLINE y UNSUPPORTED_OPERATING_SYSTEMS. NUMSETUPMODULES corresponde a la cantidad de productos que se instalará. La sección SETUPMODULES define el nombre del producto que se instalará y la sección COMMANDLINE proporciona las opciones que se transmitirán a esa instalación. La sección UNSUPPORTED_OPERATING_SYSTEMS puede utilizarse para bloquear la instalación de versiones anteriores del sistema operativo o para requerir un paquete de servicio en particular. Componentes a instalar Sintaxis Notas Cliente de PI AF en el equipo del servicio de aplicación de PI AF Para especificar el servidor de PI AF predeterminado al instalar el cliente de PI AF /qn REBOOT=Suppress ALLUSERS=1 ADDLOCAL=ALL /qn REBOOT=Suppress ALLUSERS=1 ADDLOCAL=ALL AF_SERVER=PI_AF_Server_Name Al instalar el cliente de PI AF después de la instalación del servidor de PI AF, no es necesario especificar el servidor de PI AF predeterminado, ya que el programa de instalación ya lo ha hecho. Debe especificar el servidor de PI AF predeterminado usando la propiedad AF_SERVER. Guía de instalación y actualización de cliente de PI Asset Framework 11

16 Componentes a instalar Sintaxis Notas Características específicas del cliente de PI AF Para instalar PI AF SDK 4.0, los archivos comunes y la documentación sin PI System Explorer ni Management: /qn REBOOT=Suppress ALLUSERS=1 DDLOCAL=FD_AFSDK,FD_AFDocs Para instalar PI AF SDK 4.0, PI System Explorer sin los componentes de Management y los archivos comunes sin la documentación: /qn REBOOT=Suppress ALLUSERS=1 ADDLOCAL=FD_AFSDK,FD_AFExplorer Para especificar el servidor de PI AF y los nombres del servidor de PI, e instalar AF SDK, PI System Explorer, Management y PI Builder: /qn REBOOT=Suppress ALLUSERS=1 AF_SERVER=PI_AF_Server_Name PI_SERVER=PI_Server_Name ADDLOCAL=FD_AFSDK,FD_AFBuilder, FD_AFAnalysisMgmt Para instalar AF SDK, PI Builder y AF SDK para.net 3.5 (si está instalado PI SDK): /qn REBOOT=Suppress ALLUSERS=1 ADDLOCAL=FD_AFSDK,FD_AFBuilder,FD_AF SDK35 PI AF SDK 4.0 es una función necesaria. Actualización silenciosa de PI AF Client Al actualizar una instalación de cliente anterior, no es necesario especificar otra vez los argumentos o las características de PI AF: msiexec.exe /i AFClient_Version #.msi REBOOT=Suppress ALLUSERS=1 /qn Autenticación de clientes de PI AF y Windows El PI AF SDK se instala como parte de la instalación del cliente de PI AF. PI System Explorer y otros clientes de PI AF SDK se comunican con el servidor de PI AF utilizando la autenticación de Windows. El PI AF SDK no se conecta nunca directamente con SQL Server excepto para configurar un colectivo de PI AF. Cuando intente conectarse a un servidor de PI AF a través de PI System Explorer, se utilizarán sus credenciales de inicio de sesión. Si tiene permiso para acceder al servidor de PI AF, se produce la conexión. Si usted no tiene los derechos apropiados, se abre una ventana de acceso donde puede introducir las credenciales. Por ejemplo, esto se puede producir si ha iniciado sesión como usuario local, no es un usuario de dominio o el equipo del cliente está en un dominio que no es el del servidor de PI AF. Ejecutar PI System Explorer con permisos elevados Si ejecuta PI System Explorer u otro cliente de PI AF directamente en el equipo del servidor de PI AF y el sistema operativo tiene activado el control de cuentas de usuario, el uso de una cuenta administrativa local no elevará la cuenta. Se le solicitará que reinicie con permisos elevados. Para evitar este mensaje de aviso, seleccione una de estas opciones: 12 Guía de instalación y actualización de cliente de PI Asset Framework

17 Procedimiento Ejecute PI System Explorer como administrador: a. En el menú Inicio, pulse con el botón secundario del ratón sobre PI System Explorer u otro cliente de PI AF. b. Seleccione Ejecutar como administrador. Configure PI System Explorer para ejecutarlo como Administrador cada vez que se inicie: a. En el menú Inicio, pulse con el botón secundario del ratón sobre PI System Explorer (u otro cliente de PI AF). b. Seleccione Propiedades. c. En la pestaña Compatibilidad, seleccione la casilla de verificación Ejecutar este programa como administrador. Modifique los valores de seguridad de PI AF para que el usuario o un grupo que contenga el usuario (que no sea el grupo local Administradores) tenga los privilegios correctos. Cortafuegos entre PI AF Server y PI AF Client Toda la conectividad entre un cliente de PI AF y un servidor de PI AF tiene lugar a través de PI AF SDK. Los puertos correspondientes deben estar abiertos. La conexión del servidor de PI AF debe utilizar la dirección IP o el nombre DNS del servidor de PI AF y no del nombre del equipo. De forma predeterminada, el PI AF SDK se comunica con el servidor de PI AF a través de los puertos 5457 y El puerto 5457 es el puerto primario que el PI AF SDK utiliza para comunicarse con el servidor de PI AF desde el cliente. Algunos productos de cliente, como PI OLEDB Enterprise y PI WebParts, utilizan el puerto 5459 para comunicarse con el servidor de PI AF. En función de cómo se hayan definido las conexiones, el servidor de PI AF puede realizar una búsqueda de nombre-inverso de la dirección IP del cliente de conexión como parte del proceso de autenticación. El método seleccionado para la resolución de nombres puede exigir que el servidor de PI AF sea capaz de abrir las conexiones de salida en algunos puertos: Resolución mediante entradas en el archivo HOSTS (sin requisitos de puerto, pero los clientes deben tener direcciones IP fijas). Resoluciones mediante DNS (generalmente el puerto 53). Resolución mediante servicios de nombres NETBIOS (puerto 137). Es posible que también deba abrir el puerto 445 si desea buscar cuentas mientras administra de forma remota la seguridad de PI AF. Cortafuegos entre cliente de PI AF y PI Data Archive Los clientes de PI AF necesitan conectarse al servicio de aplicación de PI AF para poder acceder a la base de datos SQL de PI AF. Es posible que también deba conectarse directamente a PI Data Archive si los elementos de PI AF se han configurado con referencias de datos de PI point. La conexión a PI Data Archive se establece directamente desde el cliente de PI AF. No se necesita ninguna conexión ni autenticación en relación con SQL Server o el servidor de PI AF. Guía de instalación y actualización de cliente de PI Asset Framework 13

18 La comunicación con PI Data Archive necesita, de forma predeterminada, que el puerto 5450 esté abierto; sin embargo, puede modificarlo si lo desea. Para obtener más detalles, consulte el artículo de KB de OSIsoft 2820OSI8: Qué puertos del cortafuegos se deben abrir para un servidor PI? ( 14 Guía de instalación y actualización de cliente de PI Asset Framework

19 Soporte técnico y otros recursos Para obtener asistencia técnica, póngase en contacto con el soporte técnico de OSIsoft llamando al o visitando la página Contact Us del Soporte Técnico OSIsoft ( El sitio web ofrece más opciones de contacto para clientes fuera de los Estados Unidos. Cuando se ponga en contacto con el soporte técnico de OSIsoft, tenga a mano la siguiente información: Nombre de producto, versión y números de versión Detalles sobre la plataforma del equipo (tipo de CPU, sistema operativo y número 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 ( 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 programación e integración de los productos OSIsoft. Guía de instalación y actualización de cliente de PI Asset Framework 15

20 Soporte técnico y otros recursos 16 Guía de instalación y actualización de cliente de PI Asset Framework