OCI y Windows local

En esta sección se describen los pasos para configurar Oracle Management Agent y desplegar los plugins de JMS en un host de Windows local o de OCI mediante el script de instalación. Los conjuntos de JMS no soportan Oracle Cloud Agent para OCI Windows, por lo que el script instala OMA en todas las plataformas de Windows.

Requisitos:

Ejecute la secuencia de comandos de instalación con privilegios de administrador.

Nota

De forma predeterminada, la secuencia de comandos de instalación:

Genere un rastreador de uso con funcionalidad adicional para recopilar la propiedad user.name para identificar mejor las aplicaciones que se ejecutan en servidores de aplicaciones como WebLogic y Tomcat. Si no desea activar esta función, actualice el parámetro --enable-user-name=false en el script de instalación. Puede modificar el archivo de propiedades de Java Usage Tracker en el futuro para agregar o eliminar user.name de la sección additionalProperties.
Instale el agente con la configuración de Frecuencia de telemetría inferior de JMS.
En sistemas de bits de Windows 64, tiene la opción de utilizar la frecuencia de telemetría por defecto de MACS en lugar de la frecuencia de telemetría inferior de JMS. Cambie el valor del parámetro low-telemetry-interval a false en el script de instalación. El valor por defecto es true.
Cree la variable de entorno OVERRIDE_VERSION_CHECK si no está presente y defínala en true en instancias de Windows 10, sustituyendo la comprobación de versión del servicio Management Agent. Management Agent Service solo soporta el servicio de gestión de Java en la plataforma Windows 10.

Ejecute el comando --help para ver la descripción de opciones como activar o desactivar el nombre de usuario, la configuración de proxy, etc.

A continuación se muestran los parámetros opcionales junto con la descripción:


-u, --uninstall              Uninstall plug-ins, delete configuration files or restore originals from backups and exit.
-r, --reinstall              Uninstall plug-ins, delete configuration files or restore originals from backups and continue installation.
-h, --help                   Print usage message end exit.
--diagnostic                 Determines if prerequisite conditions are met on the host machine to allow for successful agent installation or upgradation, and plug-in deployment. 
                             Installation attempt will be skipped.
--enable-user-name           Generate usage tracker with additional functionality to collect the 'user.name' property for better identification 
                             of applications running on Application Servers like WebLogic and Tomcat servers. 
                             Default value is 'true'. 
--force-32bit-installer      Force 32 bit Management Agent installation. Use this parameter to monitor a 32 bit Windows instance.
--ignore-unsupported         The setup will proceed on an unsupported platform. 
                             Installation might be successful, but not all functionality might work as intended.
--proxy-host                 Add proxy host to curl commands, add or replace line 'ProxyHost = VALUE' in install key before Management Agent setup.
                             Format is --proxy-host="VALUE" (for example, --proxy-host="100.0.0.10").
                             Default is no proxy.
--proxy-port                 Add proxy port to curl commands, add or replace line 'ProxyPort = VALUE' in install key before Management Agent setup.
                             Format is --proxy-port="VALUE" (for example, --proxy-port="8050"). 
--proxy-password             Add proxy password to curl commands, add or replace line 'ProxyPassword = VALUE' in install key before Management Agent setup.
                             Format is --proxy-password="VALUE" (for example, --proxy-password="example"). 
--proxy-realm                Add or replace line 'ProxyRealm = VALUE' in install key before Management  Agent setup.
                             Format is --proxy-realm="VALUE" (for example, --proxy-realm="OC1").
--proxy-user                 Add proxy user to curl commands, add or replace line 'ProxyUser = VALUE' in install key before Management Agent setup.
                             Format is --proxy-user="VALUE" (for example, --proxy-user="opc").
--use-agent-installer-path   Path to management agent installation file if it isn't in the same folder as the install script. 
--use-java-path              Specify the Oracle Java 8 installation path for agent installation; 
                             if the path is not specified, the script will attempt to find a suitable Oracle Java 8 installation path from the file system. 
                             Format is --use-java-path={CUSTOM_PATH}(for example, --use-java-path="C:\Program Files\Java\jdk1.8.0_361").
--low-metrics-frequency      Installs the agent with low frequency telemetry configuration instead of MACS default frequency. 
                             Default value is 'true'. Applicable on Windows 64 bit instances only. 
--use-agent-display-name     Specify the name to be displayed on the MACS console of your Management Agent.
                             If the name is not specified, the script will generate the name automatically.

Pasos

Abra PowerShell como administrador.

Nota

Se necesita PowerShell versión 5.1 o cualquier versión inferior a 7 para ejecutar el instalador o el script de instalación.
Para asegurarse de que tiene los permisos correctos para ejecutar el script, escriba Set-ExecutionPolicy RemoteSigned y responda A.

(Comprobación de diagnóstico opcional) Navegue hasta la carpeta en la que guardó el script de instalación y el software del agente de gestión. Ejecute el script con el siguiente comando:

.\JMS_YourFleetName_windows.ps1 --diagnostic

Según el sistema operativo y el tipo de agente, los resultados serán similares a:

Fallo de diagnóstico:

======================================================================================================
Diagnostic Summary
======================================================================================================
User has administrator privileges? : Yes
Powershell version meets requirements? : Yes
Certified OS? : Yes
Able to reach OCI endpoint? : No 
Check your internet connection and proxy setting.
Is clock sync with OCI platform? : Unknown 
The clock sync check was skipped. Can't read headers from provided OCI endpoint.
Certificate verification has been passed? : Unknown 
The certificate check was skipped. Can't read certificate from provided OCI endpoint.
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Available Java for agent installation ? : Yes
Management Agent installer available? : Yes
======================================================================================================
Diagnostics have failed. Please resolve all issues and run the deployMgmtAgent.ps1 script again.

El diagnóstico se ha realizado correctamente:

======================================================================================================
Diagnostic Summary
======================================================================================================
User has administrator privileges? : Yes
Powershell version meets requirements? : Yes
Certified OS? : Yes
Able to reach OCI endpoint? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Available Java for agent installation ? : Yes
Management Agent installer available? : Yes
======================================================================================================
Diagnostics have finished running and no error occurred.

Consulte Running Agent Installation Diagnostics para obtener la lista completa de preguntas con soluciones o recomendaciones.

Vaya a la carpeta en la que ha descargado el script y el software del agente de gestión. Ejecute el script con el siguiente comando:
```
.\JMS_YourFleetName_windows.ps1
```
- Si la instalación se realiza correctamente, verá un mensaje similar al siguiente:
```
...
Agent was successfully registered using key YourFleetName (ocid1.managementagentinstallkey.oc1.<ocid hash>) and assigned to fleet YourFleetName (ocid1.jmsfleet.oc1.<ocid hash>)
Management Agent with plugins installation has been completed.
```
- En caso de que el agente ya esté instalado, el script actualizará el software del agente a la última versión, si corresponde. Si los plugins de JMS aún no se han desplegado, despliegue Seguimiento de uso de Java y Java Management Service de forma manual, como se describe en la página Desplegar un plugin de servicio mediante la página Agentes. O bien, puede volver a instalar el agente junto con el despliegue del plugin JMS; ejecute el script con el parámetro --force.
(Opcional) Escriba lo siguiente para verificar si la instalación se ha realizado correctamente: Get-Service -name mgmt_agent.

Los archivos log se encuentran en el directorio C:\Oracle\mgmt_agent\plugins\jm\stateDir\log.

Documentación de Oracle Cloud Infrastructure

OCI y Windows local