Linux in locale

In questa sezione vengono descritti i passi per impostare l'Oracle Management Agent e distribuire i plugin JMS su un host Linux in locale utilizzando lo script di installazione.

I prerequisiti

Eseguire lo script di installazione con sudo o accesso amministrativo.

Nota

Per impostazione predefinita, lo script di installazione consente di:

Creare o aggiornare il file delle proprietà di Java Usage Tracker 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 attivare questa funzione, eseguire lo script di installazione con l'argomento --enable-user-name=false. È possibile modificare il file delle proprietà di Java Usage Tracker in futuro per aggiungere o rimuovere user.name dalla sezione additionalProperties.
Disabilitare la modalità FIPS (Federal Information Processing Standards) per i plugin.
Il plugin legge la variabile di ambiente di sistema ENV_AGENT_PLUGIN_FIPS_APPROVED e, se viene rilevata, abilitare la modalità FIPS per i plugin. USGov recidive. Per creare o modificare questa variabile, eseguire lo script di installazione con l'argomento --enable-fips-mode=true.
Installare l'agente con la frequenza di telemetria predefinita MACS.

Eseguire il comando --help per visualizzare la descrizione di opzioni quali l'abilitazione o la disabilitazione di nome utente, impostazioni proxy, FIPS 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'. 
--enable-fips-mode            Enable FIPS mode for plug-ins in USGov realms.
                              Format is --enable-fips-mode=true|false (for example, --enable-fips-mode=false).
                              Modify /etc/environment and create a line with ENV_AGENT_PLUGIN_FIPS_APPROVED=true or false.
                              Default value is false.
--install-management-agent    Installation of OMA on the OCI compute instance.                               
--uninstall-management-agent  Uninstallation of OMA on the OCI compute instance.                                
--reinstall-management-agent  Force OMA installation on the OCI compute instance and remove existing OMA.                               
--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-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").
--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").
--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=/usr/java/jdk1.8.0_361)).    
--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

(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:

$ sudo bash ./JMS_YourFleetName_linux.sh --diagnostic

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

Diagnostica non riuscita:

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : No    
   Found 2 files with 'oracle.mgmt_agent*.rpm' pattern in /home/opc folder.    
   Please, run script test_linux.sh again with --use-agent-installer-path parameter.
Management Agent has been detected? : No
======================================================================================================
Diagnostics have failed. Please resolve all issues and run script test_linux.sh again.

Diagnostica completata e riuscita:

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : Yes
Existing Management Agent has been detected? : Yes
Existing Management Agent has JMS plugins? : Yes
Existing Management Agent can be upgraded? : 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 sono stati salvati lo script di installazione e il software del Management Agent. Eseguire lo script utilizzando il comando seguente:
```
$ sudo bash ./JMS_YourFleetName_linux.sh
```
- Se l'installazione ha esito positivo, verrà visualizzato un messaggio simile al seguente:
```
...
Management Agent installation has been completed.
Management Agent plugin 'Java Management Service' installation has been completed.
Management Agent plugin 'Java Usage Tracking' installation has been completed.
Management Agent was successfully registered using key YourFleetName (ocid1.managementagentinstallkey.oc1.iad.<ocid hash>).Assigned JMS Fleet is YourFleetName (ocid1.jmsfleet.oc1.iad.<ocid hash>).
```
- 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.

(Facoltativo) Per verificare se il Management Agent è in esecuzione, digitare:

$ sudo systemctl status mgmt_agent

I risultati mostreranno:

mgmt_agent.service - mgmt_agent
   Loaded: loaded (/etc/systemd/system/mgmt_agent.service; enabled; vendor preset: disabled)
   Active: active (running) since Wed 2022-08-24 07:05:38 GMT; 24s ago
  Process: 1772 ExecStart=/opt/oracle/mgmt_agent/agent_inst/bin/agentcore start sysd (code=exited, status=0/SUCCESS)
 Main PID: 1864 (wrapper)
   Memory: 414.6M
   CGroup: /system.slice/mgmt_agent.service
           ├─1864 /opt/oracle/mgmt_agent/agent_inst/bin/./wrapper /opt/oracle/mgmt_agent/agent_inst/bin/../config/wrapper.conf wrapper.syslog.ident=mgmt_agent wrapper.pidfile=/opt/oracle/mgmt_agent/agent_inst/bin/../log...
           └─2171 /usr/java/jdk1.8.0_301-amd64/bin/java -Dorg.tanukisoftware.wrapper.WrapperSimpleApp.maxStartMainWait=5 -Djava.security.egd=file:///dev/./urandom -XX:+HeapDumpOnOutOfMemoryError -Dpolyglot.engine.AllowE...

Aug 24 07:05:21 name-agent-stage systemd[1]: Starting mgmt_agent...
Aug 24 07:05:21 name-agent-stage agentcore[1772]: Removed stale pid file: /opt/oracle/mgmt_agent/agent_inst/bin/../log/mgmt_agent.pid
Aug 24 07:05:21 name-agent-stage agentcore[1772]: Starting mgmt_agent...
Aug 24 07:05:33 name-agent-stage agentcore[1772]: Waiting for mgmt_agent..............
Aug 24 07:05:34 name-agent-stage sudo[2752]: mgmt_agent : TTY=unknown ; PWD=/opt/oracle/mgmt_agent/agent_inst/bin ; USER=root ; ENV=ORACLE_CLOUD_AGENT_PLUGIN_COOKIE=<Cookie_ID> LOGDIR=/opt/or...
Aug 24 07:05:38 name-agent-stage systemd[1]: Started mgmt_agent.

È inoltre possibile visualizzare la console per verificare se il Management Agent è in esecuzione. Per ulteriori informazioni, vedere Panoramica della console dei Management Agent.

I file di log si trovano nella directory /opt/oracle/mgmt_agent/plugins/jm/stateDir/log.

Documentazione di Oracle Cloud Infrastructure

Linux in locale