Windows OCI e on-premise

In questa sezione vengono descritti i passi per impostare l'Oracle Management Agent e distribuire i plugin JMS su un host Windows OCI o in locale utilizzando lo script di installazione. JMS Fleets non supporta Oracle Cloud Agent per OCI Windows, pertanto lo script installa OMA su tutte le piattaforme Windows.

I prerequisiti

Eseguire lo script di installazione con privilegi di amministratore.

Nota

Per impostazione predefinita, lo script di installazione consente di:

Genera un tracker sull'utilizzo con funzionalità aggiuntive per raccogliere la proprietà user.name per una migliore identificazione delle applicazioni in esecuzione su Application Server come WebLogic e Tomcat. Se non si desidera abilitare questa funzione, aggiornare il parametro --enable-user-name=false nello script di installazione. È possibile modificare il file delle proprietà di Java Usage Tracker in futuro per aggiungere o rimuovere user.name dalla sezione additionalProperties.
Installare l'agente con la configurazione della frequenza di telemetria JMS inferiore.
Nei sistemi a Windows 64 bit è possibile utilizzare la frequenza di telemetria predefinita MACS anziché la frequenza di telemetria inferiore JMS. Modificare il valore del parametro low-telemetry-interval in false nello script di installazione. Il valore predefinito è true.
Creare la variabile di ambiente OVERRIDE_VERSION_CHECK se non è presente e impostarla su true nelle istanze di Windows 10, ignorando il controllo della versione del servizio Management Agent. Il servizio Management Agent supporta solo il servizio Java Management sulla piattaforma Windows 10.

Eseguire il comando --help per visualizzare la descrizione di opzioni quali l'abilitazione o la disabilitazione del nome utente, delle impostazioni proxy e così via.

Di seguito sono riportati i parametri facoltativi insieme alla descrizione.


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

Passi

Aprire PowerShell come amministratore.

Nota

per eseguire il programma di installazione o lo script di installazione è necessaria la versione 5.1 o una versione inferiore a 7 di PowerShell.
Per assicurarsi di disporre delle autorizzazioni corrette per eseguire lo script, digitare Set-ExecutionPolicy RemoteSigned e rispondere a A.

(Controllo diagnostico facoltativo) Passare alla cartella in cui sono stati salvati lo script di installazione e il software del Management Agent. Eseguire lo script utilizzando il comando seguente:

.\JMS_YourFleetName_windows.ps1 --diagnostic

A seconda del sistema operativo e del tipo di agente, i risultati saranno simili a:

Diagnostica non riuscita:

======================================================================================================
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.

Diagnostica completata e riuscita:

======================================================================================================
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.

Per l'elenco completo delle domande con soluzioni o suggerimenti, vedere Esecuzione della diagnostica dell'installazione dell'agente.

Andare alla cartella in cui è stato scaricato lo script e il software del Management Agent. Eseguire lo script utilizzando il comando seguente:
```
.\JMS_YourFleetName_windows.ps1
```
- Se l'installazione ha esito positivo, verrà visualizzato un messaggio simile al seguente:
```
...
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.
```
- Se l'agente è già installato, lo script aggiornerà il software dell'agente alla versione più recente, se applicabile. Se i plugin JMS non sono ancora stati distribuiti, distribuire manualmente i plugin Java Usage Tracking e Java Management Service, come descritto nella pagina Distribuisci un plugin servizio utilizzando gli agenti. In alternativa, è possibile reinstallare l'agente insieme alla distribuzione del plugin JMS; eseguire lo script con il parametro --force.
(Opzionale) Digitare quanto segue per verificare se l'installazione riesce: Get-Service -name mgmt_agent.

I file di log si trovano nella directory C:\Oracle\mgmt_agent\plugins\jm\stateDir\log.

Documentazione di Oracle Cloud Infrastructure

Windows OCI e on-premise