OCI e Windows On-premises

Esta seção descreve as etapas para configurar o Oracle Management Agent e implantar os plug-ins JMS em um host do Windows local ou do OCI usando o script de instalação. O JMS Fleets não suporta o Oracle Cloud Agent para o OCI Windows; portanto, o script instala o OMA em todas as plataformas Windows.

Pré-requisitos:

Execute o script de instalação com privilégios de administrador.

Observação

Por padrão, o script de instalação:

Gere um rastreador de uso com funcionalidade adicional para coletar a propriedade user.name para melhor identificação de aplicativos em execução em Servidores de Aplicativos, como WebLogic e Tomcat. Se você não quiser ativar esse recurso, atualize o parâmetro --enable-user-name=false no script de instalação. Você pode modificar o arquivo de propriedades do Rastreador de Uso do Java no futuro para adicionar ou remover user.name da seção additionalProperties.
Instale o agente com a configuração de frequência de telemetria inferior do JMS.
Em sistemas de bits do Windows 64, você tem a opção de usar a frequência de telemetria padrão MACS em vez da menor frequência de telemetria JMS. Altere o valor do parâmetro low-telemetry-interval para false no script de instalação. O valor padrão é true.
Crie a variável de ambiente OVERRIDE_VERSION_CHECK se ela não estiver presente e defina-a como true nas instâncias do Windows 10, substituindo a verificação de versão do Serviço Management Agent. O Serviço do Management Agent suporta apenas o serviço Java Management na plataforma Windows 10.

Execute o comando --help para exibir a descrição de opções, como ativar ou desativar nome de usuário, definições de proxy etc.

Estes são os parâmetros opcionais juntamente com a descrição:


-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 the absolute path and not a relative path. For example, --use-agent-installer-path="C:\User\vmUser\Downloads"
--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. 
                             Use the absolute path and not a relative path. Format is --use-java-path={CUSTOM_PATH}(for example, --use-java-path="C:\Program Files\Java\jdk1.8.0_451").  
--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.

Etapas

Abra PowerShell como administrador.

Observação

É necessário o PowerShell versão 5.1 ou qualquer versão abaixo de 7 para executar o instalador ou o script de instalação.
Para garantir que você tenha as permissões corretas para executar o script, digite Set-ExecutionPolicy RemoteSigned e responda A.

(Verificação de diagnóstico opcional) Navegue até a pasta em que você salvou o script de instalação e o software do agente de gerenciamento. Execute o script usando o comando a seguir:

.\JMS_YourFleetName_windows.ps1 --diagnostic

Dependendo do sistema operacional e do tipo de agente, os resultados serão semelhantes a:

Falha no 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.

O diagnóstico foi concluído com sucesso:

======================================================================================================
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 Executando Diagnósticos de Instalação do Agente para obter a lista completa de perguntas com soluções ou recomendações.

Vá para a pasta em que você fez download do script e do software do agente de gerenciamento. Execute o script usando o comando a seguir:
```
.\JMS_YourFleetName_windows.ps1
```
- Se a instalação for bem-sucedida, você verá uma mensagem semelhante a esta:
```
...
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.
```
- Caso o agente já esteja instalado, o script atualizará o software do agente para a versão mais recente, se aplicável. Se os plug-ins JMS ainda não estiverem implantados, implante os plug-ins Controle de Uso do Java e Java Management Service manualmente, conforme descrito na Página Implantar um Plug-in de Serviço Usando os Agentes. Ou você pode reinstalar o agente junto com a implantação do plug-in JMS; execute o script com o parâmetro --force.
(Opcional) Digite o seguinte para verificar se a instalação foi bem-sucedida: Get-Service -name mgmt_agent.

Os arquivos de log estão localizados no diretório C:\Oracle\mgmt_agent\plugins\jm\stateDir\log.

Documentação do Oracle Cloud Infrastructure

OCI e Windows On-premises