Requisiti di Oracle Cloud Infrastructure

• È necessario confermare di aver già impostato correttamente l'ambiente Oracle Cloud Infrastructure come descritto in Impostazione di Oracle Cloud Infrastructure for Management Agent Service.

Sistemi operativi supportati

Requisiti del sistema operativo

• Requisito minimo del disco: 300 Mb di spazio libero su disco e 100 Mb aggiuntivi per il download del software Management Gateway.

  Richiede anche spazio su disco per la scrittura dei messaggi nel buffer su disco. Quest'area deve avere almeno 1 GB di spazio libero su disco.

• Utente con privilegi sudo responsabile dell'installazione del software Management Gateway sull'host.

• Java Development Kit (JDK) o Java Runtime Environment (JRE) devono essere installati sull'host prima di installare il software Management Gateway.

  Assicurarsi di aver scaricato e installato JDK o JRE versione 1.8u281 o successiva prima di avviare il processo di installazione del software di Management Gateway. Visualizza i download di Java

• Management Gateway richiede un host dedicato. Se Management Agent è già installato sull'host, installare Management Gateway su un altro host dedicato.

• Assicurarsi che /tmp non abbia il flag noexec impostato se viene attivato.

Prerequisiti di rete

• Se l'impostazione di rete prevede un firewall, assicurarsi che la comunicazione HTTPS (porta 443) sia consentita dall'host in cui Management Gateway viene distribuito nei domini Oracle Cloud Infrastructure appropriati. Il dominio pertinente dipenderà dal realm. Ad esempio, i Management Agent che utilizzano il realm commerciale Oracle Cloud Infrastructure OC1 dovranno connettersi al dominio *.oraclecloud.com.

  Oracle Cloud Infrastructure è in hosting nelle aree. Le regioni sono raggruppate in regni. La tenancy esiste in un singolo realm e può accedere a tutte le aree che appartengono a tale realm. Non è possibile accedere alle aree non presenti nel realm. Al momento, Oracle Cloud Infrastructure ha più realm. Per ulteriori informazioni su aree e realm, vedere Aree e domini di disponibilità.

  Ogni gateway appartiene a un compartimento OCI specifico. Tutti gli agenti che si connettono tramite un gateway devono trovarsi nello stesso compartimento di tale gateway.

  È possibile utilizzare qualsiasi strumento di connettività di rete disponibile per verificare la connettività con il centro dati.

  Per informazioni sugli intervalli di indirizzi IP per i servizi distribuiti in Oracle Cloud Infrastructure, vedere Intervalli di indirizzi IP.

  Nella seguente tabella di esempio sono elencate le porte che devono essere aperte per la comunicazione.

  Direzione	Porta	Protocollo	Causa
  Host Management Gateway esterno	443	HTTPS	Comunicazione con i servizi Oracle Cloud Infrastructure.

A partire da Management Agent versione 221019.0021 e da Management Gateway versione 221019.0021.1667404647, la comunicazione tra agente, gateway e OCI richiede certificati. I certificati e altre entità obbligatorie verranno creati automaticamente, ma è necessario impostare determinati criteri OCI affinché questo funzioni.

Sono disponibili due opzioni:

Creazione automatica certificato (consigliato)

Questo è il metodo consigliato per creare certificati.

Se il parametro GatewayCertOcid non è impostato nel file di risposta, Management Gateway tenta di creare automaticamente i certificati richiesti e altre entità richieste.

Se Management Gateway è configurato in modalità High Availability e il load balancer e Management Gateway si trovano in domini diversi, vedere Advanced Configuration Management Gateway High Availability per i dettagli.

Gruppi dinamici obbligatori:

È necessario creare gruppi dinamici nel dominio di Identity default. Per ulteriori informazioni, vedere Oggetti per i domini di Identity.

1. Creare Credential_Dynamic_Group con la regola seguente:

   ALL  {resource.type='certificateauthority', resource.compartment.id='<>'}  

2. Creare Management_Gateway_Dynamic_Group con la regola seguente:

   ALL {resource.type='managementagent', resource.compartment.id='<>'} 

Criteri richiesti:

Allow DYNAMIC-GROUP Credential_Dynamic_Group to USE certificate-authority-delegates in compartment <>

Allow DYNAMIC-GROUP Credential_Dynamic_Group to USE vaults in compartment <>

Allow DYNAMIC-GROUP Credential_Dynamic_Group to USE keys in compartment <>

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to READ certificate-authority-bundle in compartment <>

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to READ leaf-certificate-bundle in compartment <>

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to MANAGE certificate-authorities in compartment <> where  any{request.permission='CERTIFICATE_AUTHORITY_CREATE', request.permission='CERTIFICATE_AUTHORITY_INSPECT', request.permission='CERTIFICATE_AUTHORITY_READ'} 

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to MANAGE leaf-certificates in compartment <> where  any{request.permission='CERTIFICATE_CREATE', request.permission='CERTIFICATE_INSPECT', request.permission ='CERTIFICATE_UPDATE', request.permission='CERTIFICATE_READ'}

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to MANAGE vaults in compartment <> where any{request.permission='VAULT_CREATE', request.permission='VAULT_INSPECT', request.permission='VAULT_READ', request.permission='VAULT_CREATE_KEY', request.permission='VAULT_IMPORT_KEY', request.permission='VAULT_CREATE_SECRET'} 

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to MANAGE keys in compartment <> where any{request.permission='KEY_CREATE', request.permission='KEY_INSPECT', request.permission='KEY_READ'} 

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to USE certificate-authority-delegates in compartment <>

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to USE key-delegate in compartment <> 

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group TO MANAGE leaf-certificates in compartment <> where all{request.permission='CERTIFICATE_DELETE', target.leaf-certificate.name=request.principal.id} 

Se i gruppi dinamici sono stati creati in precedenza nei domini non predefiniti, tutti i criteri devono cambiare.

Per modificare i criteri nel dominio di Identity non predefinito, modificare tutti i criteri precedenti utilizzando la sintassi riportata di seguito.

Allow DYNAMIC-GROUP <Domain Name>/Credential_Dynamic_Group to USE certificate-authority-delegates in compartment <>

Allow DYNAMIC-GROUP <Domain Name>/Management_Gateway_Dynamic_Group to READ certificate-authority-bundle in compartment <>

Gestione manuale dei certificati

È possibile impostare i certificati manualmente. L'amministratore può creare un certificato utilizzando la console OCI. Successivamente, specificare l'OCID di tale certificato nel file di risposta utilizzando il parametro GatewayCertOcid.

Per informazioni sulla creazione di un certificato, vedere Panoramica di Certificate.htm.

Gruppi dinamici richiesti:

1. Creare Credential_Dynamic_Group con la regola seguente:

   ALL  {resource.type='certificateauthority', resource.compartment.id='<>'}  

2. Creare Management_Gateway_Dynamic_Group con la regola seguente:

   ALL {resource.type='managementagent', resource.compartment.id='<>'} 

Criteri richiesti:

Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to READ certificate-authority-bundle in compartment <>
Allow DYNAMIC-GROUP Management_Gateway_Dynamic_Group to READ leaf-certificate-bundle in compartment <>

Quando si utilizza un'istanza di computazione, è possibile utilizzare le funzionalità Oracle Cloud Agent per abilitare il plugin Management Agent.

Prima di procedere, confermare di aver completato i prerequisiti. Per i dettagli, vedere Eseguire i prerequisiti per la distribuzione dei Management Agent nelle istanze di computazione.

Abilita Management Agent

Abilitazione dei Management Agent mediante la console

Per ulteriori informazioni, vedere Gestione dei plugin mediante la console.

Abilita Management Agent mediante l'API Compute

Per informazioni sull'uso dell'interfaccia API, vedere API REST.

Per informazioni sugli SDK, vedere Software Development Kits and Command Line Interface.

... 
    .agentConfig(LaunchInstanceAgentConfigDetails.builder()
			.isMonitoringDisabled(false)
			.isManagementDisabled(true)
			.areAllPluginsDisabled(false)
			.pluginsConfig(new ArrayList<>(Arrays.asList(InstanceAgentPluginConfigDetails.builder()
					.name("Management Agent")   
					.desiredState(InstanceAgentPluginConfigDetails.DesiredState.Enabled).build()))).build())
...

Dove .name("Management Agent") indica che è per il plugin Management Agent e .desiredState(InstanceAgentPluginConfigDetails.DesiredState.Enabled).build()))).build()) indica di abilitare il Management Agent.

Per ulteriori informazioni, vedere Gestione dei plugin mediante l'API.

Per configurare Management Gateway per un Management Agent abilitato in un'istanza di Oracle Cloud Compute, effettuare le operazioni riportate di seguito.